From 01a388d6433d9c34e014ea04578dcc141fd06d9e Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 24 Sep 2025 11:29:00 +0200 Subject: [PATCH 01/25] Refactor everything --- .cargo/config.toml | 2 + Cargo.lock | 1743 +++++++++++++++++++++++++++-- Cargo.toml | 8 +- src/app.rs | 730 +++--------- src/cli.rs | 86 +- src/diff_image_loader.rs | 8 +- src/github_auth.rs | 16 +- src/github_model.rs | 40 + src/github_pr.rs | 108 +- src/home.rs | 9 + src/lib.rs | 320 +++--- src/loaders/mod.rs | 17 + src/main.rs | 109 +- src/native_loaders/file_diff.rs | 78 -- src/native_loaders/file_loader.rs | 128 +++ src/native_loaders/mod.rs | 2 +- src/octokit.rs | 50 + src/settings.rs | 47 + src/snapshot.rs | 64 +- src/state.rs | 267 +++++ src/viewer/diff_view.rs | 88 ++ src/viewer/file_tree.rs | 66 ++ src/viewer/mod.rs | 159 +++ src/viewer/viewer_options.rs | 65 ++ 24 files changed, 3112 insertions(+), 1098 deletions(-) create mode 100644 .cargo/config.toml create mode 100644 src/github_model.rs create mode 100644 src/home.rs delete mode 100644 src/native_loaders/file_diff.rs create mode 100644 src/native_loaders/file_loader.rs create mode 100644 src/octokit.rs create mode 100644 src/settings.rs create mode 100644 src/state.rs create mode 100644 src/viewer/diff_view.rs create mode 100644 src/viewer/file_tree.rs create mode 100644 src/viewer/mod.rs create mode 100644 src/viewer/viewer_options.rs diff --git a/.cargo/config.toml b/.cargo/config.toml new file mode 100644 index 0000000..cb9ecf9 --- /dev/null +++ b/.cargo/config.toml @@ -0,0 +1,2 @@ +[target.wasm32-unknown-unknown] +rustflags = ['--cfg', 'getrandom_backend="wasm_js"'] \ No newline at end of file diff --git a/Cargo.lock b/Cargo.lock index 720146a..16e16f9 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -134,6 +134,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5a15f179cd60c4584b8a8c596927aadc462e27f2ca70c04e0071964a73ba7a75" dependencies = [ "cfg-if", + "const-random", "getrandom 0.3.3", "once_cell", "serde", @@ -309,6 +310,174 @@ version = "0.7.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50" +[[package]] +name = "arrow" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f3f15b4c6b148206ff3a2b35002e08929c2462467b62b9c02036d9c34f9ef994" +dependencies = [ + "arrow-arith", + "arrow-array", + "arrow-buffer", + "arrow-cast", + "arrow-data", + "arrow-ipc", + "arrow-ord", + "arrow-row", + "arrow-schema", + "arrow-select", + "arrow-string", +] + +[[package]] +name = "arrow-arith" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "30feb679425110209ae35c3fbf82404a39a4c0436bb3ec36164d8bffed2a4ce4" +dependencies = [ + "arrow-array", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "chrono", + "num", +] + +[[package]] +name = "arrow-array" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "70732f04d285d49054a48b72c54f791bb3424abae92d27aafdf776c98af161c8" +dependencies = [ + "ahash", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "chrono", + "half", + "hashbrown 0.15.5", + "num", +] + +[[package]] +name = "arrow-buffer" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "169b1d5d6cb390dd92ce582b06b23815c7953e9dfaaea75556e89d890d19993d" +dependencies = [ + "bytes", + "half", + "num", +] + +[[package]] +name = "arrow-cast" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e4f12eccc3e1c05a766cafb31f6a60a46c2f8efec9b74c6e0648766d30686af8" +dependencies = [ + "arrow-array", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "arrow-select", + "atoi", + "base64", + "chrono", + "half", + "lexical-core", + "num", + "ryu", +] + +[[package]] +name = "arrow-data" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8de1ce212d803199684b658fc4ba55fb2d7e87b213de5af415308d2fee3619c2" +dependencies = [ + "arrow-buffer", + "arrow-schema", + "half", + "num", +] + +[[package]] +name = "arrow-ipc" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d9ea5967e8b2af39aff5d9de2197df16e305f47f404781d3230b2dc672da5d92" +dependencies = [ + "arrow-array", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "flatbuffers", +] + +[[package]] +name = "arrow-ord" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6506e3a059e3be23023f587f79c82ef0bcf6d293587e3272d20f2d30b969b5a7" +dependencies = [ + "arrow-array", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "arrow-select", +] + +[[package]] +name = "arrow-row" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "52bf7393166beaf79b4bed9bfdf19e97472af32ce5b6b48169d321518a08cae2" +dependencies = [ + "arrow-array", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "half", +] + +[[package]] +name = "arrow-schema" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "af7686986a3bf2254c9fb130c623cdcb2f8e1f15763e7c71c310f0834da3d292" + +[[package]] +name = "arrow-select" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "dd2b45757d6a2373faa3352d02ff5b54b098f5e21dccebc45a21806bc34501e5" +dependencies = [ + "ahash", + "arrow-array", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "num", +] + +[[package]] +name = "arrow-string" +version = "55.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0377d532850babb4d927a06294314b316e23311503ed580ec6ce6a0158f49d40" +dependencies = [ + "arrow-array", + "arrow-buffer", + "arrow-data", + "arrow-schema", + "arrow-select", + "memchr", + "num", + "regex", + "regex-syntax", +] + [[package]] name = "as-raw-xcb-connection" version = "1.0.1" @@ -455,6 +624,15 @@ dependencies = [ "syn", ] +[[package]] +name = "atoi" +version = "2.0.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f28d99ec8bfea296261ca1af174f24225171fea9664ba9003cbebee704810528" +dependencies = [ + "num-traits", +] + [[package]] name = "atomic-waker" version = "1.1.2" @@ -540,6 +718,12 @@ dependencies = [ "arrayvec", ] +[[package]] +name = "az" +version = "1.2.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7b7e4c2464d97fe331d41de9d5db0def0a96f4d823b8b32a2efd503578988973" + [[package]] name = "backtrace" version = "0.3.75" @@ -609,6 +793,15 @@ version = "0.1.6" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0d8c1fef690941d3e7788d328517591fecc684c084084702d6ff1641e993699a" +[[package]] +name = "block-buffer" +version = "0.10.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71" +dependencies = [ + "generic-array", +] + [[package]] name = "block2" version = "0.5.1" @@ -618,6 +811,15 @@ dependencies = [ "objc2 0.5.2", ] +[[package]] +name = "block2" +version = "0.6.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "340d2f0bdb2a43c1d3cd40513185b2bd7def0aa1052f956455114bc98f82dcf2" +dependencies = [ + "objc2 0.6.2", +] + [[package]] name = "blocking" version = "1.6.2" @@ -673,6 +875,12 @@ dependencies = [ "syn", ] +[[package]] +name = "byteorder" +version = "1.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b" + [[package]] name = "byteorder-lite" version = "0.1.0" @@ -711,6 +919,38 @@ dependencies = [ "wayland-client", ] +[[package]] +name = "camino" +version = "1.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e1de8bc0aa9e9385ceb3bf0c152e3a9b9544f6c4a912c8ae504e80c1f0368603" +dependencies = [ + "serde_core", +] + +[[package]] +name = "cargo-platform" +version = "0.1.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e35af189006b9c0f00a064685c727031e3ed2d8020f7ba284d78cc2671bd36ea" +dependencies = [ + "serde", +] + +[[package]] +name = "cargo_metadata" +version = "0.18.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2d886547e41f740c616ae73108f6eb70afe6d940c7bc697cb30f13daec073037" +dependencies = [ + "camino", + "cargo-platform", + "semver", + "serde", + "serde_json", + "thiserror 1.0.69", +] + [[package]] name = "cc" version = "1.2.38" @@ -814,6 +1054,12 @@ version = "0.7.5" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b94f61472cee1439c0b966b47e3aca9ae07e45d070759512cd390ea2bebc6675" +[[package]] +name = "clean-path" +version = "0.2.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "aaa6b4b263a5d737e9bf6b7c09b72c41a5480aec4d7219af827f6564e950b6a5" + [[package]] name = "clipboard-win" version = "5.4.1" @@ -834,6 +1080,12 @@ dependencies = [ "unicode-width", ] +[[package]] +name = "color-hex" +version = "0.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ecdffb913a326b6c642290a0d0ec8e8d6597291acdc07cc4c9cb4b3635d44cf9" + [[package]] name = "color_quant" version = "1.1.0" @@ -866,6 +1118,17 @@ dependencies = [ "memchr", ] +[[package]] +name = "comfy-table" +version = "7.2.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b03b7db8e0b4b2fdad6c551e634134e99ec000e5c8c3b6856c65e8bbaded7a3b" +dependencies = [ + "crossterm", + "unicode-segmentation", + "unicode-width", +] + [[package]] name = "concat-idents" version = "1.1.5" @@ -885,6 +1148,35 @@ dependencies = [ "crossbeam-utils", ] +[[package]] +name = "const-random" +version = "0.1.18" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "87e00182fe74b066627d63b85fd550ac2998d4b0bd86bfed477a0ae4c7c71359" +dependencies = [ + "const-random-macro", +] + +[[package]] +name = "const-random-macro" +version = "0.1.16" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f9d839f2a20b0aee515dc581a6172f2321f96cab76c1a38a4c584a194955390e" +dependencies = [ + "getrandom 0.2.16", + "once_cell", + "tiny-keccak", +] + +[[package]] +name = "convert_case" +version = "0.6.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ec182b0ca2f35d8fc196cf3404988fd8b8c739a4d270ff118a398feb0cbec1ca" +dependencies = [ + "unicode-segmentation", +] + [[package]] name = "core-foundation" version = "0.9.4" @@ -935,6 +1227,15 @@ dependencies = [ "libc", ] +[[package]] +name = "cpufeatures" +version = "0.2.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280" +dependencies = [ + "libc", +] + [[package]] name = "crc32fast" version = "1.5.0" @@ -944,6 +1245,28 @@ dependencies = [ "cfg-if", ] +[[package]] +name = "crossbeam" +version = "0.8.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1137cd7e7fc0fb5d3c5a8678be38ec56e819125d8d7907411fe24ccb943faca8" +dependencies = [ + "crossbeam-channel", + "crossbeam-deque", + "crossbeam-epoch", + "crossbeam-queue", + "crossbeam-utils", +] + +[[package]] +name = "crossbeam-channel" +version = "0.5.15" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "82b8f8f868b36967f9606790d1903570de9ceaf870a7bf9fbbd3016d636a2cb2" +dependencies = [ + "crossbeam-utils", +] + [[package]] name = "crossbeam-deque" version = "0.8.6" @@ -963,24 +1286,72 @@ dependencies = [ "crossbeam-utils", ] +[[package]] +name = "crossbeam-queue" +version = "0.3.12" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0f58bbc28f91df819d0aa2a2c00cd19754769c2fad90579b3592b1c9ba7a3115" +dependencies = [ + "crossbeam-utils", +] + [[package]] name = "crossbeam-utils" version = "0.8.21" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28" +[[package]] +name = "crossterm" +version = "0.29.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d8b9f2e4c67f833b660cdb0a3523065869fb35570177239812ed4c905aeff87b" +dependencies = [ + "bitflags 2.9.4", + "crossterm_winapi", + "document-features", + "parking_lot", + "rustix 1.1.2", + "winapi", +] + +[[package]] +name = "crossterm_winapi" +version = "0.9.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "acdd7c62a3665c7f6830a51635d9ac9b23ed385797f70a83bb8bafe9c572ab2b" +dependencies = [ + "winapi", +] + [[package]] name = "crunchy" version = "0.2.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "460fbee9c2c2f33933d720630a6a0bac33ba7053db5344fac858d4b8952d77d5" +[[package]] +name = "crypto-common" +version = "0.1.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3" +dependencies = [ + "generic-array", + "typenum", +] + [[package]] name = "cursor-icon" version = "1.2.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f27ae1dd37df86211c42e150270f82743308803d90a6f6e6651cd730d5e1732f" +[[package]] +name = "data-url" +version = "0.3.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "be1e0bca6c3637f992fc1cc7cbc52a78c1ef6db076dbf1059c4323d6a2048376" + [[package]] name = "deranged" version = "0.5.3" @@ -1014,6 +1385,16 @@ dependencies = [ "rayon", ] +[[package]] +name = "digest" +version = "0.10.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292" +dependencies = [ + "block-buffer", + "crypto-common", +] + [[package]] name = "dispatch" version = "0.2.0" @@ -1077,7 +1458,8 @@ version = "0.32.3" source = "git+https://github.com/emilk/egui?branch=lucas%2Fexperiments%2Fkitdiff#1d58a55446bcc696137687ab39953905d2c6a9fb" dependencies = [ "bytemuck", - "emath", + "color-hex", + "emath 0.32.3 (git+https://github.com/emilk/egui?branch=lucas%2Fexperiments%2Fkitdiff)", "serde", ] @@ -1105,15 +1487,17 @@ dependencies = [ "objc2-foundation 0.2.2", "parking_lot", "percent-encoding", + "pollster", "profiling", "raw-window-handle", - "ron", + "ron 0.11.0", "serde", "static_assertions", "wasm-bindgen", "wasm-bindgen-futures", "web-sys", "web-time", + "wgpu", "windows-sys 0.60.2", "winit", ] @@ -1125,13 +1509,14 @@ source = "git+https://github.com/emilk/egui?branch=lucas%2Fexperiments%2Fkitdiff dependencies = [ "accesskit", "ahash", + "backtrace", "bitflags 2.9.4", - "emath", + "emath 0.32.3 (git+https://github.com/emilk/egui?branch=lucas%2Fexperiments%2Fkitdiff)", "epaint", "log", "nohash-hasher", "profiling", - "ron", + "ron 0.11.0", "serde", "smallvec", "unicode-segmentation", @@ -1175,6 +1560,27 @@ dependencies = [ "winit", ] +[[package]] +name = "egui_commonmark" +version = "0.21.1" +source = "git+https://github.com/rerun-io/egui_commonmark.git?branch=lucas%2Fupdate-egui-main#361af065d90fd9c04c232aa50701aefdf956dc46" +dependencies = [ + "egui", + "egui_commonmark_backend", + "egui_extras", + "pulldown-cmark", +] + +[[package]] +name = "egui_commonmark_backend" +version = "0.21.0" +source = "git+https://github.com/rerun-io/egui_commonmark.git?branch=lucas%2Fupdate-egui-main#361af065d90fd9c04c232aa50701aefdf956dc46" +dependencies = [ + "egui", + "egui_extras", + "pulldown-cmark", +] + [[package]] name = "egui_extras" version = "0.32.3" @@ -1188,6 +1594,8 @@ dependencies = [ "log", "mime_guess2", "profiling", + "resvg", + "serde", ] [[package]] @@ -1219,6 +1627,19 @@ dependencies = [ "parking_lot", ] +[[package]] +name = "egui_tiles" +version = "0.13.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8b1545ed157141c0fa3ef34e03104b53f68d720a37535a6f4ba252770aa6fb1f" +dependencies = [ + "ahash", + "egui", + "itertools 0.14.0", + "log", + "serde", +] + [[package]] name = "ehttp" version = "0.5.0" @@ -1240,6 +1661,12 @@ version = "1.15.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "48c757948c5ede0e46177b7add2e67155f70e33c07fea8284df6576da70b3719" +[[package]] +name = "emath" +version = "0.32.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "45fd7bc25f769a3c198fe1cf183124bf4de3bd62ef7b4f1eaf6b08711a3af8db" + [[package]] name = "emath" version = "0.32.3" @@ -1271,6 +1698,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6866f3bfdf8207509a033af1a75a7b08abda06bbaaeae6669323fd5a097df2e9" dependencies = [ "enum-map-derive", + "serde", ] [[package]] @@ -1348,12 +1776,13 @@ dependencies = [ "ahash", "bytemuck", "ecolor", - "emath", + "emath 0.32.3 (git+https://github.com/emilk/egui?branch=lucas%2Fexperiments%2Fkitdiff)", "epaint_default_fonts", "log", "nohash-hasher", "parking_lot", "profiling", + "rayon", "serde", ] @@ -1404,6 +1833,15 @@ version = "3.3.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "dea2df4cf52843e0452895c455a1a2cfbb842a1e7329671acf418fdc53ed4c59" +[[package]] +name = "euclid" +version = "0.22.11" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ad9cdb4b747e485a12abb0e6566612956c7a1bafa3bdb8d682c5b6d403589e48" +dependencies = [ + "num-traits", +] + [[package]] name = "event-listener" version = "5.4.1" @@ -1494,7 +1932,30 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1ced73b1dacfc750a6db6c0a0c3a3853c8b41997e2e2c563dc90804ae6867959" [[package]] -name = "flate2" +name = "fixed" +version = "1.29.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "707070ccf8c4173548210893a0186e29c266901b71ed20cd9e2ca0193dfe95c3" +dependencies = [ + "az", + "bytemuck", + "half", + "serde", + "typenum", +] + +[[package]] +name = "flatbuffers" +version = "25.2.10" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1045398c1bfd89168b5fd3f1fc11f6e70b34f6f66300c87d44d3de849463abf1" +dependencies = [ + "bitflags 2.9.4", + "rustc_version", +] + +[[package]] +name = "flate2" version = "1.1.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4a3d7db9596fecd151c5f638c0ee5d5bd487b6e0ea232e5dc96d5250f6f94b1d" @@ -1504,6 +1965,12 @@ dependencies = [ "miniz_oxide", ] +[[package]] +name = "float-cmp" +version = "0.9.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "98de4bbd547a563b716d8dfa9aad1cb19bfab00f4fa09a6a4ed21dbcf44ce9c4" + [[package]] name = "fnv" version = "1.0.7" @@ -1567,6 +2034,15 @@ dependencies = [ "percent-encoding", ] +[[package]] +name = "fsevent-sys" +version = "4.1.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "76ee7a02da4d231650c7cea31349b889be2f45ddb3ef3032d2ec8185f6313fd2" +dependencies = [ + "libc", +] + [[package]] name = "futures" version = "0.3.31" @@ -1669,6 +2145,16 @@ dependencies = [ "slab", ] +[[package]] +name = "generic-array" +version = "0.14.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a" +dependencies = [ + "typenum", + "version_check", +] + [[package]] name = "gethostname" version = "1.0.2" @@ -1708,9 +2194,11 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "26145e563e54f2cadc477553f1ec5ee650b00862f0a58bcd12cbdc5f0ea2d2f4" dependencies = [ "cfg-if", + "js-sys", "libc", "r-efi", "wasi 0.14.7+wasi-0.2.4", + "wasm-bindgen", ] [[package]] @@ -1755,6 +2243,12 @@ dependencies = [ "xml-rs", ] +[[package]] +name = "glob" +version = "0.3.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0cc23270f6e1808e30a928bdc84dea0b9b4136a8bc82338574f23baf47bbd280" + [[package]] name = "globset" version = "0.4.16" @@ -1922,6 +2416,7 @@ version = "2.6.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "459196ed295495a68f7d7fe1d84f6c4b7ff0e21fe3017b2f283c6fac3ad803c9" dependencies = [ + "bytemuck", "cfg-if", "crunchy", "num-traits", @@ -2027,6 +2522,12 @@ version = "1.10.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87" +[[package]] +name = "httpdate" +version = "1.0.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9" + [[package]] name = "hyper" version = "1.7.0" @@ -2041,6 +2542,7 @@ dependencies = [ "http", "http-body", "httparse", + "httpdate", "itoa", "pin-project-lite", "pin-utils", @@ -2114,7 +2616,7 @@ dependencies = [ "libc", "percent-encoding", "pin-project-lite", - "socket2", + "socket2 0.6.0", "system-configuration", "tokio", "tower-service", @@ -2283,7 +2785,7 @@ dependencies = [ "image-webp", "moxcms", "num-traits", - "png", + "png 0.18.0", "qoi", "ravif", "rayon", @@ -2303,12 +2805,24 @@ dependencies = [ "quick-error", ] +[[package]] +name = "imagesize" +version = "0.13.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "edcd27d72f2f071c64249075f42e205ff93c9a4c5f6c6da53e79ed9f9832c285" + [[package]] name = "imgref" version = "1.11.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d0263a3d970d5c054ed9312c0057b4f3bde9c0b33836d3637361d4a9e6e7a408" +[[package]] +name = "indent" +version = "0.1.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d9f1a0777d972970f204fdf8ef319f1f4f8459131636d7e3c96c5d59570d0fa6" + [[package]] name = "indexmap" version = "2.11.4" @@ -2319,6 +2833,26 @@ dependencies = [ "hashbrown 0.16.0", ] +[[package]] +name = "inotify" +version = "0.11.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f37dccff2791ab604f9babef0ba14fbe0be30bd368dc541e2b08d07c8aa908f3" +dependencies = [ + "bitflags 2.9.4", + "inotify-sys", + "libc", +] + +[[package]] +name = "inotify-sys" +version = "0.1.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e05c02b5e89bff3b946cedeca278abc628fe811e604f027c45a8aa3cf793d0eb" +dependencies = [ + "libc", +] + [[package]] name = "interpolate_name" version = "0.2.4" @@ -2363,6 +2897,15 @@ version = "1.70.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7943c866cc5cd64cbc25b2e01621d07fa8eb2a1a23160ee81ce38704e97b8ecf" +[[package]] +name = "itertools" +version = "0.10.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b0fd2260e829bddf4cb6ea802289de2f86d6a7a690192fbe91b3f46e0f2c8473" +dependencies = [ + "either", +] + [[package]] name = "itertools" version = "0.12.1" @@ -2372,6 +2915,15 @@ dependencies = [ "either", ] +[[package]] +name = "itertools" +version = "0.14.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2b192c782037fadd9cfa75548310488aabdbf3d2da73885b31bd0abd03351285" +dependencies = [ + "either", +] + [[package]] name = "itoa" version = "1.0.15" @@ -2385,10 +2937,14 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "be1f93b8b1eb69c77f24bbb0afdf66f54b632ee39af40ca21c4365a1d7347e49" dependencies = [ "jiff-static", + "jiff-tzdb-platform", + "js-sys", "log", "portable-atomic", "portable-atomic-util", "serde", + "wasm-bindgen", + "windows-sys 0.59.0", ] [[package]] @@ -2402,6 +2958,21 @@ dependencies = [ "syn", ] +[[package]] +name = "jiff-tzdb" +version = "0.1.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c1283705eb0a21404d2bfd6eef2a7593d240bc42a0bdb39db0ad6fa2ec026524" + +[[package]] +name = "jiff-tzdb-platform" +version = "0.1.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "875a5a69ac2bab1a891711cf5eccbec1ce0341ea805560dcd90b7a2e925132e8" +dependencies = [ + "jiff-tzdb", +] + [[package]] name = "jni" version = "0.21.1" @@ -2480,6 +3051,7 @@ checksum = "e2db585e1d738fc771bf08a151420d3ed193d9d895a36df7f6f8a9456b911ddc" name = "kitdiff" version = "0.1.0" dependencies = [ + "anyhow", "chrono", "clap", "dify", @@ -2490,12 +3062,14 @@ dependencies = [ "env_logger", "flate2", "futures", + "getrandom 0.3.3", "git2", "ignore", "image", "js-sys", "octocrab", "octocrab-wasm", + "re_ui", "serde", "serde_json", "tar", @@ -2507,6 +3081,37 @@ dependencies = [ "zip", ] +[[package]] +name = "kqueue" +version = "1.1.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "eac30106d7dce88daf4a3fcb4879ea939476d5074a9b7ddd0fb97fa4bed5596a" +dependencies = [ + "kqueue-sys", + "libc", +] + +[[package]] +name = "kqueue-sys" +version = "1.0.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ed9625ffda8729b85e45cf04090035ac368927b8cebc34898e7c120f52e4838b" +dependencies = [ + "bitflags 1.3.2", + "libc", +] + +[[package]] +name = "kurbo" +version = "0.11.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c62026ae44756f8a599ba21140f350303d4f08dcdcc71b5ad9c9bb8128c13c62" +dependencies = [ + "arrayvec", + "euclid", + "smallvec", +] + [[package]] name = "lazy_static" version = "1.5.0" @@ -2519,6 +3124,63 @@ version = "0.5.3" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "7a79a3332a6609480d7d0c9eab957bca6b455b91bb84e66d19f5ff66294b85b8" +[[package]] +name = "lexical-core" +version = "1.0.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7d8d125a277f807e55a77304455eb7b1cb52f2b18c143b60e766c120bd64a594" +dependencies = [ + "lexical-parse-float", + "lexical-parse-integer", + "lexical-util", + "lexical-write-float", + "lexical-write-integer", +] + +[[package]] +name = "lexical-parse-float" +version = "1.0.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "52a9f232fbd6f550bc0137dcb5f99ab674071ac2d690ac69704593cb4abbea56" +dependencies = [ + "lexical-parse-integer", + "lexical-util", +] + +[[package]] +name = "lexical-parse-integer" +version = "1.0.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9a7a039f8fb9c19c996cd7b2fcce303c1b2874fe1aca544edc85c4a5f8489b34" +dependencies = [ + "lexical-util", +] + +[[package]] +name = "lexical-util" +version = "1.0.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2604dd126bb14f13fb5d1bd6a66155079cb9fa655b37f875b3a742c705dbed17" + +[[package]] +name = "lexical-write-float" +version = "1.0.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "50c438c87c013188d415fbabbb1dceb44249ab81664efbd31b14ae55dabb6361" +dependencies = [ + "lexical-util", + "lexical-write-integer", +] + +[[package]] +name = "lexical-write-integer" +version = "1.0.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "409851a618475d2d5796377cad353802345cba92c867d9fbcde9cf4eac4e14df" +dependencies = [ + "lexical-util", +] + [[package]] name = "libc" version = "0.2.175" @@ -2651,6 +3313,15 @@ version = "0.4.28" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "34080505efa8e45a4b816c349525ebe327ceaa8559756f0356cba97ef3bf7432" +[[package]] +name = "log-once" +version = "0.4.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6d8a05e3879b317b1b6dbf353e5bba7062bedcc59815267bb23eaa0c576cebf0" +dependencies = [ + "log", +] + [[package]] name = "loop9" version = "0.1.5" @@ -2660,6 +3331,15 @@ dependencies = [ "imgref", ] +[[package]] +name = "lz4_flex" +version = "0.11.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "08ab2867e3eeeca90e844d1940eab391c9dc5228783db2ed999acbc0a9ed375a" +dependencies = [ + "twox-hash", +] + [[package]] name = "malloc_buf" version = "0.0.6" @@ -2759,6 +3439,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "78bed444cc8a2160f01cbcf811ef18cac863ad68ae8ca62092e8db51d51c761c" dependencies = [ "libc", + "log", "wasi 0.11.1+wasi-snapshot-preview1", "windows-sys 0.59.0", ] @@ -2815,6 +3496,12 @@ dependencies = [ "tempfile", ] +[[package]] +name = "natord" +version = "1.0.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "308d96db8debc727c3fd9744aac51751243420e46edf401010908da7f8d5e57c" + [[package]] name = "ndk" version = "0.9.0" @@ -2895,6 +3582,44 @@ version = "0.3.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0676bb32a98c1a483ce53e500a81ad9c3d5b3f7c920c28c24e9cb0980d0b5bc8" +[[package]] +name = "notify" +version = "8.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4d3d07927151ff8575b7087f245456e549fea62edf0ec4e565a5ee50c8402bc3" +dependencies = [ + "bitflags 2.9.4", + "fsevent-sys", + "inotify", + "kqueue", + "libc", + "log", + "mio", + "notify-types", + "walkdir", + "windows-sys 0.60.2", +] + +[[package]] +name = "notify-types" +version = "2.0.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5e0826a989adedc2a244799e823aece04662b66609d96af8dff7ac6df9a8925d" + +[[package]] +name = "num" +version = "0.4.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "35bd024e8b2ff75562e5f34e7f4905839deb4b22955ef5e73d2fea1b9813cb23" +dependencies = [ + "num-bigint", + "num-complex", + "num-integer", + "num-iter", + "num-rational", + "num-traits", +] + [[package]] name = "num-bigint" version = "0.4.6" @@ -2905,6 +3630,15 @@ dependencies = [ "num-traits", ] +[[package]] +name = "num-complex" +version = "0.4.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "73f88a1307638156682bada9d7604135552957b7818057dcef22705b4d509495" +dependencies = [ + "num-traits", +] + [[package]] name = "num-conv" version = "0.1.0" @@ -2931,6 +3665,17 @@ dependencies = [ "num-traits", ] +[[package]] +name = "num-iter" +version = "0.1.45" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1429034a0490724d0075ebb2bc9e875d6503c3cf69e235a8941aa757d83ef5bf" +dependencies = [ + "autocfg", + "num-integer", + "num-traits", +] + [[package]] name = "num-rational" version = "0.4.2" @@ -3015,13 +3760,13 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e4e89ad9e3d7d297152b17d39ed92cd50ca8063a89a9fa569046d41568891eff" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "libc", "objc2 0.5.2", - "objc2-core-data", - "objc2-core-image", + "objc2-core-data 0.2.2", + "objc2-core-image 0.2.2", "objc2-foundation 0.2.2", - "objc2-quartz-core", + "objc2-quartz-core 0.2.2", ] [[package]] @@ -3031,10 +3776,16 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e6f29f568bec459b0ddff777cec4fe3fd8666d82d5a40ebd0ff7e66134f89bcc" dependencies = [ "bitflags 2.9.4", + "block2 0.6.1", + "libc", "objc2 0.6.2", + "objc2-cloud-kit 0.3.1", + "objc2-core-data 0.3.1", "objc2-core-foundation", "objc2-core-graphics", + "objc2-core-image 0.3.1", "objc2-foundation 0.3.1", + "objc2-quartz-core 0.3.1", ] [[package]] @@ -3044,19 +3795,30 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "74dd3b56391c7a0596a295029734d3c1c5e7e510a4cb30245f8221ccea96b009" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-core-location", "objc2-foundation 0.2.2", ] +[[package]] +name = "objc2-cloud-kit" +version = "0.3.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "17614fdcd9b411e6ff1117dfb1d0150f908ba83a7df81b1f118005fe0a8ea15d" +dependencies = [ + "bitflags 2.9.4", + "objc2 0.6.2", + "objc2-foundation 0.3.1", +] + [[package]] name = "objc2-contacts" version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a5ff520e9c33812fd374d8deecef01d4a840e7b41862d849513de77e44aa4889" dependencies = [ - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-foundation 0.2.2", ] @@ -3068,11 +3830,22 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "617fbf49e071c178c0b24c080767db52958f716d9eabdf0890523aeae54773ef" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-foundation 0.2.2", ] +[[package]] +name = "objc2-core-data" +version = "0.3.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "291fbbf7d29287518e8686417cf7239c74700fd4b607623140a7d4a3c834329d" +dependencies = [ + "bitflags 2.9.4", + "objc2 0.6.2", + "objc2-foundation 0.3.1", +] + [[package]] name = "objc2-core-foundation" version = "0.3.1" @@ -3103,19 +3876,29 @@ version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "55260963a527c99f1819c4f8e3b47fe04f9650694ef348ffd2227e8196d34c80" dependencies = [ - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-foundation 0.2.2", "objc2-metal", ] +[[package]] +name = "objc2-core-image" +version = "0.3.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "79b3dc0cc4386b6ccf21c157591b34a7f44c8e75b064f85502901ab2188c007e" +dependencies = [ + "objc2 0.6.2", + "objc2-foundation 0.3.1", +] + [[package]] name = "objc2-core-location" version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "000cfee34e683244f284252ee206a27953279d370e309649dc3ee317b37e5781" dependencies = [ - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-contacts", "objc2-foundation 0.2.2", @@ -3134,7 +3917,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0ee638a5da3799329310ad4cfa62fbf045d5f56e3ef5ba4149e7452dcf89d5a8" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "dispatch", "libc", "objc2 0.5.2", @@ -3168,7 +3951,7 @@ version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a1a1ae721c5e35be65f01a03b6d2ac13a54cb4fa70d8a5da293d7b0020261398" dependencies = [ - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-app-kit 0.2.2", "objc2-foundation 0.2.2", @@ -3181,7 +3964,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "dd0cba1276f6023976a406a14ffa85e1fdd19df6b0f737b063b95f6c8c7aadd6" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-foundation 0.2.2", ] @@ -3193,12 +3976,23 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e42bee7bff906b14b167da2bac5efe6b6a07e6f7c0a21a7308d40c960242dc7a" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-foundation 0.2.2", "objc2-metal", ] +[[package]] +name = "objc2-quartz-core" +version = "0.3.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "90ffb6a0cd5f182dc964334388560b12a57f7b74b3e2dec5e2722aa2dfb2ccd5" +dependencies = [ + "bitflags 2.9.4", + "objc2 0.6.2", + "objc2-foundation 0.3.1", +] + [[package]] name = "objc2-symbols" version = "0.2.2" @@ -3216,15 +4010,15 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "b8bb46798b20cd6b91cbd113524c490f1686f4c4e8f49502431415f3512e2b6f" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "objc2 0.5.2", - "objc2-cloud-kit", - "objc2-core-data", - "objc2-core-image", + "objc2-cloud-kit 0.2.2", + "objc2-core-data 0.2.2", + "objc2-core-image 0.2.2", "objc2-core-location", "objc2-foundation 0.2.2", "objc2-link-presentation", - "objc2-quartz-core", + "objc2-quartz-core 0.2.2", "objc2-symbols", "objc2-uniform-type-identifiers", "objc2-user-notifications", @@ -3236,7 +4030,7 @@ version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "44fa5f9748dbfe1ca6c0b79ad20725a11eca7c2218bceb4b005cb1be26273bfe" dependencies = [ - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-foundation 0.2.2", ] @@ -3248,7 +4042,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "76cfcbf642358e8689af64cee815d139339f3ed8ad05103ed5eaf73db8d84cb3" dependencies = [ "bitflags 2.9.4", - "block2", + "block2 0.5.1", "objc2 0.5.2", "objc2-core-location", "objc2-foundation 0.2.2", @@ -3277,6 +4071,7 @@ dependencies = [ "chrono", "either", "futures", + "futures-core", "futures-util", "http", "http-body", @@ -3507,6 +4302,12 @@ dependencies = [ "unicase", ] +[[package]] +name = "pico-args" +version = "0.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5be167a7af36ee22fe3115051bc51f6e6c7054c9348e28deb4f49bd6f705a315" + [[package]] name = "pin-project" version = "1.1.10" @@ -3558,9 +4359,22 @@ checksum = "7edddbd0b52d732b21ad9a5fab5c704c14cd949e5e9a1ec5929a24fded1b904c" [[package]] name = "png" -version = "0.18.0" +version = "0.17.16" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "97baced388464909d42d89643fe4361939af9b7ce7a31ee32a168f832a70f2a0" +checksum = "82151a2fc869e011c153adc57cf2789ccb8d9906ce52c0b39a6b5697749d7526" +dependencies = [ + "bitflags 1.3.2", + "crc32fast", + "fdeflate", + "flate2", + "miniz_oxide", +] + +[[package]] +name = "png" +version = "0.18.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "97baced388464909d42d89643fe4361939af9b7ce7a31ee32a168f832a70f2a0" dependencies = [ "bitflags 2.9.4", "crc32fast", @@ -3583,6 +4397,12 @@ dependencies = [ "windows-sys 0.61.0", ] +[[package]] +name = "pollster" +version = "0.4.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2f3a9f18d041e6d0e102a0a46750538147e5e8992d3b4873aaafee2520b00ce3" + [[package]] name = "portable-atomic" version = "1.11.1" @@ -3665,6 +4485,63 @@ dependencies = [ "syn", ] +[[package]] +name = "prost" +version = "0.13.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2796faa41db3ec313a31f7624d9286acf277b52de526150b7e69f3debf891ee5" +dependencies = [ + "bytes", + "prost-derive", +] + +[[package]] +name = "prost-derive" +version = "0.13.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8a56d757972c98b346a9b766e3f02746cde6dd1cd1d1d563472929fdd74bec4d" +dependencies = [ + "anyhow", + "itertools 0.14.0", + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "prost-types" +version = "0.13.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "52c2c1bf36ddb1a1c396b3601a3cec27c2462e45f07c386894ec3ccf5332bd16" +dependencies = [ + "prost", +] + +[[package]] +name = "puffin" +version = "0.19.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "fa9dae7b05c02ec1a6bc9bcf20d8bc64a7dcbf57934107902a872014899b741f" +dependencies = [ + "anyhow", + "byteorder", + "cfg-if", + "itertools 0.10.5", + "once_cell", + "parking_lot", +] + +[[package]] +name = "pulldown-cmark" +version = "0.13.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1e8bbe1a966bd2f362681a44f6edce3c2310ac21e4d5067a6e7ec396297a6ea0" +dependencies = [ + "bitflags 2.9.4", + "memchr", + "unicase", +] + [[package]] name = "pxfm" version = "0.1.23" @@ -3750,89 +4627,540 @@ version = "0.6.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c" dependencies = [ - "getrandom 0.2.16", + "getrandom 0.2.16", +] + +[[package]] +name = "range-alloc" +version = "0.1.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c3d6831663a5098ea164f89cff59c6284e95f4e3c76ce9848d4529f5ccca9bde" + +[[package]] +name = "rav1e" +version = "0.7.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cd87ce80a7665b1cce111f8a16c1f3929f6547ce91ade6addf4ec86a8dda5ce9" +dependencies = [ + "arbitrary", + "arg_enum_proc_macro", + "arrayvec", + "av1-grain", + "bitstream-io", + "built", + "cfg-if", + "interpolate_name", + "itertools 0.12.1", + "libc", + "libfuzzer-sys", + "log", + "maybe-rayon", + "new_debug_unreachable", + "noop_proc_macro", + "num-derive", + "num-traits", + "once_cell", + "paste", + "profiling", + "rand", + "rand_chacha", + "simd_helpers", + "system-deps", + "thiserror 1.0.69", + "v_frame", + "wasm-bindgen", +] + +[[package]] +name = "ravif" +version = "0.11.20" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5825c26fddd16ab9f515930d49028a630efec172e903483c94796cfe31893e6b" +dependencies = [ + "avif-serialize", + "imgref", + "loop9", + "quick-error", + "rav1e", + "rayon", + "rgb", +] + +[[package]] +name = "raw-window-handle" +version = "0.6.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "20675572f6f24e9e76ef639bc5552774ed45f1c30e2951e1e99c59888861c539" + +[[package]] +name = "rayon" +version = "1.11.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "368f01d005bf8fd9b1206fb6fa653e6c4a81ceb1466406b81792d87c5677a58f" +dependencies = [ + "either", + "rayon-core", +] + +[[package]] +name = "rayon-core" +version = "1.13.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91" +dependencies = [ + "crossbeam-deque", + "crossbeam-utils", +] + +[[package]] +name = "re_arrow_util" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "anyhow", + "arrow", + "half", + "itertools 0.14.0", + "re_log", + "re_tracing", +] + +[[package]] +name = "re_build_info" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "re_byte_size", + "serde", +] + +[[package]] +name = "re_build_tools" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "anyhow", + "cargo_metadata", + "glob", + "jiff", + "sha2", + "unindent", + "walkdir", +] + +[[package]] +name = "re_byte_size" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "arrow", + "half", + "smallvec", +] + +[[package]] +name = "re_case" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "convert_case", +] + +[[package]] +name = "re_chunk" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "ahash", + "anyhow", + "arrow", + "bytemuck", + "crossbeam", + "document-features", + "half", + "itertools 0.14.0", + "nohash-hasher", + "rand", + "re_arrow_util", + "re_byte_size", + "re_error", + "re_format", + "re_format_arrow", + "re_log", + "re_log_types", + "re_sorbet", + "re_span", + "re_tracing", + "re_tuid", + "re_types_core", + "thiserror 1.0.69", + "tracing", +] + +[[package]] +name = "re_chunk_store" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "ahash", + "anyhow", + "arrow", + "document-features", + "indent", + "itertools 0.14.0", + "nohash-hasher", + "parking_lot", + "re_arrow_util", + "re_byte_size", + "re_chunk", + "re_format", + "re_log", + "re_log_encoding", + "re_log_types", + "re_sorbet", + "re_tracing", + "re_types_core", + "tap", + "thiserror 1.0.69", + "web-time", +] + +[[package]] +name = "re_entity_db" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "ahash", + "document-features", + "emath 0.32.3 (registry+https://github.com/rust-lang/crates.io-index)", + "itertools 0.14.0", + "nohash-hasher", + "parking_lot", + "re_arrow_util", + "re_build_info", + "re_byte_size", + "re_chunk", + "re_chunk_store", + "re_format", + "re_int_histogram", + "re_log", + "re_log_encoding", + "re_log_types", + "re_query", + "re_smart_channel", + "re_sorbet", + "re_tracing", + "re_types_core", + "re_uri", + "thiserror 1.0.69", + "web-time", +] + +[[package]] +name = "re_error" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" + +[[package]] +name = "re_format" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "half", + "num-traits", +] + +[[package]] +name = "re_format_arrow" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "arrow", + "comfy-table", + "itertools 0.14.0", + "re_arrow_util", + "re_tuid", + "re_types_core", + "serde_json", +] + +[[package]] +name = "re_int_histogram" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "smallvec", + "static_assertions", +] + +[[package]] +name = "re_log" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "env_filter", + "env_logger", + "js-sys", + "log", + "log-once", + "parking_lot", + "tracing", + "wasm-bindgen", +] + +[[package]] +name = "re_log_encoding" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "arrow", + "bytes", + "lz4_flex", + "parking_lot", + "re_build_info", + "re_chunk", + "re_log", + "re_log_types", + "re_protos", + "re_smart_channel", + "re_sorbet", + "re_tracing", + "thiserror 1.0.69", + "tokio", + "tokio-stream", + "tracing", +] + +[[package]] +name = "re_log_types" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "ahash", + "arrow", + "bytemuck", + "clean-path", + "document-features", + "fixed", + "half", + "itertools 0.14.0", + "jiff", + "natord", + "nohash-hasher", + "num-derive", + "num-traits", + "re_arrow_util", + "re_build_info", + "re_byte_size", + "re_format", + "re_log", + "re_string_interner", + "re_tracing", + "re_tuid", + "re_types_core", + "serde", + "static_assertions", + "thiserror 1.0.69", + "typenum", + "uuid", + "web-time", +] + +[[package]] +name = "re_protos" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "arrow", + "jiff", + "prost", + "prost-types", + "re_arrow_util", + "re_build_info", + "re_byte_size", + "re_chunk", + "re_log_types", + "re_sorbet", + "re_tuid", + "serde", + "thiserror 1.0.69", + "tonic", + "url", +] + +[[package]] +name = "re_query" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "ahash", + "anyhow", + "arrow", + "indent", + "itertools 0.14.0", + "nohash-hasher", + "parking_lot", + "paste", + "re_arrow_util", + "re_byte_size", + "re_chunk", + "re_chunk_store", + "re_error", + "re_format", + "re_log", + "re_log_types", + "re_tracing", + "re_types_core", + "seq-macro", + "thiserror 1.0.69", +] + +[[package]] +name = "re_smart_channel" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "crossbeam", + "parking_lot", + "re_tracing", + "re_uri", + "serde", + "thiserror 1.0.69", + "web-time", +] + +[[package]] +name = "re_sorbet" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "arrow", + "itertools 0.14.0", + "nohash-hasher", + "re_arrow_util", + "re_format_arrow", + "re_log", + "re_log_types", + "re_tracing", + "re_tuid", + "re_types_core", + "semver", + "thiserror 1.0.69", + "tracing", + "web-time", +] + +[[package]] +name = "re_span" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "num-traits", ] [[package]] -name = "range-alloc" -version = "0.1.4" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c3d6831663a5098ea164f89cff59c6284e95f4e3c76ce9848d4529f5ccca9bde" +name = "re_string_interner" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "ahash", + "nohash-hasher", + "parking_lot", + "serde", + "static_assertions", +] [[package]] -name = "rav1e" -version = "0.7.1" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "cd87ce80a7665b1cce111f8a16c1f3929f6547ce91ade6addf4ec86a8dda5ce9" +name = "re_tracing" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" dependencies = [ - "arbitrary", - "arg_enum_proc_macro", - "arrayvec", - "av1-grain", - "bitstream-io", - "built", - "cfg-if", - "interpolate_name", - "itertools", - "libc", - "libfuzzer-sys", - "log", - "maybe-rayon", - "new_debug_unreachable", - "noop_proc_macro", - "num-derive", - "num-traits", - "once_cell", - "paste", - "profiling", - "rand", - "rand_chacha", - "simd_helpers", - "system-deps", - "thiserror 1.0.69", - "v_frame", - "wasm-bindgen", + "puffin", ] [[package]] -name = "ravif" -version = "0.11.20" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "5825c26fddd16ab9f515930d49028a630efec172e903483c94796cfe31893e6b" +name = "re_tuid" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" dependencies = [ - "avif-serialize", - "imgref", - "loop9", - "quick-error", - "rav1e", - "rayon", - "rgb", + "bytemuck", + "document-features", + "getrandom 0.3.3", + "re_byte_size", + "serde", + "web-time", ] [[package]] -name = "raw-window-handle" -version = "0.6.2" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "20675572f6f24e9e76ef639bc5552774ed45f1c30e2951e1e99c59888861c539" +name = "re_types_core" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +dependencies = [ + "anyhow", + "arrow", + "bytemuck", + "document-features", + "half", + "itertools 0.14.0", + "nohash-hasher", + "re_arrow_util", + "re_byte_size", + "re_case", + "re_error", + "re_log", + "re_string_interner", + "re_tracing", + "re_tuid", + "serde", + "thiserror 1.0.69", +] [[package]] -name = "rayon" -version = "1.11.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "368f01d005bf8fd9b1206fb6fa653e6c4a81ceb1466406b81792d87c5677a58f" +name = "re_ui" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" dependencies = [ - "either", - "rayon-core", + "ahash", + "anyhow", + "eframe", + "egui", + "egui_commonmark", + "egui_extras", + "egui_tiles", + "getrandom 0.3.3", + "itertools 0.14.0", + "jiff", + "notify", + "num-traits", + "objc2-app-kit 0.3.1", + "parking_lot", + "raw-window-handle", + "re_build_tools", + "re_entity_db", + "re_format", + "re_log", + "re_log_types", + "re_tracing", + "ron 0.10.1", + "serde", + "smallvec", + "strum", + "strum_macros", + "sublime_fuzzy", + "url", ] [[package]] -name = "rayon-core" -version = "1.13.0" -source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91" +name = "re_uri" +version = "0.26.0-alpha.1+dev" +source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" dependencies = [ - "crossbeam-deque", - "crossbeam-utils", + "re_log", + "re_log_types", + "re_tuid", + "serde", + "thiserror 1.0.69", + "url", ] [[package]] @@ -3928,11 +5256,28 @@ dependencies = [ "web-sys", ] +[[package]] +name = "resvg" +version = "0.45.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a8928798c0a55e03c9ca6c4c6846f76377427d2c1e1f7e6de3c06ae57942df43" +dependencies = [ + "log", + "pico-args", + "rgb", + "svgtypes", + "tiny-skia", + "usvg", +] + [[package]] name = "rgb" version = "0.8.52" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "0c6a884d2998352bb4daf0183589aec883f16a6da1f4dde84d8e2e9a5409a1ce" +dependencies = [ + "bytemuck", +] [[package]] name = "ring" @@ -3948,6 +5293,19 @@ dependencies = [ "windows-sys 0.52.0", ] +[[package]] +name = "ron" +version = "0.10.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "beceb6f7bf81c73e73aeef6dd1356d9a1b2b4909e1f0fc3e59b034f9572d7b7f" +dependencies = [ + "base64", + "bitflags 2.9.4", + "serde", + "serde_derive", + "unicode-ident", +] + [[package]] name = "ron" version = "0.11.0" @@ -3961,6 +5319,12 @@ dependencies = [ "unicode-ident", ] +[[package]] +name = "roxmltree" +version = "0.20.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "6c20b6793b5c2fa6553b250154b78d6d0db37e72700ae35fad9387a46f487c97" + [[package]] name = "rustc-demangle" version = "0.1.26" @@ -3979,6 +5343,15 @@ version = "2.1.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "357703d41365b4b27c590e3ed91eabb1b663f07c4c084095e60cbed4362dff0d" +[[package]] +name = "rustc_version" +version = "0.4.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92" +dependencies = [ + "semver", +] + [[package]] name = "rustix" version = "0.38.44" @@ -4152,6 +5525,22 @@ dependencies = [ "libc", ] +[[package]] +name = "semver" +version = "1.0.27" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "d767eb0aabc880b29956c35734170f26ed551a859dbd361d140cdbeca61ab1e2" +dependencies = [ + "serde", + "serde_core", +] + +[[package]] +name = "seq-macro" +version = "0.3.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1bc711410fbe7399f390ca1c3b60ad0f53f80e95c5eb935e52268a0e2cd49acc" + [[package]] name = "serde" version = "1.0.225" @@ -4238,6 +5627,17 @@ dependencies = [ "serde", ] +[[package]] +name = "sha2" +version = "0.10.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283" +dependencies = [ + "cfg-if", + "cpufeatures", + "digest", +] + [[package]] name = "shlex" version = "1.3.0" @@ -4280,6 +5680,15 @@ dependencies = [ "time", ] +[[package]] +name = "simplecss" +version = "0.2.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7a9c6883ca9c3c7c90e888de77b7a5c849c779d25d74a1269b0218b14e8b136c" +dependencies = [ + "log", +] + [[package]] name = "siphasher" version = "1.0.1" @@ -4373,6 +5782,16 @@ dependencies = [ "syn", ] +[[package]] +name = "socket2" +version = "0.5.10" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e22376abed350d73dd1cd119b57ffccad95b4e585a7cda43e286245ce23c0678" +dependencies = [ + "libc", + "windows-sys 0.52.0", +] + [[package]] name = "socket2" version = "0.6.0" @@ -4409,6 +5828,9 @@ name = "strict-num" version = "0.1.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6637bab7722d379c8b41ba849228d680cc12d0a45ba1fa2b48f2a30577a06731" +dependencies = [ + "float-cmp", +] [[package]] name = "strsim" @@ -4438,12 +5860,28 @@ dependencies = [ "syn", ] +[[package]] +name = "sublime_fuzzy" +version = "0.7.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "fa7986063f7c0ab374407e586d7048a3d5aac94f103f751088bf398e07cd5400" + [[package]] name = "subtle" version = "2.6.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292" +[[package]] +name = "svgtypes" +version = "0.15.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "68c7541fff44b35860c1a7a47a7cadf3e4a304c457b58f9870d9706ece028afc" +dependencies = [ + "kurbo", + "siphasher", +] + [[package]] name = "syn" version = "2.0.106" @@ -4509,6 +5947,12 @@ dependencies = [ "version-compare", ] +[[package]] +name = "tap" +version = "1.0.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "55937e1799185b12863d447f42597ed69d9928686b8d88a1df17376a097d8369" + [[package]] name = "tar" version = "0.4.44" @@ -4633,6 +6077,15 @@ dependencies = [ "time-core", ] +[[package]] +name = "tiny-keccak" +version = "2.0.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2c9d3793400a45f954c52e73d068316d76b6f4e36977e3fcebb13a2721e80237" +dependencies = [ + "crunchy", +] + [[package]] name = "tiny-skia" version = "0.11.4" @@ -4644,6 +6097,7 @@ dependencies = [ "bytemuck", "cfg-if", "log", + "png 0.17.16", "tiny-skia-path", ] @@ -4683,7 +6137,7 @@ dependencies = [ "pin-project-lite", "signal-hook-registry", "slab", - "socket2", + "socket2 0.6.0", "tokio-macros", "windows-sys 0.59.0", ] @@ -4719,6 +6173,17 @@ dependencies = [ "tokio", ] +[[package]] +name = "tokio-stream" +version = "0.1.17" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "eca58d7bba4a75707817a2c44174253f9236b2d5fbd055602e9d5c07c139a047" +dependencies = [ + "futures-core", + "pin-project-lite", + "tokio", +] + [[package]] name = "tokio-util" version = "0.7.16" @@ -4796,6 +6261,34 @@ dependencies = [ "winnow", ] +[[package]] +name = "tonic" +version = "0.13.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7e581ba15a835f4d9ea06c55ab1bd4dce26fc53752c69a04aac00703bfb49ba9" +dependencies = [ + "async-trait", + "base64", + "bytes", + "h2", + "http", + "http-body", + "http-body-util", + "hyper", + "hyper-timeout", + "hyper-util", + "percent-encoding", + "pin-project", + "prost", + "socket2 0.5.10", + "tokio", + "tokio-stream", + "tower", + "tower-layer", + "tower-service", + "tracing", +] + [[package]] name = "tower" version = "0.5.2" @@ -4804,7 +6297,9 @@ checksum = "d039ad9159c98b70ecfd540b2573b97f7f52c3e8d9f8ad57a24b916a536975f9" dependencies = [ "futures-core", "futures-util", + "indexmap", "pin-project-lite", + "slab", "sync_wrapper", "tokio", "tokio-util", @@ -4888,6 +6383,12 @@ version = "0.25.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "d2df906b07856748fa3f6e0ad0cbaa047052d4a7dd609e231c4f72cee8c36f31" +[[package]] +name = "twox-hash" +version = "2.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9ea3136b675547379c4bd395ca6b938e5ad3c3d20fad76e7fe85f9e0d011419c" + [[package]] name = "type-map" version = "0.5.1" @@ -4897,6 +6398,12 @@ dependencies = [ "rustc-hash 2.1.1", ] +[[package]] +name = "typenum" +version = "1.18.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1dccffe3ce07af9386bfd29e80c0ab1a8205a2fc34e4bcd40364df902cfa8f3f" + [[package]] name = "uds_windows" version = "1.1.0" @@ -4932,6 +6439,12 @@ version = "0.2.1" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4a1a07cc7db3810833284e8d372ccdc6da29741639ecc70c9ec107df0fa6154c" +[[package]] +name = "unindent" +version = "0.2.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3" + [[package]] name = "untrusted" version = "0.9.0" @@ -4966,6 +6479,28 @@ dependencies = [ "serde", ] +[[package]] +name = "usvg" +version = "0.45.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "80be9b06fbae3b8b303400ab20778c80bbaf338f563afe567cf3c9eea17b47ef" +dependencies = [ + "base64", + "data-url", + "flate2", + "imagesize", + "kurbo", + "log", + "pico-args", + "roxmltree", + "simplecss", + "siphasher", + "strict-num", + "svgtypes", + "tiny-skia-path", + "xmlwriter", +] + [[package]] name = "utf8_iter" version = "1.0.4" @@ -4978,6 +6513,18 @@ version = "0.2.2" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "06abde3611657adf66d383f00b093d7faecc7fa57071cce2578660c9f1010821" +[[package]] +name = "uuid" +version = "1.18.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2f87b8aa10b915a06587d0dec516c282ff295b475d94abf425d62b57710070a2" +dependencies = [ + "getrandom 0.3.3", + "js-sys", + "serde", + "wasm-bindgen", +] + [[package]] name = "v_frame" version = "0.3.9" @@ -5903,7 +7450,7 @@ dependencies = [ "android-activity", "atomic-waker", "bitflags 2.9.4", - "block2", + "block2 0.5.1", "bytemuck", "calloop", "cfg_aliases", @@ -6039,6 +7586,12 @@ version = "0.8.27" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6fd8403733700263c6eb89f192880191f1b83e332f7a20371ddcf421c4a337c7" +[[package]] +name = "xmlwriter" +version = "0.1.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ec7a2a501ed189703dba8b08142f057e887dfc4b2cc4db2d343ac6376ba3e0b9" + [[package]] name = "yoke" version = "0.8.0" diff --git a/Cargo.toml b/Cargo.toml index a379f8e..fd849cf 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -30,10 +30,13 @@ zip = { version = "5", default-features = false, features = ["deflate"] } flate2 = { version = "1.1" } tar = { version = "0.4" } chrono = { version = "0.4", features = ["serde"] } -octocrab = { version = "0.45.0", default-features = false } +octocrab = { version = "0.45.0", default-features = false, features = ["stream"] } octocrab-wasm = { path = "crates/octocrab-wasm" } egui_inbox = { version = "0.9.0", features = ["async", "tokio"] } futures = "0.3" +re_ui = "0.26.0-alpha.1+dev" +getrandom = { version = "0.3", features = ["wasm_js"] } +anyhow = "1.0.99" # native: [target.'cfg(not(target_arch = "wasm32"))'.dependencies] @@ -65,6 +68,9 @@ egui = { git = "https://github.com/emilk/egui", branch = "lucas/experiments/kitd eframe = { git = "https://github.com/emilk/egui", branch = "lucas/experiments/kitdiff" } egui_extras = { git = "https://github.com/emilk/egui", branch = "lucas/experiments/kitdiff" } +re_ui = { git = "https://github.com/rerun-io/rerun", branch = "main" } +egui_commonmark = { git = "https://github.com/rerun-io/egui_commonmark.git", branch = "lucas/update-egui-main" } + # If you fork https://github.com/emilk/egui you can test with: # egui = { path = "../egui/crates/egui" } # eframe = { path = "../egui/crates/eframe" } diff --git a/src/app.rs b/src/app.rs index f83c189..85ebb1c 100644 --- a/src/app.rs +++ b/src/app.rs @@ -1,10 +1,12 @@ -use crate::diff_image_loader::{DiffLoader, DiffOptions}; +use crate::diff_image_loader::{DiffImageLoader, DiffOptions}; use crate::github_auth::{AuthState, LoggedInState}; #[cfg(target_arch = "wasm32")] use crate::github_auth::{GitHubAuth, github_artifact_api_url, parse_github_artifact_url}; use crate::github_pr::{GithubPr, parse_github_pr_url}; +use crate::settings::Settings; use crate::snapshot::{FileReference, Snapshot}; -use crate::{DiffSource, PathOrBlob}; +use crate::state::{AppState, PageRef, SystemCommand}; +use crate::{DiffSource, PathOrBlob, home, viewer}; use eframe::egui::panel::Side; use eframe::egui::{ Align, Context, Image, ImageSource, Modifiers, RichText, ScrollArea, SizeHint, Slider, @@ -12,630 +14,180 @@ use eframe::egui::{ }; use eframe::{Frame, Storage, egui}; use egui_extras::install_image_loaders; +use egui_inbox::UiInbox; use std::sync::{Arc, mpsc}; -#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] -enum ImageMode { - Pixel, - Fit, -} - -#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)] -struct Settings { - new_opacity: f32, - diff_opacity: f32, - mode: ImageMode, - texture_magnification: TextureFilter, - use_original_diff: bool, - options: DiffOptions, - #[cfg(target_arch = "wasm32")] - auth: AuthState, -} - -impl Settings { - fn auth(&self) -> Option<&LoggedInState> { - #[cfg(target_arch = "wasm32")] - { - self.auth.logged_in.as_ref() - } - #[cfg(not(target_arch = "wasm32"))] - { - None - } - } -} - -impl Default for Settings { - fn default() -> Self { - Self { - new_opacity: 0.5, - diff_opacity: 0.25, - mode: ImageMode::Fit, - texture_magnification: TextureFilter::Nearest, - use_original_diff: true, - options: DiffOptions::default(), - #[cfg(target_arch = "wasm32")] - auth: Default::default(), - } - } -} - pub struct App { - diff_loader: Arc, - snapshots: Vec, - index: usize, - receiver: mpsc::Receiver, - sender: mpsc::Sender, - is_loading: bool, - filter: String, - drag_and_drop_enabled: bool, - #[cfg(target_arch = "wasm32")] - github_auth: GitHubAuth, - #[cfg(target_arch = "wasm32")] - github_url_input: String, - github_pr_url_input: String, - github_pr: Option, - settings: Settings, + diff_loader: Arc, + state: AppState, + inbox: UiInbox, } impl App { pub fn new(cc: &eframe::CreationContext, source: Option) -> Self { + re_ui::apply_style_and_install_loaders(&cc.egui_ctx); + let settings: Settings = cc .storage .and_then(|s| eframe::get_value(s, eframe::APP_KEY)) .unwrap_or_default(); + let state = AppState::new(settings); + install_image_loaders(&cc.egui_ctx); - let diff_loader = Arc::new(DiffLoader::default()); + let diff_loader = Arc::new(DiffImageLoader::default()); cc.egui_ctx.add_image_loader(diff_loader.clone()); - let (sender, receiver) = mpsc::channel(); let ctx = cc.egui_ctx.clone(); - #[cfg(target_arch = "wasm32")] - let github_auth = GitHubAuth::new(settings.auth.clone()); - - let mut github_pr = None; + // if let Some(source) = source { + // match source { + // // TODO: This kinda sucks, maybe sources should just have an UI? + // DiffSource::Pr(pr) => { + // if let Ok((user, repo, pr_number)) = parse_github_pr_url(&pr) { + // let auth_token = settings.auth().map(|auth| auth.provider_token.clone()); + // github_pr = Some(GithubPr::new( + // user, + // repo, + // pr_number, + // ctx.clone(), + // auth_token, + // )); + // } else { + // eprintln!("Invalid GitHub PR URL"); + // } + // } + // source => { + // source.load(sender.clone(), ctx, settings.auth()); + // } + // } + // } + + let inbox = UiInbox::new(); if let Some(source) = source { - match source { - // TODO: This kinda sucks, maybe sources should just have an UI? - DiffSource::Pr(pr) => { - if let Ok((user, repo, pr_number)) = parse_github_pr_url(&pr) { - let auth_token = settings.auth().map(|auth| auth.provider_token.clone()); - github_pr = Some(GithubPr::new( - user, - repo, - pr_number, - ctx.clone(), - auth_token, - )); - } else { - eprintln!("Invalid GitHub PR URL"); - } - } - source => { - source.load(sender.clone(), ctx, settings.auth()); - } - } + inbox.sender().send(SystemCommand::Open(source)).ok(); } Self { diff_loader, - snapshots: Vec::new(), - receiver: receiver, - sender: sender, - is_loading: true, - index: 0, - filter: String::new(), - drag_and_drop_enabled: true, - #[cfg(target_arch = "wasm32")] - github_auth, - #[cfg(target_arch = "wasm32")] - github_url_input: String::new(), - github_pr_url_input: String::new(), - github_pr, - settings, + state, + inbox, } } } impl eframe::App for App { fn save(&mut self, storage: &mut dyn Storage) { - #[cfg(target_arch = "wasm32")] - { - self.settings.auth = self.github_auth.get_auth_state().clone(); - } - eframe::set_value(storage, eframe::APP_KEY, &self.settings); + eframe::set_value(storage, eframe::APP_KEY, &self.state.persist()); } fn update(&mut self, ctx: &Context, _frame: &mut Frame) { - // Update GitHub authentication - #[cfg(target_arch = "wasm32")] - self.github_auth.update(ctx); - // Handle incoming snapshots from background discovery - { - let receiver = &self.receiver; - let mut new_snapshots = Vec::new(); - while let Ok(snapshot) = receiver.try_recv() { - if let FileReference::Source(ImageSource::Bytes { bytes, uri }) = &snapshot.old { - ctx.include_bytes(uri.clone(), bytes.clone()) - } - if let FileReference::Source(ImageSource::Bytes { bytes, uri }) = &snapshot.new { - ctx.include_bytes(uri.clone(), bytes.clone()) - } - new_snapshots.push(snapshot); - } - - if !new_snapshots.is_empty() { - self.snapshots.extend(new_snapshots); - self.snapshots.sort_by_key(|s| s.path.clone()); - } - - // Check if the channel is disconnected (discovery finished) - if receiver.try_recv().is_err() && self.is_loading { - // Try one more time to ensure we didn't miss any - if matches!(receiver.try_recv(), Err(mpsc::TryRecvError::Disconnected)) { - self.is_loading = false; - } - } - } - - for file in &ctx.input(|i| i.raw.dropped_files.clone()) { - let data = file - .bytes - .clone() - .map(|b| PathOrBlob::Blob(b.into())) - .or(file.path.as_ref().map(|p| PathOrBlob::Path(p.clone()))); - - if let Some(data) = data { - let source = if file.name.ends_with(".tar.gz") || file.name.ends_with(".tgz") { - Some(DiffSource::TarGz(data)) - } else if file.name.ends_with(".zip") { - Some(DiffSource::Zip(data)) - } else { - None - }; - - if let Some(source) = source { - // Clear existing snapshots for new file - self.snapshots.clear(); - self.index = 0; - self.is_loading = true; - - source.load(self.sender.clone(), ctx.clone(), self.settings.auth()); - } - } - - // if let Some(path) = &file.path { - // if let Some(name) = path.file_name().and_then(|n| n.to_str()) { - // if name.ends_with(".tar.gz") || name.ends_with(".tgz") { - // // For native, read from file system - // #[cfg(not(target_arch = "wasm32"))] - // if let Ok(data) = std::fs::read(path) { - // if let Some(sender) = &self.sender { - // // Clear existing snapshots for new file - // self.snapshots.clear(); - // self.index = 0; - // self.is_loading = true; - // - // if let Err(e) = - // extract_and_discover_tar_gz(data, sender.clone(), ctx.clone()) - // { - // eprintln!("Failed to extract tar.gz: {:?}", e); - // } - // } - // } - // } - // } - // } - // - // // For wasm, use the bytes directly if available - // #[cfg(target_arch = "wasm32")] - // if let Some(bytes) = &file.bytes { - // let name = &file.name; - // if name.ends_with(".tar.gz") || name.ends_with(".tgz") { - // if let Some(sender) = &self.sender { - // // Clear existing snapshots for new file - // self.snapshots.clear(); - // self.index = 0; - // self.is_loading = true; - // - // if let Err(e) = - // extract_and_discover_tar_gz(bytes.to_vec(), sender.clone(), ctx.clone()) - // { - // eprintln!("Failed to extract tar.gz: {:?}", e); - // panic!("{e:?}") - // } - // } - // } - // } - } - - let filtered = self - .snapshots - .iter() - .enumerate() - .filter(|(_, snapshot)| { - self.filter.is_empty() - || snapshot - .path - .to_str() - .map(|p| p.contains(&self.filter)) - .unwrap_or(false) - }) - .collect::>(); - let current_filtered_index = filtered.iter().position(|(i, _)| *i == self.index); - if current_filtered_index.is_none() && !filtered.is_empty() { - // Current index is filtered out, jump to first filtered - self.index = filtered[0].0; - } - let current_filtered_index = current_filtered_index.unwrap_or(0); - - let mut new_index = None; - if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowDown)) { - // Find next snapshot that matches filter - if current_filtered_index + 1 < filtered.len() { - new_index = Some(filtered[current_filtered_index + 1].0); - } - } - if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowUp)) { - // Find previous snapshot that matches filter - if current_filtered_index > 0 { - new_index = Some(filtered[current_filtered_index - 1].0); - } - } - if let Some(new_index) = new_index { - self.index = new_index; - } - - let (show_old, show_new, show_diff) = ctx.input(|i| { - let show_old = i.key_down(egui::Key::Num1); - let show_new = i.key_down(egui::Key::Num2); - let show_diff = i.key_down(egui::Key::Num3); - (show_old, show_new, show_diff) - }); - let show_all = !show_old && !show_new && !show_diff; - - egui::SidePanel::new(Side::Left, "files").show(ctx, |ui| { - ui.style_mut().wrap_mode = Some(egui::TextWrapMode::Truncate); - - TextEdit::singleline(&mut self.filter) - .hint_text("Filter") - .show(ui); - - ScrollArea::vertical().show(ui, |ui| { - ui.set_width(ui.available_width()); - - let mut current_prefix = None; - for (i, snapshot) in &filtered { - let prefix = snapshot.path.parent().and_then(|p| p.to_str()); - if prefix != current_prefix { - if let Some(prefix) = prefix { - ui.label(prefix); - } - current_prefix = prefix; - } - - ui.indent(&snapshot.path, |ui| { - let response = ui.selectable_label( - *i == self.index, - snapshot.path.file_name().unwrap().to_str().unwrap(), - ); - - if Some(*i) == new_index { - response.scroll_to_me(Some(Align::Center)) - } - - if response.clicked() { - self.index = *i; - } - }); - } - }); + self.state.update(ctx); + self.inbox.read(ctx).for_each(|cmd| { + self.state.handle(ctx, cmd); }); - egui::SidePanel::right("options").show(ctx, |ui| { - ui.set_width(ui.available_width()); - - let settings = &mut self.settings; - - ui.add(Slider::new(&mut settings.new_opacity, 0.0..=1.0).text("New Opacity")); - ui.add(Slider::new(&mut settings.diff_opacity, 0.0..=1.0).text("Diff Opacity")); - ui.add( - Slider::new(&mut self.index, 0..=self.snapshots.len().saturating_sub(1)) - .text("Snapshot Index"), - ); - - ui.horizontal_wrapped(|ui| { - ui.label("Size:"); - ui.selectable_value(&mut settings.mode, ImageMode::Pixel, "1:1"); - ui.selectable_value(&mut settings.mode, ImageMode::Fit, "Fit"); - }); - - ui.horizontal_wrapped(|ui| { - ui.label("Filtering:"); - ui.selectable_value( - &mut settings.texture_magnification, - TextureFilter::Nearest, - "Nearest", - ); - ui.selectable_value( - &mut settings.texture_magnification, - TextureFilter::Linear, - "Linear", - ); - }); - - ui.group(|ui| { - ui.heading("Diff Options"); - ui.checkbox( - &mut settings.use_original_diff, - "Use original diff if available", - ); - - ui.add( - Slider::new(&mut settings.options.threshold, 0.01..=1000.0) - .logarithmic(true) - .text("Diff Threshold"), - ); - ui.checkbox(&mut settings.options.detect_aa_pixels, "Detect AA Pixels"); - }); - - // GitHub Authentication Section (WASM only) - #[cfg(target_arch = "wasm32")] - ui.group(|ui| { - ui.heading("GitHub Integration"); - - if self.github_auth.is_authenticated() { - if let Some(username) = self.github_auth.get_username() { - ui.label(format!("✅ Signed in as {}", username)); - } else { - ui.label("✅ Signed in"); - } - - if ui.button("Sign Out").clicked() { - self.github_auth.logout(); - } - } else { - ui.label("❌ Not signed in"); - - ui.separator(); - ui.heading("🔐 GitHub Authentication"); - ui.label("Sign in with GitHub to access private repositories and artifacts"); - - if ui.button("🚀 Sign in with GitHub").clicked() { - self.github_auth.login_github(); - } - - ui.separator(); - ui.label("💡 This uses Supabase for secure OAuth authentication"); - ui.label("Your GitHub token is safely managed and never exposed"); - } - - ui.separator(); - - ui.label("GitHub Artifact URL:"); - ui.text_edit_singleline(&mut self.github_url_input); - - if ui.button("Download Artifact").clicked() && !self.github_url_input.is_empty() { - if let Some((owner, repo, artifact_id)) = - parse_github_artifact_url(&self.github_url_input) - { - let api_url = github_artifact_api_url(&owner, &repo, &artifact_id); - let token = self.github_auth.get_token().map(|t| t.to_string()); - - let source = DiffSource::Zip(PathOrBlob::Url(api_url, token)); - - // Clear existing snapshots - self.snapshots.clear(); - self.index = 0; - self.is_loading = true; - - source.load(self.sender.clone(), ctx.clone(), self.settings.auth()); - } else { - // Show error for invalid URL - eprintln!("Invalid GitHub artifact URL"); - } - } - - if !self.github_url_input.is_empty() - && parse_github_artifact_url(&self.github_url_input).is_none() - { - ui.colored_label(ui.visuals().error_fg_color, "Invalid GitHub artifact URL"); - } - - ui.label("Expected format:"); - ui.monospace("github.com/owner/repo/actions/runs/12345/artifacts/67890"); - }); - - // GitHub PR Section - ui.group(|ui| { - ui.heading("GitHub PR Integration"); - - ui.label("GitHub PR URL:"); - ui.text_edit_singleline(&mut self.github_pr_url_input); - - ui.horizontal(|ui| { - if ui.button("Load PR").clicked() && !self.github_pr_url_input.is_empty() { - if let Ok((user, repo, pr_number)) = - parse_github_pr_url(&self.github_pr_url_input) - { - let auth_token = - self.settings.auth().map(|auth| auth.provider_token.clone()); - self.github_pr = Some(GithubPr::new( - user, - repo, - pr_number, - ctx.clone(), - auth_token, - )); - } else { - eprintln!("Invalid GitHub PR URL"); - } - } - - if ui.button("Compare Branches Directly").clicked() - && !self.github_pr_url_input.is_empty() - { - let source = DiffSource::Pr(self.github_pr_url_input.clone()); - - // Clear existing snapshots - self.snapshots.clear(); - self.index = 0; - self.is_loading = true; - - source.load(self.sender.clone(), ctx.clone(), self.settings.auth()); - } - }); - - if !self.github_pr_url_input.is_empty() - && parse_github_pr_url(&self.github_pr_url_input).is_err() - { - ui.colored_label(ui.visuals().error_fg_color, "Invalid GitHub PR URL"); + { + let state_ref = self + .state + .reference(ctx, &self.diff_loader, self.inbox.sender()); + match &state_ref.page { + PageRef::Home => { + home::home_view(ctx, &state_ref); } - - ui.label("Expected format:"); - ui.monospace("https://github.com/owner/repo/pull/123"); - - // Show PR details and artifacts if available - if let Some(pr) = &mut self.github_pr { - ui.separator(); - if let Some(selected_source) = pr.ui(ui) { - // Clear existing snapshots - self.snapshots.clear(); - self.index = 0; - self.is_loading = true; - - selected_source.load( - self.sender.clone(), - ctx.clone(), - self.settings.auth(), - ); - } + PageRef::DiffViewer(diff) => { + viewer::viewer_ui(ctx, &diff.with_app(&state_ref)); } - }); - - // Show loading status - if self.is_loading { - ui.label(format!( - "Loading... {} snapshots found", - self.snapshots.len() - )); - } else { - ui.label(format!("{} snapshots total", self.snapshots.len())); } - }); - - egui::CentralPanel::default().show(ctx, |ui| { - ui.label( - "Use 1/2/3 to only show old / new / diff at 100% opacity. Arrow keys to navigate.", - ); - - if self.drag_and_drop_enabled && self.snapshots.is_empty() && !self.is_loading { - ui.separator(); - ui.vertical_centered(|ui| { - ui.add_space(50.0); - ui.heading("Drop a .tar.gz, .tgz, or .zip file here"); - ui.label("The file should contain PNG snapshot files"); - ui.add_space(20.0); - }); - } - - if let Some(snapshot) = self.snapshots.get(self.index) { - let diff_uri = - snapshot.diff_uri(self.settings.use_original_diff, self.settings.options); - - if let Some(info) = self.diff_loader.diff_info(&diff_uri) { - if info.diff == 0 { - ui.strong("All differences below threshold!"); - } else { - ui.label( - RichText::new(format!("Diff pixels: {}", info.diff)) - .color(ui.visuals().warn_fg_color), - ); - } - } else { - ui.label("No diff info yet..."); - } - - // ui.label(format!("old: {}", snapshot.old_uri())); - // ui.label(format!("new: {}", snapshot.new_uri())); - // ui.label(format!("diff: {}", diff_uri)); - - let rect = ui.available_rect_before_wrap(); - - let ppp = ui.pixels_per_point(); - let mut any_loading = false; - let mut make_image = |uri: String| { - let mut img = Image::new(uri).texture_options(TextureOptions { - magnification: self.settings.texture_magnification, - ..TextureOptions::default() - }); - if self.settings.mode == ImageMode::Pixel { - img = img.fit_to_original_size(1.0 / ppp); - } - any_loading |= img - .load_for_size(ctx, rect.size()) - .is_ok_and(|poll| poll.is_pending()); - img - }; - - if show_all || show_old { - ui.place(rect, make_image(snapshot.old_uri())); - } - - if show_all || show_new { - if show_all { - ui.set_opacity(self.settings.new_opacity); - } - ui.place(rect, make_image(snapshot.new_uri())); - } - - if show_all || show_diff { - if show_all { - ui.set_opacity(self.settings.diff_opacity); - } - ui.place(rect, make_image(diff_uri)); - } - - ui.set_opacity(1.0); + } - // Preload surrounding snapshots once our image is loaded - if !any_loading { - for i in -10..=10 { - if let Some(surrounding_snapshot) = - self.snapshots.get((self.index as isize + i) as usize) - { - ui.ctx() - .try_load_image( - &surrounding_snapshot.old_uri(), - SizeHint::default(), - ) - .ok(); - ui.ctx() - .try_load_image( - &surrounding_snapshot.new_uri(), - SizeHint::default(), - ) - .ok(); - ui.ctx() - .try_load_image( - &surrounding_snapshot.diff_uri( - self.settings.use_original_diff, - self.settings.options, - ), - SizeHint::default(), - ) - .ok(); - } - } - } - } else if self.is_loading { - ui.label("Searching for snapshots..."); - } else { - ui.label("No snapshots found."); - } - }); + // for file in &ctx.input(|i| i.raw.dropped_files.clone()) { + // let data = file + // .bytes + // .clone() + // .map(|b| PathOrBlob::Blob(b.into())) + // .or(file.path.as_ref().map(|p| PathOrBlob::Path(p.clone()))); + // + // if let Some(data) = data { + // let source = if file.name.ends_with(".tar.gz") || file.name.ends_with(".tgz") { + // Some(DiffSource::TarGz(data)) + // } else if file.name.ends_with(".zip") { + // Some(DiffSource::Zip(data)) + // } else { + // None + // }; + // + // if let Some(source) = source { + // // Clear existing snapshots for new file + // self.snapshots.clear(); + // self.index = 0; + // self.is_loading = true; + // + // source.load(self.sender.clone(), ctx.clone(), self.settings.auth()); + // } + // } + // + // // if let Some(path) = &file.path { + // // if let Some(name) = path.file_name().and_then(|n| n.to_str()) { + // // if name.ends_with(".tar.gz") || name.ends_with(".tgz") { + // // // For native, read from file system + // // #[cfg(not(target_arch = "wasm32"))] + // // if let Ok(data) = std::fs::read(path) { + // // if let Some(sender) = &self.sender { + // // // Clear existing snapshots for new file + // // self.snapshots.clear(); + // // self.index = 0; + // // self.is_loading = true; + // // + // // if let Err(e) = + // // extract_and_discover_tar_gz(data, sender.clone(), ctx.clone()) + // // { + // // eprintln!("Failed to extract tar.gz: {:?}", e); + // // } + // // } + // // } + // // } + // // } + // // } + // // + // // // For wasm, use the bytes directly if available + // // #[cfg(target_arch = "wasm32")] + // // if let Some(bytes) = &file.bytes { + // // let name = &file.name; + // // if name.ends_with(".tar.gz") || name.ends_with(".tgz") { + // // if let Some(sender) = &self.sender { + // // // Clear existing snapshots for new file + // // self.snapshots.clear(); + // // self.index = 0; + // // self.is_loading = true; + // // + // // if let Err(e) = + // // extract_and_discover_tar_gz(bytes.to_vec(), sender.clone(), ctx.clone()) + // // { + // // eprintln!("Failed to extract tar.gz: {:?}", e); + // // panic!("{e:?}") + // // } + // // } + // // } + // // } + // } + + // let mut new_index = None; + // if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowDown)) { + // // Find next snapshot that matches filter + // if current_filtered_index + 1 < filtered.len() { + // new_index = Some(filtered[current_filtered_index + 1].0); + // } + // } + // if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowUp)) { + // // Find previous snapshot that matches filter + // if current_filtered_index > 0 { + // new_index = Some(filtered[current_filtered_index - 1].0); + // } + // } + // if let Some(new_index) = new_index { + // self.index = new_index; + // } } } diff --git a/src/cli.rs b/src/cli.rs index 9914cb6..1f96946 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -31,57 +31,55 @@ impl Commands { Commands::Git => DiffSource::Git, Commands::Pr { url } => { // Check if the PR URL is actually a GitHub artifact URL - if let Some((owner, repo, artifact_id)) = parse_github_artifact_url(url) { - DiffSource::GHArtifact { - owner, - repo, - artifact_id, - } + if let Some((repo, artifact_id)) = parse_github_artifact_url(url) { + DiffSource::GHArtifact { repo, artifact_id } } else { DiffSource::Pr(url.clone()) } } Commands::Zip { source } => { - // Check if it's a GitHub artifact URL first - if let Some((owner, repo, artifact_id)) = parse_github_artifact_url(source) { - DiffSource::GHArtifact { - owner, - repo, - artifact_id, - } - } else if source.starts_with("http://") || source.starts_with("https://") { - #[cfg(target_arch = "wasm32")] - { - if source.ends_with(".tar.gz") || source.ends_with(".tgz") { - DiffSource::TarGz(kitdiff::PathOrBlob::Url(source.clone(), None)) - } else { - DiffSource::Zip(kitdiff::PathOrBlob::Url(source.clone(), None)) - } - } - #[cfg(not(target_arch = "wasm32"))] - { - panic!( - "URL sources not supported on native platforms. Use 'gh-artifact' command for GitHub artifacts or download and provide a local file path." - ); - } - } else { - if source.ends_with(".tar.gz") || source.ends_with(".tgz") { - DiffSource::TarGz(kitdiff::PathOrBlob::Path(source.clone().into())) - } else { - DiffSource::Zip(kitdiff::PathOrBlob::Path(source.clone().into())) - } - } + // // Check if it's a GitHub artifact URL first + // if let Some((repo, artifact_id)) = parse_github_artifact_url(source) { + // DiffSource::GHArtifact { + // owner, + // repo, + // artifact_id, + // } + // } else if source.starts_with("http://") || source.starts_with("https://") { + // #[cfg(target_arch = "wasm32")] + // { + // if source.ends_with(".tar.gz") || source.ends_with(".tgz") { + // DiffSource::TarGz(kitdiff::PathOrBlob::Url(source.clone(), None)) + // } else { + // DiffSource::Zip(kitdiff::PathOrBlob::Url(source.clone(), None)) + // } + // } + // #[cfg(not(target_arch = "wasm32"))] + // { + // panic!( + // "URL sources not supported on native platforms. Use 'gh-artifact' command for GitHub artifacts or download and provide a local file path." + // ); + // } + // } else { + // if source.ends_with(".tar.gz") || source.ends_with(".tgz") { + // DiffSource::TarGz(kitdiff::PathOrBlob::Path(source.clone().into())) + // } else { + // DiffSource::Zip(kitdiff::PathOrBlob::Path(source.clone().into())) + // } + // } + todo!() } Commands::GhArtifact { url } => { - if let Some((owner, repo, artifact_id)) = parse_github_artifact_url(url) { - DiffSource::GHArtifact { - owner, - repo, - artifact_id, - } - } else { - panic!("Invalid GitHub artifact URL: {}", url); - } + // if let Some((owner, repo, artifact_id)) = parse_github_artifact_url(url) { + // DiffSource::GHArtifact { + // owner, + // repo, + // artifact_id, + // } + // } else { + // panic!("Invalid GitHub artifact URL: {}", url); + // } + todo!() } } } diff --git a/src/diff_image_loader.rs b/src/diff_image_loader.rs index 07a8423..14f542b 100644 --- a/src/diff_image_loader.rs +++ b/src/diff_image_loader.rs @@ -7,7 +7,7 @@ use std::sync::Arc; use std::task::Poll; #[derive(Default)] -pub struct DiffLoader { +pub struct DiffImageLoader { image_loader: Arc, diffs: Arc, LoadError>>>>, } @@ -18,7 +18,7 @@ pub struct DiffInfo { pub diff: i32, } -#[derive(Debug, Clone, Copy, serde::Serialize, serde::Deserialize)] +#[derive(Debug, Clone, Copy, PartialEq, serde::Serialize, serde::Deserialize)] pub struct DiffOptions { pub threshold: f32, pub detect_aa_pixels: bool, @@ -51,7 +51,7 @@ impl DiffUri { } } -impl DiffLoader { +impl DiffImageLoader { pub fn new(ctx: &Context) -> Self { let image_loader = ctx .loaders() @@ -79,7 +79,7 @@ impl DiffLoader { } } -impl ImageLoader for DiffLoader { +impl ImageLoader for DiffImageLoader { fn id(&self) -> &str { "DiffLoader" } diff --git a/src/github_auth.rs b/src/github_auth.rs index eaeca76..ff498c0 100644 --- a/src/github_auth.rs +++ b/src/github_auth.rs @@ -3,13 +3,18 @@ use ehttp; use serde_json; use std::fmt; use std::sync::mpsc; +use crate::github_model::GithubRepoLink; -#[derive(Debug, Clone, Default, serde::Serialize, serde::Deserialize)] +pub enum GithubAuthCommand { + +} + +#[derive(Debug, Clone, Default, PartialEq, serde::Serialize, serde::Deserialize)] pub struct AuthState { pub logged_in: Option, } -#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)] +#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct LoggedInState { pub access_token: String, pub provider_token: String, // GitHub OAuth token @@ -73,7 +78,7 @@ fn get_current_timestamp() -> u64 { } // URL parsing utilities -pub fn parse_github_artifact_url(url: &str) -> Option<(String, String, String)> { +pub fn parse_github_artifact_url(url: &str) -> Option<(GithubRepoLink, String)> { // Expected format: github.com/owner/repo/actions/runs/12345/artifacts/67890 let url = url .trim_start_matches("https://") @@ -87,9 +92,10 @@ pub fn parse_github_artifact_url(url: &str) -> Option<(String, String, String)> && parts[6] == "artifacts" && parts.len() >= 8 { + let owner = parts[1].to_string(); + let repo = parts[2].to_string(); Some(( - parts[1].to_string(), // owner - parts[2].to_string(), // repo + GithubRepoLink { owner, repo }, parts[7].to_string(), // artifact_id )) } else { diff --git a/src/github_model.rs b/src/github_model.rs new file mode 100644 index 0000000..edb6bd9 --- /dev/null +++ b/src/github_model.rs @@ -0,0 +1,40 @@ +use std::fmt::Display; +use std::str::FromStr; + +pub type PrNumber = u64; + +#[derive(Debug, Clone)] +pub struct GithubRepoLink { + pub owner: String, + pub repo: String, +} + +#[derive(Debug, Clone)] +pub struct GithubPrLink { + pub repo: GithubRepoLink, + pub pr_number: PrNumber, +} + +impl GithubPrLink { + pub fn short_name(&self) -> String { + format!("{}/{}#{}", self.repo.owner, self.repo.repo, self.pr_number) + } +} + +impl FromStr for GithubPrLink { + type Err = String; + + fn from_str(s: &str) -> Result { + todo!() + } +} + +impl Display for GithubPrLink { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + write!( + f, + "{}/{}/pull/{}", + self.repo.owner, self.repo.repo, self.pr_number + ) + } +} diff --git a/src/github_pr.rs b/src/github_pr.rs index bfd2a42..4ed9f27 100644 --- a/src/github_pr.rs +++ b/src/github_pr.rs @@ -7,9 +7,12 @@ use futures::{StreamExt, TryStreamExt}; use octocrab::{AuthState, Error, Octocrab}; use std::collections::HashMap; use std::future::ready; +use std::pin::pin; use std::sync::mpsc; use std::task::Poll; // Import octocrab models +use crate::github_model::{GithubPrLink, PrNumber}; +use crate::octokit::RepoClient; use octocrab::models::{ pulls::PullRequest, repos::RepoCommit, @@ -72,22 +75,14 @@ pub struct GithubArtifact { } pub struct GithubPr { - pub user: String, - pub repo: String, - pub pr_number: u32, + link: GithubPrLink, pub auth_token: Option, inbox: UiInbox>, pub data: Poll>, } impl GithubPr { - pub fn new( - user: String, - repo: String, - pr_number: u32, - ctx: Context, - auth_token: Option, - ) -> Self { + pub fn new(link: GithubPrLink, auth_token: Option) -> Self { let mut client = octocrab_wasm::builder() .build() .expect("Failed to build Octocrab client"); @@ -101,20 +96,15 @@ impl GithubPr { let mut inbox = UiInbox::new(); { - let client = client.clone(); - let user = user.clone(); - let repo = repo.clone(); - let pr_number = pr_number; + let client = RepoClient::new(client, link.repo.clone()); inbox.spawn(|tx| async move { - let details = get_all_pr_artifacts(&client, &user, &repo, pr_number as u64).await; + let details = get_all_pr_artifacts(&client, link.pr_number).await; let _ = tx.send(details); }); } Self { - user: user.clone(), - repo: repo.clone(), - pr_number, + link, auth_token: auth_token.clone(), inbox, data: Poll::Pending, @@ -130,7 +120,7 @@ impl GithubPr { let mut selected_source = None; ui.group(|ui| { - ui.heading(format!("GitHub PR #{}", self.pr_number)); + ui.heading(format!("GitHub PR #{}", self.link.pr_number)); match &self.data { Poll::Ready(Ok(data)) => { @@ -167,8 +157,7 @@ impl GithubPr { for artifact in artifacts { if ui.button(&artifact.name).clicked() { selected_source = Some(DiffSource::GHArtifact { - owner: self.user.clone(), - repo: self.repo.clone(), + repo: self.link.repo.clone(), artifact_id: artifact.id.to_string(), }); } @@ -193,44 +182,34 @@ impl GithubPr { } async fn get_pr_runs_by_commit( - octocrab: &Octocrab, - owner: &str, - repo: &str, - pr_number: u64, + repo: &RepoClient, + pr_number: PrNumber, ) -> octocrab::Result>> { // First, get the PR to find the head branch - let pr = octocrab.pulls(owner, repo).get(pr_number).await?; + let pr = repo.pulls().get(pr_number).await?; // Get the branch name from the PR let branch_name = &pr.head.ref_field; // List all workflow runs for this branch let mut runs_by_commit: HashMap> = HashMap::new(); - let mut page = 1u32; - - loop { - let runs = octocrab - .workflows(owner, repo) - .list_all_runs() - .branch(branch_name) - .page(page) - .per_page(100) - .send() - .await?; - - // Group runs by commit SHA - for run in runs.items { - runs_by_commit - .entry(run.head_sha.clone()) - .or_insert_with(Vec::new) - .push(run); - } - // Check if there are more pages - if runs.next.is_none() { - break; - } - page += 1; + let page = repo + .workflows() + .list_all_runs() + .branch(branch_name) + .per_page(100) + .send() + .await? + .into_stream(&repo); + + let mut page = pin!(page); + + while let Some(run) = page.next().await.transpose()? { + runs_by_commit + .entry(run.head_sha.clone()) + .or_insert_with(Vec::new) + .push(run); } Ok(runs_by_commit) @@ -238,20 +217,14 @@ async fn get_pr_runs_by_commit( // Get all commits for a PR to get a complete picture async fn get_pr_commits_with_runs( - octocrab: &Octocrab, - owner: &str, - repo: &str, - pr_number: u64, + repo: &RepoClient, + pr: PrNumber, ) -> octocrab::Result)>> { // Get all commits in the PR - let commits = octocrab - .pulls(owner, repo) - .pr_commits(pr_number) - .send() - .await?; + let commits = repo.pulls().pr_commits(pr).send().await?; // Get all runs grouped by commit - let runs_by_commit = get_pr_runs_by_commit(octocrab, owner, repo, pr_number).await?; + let runs_by_commit = get_pr_runs_by_commit(repo, pr).await?; Ok(commits .items @@ -272,19 +245,16 @@ struct PrWithArtifacts { } async fn get_all_pr_artifacts( - octocrab: &Octocrab, - owner: &str, - repo: &str, - pr_number: u64, + repo: &RepoClient, + pr: PrNumber, ) -> octocrab::Result { - let commits_with_runs = get_pr_commits_with_runs(octocrab, owner, repo, pr_number).await?; + let commits_with_runs = get_pr_commits_with_runs(repo, pr).await?; let mut artifacts_by_commit = Vec::new(); for (commit, runs) in commits_with_runs { let artifacts = FuturesUnordered::from_iter(runs.into_iter().map(|run| async move { - octocrab - .actions() - .list_workflow_run_artifacts(owner, repo, run.id.into()) + repo.actions() + .list_workflow_run_artifacts(&repo.repo().owner, &repo.repo().repo, run.id) .send() .await })) @@ -300,7 +270,7 @@ async fn get_all_pr_artifacts( artifacts_by_commit.push((commit, artifacts)); } - let pr = octocrab.pulls(owner, repo).get(pr_number).await?; + let pr = repo.pulls().get(pr).await?; Ok(PrWithArtifacts { pr, diff --git a/src/home.rs b/src/home.rs new file mode 100644 index 0000000..02191cf --- /dev/null +++ b/src/home.rs @@ -0,0 +1,9 @@ +use crate::state::AppStateRef; +use eframe::egui::{CentralPanel, Context, Ui}; + +pub fn home_view(ctx: &Context, app: &AppStateRef<'_>) { + CentralPanel::default().show(ctx, |ui| { + ui.heading("Kitdiff"); + ui.label("Drag in a file to start"); + }); +} diff --git a/src/lib.rs b/src/lib.rs index b35d0d3..7ca35d4 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -1,9 +1,11 @@ use crate::github_auth::{AuthState, LoggedInState}; +use crate::loaders::SnapshotLoader; use crate::snapshot::Snapshot; use eframe::egui::Context; use eframe::egui::load::Bytes; use std::any::Any; use std::sync::mpsc::Sender; +use crate::github_model::GithubRepoLink; pub mod app; pub mod diff_image_loader; @@ -12,7 +14,13 @@ pub mod github_pr; pub mod loaders; #[cfg(not(target_arch = "wasm32"))] pub mod native_loaders; +mod settings; pub mod snapshot; +mod state; +mod github_model; +mod octokit; +mod viewer; +mod home; #[derive(Debug, Clone)] pub enum DiffSource { @@ -20,176 +28,174 @@ pub enum DiffSource { Files, #[cfg(not(target_arch = "wasm32"))] Git, - Pr(String), // Store the PR URL - Zip(PathOrBlob), // Store the zip source (URL or file path) - TarGz(PathOrBlob), // Tar.gz files loaded via drag and drop + Pr(String), + Zip(PathOrBlob), + TarGz(PathOrBlob), GHArtifact { - owner: String, - repo: String, + repo: GithubRepoLink, artifact_id: String, - }, // GitHub artifact + }, } impl DiffSource { pub fn load( self, - tx: Sender, ctx: Context, auth: Option<&LoggedInState>, - ) -> Option { + ) -> SnapshotLoader { match self { #[cfg(not(target_arch = "wasm32"))] DiffSource::Files => { - native_loaders::file_diff::file_discovery(".", tx, ctx); - None - } - #[cfg(not(target_arch = "wasm32"))] - DiffSource::Git => { - native_loaders::git_loader::git_discovery(tx, ctx) - .expect("Failed to run git discovery"); - None - } - DiffSource::Pr(url) => { - #[cfg(not(target_arch = "wasm32"))] - { - native_loaders::git_loader::pr_git_discovery(url, tx, ctx) - .expect("Failed to run PR git discovery"); - } - #[cfg(target_arch = "wasm32")] - { - eprintln!( - "PR git discovery not supported on WASM. Use GitHub artifacts instead." - ); - } - None - } - DiffSource::Zip(data) => { - #[cfg(target_arch = "wasm32")] - { - // For URLs in wasm, spawn async task - if matches!(data, PathOrBlob::Url(_, _)) { - let data_clone = data.clone(); - let tx_clone = tx.clone(); - let ctx_clone = ctx.clone(); - - wasm_bindgen_futures::spawn_local(async move { - if let Some(bytes) = data_clone.load_bytes_async().await { - if let Err(e) = loaders::zip_loader::extract_and_discover_zip( - bytes.to_vec(), - tx_clone, - ctx_clone, - ) { - eprintln!("Failed to run zip discovery: {:?}", e); - } - } - }); - None - } else { - // For blobs, use sync method - loaders::zip_loader::extract_and_discover_zip( - data.load_bytes()?.to_vec(), - tx, - ctx, - ) - .expect("Failed to run zip discovery"); - None - } - } - #[cfg(not(target_arch = "wasm32"))] - { - loaders::zip_loader::extract_and_discover_zip( - data.load_bytes()?.to_vec(), - tx, - ctx, - ) - .expect("Failed to run zip discovery"); - None - } - } - DiffSource::TarGz(data) => { - #[cfg(target_arch = "wasm32")] - { - // For URLs in wasm, spawn async task - if matches!(data, PathOrBlob::Url(_, _)) { - let data_clone = data.clone(); - let tx_clone = tx.clone(); - let ctx_clone = ctx.clone(); - - wasm_bindgen_futures::spawn_local(async move { - if let Some(bytes) = data_clone.load_bytes_async().await { - if let Err(e) = loaders::tar_loader::extract_and_discover_tar_gz( - bytes.to_vec(), - tx_clone, - ctx_clone, - ) { - eprintln!("Failed to run tar.gz discovery: {:?}", e); - } - } - }); - None - } else { - // For blobs, use sync method - loaders::tar_loader::extract_and_discover_tar_gz( - data.load_bytes()?.to_vec(), - tx, - ctx, - ) - .expect("Failed to run tar.gz discovery"); - None - } - } - #[cfg(not(target_arch = "wasm32"))] - { - loaders::tar_loader::extract_and_discover_tar_gz( - data.load_bytes()?.to_vec(), - tx, - ctx, - ) - .expect("Failed to run tar.gz discovery"); - None - } - } - DiffSource::GHArtifact { - owner, - repo, - artifact_id, - } => { - #[cfg(target_arch = "wasm32")] - { - use crate::github_auth::github_artifact_api_url; - - // Create GitHub API URL for artifact - let api_url = github_artifact_api_url(&owner, &repo, &artifact_id); - - // TODO: Get GitHub token from auth state - we'll need to pass this context - // For now, try without token (works for public repos) - let data = PathOrBlob::Url(api_url, auth.map(|l| l.provider_token.clone())); - - // Use async zip loading since it's a URL - let tx_clone = tx.clone(); - let ctx_clone = ctx.clone(); - - wasm_bindgen_futures::spawn_local(async move { - if let Some(bytes) = data.load_bytes_async().await { - if let Err(e) = loaders::zip_loader::extract_and_discover_zip( - bytes.to_vec(), - tx_clone, - ctx_clone, - ) { - eprintln!("Failed to run GitHub artifact zip discovery: {:?}", e); - } - } - }); - None - } - #[cfg(not(target_arch = "wasm32"))] - { - eprintln!( - "GitHub artifact loading not supported on native platforms yet. Please download the artifact manually and use the zip command instead." - ); - None - } + Box::new(native_loaders::file_loader::FileLoader::new(".")) } + _ => todo!() + // #[cfg(not(target_arch = "wasm32"))] + // DiffSource::Git => { + // native_loaders::git_loader::git_discovery(tx, ctx) + // .expect("Failed to run git discovery"); + // None + // } + // DiffSource::Pr(url) => { + // #[cfg(not(target_arch = "wasm32"))] + // { + // native_loaders::git_loader::pr_git_discovery(url, tx, ctx) + // .expect("Failed to run PR git discovery"); + // } + // #[cfg(target_arch = "wasm32")] + // { + // eprintln!( + // "PR git discovery not supported on WASM. Use GitHub artifacts instead." + // ); + // } + // None + // } + // DiffSource::Zip(data) => { + // #[cfg(target_arch = "wasm32")] + // { + // // For URLs in wasm, spawn async task + // if matches!(data, PathOrBlob::Url(_, _)) { + // let data_clone = data.clone(); + // let tx_clone = tx.clone(); + // let ctx_clone = ctx.clone(); + // + // wasm_bindgen_futures::spawn_local(async move { + // if let Some(bytes) = data_clone.load_bytes_async().await { + // if let Err(e) = loaders::zip_loader::extract_and_discover_zip( + // bytes.to_vec(), + // tx_clone, + // ctx_clone, + // ) { + // eprintln!("Failed to run zip discovery: {:?}", e); + // } + // } + // }); + // None + // } else { + // // For blobs, use sync method + // loaders::zip_loader::extract_and_discover_zip( + // data.load_bytes()?.to_vec(), + // tx, + // ctx, + // ) + // .expect("Failed to run zip discovery"); + // None + // } + // } + // #[cfg(not(target_arch = "wasm32"))] + // { + // loaders::zip_loader::extract_and_discover_zip( + // data.load_bytes()?.to_vec(), + // tx, + // ctx, + // ) + // .expect("Failed to run zip discovery"); + // None + // } + // } + // DiffSource::TarGz(data) => { + // #[cfg(target_arch = "wasm32")] + // { + // // For URLs in wasm, spawn async task + // if matches!(data, PathOrBlob::Url(_, _)) { + // let data_clone = data.clone(); + // let tx_clone = tx.clone(); + // let ctx_clone = ctx.clone(); + // + // wasm_bindgen_futures::spawn_local(async move { + // if let Some(bytes) = data_clone.load_bytes_async().await { + // if let Err(e) = loaders::tar_loader::extract_and_discover_tar_gz( + // bytes.to_vec(), + // tx_clone, + // ctx_clone, + // ) { + // eprintln!("Failed to run tar.gz discovery: {:?}", e); + // } + // } + // }); + // None + // } else { + // // For blobs, use sync method + // loaders::tar_loader::extract_and_discover_tar_gz( + // data.load_bytes()?.to_vec(), + // tx, + // ctx, + // ) + // .expect("Failed to run tar.gz discovery"); + // None + // } + // } + // #[cfg(not(target_arch = "wasm32"))] + // { + // loaders::tar_loader::extract_and_discover_tar_gz( + // data.load_bytes()?.to_vec(), + // tx, + // ctx, + // ) + // .expect("Failed to run tar.gz discovery"); + // None + // } + // } + // DiffSource::GHArtifact { + // owner, + // repo, + // artifact_id, + // } => { + // #[cfg(target_arch = "wasm32")] + // { + // use crate::github_auth::github_artifact_api_url; + // + // // Create GitHub API URL for artifact + // let api_url = github_artifact_api_url(&owner, &repo, &artifact_id); + // + // // TODO: Get GitHub token from auth state - we'll need to pass this context + // // For now, try without token (works for public repos) + // let data = PathOrBlob::Url(api_url, auth.map(|l| l.provider_token.clone())); + // + // // Use async zip loading since it's a URL + // let tx_clone = tx.clone(); + // let ctx_clone = ctx.clone(); + // + // wasm_bindgen_futures::spawn_local(async move { + // if let Some(bytes) = data.load_bytes_async().await { + // if let Err(e) = loaders::zip_loader::extract_and_discover_zip( + // bytes.to_vec(), + // tx_clone, + // ctx_clone, + // ) { + // eprintln!("Failed to run GitHub artifact zip discovery: {:?}", e); + // } + // } + // }); + // None + // } + // #[cfg(not(target_arch = "wasm32"))] + // { + // eprintln!( + // "GitHub artifact loading not supported on native platforms yet. Please download the artifact manually and use the zip command instead." + // ); + // None + // } + // } } } } diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index 93ee47c..d0202a5 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -1,2 +1,19 @@ +use crate::snapshot::Snapshot; +use eframe::egui; +use std::task::Poll; + pub mod tar_loader; pub mod zip_loader; + +pub trait LoadSnapshots { + fn update(&mut self, ctx: &egui::Context); + + fn snapshots(&self) -> &[Snapshot]; + + /// State is separate so that snapshots can be streamed in + fn state(&self) -> Poll>; + + fn extra_ui(&mut self, ui: &mut egui::Ui) {} +} + +pub type SnapshotLoader = Box; \ No newline at end of file diff --git a/src/main.rs b/src/main.rs index eb606d8..cbbb053 100644 --- a/src/main.rs +++ b/src/main.rs @@ -23,58 +23,58 @@ fn main() -> eframe::Result<()> { ) } -#[cfg(target_arch = "wasm32")] -fn parse_url_query_params() -> Option { - use kitdiff::github_auth::parse_github_artifact_url; - use kitdiff::github_pr::parse_github_pr_url; - - if let Some(window) = web_sys::window() { - if let Ok(search) = window.location().search() { - let search = search.strip_prefix('?').unwrap_or(&search); - - // Parse query parameters - for param in search.split('&') { - if let Some((key, value)) = param.split_once('=') { - if key == "url" { - // URL decode the value - let decoded_url = js_sys::decode_uri_component(value).ok()?.as_string()?; - - // Try to parse as GitHub PR URL - if let Ok((_user, _repo, _pr_number)) = parse_github_pr_url(&decoded_url) { - return Some(DiffSource::Pr(decoded_url)); - } - - // Try to parse as GitHub artifact URL - if let Some((owner, repo, artifact_id)) = - parse_github_artifact_url(&decoded_url) - { - return Some(DiffSource::GHArtifact { - owner, - repo, - artifact_id, - }); - } - - // Try to parse as direct zip/tar.gz URL - if decoded_url.ends_with(".zip") { - return Some(DiffSource::Zip(kitdiff::PathOrBlob::Url( - decoded_url, - None, - ))); - } - if decoded_url.ends_with(".tar.gz") || decoded_url.ends_with(".tgz") { - return Some(DiffSource::TarGz(kitdiff::PathOrBlob::Url( - decoded_url, - None, - ))); - } - } - } - } - } - } - None -} +// #[cfg(target_arch = "wasm32")] +// fn parse_url_query_params() -> Option { +// use kitdiff::github_auth::parse_github_artifact_url; +// use kitdiff::github_pr::parse_github_pr_url; +// +// if let Some(window) = web_sys::window() { +// if let Ok(search) = window.location().search() { +// let search = search.strip_prefix('?').unwrap_or(&search); +// +// // Parse query parameters +// for param in search.split('&') { +// if let Some((key, value)) = param.split_once('=') { +// if key == "url" { +// // URL decode the value +// let decoded_url = js_sys::decode_uri_component(value).ok()?.as_string()?; +// +// // Try to parse as GitHub PR URL +// if let Ok((_user, _repo, _pr_number)) = parse_github_pr_url(&decoded_url) { +// return Some(DiffSource::Pr(decoded_url)); +// } +// +// // Try to parse as GitHub artifact URL +// if let Some((owner, repo, artifact_id)) = +// parse_github_artifact_url(&decoded_url) +// { +// return Some(DiffSource::GHArtifact { +// owner, +// repo, +// artifact_id, +// }); +// } +// +// // Try to parse as direct zip/tar.gz URL +// if decoded_url.ends_with(".zip") { +// return Some(DiffSource::Zip(kitdiff::PathOrBlob::Url( +// decoded_url, +// None, +// ))); +// } +// if decoded_url.ends_with(".tar.gz") || decoded_url.ends_with(".tgz") { +// return Some(DiffSource::TarGz(kitdiff::PathOrBlob::Url( +// decoded_url, +// None, +// ))); +// } +// } +// } +// } +// } +// } +// None +// } #[cfg(target_arch = "wasm32")] fn main() { @@ -90,8 +90,9 @@ fn main() { .dyn_into::() .unwrap(); - // Parse URL query parameters for DiffSource - let diff_source = parse_url_query_params(); + // // Parse URL query parameters for DiffSource + // let diff_source = parse_url_query_params(); + let diff_source = None; let start_result = eframe::WebRunner::new() .start( diff --git a/src/native_loaders/file_diff.rs b/src/native_loaders/file_diff.rs deleted file mode 100644 index 28a6ae7..0000000 --- a/src/native_loaders/file_diff.rs +++ /dev/null @@ -1,78 +0,0 @@ -use crate::snapshot::{FileReference, Snapshot}; -use eframe::egui::Context; -use ignore::WalkBuilder; -use ignore::types::TypesBuilder; -use std::path::{Path, PathBuf}; -use std::sync::mpsc; - -pub fn file_discovery(base_path: impl Into, sender: mpsc::Sender, ctx: Context) { - let path = base_path.into(); - - std::thread::spawn(move || { - // Create type matcher for .png files - let mut types_builder = TypesBuilder::new(); - types_builder.add("png", "*.png").unwrap(); - types_builder.select("png"); - let types = types_builder.build().unwrap(); - - // Build sequential walker for .png files only to maintain order - for result in WalkBuilder::new(&path).types(types).build() { - if let Ok(entry) = result { - if entry.file_type().map_or(false, |ft| ft.is_file()) { - if let Some(snapshot) = try_create_snapshot(entry.path(), &path) { - if sender.send(snapshot).is_ok() { - ctx.request_repaint(); - } - } - } - } - } - }); -} - -fn try_create_snapshot(png_path: &Path, base_path: &Path) -> Option { - let file_name = png_path.file_name()?.to_str()?; - - // Skip files that are already variants (.old.png, .new.png, .diff.png) - if file_name.ends_with(".old.png") - || file_name.ends_with(".new.png") - || file_name.ends_with(".diff.png") - { - return None; - } - - // Get base path without .png extension - let file_base_path = png_path.with_extension(""); - let old_path = file_base_path.with_extension("old.png"); - let new_path = file_base_path.with_extension("new.png"); - let diff_path = file_base_path.with_extension("diff.png"); - - // Only create snapshot if diff exists - if !diff_path.exists() { - return None; - } - - // Create relative path from the base directory - let relative_path = png_path.strip_prefix(base_path).unwrap_or(png_path); - - if old_path.exists() { - // old.png exists, use original as new and old.png as old - Some(Snapshot { - path: relative_path.to_path_buf(), - old: FileReference::Path(old_path), - new: FileReference::Path(png_path.to_path_buf()), - diff: Some(diff_path), - }) - } else if new_path.exists() { - // new.png exists, use original as old and new.png as new - Some(Snapshot { - path: relative_path.to_path_buf(), - old: FileReference::Path(png_path.to_path_buf()), - new: FileReference::Path(new_path), - diff: Some(diff_path), - }) - } else { - // No old or new variant, skip this snapshot - None - } -} diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs new file mode 100644 index 0000000..01a3e0e --- /dev/null +++ b/src/native_loaders/file_loader.rs @@ -0,0 +1,128 @@ +use crate::loaders::LoadSnapshots; +use crate::snapshot::{FileReference, Snapshot}; +use anyhow::Error; +use eframe::egui::Context; +use egui_inbox::UiInbox; +use ignore::WalkBuilder; +use ignore::types::TypesBuilder; +use std::path::{Path, PathBuf}; +use std::sync::mpsc; +use std::task::Poll; + +pub struct FileLoader { + base_path: PathBuf, + inbox: UiInbox>, + loading: bool, + snapshots: Vec, +} + +impl FileLoader { + pub fn new(base_path: impl Into) -> Self { + let base_path = base_path.into(); + + let (sender, inbox) = UiInbox::channel(); + + { + let base_path = base_path.clone(); + std::thread::spawn(move || { + let mut types_builder = TypesBuilder::new(); + types_builder.add("png", "*.png").unwrap(); + types_builder.select("png"); + let types = types_builder.build().unwrap(); + + for result in WalkBuilder::new(&base_path).types(types).build() { + if let Ok(entry) = result { + if entry.file_type().map_or(false, |ft| ft.is_file()) { + if let Some(snapshot) = try_create_snapshot(entry.path(), &base_path) { + if sender.send(Some(snapshot)).is_err() { + break; + }; + } + } + } + } + + // Signal completion + sender.send(None).ok(); + }); + } + + Self { + base_path, + inbox, + snapshots: Vec::new(), + loading: true, + } + } +} + +impl LoadSnapshots for FileLoader { + fn update(&mut self, ctx: &Context) { + for snapshot in self.inbox.read(ctx) { + if let Some(snapshot) = snapshot { + self.snapshots.push(snapshot); + } else { + self.loading = false; + } + } + } + + fn snapshots(&self) -> &[Snapshot] { + &self.snapshots + } + + fn state(&self) -> Poll> { + if self.loading { + Poll::Pending + } else { + Poll::Ready(Ok(())) + } + } +} + +fn try_create_snapshot(png_path: &Path, base_path: &Path) -> Option { + let file_name = png_path.file_name()?.to_str()?; + + // Skip files that are already variants (.old.png, .new.png, .diff.png) + if file_name.ends_with(".old.png") + || file_name.ends_with(".new.png") + || file_name.ends_with(".diff.png") + { + return None; + } + + // Get base path without .png extension + let file_base_path = png_path.with_extension(""); + let old_path = file_base_path.with_extension("old.png"); + let new_path = file_base_path.with_extension("new.png"); + let diff_path = file_base_path.with_extension("diff.png"); + + // Only create snapshot if diff exists + if !diff_path.exists() { + return None; + } + + // Create relative path from the base directory + let relative_path = png_path.strip_prefix(base_path).unwrap_or(png_path); + + if old_path.exists() { + // old.png exists, use original as new and old.png as old + Some(Snapshot { + path: relative_path.to_path_buf(), + old: FileReference::Path(old_path), + new: FileReference::Path(png_path.to_path_buf()), + diff: Some(diff_path), + }) + } else if new_path.exists() { + // new.png exists, use original as old and new.png as new + Some(Snapshot { + path: relative_path.to_path_buf(), + old: FileReference::Path(png_path.to_path_buf()), + new: FileReference::Path(new_path), + diff: Some(diff_path), + }) + } else { + // No old or new variant, skip this snapshot + None + } +} diff --git a/src/native_loaders/mod.rs b/src/native_loaders/mod.rs index 80888cd..ee89611 100644 --- a/src/native_loaders/mod.rs +++ b/src/native_loaders/mod.rs @@ -1,2 +1,2 @@ -pub mod file_diff; +pub mod file_loader; pub mod git_loader; diff --git a/src/octokit.rs b/src/octokit.rs new file mode 100644 index 0000000..b740ad9 --- /dev/null +++ b/src/octokit.rs @@ -0,0 +1,50 @@ +use crate::github_model::{GithubPrLink, GithubRepoLink}; +use std::ops::Deref; +use octocrab::Page; + +pub struct RepoClient { + client: octocrab::Octocrab, + link: GithubRepoLink, +} + +impl Deref for RepoClient { + type Target = octocrab::Octocrab; + + fn deref(&self) -> &Self::Target { + &self.client + } +} + +impl RepoClient { + pub fn new(client: octocrab::Octocrab, link: GithubRepoLink) -> Self { + Self { client, link } + } + + pub fn repo(&self) -> &GithubRepoLink { + &self.link + } + + pub fn issues(&self) -> octocrab::issues::IssueHandler<'_> { + self.client.issues(&self.link.owner, &self.link.repo) + } + + pub fn commits(&self) -> octocrab::commits::CommitHandler<'_> { + self.client.commits(&self.link.owner, &self.link.repo) + } + + pub fn pulls(&self) -> octocrab::pulls::PullRequestHandler<'_> { + self.client.pulls(&self.link.owner, &self.link.repo) + } + + pub fn workflows(&self) -> octocrab::workflows::WorkflowsHandler<'_> { + self.client.workflows(&self.link.owner, &self.link.repo) + } + + pub fn repos(&self) -> octocrab::repos::RepoHandler<'_> { + self.client.repos(&self.link.owner, &self.link.repo) + } + + pub fn checks(&self) -> octocrab::checks::ChecksHandler<'_> { + self.client.checks(&self.link.owner, &self.link.repo) + } +} diff --git a/src/settings.rs b/src/settings.rs new file mode 100644 index 0000000..bce0d2c --- /dev/null +++ b/src/settings.rs @@ -0,0 +1,47 @@ +use crate::diff_image_loader::DiffOptions; +use crate::github_auth::{AuthState, LoggedInState}; +use eframe::egui::TextureFilter; + +#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] +pub enum ImageMode { + Pixel, + Fit, +} + +#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] +pub struct Settings { + pub new_opacity: f32, + pub diff_opacity: f32, + pub mode: ImageMode, + pub texture_magnification: TextureFilter, + pub use_original_diff: bool, + pub options: DiffOptions, + pub auth: AuthState, +} + +impl Settings { + fn auth(&self) -> Option<&LoggedInState> { + #[cfg(target_arch = "wasm32")] + { + self.auth.logged_in.as_ref() + } + #[cfg(not(target_arch = "wasm32"))] + { + None + } + } +} + +impl Default for Settings { + fn default() -> Self { + Self { + new_opacity: 0.5, + diff_opacity: 0.25, + mode: ImageMode::Fit, + texture_magnification: TextureFilter::Nearest, + use_original_diff: true, + options: DiffOptions::default(), + auth: Default::default(), + } + } +} diff --git a/src/snapshot.rs b/src/snapshot.rs index 7a9d81e..e96e73f 100644 --- a/src/snapshot.rs +++ b/src/snapshot.rs @@ -1,6 +1,7 @@ use crate::diff_image_loader; use crate::diff_image_loader::DiffOptions; -use eframe::egui::ImageSource; +use crate::state::{AppStateRef, PageRef, ViewerStateRef}; +use eframe::egui::{Color32, ImageSource}; use std::path::PathBuf; #[derive(Debug, Clone)] @@ -31,6 +32,13 @@ impl FileReference { } impl Snapshot { + pub fn file_name(&self) -> std::borrow::Cow<'_, str> { + self.path + .file_name() + .map(|n| n.to_string_lossy()) + .unwrap_or_else(|| self.path.as_os_str().to_string_lossy()) + } + pub fn old_uri(&self) -> String { self.old.to_uri() } @@ -58,4 +66,58 @@ impl Snapshot { .to_uri() }) } + + fn make_image( + &self, + state: &AppStateRef<'_>, + uri: String, + opacity: f32, + show_all: bool, + ) -> eframe::egui::Image { + eframe::egui::Image::new(uri) + .texture_options(eframe::egui::TextureOptions { + magnification: state.settings.texture_magnification, + ..eframe::egui::TextureOptions::default() + }) + .fit_to_original_size(match state.settings.mode { + crate::settings::ImageMode::Pixel => 1.0 / state.egui_ctx.pixels_per_point(), + crate::settings::ImageMode::Fit => 0.0, + }) + .tint(Color32::from_white_alpha(if show_all { + u8::MAX + } else { + (255.0 * opacity) as u8 + })) + } + + pub fn old_image(&self, state: &AppStateRef<'_>) -> Option { + let PageRef::DiffViewer(vs) = &state.page else { + return None; + }; + let show_all = vs.view_filter.all(); + let show_old = vs.view_filter.show_old; + (show_all || show_old).then(|| self.make_image(state, self.old_uri(), 1.0, show_all)) + } + + pub fn new_image(&self, state: &AppStateRef<'_>) -> Option { + let PageRef::DiffViewer(vs) = &state.page else { + return None; + }; + let show_all = vs.view_filter.all(); + let show_new = vs.view_filter.show_new; + (show_all || show_new) + .then(|| self.make_image(state, self.new_uri(), state.settings.new_opacity, show_all)) + } + + pub fn diff_image(&self, state: &AppStateRef<'_>) -> Option { + let PageRef::DiffViewer(vs) = &state.page else { + return None; + }; + let show_all = vs.view_filter.all(); + let show_diff = vs.view_filter.show_diff; + (show_all || show_diff).then(|| { + let diff_uri = self.diff_uri(state.settings.use_original_diff, state.settings.options); + self.make_image(state, diff_uri, state.settings.diff_opacity, show_all) + }) + } } diff --git a/src/state.rs b/src/state.rs new file mode 100644 index 0000000..c472d3d --- /dev/null +++ b/src/state.rs @@ -0,0 +1,267 @@ +use crate::diff_image_loader::DiffImageLoader; +use crate::github_auth::{GitHubAuth, GithubAuthCommand}; +use crate::github_model::GithubPrLink; +use crate::github_pr::GithubPr; +use crate::loaders::SnapshotLoader; +use crate::settings::Settings; +use crate::snapshot::Snapshot; +use eframe::egui; +use eframe::egui::Context; +use egui_inbox::UiInboxSender; +use std::ops::Deref; + +pub struct AppState { + pub github_auth: GitHubAuth, + pub github_pr: Option, + pub settings: Settings, + pub page: Page, +} + +pub enum Page { + Home, + DiffViewer(ViewerState), +} + +pub struct ViewerState { + pub loader: SnapshotLoader, + pub index: usize, + + /// If true, this item will scroll into view. + pub index_just_selected: bool, + pub filter: String, + pub view_filter: ViewFilter, +} + +impl ViewerState { + fn filtered_snapshots(&self) -> Vec> { + let filter = self.filter.to_lowercase(); + self.loader + .snapshots() + .iter() + .enumerate() + .filter(|(_, s)| { + if filter.is_empty() { + true + } else { + s.path.to_string_lossy().to_lowercase().contains(&filter) + } + }) + .collect() + } +} + +/// If any is true, only show those, but at full opacity +/// +/// If all are false, show all at their set opacities +#[derive(Default, Copy, Clone)] +pub struct ViewFilter { + pub show_old: bool, + pub show_new: bool, + pub show_diff: bool, +} + +impl ViewFilter { + pub fn all(&self) -> bool { + !self.show_old && !self.show_new && !self.show_diff + } +} + +impl AppState { + pub fn new(settings: Settings) -> AppState { + Self { + github_auth: GitHubAuth::new(settings.auth.clone()), + github_pr: None, + settings, + page: Page::Home, + } + } + + pub fn persist(&self) -> Settings { + let mut settings = self.settings.clone(); + settings.auth = self.github_auth.get_auth_state().clone(); + settings + } + + pub fn reference<'a>( + &'a self, + ctx: &'a Context, + diff_image_loader: &'a DiffImageLoader, + tx: UiInboxSender, + ) -> AppStateRef<'a> { + let page = match &self.page { + Page::Home => PageRef::Home, + Page::DiffViewer(viewer) => { + let filtered_snapshots = viewer.filtered_snapshots(); + + let active_filtered_index = filtered_snapshots + .iter() + .position(|(i, _)| *i == viewer.index) + .unwrap_or(0); + + let viewer_ref = ViewerStateRef { + state: viewer, + active_snapshot: filtered_snapshots + .get(active_filtered_index) + .map(|(_, s)| *s), + filtered_snapshots, + active_filtered_index, + }; + PageRef::DiffViewer(viewer_ref) + } + }; + + AppStateRef { + state: self, + page, + diff_image_loader, + egui_ctx: ctx, + tx, + } + } +} + +pub struct AppStateRef<'a> { + pub egui_ctx: &'a Context, + pub state: &'a AppState, + pub page: PageRef<'a>, + pub diff_image_loader: &'a DiffImageLoader, + pub tx: UiInboxSender, +} + +impl AppStateRef<'_> { + pub fn send(&self, command: impl Into) { + self.tx.send(command.into()).ok(); + } +} + +impl Deref for AppStateRef<'_> { + type Target = AppState; + + fn deref(&self) -> &Self::Target { + self.state + } +} + +pub enum PageRef<'a> { + Home, + DiffViewer(ViewerStateRef<'a>), +} + +pub type FilteredSnapshot<'a> = (usize, &'a Snapshot); + +pub struct ViewerStateRef<'a> { + pub state: &'a ViewerState, + pub filtered_snapshots: Vec>, + pub active_filtered_index: usize, + pub active_snapshot: Option<&'a Snapshot>, +} + +impl Deref for ViewerStateRef<'_> { + type Target = ViewerState; + + fn deref(&self) -> &Self::Target { + self.state + } +} + +impl<'a> ViewerStateRef<'a> { + pub fn with_app(&'a self, app: &'a AppStateRef<'a>) -> ViewerAppStateRef<'a> { + ViewerAppStateRef { app, viewer: self } + } +} + +pub struct ViewerAppStateRef<'a> { + pub app: &'a AppStateRef<'a>, + pub viewer: &'a ViewerStateRef<'a>, +} + +impl<'a> Deref for ViewerAppStateRef<'a> { + type Target = ViewerStateRef<'a>; + + fn deref(&self) -> &Self::Target { + self.viewer + } +} + +pub enum SystemCommand { + Open(crate::DiffSource), + GithubAuth(GithubAuthCommand), + LoadPrDetails(GithubPrLink), + UpdateSettings(Settings), + ViewerCommand(ViewerSystemCommand), +} + +pub enum ViewerSystemCommand { + SetFilter(String), + SelectSnapshot(usize), +} + +impl From for SystemCommand { + fn from(value: ViewerSystemCommand) -> Self { + SystemCommand::ViewerCommand(value) + } +} + +impl AppState { + pub fn handle(&mut self, ctx: &Context, command: SystemCommand) { + match command { + SystemCommand::Open(source) => { + let loader = source.load( + ctx.clone(), + self.github_auth.get_auth_state().logged_in.as_ref(), + ); + self.page = Page::DiffViewer(ViewerState { + filter: String::new(), + index: 0, + index_just_selected: true, + loader, + view_filter: ViewFilter::default(), + }); + } + SystemCommand::GithubAuth(auth) => { + todo!() + } + SystemCommand::LoadPrDetails(url) => { + self.github_pr = Some(GithubPr::new( + url, + self.github_auth.get_token().map(ToString::to_string), + )); + } + SystemCommand::UpdateSettings(settings) => { + self.settings = settings; + } + + SystemCommand::ViewerCommand(command) => { + if let Page::DiffViewer(viewer) = &mut self.page { + viewer.handle(ctx, command); + } else { + eprintln!("Received ViewerCommand but not in DiffViewer page"); // TODO: Better logging + } + } + } + } + + pub fn update(&mut self, ctx: &Context) { + if let Page::DiffViewer(viewer) = &mut self.page { + viewer.loader.update(ctx); + viewer.index_just_selected = false; + } + } +} + +impl ViewerState { + pub fn handle(&mut self, ctx: &Context, command: ViewerSystemCommand) { + match command { + ViewerSystemCommand::SetFilter(filter) => { + self.filter = filter; + self.index_just_selected = true; + } + ViewerSystemCommand::SelectSnapshot(index) => { + if index < self.loader.snapshots().len() { + self.index = index; + self.index_just_selected = true; + } + } + } + } +} diff --git a/src/viewer/diff_view.rs b/src/viewer/diff_view.rs new file mode 100644 index 0000000..01e006e --- /dev/null +++ b/src/viewer/diff_view.rs @@ -0,0 +1,88 @@ +use crate::settings::ImageMode; +use crate::state::{AppStateRef, PageRef, ViewFilter, ViewerAppStateRef, ViewerStateRef}; +use eframe::egui::{Image, RichText, SizeHint, TextureOptions, Ui}; + +pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { + ui.label("Use 1/2/3 to only show old / new / diff at 100% opacity. Arrow keys to navigate."); + + if let Some(snapshot) = state.active_snapshot { + let diff_uri = snapshot.diff_uri( + state.app.settings.use_original_diff, + state.app.settings.options, + ); + + if let Some(info) = state.app.diff_image_loader.diff_info(&diff_uri) { + if info.diff == 0 { + ui.strong("All differences below threshold!"); + } else { + ui.label( + RichText::new(format!("Diff pixels: {}", info.diff)) + .color(ui.visuals().warn_fg_color), + ); + } + } else { + ui.label("No diff info yet..."); + } + + let rect = ui.available_rect_before_wrap(); + + let old = snapshot.old_image(state.app); + let new = snapshot.new_image(state.app); + let diff = snapshot.diff_image(state.app); + + let is_loading = |maybe_image: &Option| { + maybe_image + .as_ref() + .map(|img| { + img.load_for_size(ui.ctx(), rect.size()) + .is_ok_and(|poll| poll.is_pending()) + }) + .unwrap_or(false) + }; + + let any_loading = is_loading(&old) || is_loading(&new) || is_loading(&diff); + + if let Some(old) = old { + ui.place(rect, old); + } + + if let Some(new) = new { + ui.place(rect, new); + } + + if let Some(diff) = diff { + ui.place(rect, diff); + } + + // Preload surrounding snapshots once our image is loaded + if !any_loading { + for i in -10..=10 { + if let Some((_, surrounding_snapshot)) = state + .filtered_snapshots + .get((state.active_filtered_index as isize + i) as usize) + { + ui.ctx() + .try_load_image(&surrounding_snapshot.old_uri(), SizeHint::default()) + .ok(); + ui.ctx() + .try_load_image(&surrounding_snapshot.new_uri(), SizeHint::default()) + .ok(); + ui.ctx() + .try_load_image( + &surrounding_snapshot.diff_uri( + state.app.settings.use_original_diff, + state.app.settings.options, + ), + SizeHint::default(), + ) + .ok(); + } + } + } + } else if state.loader.state().is_pending() { + // TODO: Display error + ui.label("Searching for snapshots..."); + } else { + ui.label("No snapshots found."); + } +} diff --git a/src/viewer/file_tree.rs b/src/viewer/file_tree.rs new file mode 100644 index 0000000..90833bc --- /dev/null +++ b/src/viewer/file_tree.rs @@ -0,0 +1,66 @@ +use crate::state::{FilteredSnapshot, ViewerAppStateRef, ViewerSystemCommand}; +use eframe::egui; +use eframe::egui::{Id, TextEdit, Ui}; +use re_ui::UiExt; +use re_ui::list_item::{LabelContent, ListItem}; +use std::collections::BTreeMap; + +pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { + ui.style_mut().wrap_mode = Some(egui::TextWrapMode::Truncate); + + let mut filter = state.filter.clone(); + TextEdit::singleline(&mut filter) + .hint_text("Filter") + .show(ui); + + if filter != state.filter { + state.app.send(ViewerSystemCommand::SetFilter(filter)); + } + + ui.list_item_scope("file_tree", |ui| { + let mut tree = BTreeMap::new(); + + for (snapshot_index, snapshot) in &state.filtered_snapshots { + let prefix = snapshot.path.parent().and_then(|p| p.to_str()); + tree.entry(prefix) + .or_insert(vec![]) + .push((*snapshot_index, *snapshot)) + } + + for (prefix, snapshots) in tree { + if let Some(prefix) = prefix { + ui.list_item().show_hierarchical_with_children( + ui, + Id::new(prefix), + true, + LabelContent::new(prefix), + |ui| show_prefix(ui, state, &snapshots), + ); + } else { + show_prefix(ui, state, &snapshots); + } + } + }); +} + +fn show_prefix( + ui: &mut Ui, + state: &ViewerAppStateRef<'_>, + filtered_snapshots: &[FilteredSnapshot<'_>], +) { + for (index, snapshot) in filtered_snapshots { + let selected = *index == state.index; + let content = LabelContent::new(snapshot.file_name()); + let item = ui.list_item().selected(selected); + + let response = item.show_hierarchical(ui, content); + + if response.clicked() { + state.app.send(ViewerSystemCommand::SelectSnapshot(*index)); + } + + if selected && state.index_just_selected { + response.scroll_to_me(Some(eframe::egui::Align::Center)); + } + } +} diff --git a/src/viewer/mod.rs b/src/viewer/mod.rs new file mode 100644 index 0000000..f6ac494 --- /dev/null +++ b/src/viewer/mod.rs @@ -0,0 +1,159 @@ +mod diff_view; +mod file_tree; +mod viewer_options; + +use crate::state::{AppStateRef, ViewerAppStateRef}; +use eframe::egui; +use eframe::egui::panel::Side; +use eframe::egui::{Context, Ui}; + +pub fn viewer_ui(ctx: &Context, state: &ViewerAppStateRef<'_>) { + egui::SidePanel::new(Side::Left, "files").show(ctx, |ui| { + ui.heading("Files"); + file_tree::file_tree(ui, state); + }); + + egui::SidePanel::right("options").show(ctx, |ui| { + ui.set_width(ui.available_width()); + + viewer_options::viewer_options(ui, state); + + // // GitHub Authentication Section (WASM only) + // #[cfg(target_arch = "wasm32")] + // ui.group(|ui| { + // ui.heading("GitHub Integration"); + // + // if self.github_auth.is_authenticated() { + // if let Some(username) = self.github_auth.get_username() { + // ui.label(format!("✅ Signed in as {}", username)); + // } else { + // ui.label("✅ Signed in"); + // } + // + // if ui.button("Sign Out").clicked() { + // self.github_auth.logout(); + // } + // } else { + // ui.label("❌ Not signed in"); + // + // ui.separator(); + // ui.heading("🔐 GitHub Authentication"); + // ui.label("Sign in with GitHub to access private repositories and artifacts"); + // + // if ui.button("🚀 Sign in with GitHub").clicked() { + // self.github_auth.login_github(); + // } + // + // ui.separator(); + // ui.label("💡 This uses Supabase for secure OAuth authentication"); + // ui.label("Your GitHub token is safely managed and never exposed"); + // } + // + // ui.separator(); + // + // ui.label("GitHub Artifact URL:"); + // ui.text_edit_singleline(&mut self.github_url_input); + // + // if ui.button("Download Artifact").clicked() && !self.github_url_input.is_empty() { + // if let Some((owner, repo, artifact_id)) = + // parse_github_artifact_url(&self.github_url_input) + // { + // let api_url = github_artifact_api_url(&owner, &repo, &artifact_id); + // let token = self.github_auth.get_token().map(|t| t.to_string()); + // + // let source = DiffSource::Zip(PathOrBlob::Url(api_url, token)); + // + // // Clear existing snapshots + // self.snapshots.clear(); + // self.index = 0; + // self.is_loading = true; + // + // source.load(self.sender.clone(), ctx.clone(), self.settings.auth()); + // } else { + // // Show error for invalid URL + // eprintln!("Invalid GitHub artifact URL"); + // } + // } + // + // if !self.github_url_input.is_empty() + // && parse_github_artifact_url(&self.github_url_input).is_none() + // { + // ui.colored_label(ui.visuals().error_fg_color, "Invalid GitHub artifact URL"); + // } + // + // ui.label("Expected format:"); + // ui.monospace("github.com/owner/repo/actions/runs/12345/artifacts/67890"); + // }); + // + // // GitHub PR Section + // ui.group(|ui| { + // ui.heading("GitHub PR Integration"); + // + // ui.label("GitHub PR URL:"); + // ui.text_edit_singleline(&mut self.github_pr_url_input); + // + // ui.horizontal(|ui| { + // if ui.button("Load PR").clicked() && !self.github_pr_url_input.is_empty() { + // if let Ok((user, repo, pr_number)) = + // parse_github_pr_url(&self.github_pr_url_input) + // { + // let auth_token = + // self.settings.auth().map(|auth| auth.provider_token.clone()); + // self.github_pr = Some(GithubPr::new( + // user, + // repo, + // pr_number, + // ctx.clone(), + // auth_token, + // )); + // } else { + // eprintln!("Invalid GitHub PR URL"); + // } + // } + // + // if ui.button("Compare Branches Directly").clicked() + // && !self.github_pr_url_input.is_empty() + // { + // let source = DiffSource::Pr(self.github_pr_url_input.clone()); + // + // // Clear existing snapshots + // self.snapshots.clear(); + // self.index = 0; + // self.is_loading = true; + // + // source.load(self.sender.clone(), ctx.clone(), self.settings.auth()); + // } + // }); + // + // if !self.github_pr_url_input.is_empty() + // && parse_github_pr_url(&self.github_pr_url_input).is_err() + // { + // ui.colored_label(ui.visuals().error_fg_color, "Invalid GitHub PR URL"); + // } + // + // ui.label("Expected format:"); + // ui.monospace("https://github.com/owner/repo/pull/123"); + // + // // Show PR details and artifacts if available + // if let Some(pr) = &mut self.github_pr { + // ui.separator(); + // if let Some(selected_source) = pr.ui(ui) { + // // Clear existing snapshots + // self.snapshots.clear(); + // self.index = 0; + // self.is_loading = true; + // + // selected_source.load( + // self.sender.clone(), + // ctx.clone(), + // self.settings.auth(), + // ); + // } + // } + // }); + }); + + egui::CentralPanel::default().show(ctx, |ui| { + diff_view::diff_view(ui, state); + }); +} diff --git a/src/viewer/viewer_options.rs b/src/viewer/viewer_options.rs new file mode 100644 index 0000000..9eaca99 --- /dev/null +++ b/src/viewer/viewer_options.rs @@ -0,0 +1,65 @@ +use crate::settings::ImageMode; +use crate::state::{SystemCommand, ViewerAppStateRef, ViewerSystemCommand}; +use eframe::egui::{Slider, TextureFilter, Ui}; + +pub fn viewer_options(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { + let mut settings = state.app.settings.clone(); + + ui.add(Slider::new(&mut settings.new_opacity, 0.0..=1.0).text("New Opacity")); + ui.add(Slider::new(&mut settings.diff_opacity, 0.0..=1.0).text("Diff Opacity")); + + let mut filtered_index = state.active_filtered_index; + + ui.add( + Slider::new(&mut filtered_index, 0..=state.filtered_snapshots.len()).text("Snapshot Index"), + ); + + if filtered_index != state.active_filtered_index { + if let Some((index, _)) = state.filtered_snapshots.get(filtered_index) { + state.app.send(ViewerSystemCommand::SelectSnapshot(*index)); + } + } + + ui.horizontal_wrapped(|ui| { + ui.label("Size:"); + ui.selectable_value(&mut settings.mode, ImageMode::Pixel, "1:1"); + ui.selectable_value(&mut settings.mode, ImageMode::Fit, "Fit"); + }); + + ui.horizontal_wrapped(|ui| { + ui.label("Filtering:"); + ui.selectable_value( + &mut settings.texture_magnification, + TextureFilter::Nearest, + "Nearest", + ); + ui.selectable_value( + &mut settings.texture_magnification, + TextureFilter::Linear, + "Linear", + ); + }); + + ui.group(|ui| { + ui.heading("Diff Options"); + ui.checkbox( + &mut settings.use_original_diff, + "Use original diff if available", + ); + + ui.add( + Slider::new(&mut settings.options.threshold, 0.01..=1000.0) + .logarithmic(true) + .text("Diff Threshold"), + ); + ui.checkbox(&mut settings.options.detect_aa_pixels, "Detect AA Pixels"); + }); + + if settings != state.app.settings { + state + .app + .tx + .send(SystemCommand::UpdateSettings(settings)) + .ok(); + } +} From ae8df15e315f163c7ddc2ec0d1da4201c62fc32c Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 24 Sep 2025 13:04:44 +0200 Subject: [PATCH 02/25] Add github pr api loader --- src/cli.rs | 6 +- src/github_auth.rs | 18 ++++- src/github_model.rs | 50 +++++++++++- src/github_pr.rs | 6 +- src/lib.rs | 38 ++++----- src/loaders/mod.rs | 1 + src/loaders/pr_loader.rs | 128 ++++++++++++++++++++++++++++++ src/loaders/tar_loader.rs | 20 ++--- src/loaders/zip_loader.rs | 20 ++--- src/main.rs | 7 ++ src/native_loaders/file_loader.rs | 8 +- src/native_loaders/git_loader.rs | 12 +-- src/snapshot.rs | 68 ++++++++++------ src/state.rs | 2 +- src/viewer/diff_view.rs | 33 ++++---- 15 files changed, 317 insertions(+), 100 deletions(-) create mode 100644 src/loaders/pr_loader.rs diff --git a/src/cli.rs b/src/cli.rs index 1f96946..9c8d3a6 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -34,7 +34,11 @@ impl Commands { if let Some((repo, artifact_id)) = parse_github_artifact_url(url) { DiffSource::GHArtifact { repo, artifact_id } } else { - DiffSource::Pr(url.clone()) + if let Ok(parsed_url) = url.parse() { + DiffSource::Pr(parsed_url) + } else { + panic!("Invalid GitHub PR URL: {}", url); + } } } Commands::Zip { source } => { diff --git a/src/github_auth.rs b/src/github_auth.rs index ff498c0..585cb0c 100644 --- a/src/github_auth.rs +++ b/src/github_auth.rs @@ -1,13 +1,11 @@ +use crate::github_model::GithubRepoLink; use eframe::egui; use ehttp; use serde_json; use std::fmt; use std::sync::mpsc; -use crate::github_model::GithubRepoLink; -pub enum GithubAuthCommand { - -} +pub enum GithubAuthCommand {} #[derive(Debug, Clone, Default, PartialEq, serde::Serialize, serde::Deserialize)] pub struct AuthState { @@ -31,6 +29,18 @@ pub struct GitHubAuth { auth_receiver: AuthReceiver, } +impl GitHubAuth { + pub fn client(&self) -> octocrab::Octocrab { + let mut builder = octocrab_wasm::builder(); + + if let Some(state) = &self.state.logged_in { + builder = builder.user_access_token(state.provider_token.clone()); + } + + builder.build().expect("Failed to build Octocrab client") + } +} + #[derive(Debug)] pub enum AuthError { NetworkError(String), diff --git a/src/github_model.rs b/src/github_model.rs index edb6bd9..db2a809 100644 --- a/src/github_model.rs +++ b/src/github_model.rs @@ -3,12 +3,40 @@ use std::str::FromStr; pub type PrNumber = u64; +#[derive(Debug)] +pub enum GithubParseErr { + MissingOwner, + MissingRepo, + MissingPullSegment, + MissingPrNumber, + InvalidPrNumber(std::num::ParseIntError), +} + #[derive(Debug, Clone)] pub struct GithubRepoLink { pub owner: String, pub repo: String, } +impl FromStr for GithubRepoLink { + type Err = GithubParseErr; + + fn from_str(s: &str) -> Result { + let s = s.strip_prefix("https://github.com/").unwrap_or(s); + + // Parse strings like "owner/repo" + let mut parts = s.split('/'); + + let owner = parts.next().ok_or(GithubParseErr::MissingOwner)?; + let repo = parts.next().ok_or(GithubParseErr::MissingRepo)?; + + Ok(GithubRepoLink { + owner: owner.to_string(), + repo: repo.to_string(), + }) + } +} + #[derive(Debug, Clone)] pub struct GithubPrLink { pub repo: GithubRepoLink, @@ -22,10 +50,28 @@ impl GithubPrLink { } impl FromStr for GithubPrLink { - type Err = String; + type Err = GithubParseErr; fn from_str(s: &str) -> Result { - todo!() + let s = s.strip_prefix("https://github.com/").unwrap_or(s); + + let mut parts = s.split('/'); + let owner = parts.next().ok_or(GithubParseErr::MissingOwner)?; + let repo = parts.next().ok_or(GithubParseErr::MissingRepo)?; + _ = parts.next().ok_or(GithubParseErr::MissingPullSegment)?; + let number: PrNumber = parts + .next() + .ok_or(GithubParseErr::MissingPrNumber)? + .parse() + .map_err(GithubParseErr::InvalidPrNumber)?; + + Ok(GithubPrLink { + repo: GithubRepoLink { + owner: owner.to_string(), + repo: repo.to_string(), + }, + pr_number: number, + }) } } diff --git a/src/github_pr.rs b/src/github_pr.rs index 4ed9f27..41eab92 100644 --- a/src/github_pr.rs +++ b/src/github_pr.rs @@ -8,6 +8,7 @@ use octocrab::{AuthState, Error, Octocrab}; use std::collections::HashMap; use std::future::ready; use std::pin::pin; +use std::str::FromStr; use std::sync::mpsc; use std::task::Poll; // Import octocrab models @@ -134,7 +135,8 @@ impl GithubPr { if let Some(html_url) = &details.html_url { if ui.button("Compare PR Branches").clicked() { - selected_source = Some(DiffSource::Pr(html_url.to_string())); + selected_source = + Some(DiffSource::Pr(html_url.to_string().parse().unwrap())); } } @@ -202,7 +204,7 @@ async fn get_pr_runs_by_commit( .send() .await? .into_stream(&repo); - + let mut page = pin!(page); while let Some(run) = page.next().await.transpose()? { diff --git a/src/lib.rs b/src/lib.rs index 7ca35d4..56717f6 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -5,7 +5,8 @@ use eframe::egui::Context; use eframe::egui::load::Bytes; use std::any::Any; use std::sync::mpsc::Sender; -use crate::github_model::GithubRepoLink; +use crate::github_model::{GithubPrLink, GithubRepoLink}; +use crate::state::AppState; pub mod app; pub mod diff_image_loader; @@ -28,7 +29,7 @@ pub enum DiffSource { Files, #[cfg(not(target_arch = "wasm32"))] Git, - Pr(String), + Pr(GithubPrLink), Zip(PathOrBlob), TarGz(PathOrBlob), GHArtifact { @@ -41,34 +42,34 @@ impl DiffSource { pub fn load( self, ctx: Context, - auth: Option<&LoggedInState>, + state: &AppState, ) -> SnapshotLoader { match self { #[cfg(not(target_arch = "wasm32"))] DiffSource::Files => { Box::new(native_loaders::file_loader::FileLoader::new(".")) } - _ => todo!() // #[cfg(not(target_arch = "wasm32"))] // DiffSource::Git => { // native_loaders::git_loader::git_discovery(tx, ctx) // .expect("Failed to run git discovery"); // None // } - // DiffSource::Pr(url) => { - // #[cfg(not(target_arch = "wasm32"))] - // { - // native_loaders::git_loader::pr_git_discovery(url, tx, ctx) - // .expect("Failed to run PR git discovery"); - // } - // #[cfg(target_arch = "wasm32")] - // { - // eprintln!( - // "PR git discovery not supported on WASM. Use GitHub artifacts instead." - // ); - // } - // None - // } + DiffSource::Pr(url) => { + // #[cfg(not(target_arch = "wasm32"))] + // { + // native_loaders::git_loader::pr_git_discovery(url, tx, ctx) + // .expect("Failed to run PR git discovery"); + // } + // #[cfg(target_arch = "wasm32")] + // { + // eprintln!( + // "PR git discovery not supported on WASM. Use GitHub artifacts instead." + // ); + // } + // None + Box::new(loaders::pr_loader::PrLoader::new(url, state.github_auth.client())) + } // DiffSource::Zip(data) => { // #[cfg(target_arch = "wasm32")] // { @@ -196,6 +197,7 @@ impl DiffSource { // None // } // } + _ => todo!() } } } diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index d0202a5..2c13f60 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -4,6 +4,7 @@ use std::task::Poll; pub mod tar_loader; pub mod zip_loader; +pub mod pr_loader; pub trait LoadSnapshots { fn update(&mut self, ctx: &egui::Context); diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs new file mode 100644 index 0000000..9626287 --- /dev/null +++ b/src/loaders/pr_loader.rs @@ -0,0 +1,128 @@ +use crate::github_model::{GithubPrLink, GithubRepoLink}; +use crate::loaders::{LoadSnapshots, SnapshotLoader}; +use crate::octokit::RepoClient; +use crate::snapshot::{FileReference, Snapshot}; +use anyhow::Error; +use eframe::egui::Context; +use egui_inbox::{UiInbox, UiInboxSender}; +use futures::StreamExt; +use octocrab::Octocrab; +use octocrab::models::repos::{DiffEntry, DiffEntryStatus}; +use std::ops::Deref; +use std::path::Path; +use std::pin::pin; +use std::task::Poll; + +pub struct PrLoader { + snapshots: Vec, + inbox: UiInbox>, + loading: bool, + link: GithubPrLink, +} + +impl PrLoader { + pub fn new(link: GithubPrLink, client: Octocrab) -> Self { + let mut inbox = UiInbox::new(); + let repo_client = RepoClient::new(client, link.repo.clone()); + + inbox.spawn(|tx| async move { + let result = stream_files(repo_client, link.pr_number, tx).await; + if let Err(e) = result { + eprintln!("Error loading PR files: {}", e); + } + }); + + Self { + snapshots: Vec::new(), + inbox, + loading: true, + link, + } + } +} + +async fn stream_files( + repo_client: RepoClient, + pr_number: u64, + sender: UiInboxSender>, +) -> octocrab::Result<()> { + let pr = repo_client.pulls().get(pr_number).await?; + + let file = repo_client.pulls().list_files(pr_number).await?; + + let stream = file.into_stream(&repo_client); + + let mut stream = pin!(stream); + + while let Some(file) = stream.next().await.transpose()? { + let file: DiffEntry = file; + if file.filename.ends_with(".png") { + let old_url = if file.status != DiffEntryStatus::Added { + let old_file_name = file + .previous_filename + .as_deref() + .unwrap_or(file.filename.deref()); + Some(create_media_url( + repo_client.repo(), + &pr.base.sha, + old_file_name, + )) + } else { + None + }; + + let new_url = if file.status != DiffEntryStatus::Removed { + Some(create_media_url( + repo_client.repo(), + &pr.head.sha, + &file.filename, + )) + } else { + None + }; + + let snapshot = Snapshot { + path: file.filename.clone().into(), + old: old_url.map(|url| FileReference::Source(url.into())), + new: new_url.map(|url| FileReference::Source(url.into())), + diff: None, + }; + dbg!(&snapshot); + sender.send(Some(snapshot)).ok(); + } + } + + sender.send(None).ok(); + + Ok(()) +} + +fn create_media_url(repo: &GithubRepoLink, commit_sha: &str, file_path: &str) -> String { + format!( + "https://media.githubusercontent.com/media/{}/{}/{}/{}", + repo.owner, repo.repo, commit_sha, file_path, + ) +} + +impl LoadSnapshots for PrLoader { + fn update(&mut self, ctx: &Context) { + for snapshot in self.inbox.read(ctx) { + match snapshot { + Some(s) => self.snapshots.push(s), + None => self.loading = false, + } + } + } + + fn snapshots(&self) -> &[Snapshot] { + &self.snapshots + } + + fn state(&self) -> Poll> { + if self.loading { + Poll::Pending + } else { + Poll::Ready(Ok(())) + } + } +} diff --git a/src/loaders/tar_loader.rs b/src/loaders/tar_loader.rs index 2ec3f08..4d1a03a 100644 --- a/src/loaders/tar_loader.rs +++ b/src/loaders/tar_loader.rs @@ -80,13 +80,13 @@ fn run_tar_gz_discovery( // Include bytes in egui context for loading match &snapshot.old { - FileReference::Source(ImageSource::Bytes { uri, bytes }) => { + Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { ctx.include_bytes(uri.clone(), bytes.clone()); } _ => {} } match &snapshot.new { - FileReference::Source(ImageSource::Bytes { uri, bytes }) => { + Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { ctx.include_bytes(uri.clone(), bytes.clone()); } _ => {} @@ -129,14 +129,14 @@ fn try_create_tar_snapshot(png_path: &Path, files: &HashMap>) - let old_data = files.get(&old_path)?; Some(Snapshot { path: png_path.to_path_buf(), - old: FileReference::Source(ImageSource::Bytes { + old: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("tar://{}", old_path.display())), bytes: eframe::egui::load::Bytes::Shared(old_data.clone().into()), - }), - new: FileReference::Source(ImageSource::Bytes { + })), + new: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("tar://{}", png_path.display())), bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - }), + })), diff: None, // We'll handle diff separately if needed }) } else if files.contains_key(&new_path) { @@ -144,14 +144,14 @@ fn try_create_tar_snapshot(png_path: &Path, files: &HashMap>) - let new_data = files.get(&new_path)?; Some(Snapshot { path: png_path.to_path_buf(), - old: FileReference::Source(ImageSource::Bytes { + old: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("tar://{}", png_path.display())), bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - }), - new: FileReference::Source(ImageSource::Bytes { + })), + new: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("tar://{}", new_path.display())), bytes: eframe::egui::load::Bytes::Shared(new_data.clone().into()), - }), + })), diff: None, // We'll handle diff separately if needed }) } else { diff --git a/src/loaders/zip_loader.rs b/src/loaders/zip_loader.rs index 1d97ddf..8330207 100644 --- a/src/loaders/zip_loader.rs +++ b/src/loaders/zip_loader.rs @@ -88,13 +88,13 @@ fn run_zip_discovery( // Include bytes in egui context for loading match &snapshot.old { - FileReference::Source(ImageSource::Bytes { uri, bytes }) => { + Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { ctx.include_bytes(uri.clone(), bytes.clone()); } _ => {} } match &snapshot.new { - FileReference::Source(ImageSource::Bytes { uri, bytes }) => { + Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { ctx.include_bytes(uri.clone(), bytes.clone()); } _ => {} @@ -137,14 +137,14 @@ fn try_create_zip_snapshot(png_path: &Path, files: &HashMap>) - let old_data = files.get(&old_path)?; Some(Snapshot { path: png_path.to_path_buf(), - old: FileReference::Source(ImageSource::Bytes { + old: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("zip://{}", old_path.display())), bytes: eframe::egui::load::Bytes::Shared(old_data.clone().into()), - }), - new: FileReference::Source(ImageSource::Bytes { + })), + new: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("zip://{}", png_path.display())), bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - }), + })), diff: None, // We'll handle diff separately if needed }) } else if files.contains_key(&new_path) { @@ -152,14 +152,14 @@ fn try_create_zip_snapshot(png_path: &Path, files: &HashMap>) - let new_data = files.get(&new_path)?; Some(Snapshot { path: png_path.to_path_buf(), - old: FileReference::Source(ImageSource::Bytes { + old: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("zip://{}", png_path.display())), bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - }), - new: FileReference::Source(ImageSource::Bytes { + })), + new: Some(FileReference::Source(ImageSource::Bytes { uri: Cow::Owned(format!("zip://{}", new_path.display())), bytes: eframe::egui::load::Bytes::Shared(new_data.clone().into()), - }), + })), diff: None, // We'll handle diff separately if needed }) } else { diff --git a/src/main.rs b/src/main.rs index cbbb053..f25b7ee 100644 --- a/src/main.rs +++ b/src/main.rs @@ -8,6 +8,13 @@ use kitdiff::app::App; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { + + let rt = tokio::runtime::Builder::new_multi_thread() + .enable_all() + .build() + .expect("Failed to create Tokio runtime"); + let _guard = rt.enter(); + use clap::Parser; let mode = cli::Cli::parse(); diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 01a3e0e..447d089 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -109,16 +109,16 @@ fn try_create_snapshot(png_path: &Path, base_path: &Path) -> Option { // old.png exists, use original as new and old.png as old Some(Snapshot { path: relative_path.to_path_buf(), - old: FileReference::Path(old_path), - new: FileReference::Path(png_path.to_path_buf()), + old: Some(FileReference::Path(old_path)), + new: Some(FileReference::Path(png_path.to_path_buf())), diff: Some(diff_path), }) } else if new_path.exists() { // new.png exists, use original as old and new.png as new Some(Snapshot { path: relative_path.to_path_buf(), - old: FileReference::Path(png_path.to_path_buf()), - new: FileReference::Path(new_path), + old: Some(FileReference::Path(png_path.to_path_buf())), + new: Some(FileReference::Path(new_path)), diff: Some(diff_path), }) } else { diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index c71fbb2..1860575 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -321,9 +321,9 @@ fn create_git_snapshot( Ok(Some(Snapshot { path: relative_path.to_path_buf(), - old: FileReference::Source(default_image_source), // Default branch version as ImageSource - new: FileReference::Path(current_path.to_path_buf()), // Current working tree version - diff: None, // Always None for git mode + old: Some(FileReference::Source(default_image_source)), // Default branch version as ImageSource + new: Some(FileReference::Path(current_path.to_path_buf())), // Current working tree version + diff: None, // Always None for git mode })) } @@ -433,9 +433,9 @@ fn create_pr_snapshot( Ok(Some(Snapshot { path: relative_path.to_path_buf(), - old: FileReference::Source(base_image_source), // Base branch version - new: FileReference::Source(head_image_source), // Head branch version - diff: None, // Always None for PR mode + old: Some(FileReference::Source(base_image_source)), // Base branch version + new: Some(FileReference::Source(head_image_source)), // Head branch version + diff: None, // Always None for PR mode })) } diff --git a/src/snapshot.rs b/src/snapshot.rs index e96e73f..63a9737 100644 --- a/src/snapshot.rs +++ b/src/snapshot.rs @@ -7,8 +7,10 @@ use std::path::PathBuf; #[derive(Debug, Clone)] pub struct Snapshot { pub path: PathBuf, - pub old: FileReference, - pub new: FileReference, + /// If only old is set, the file was deleted. + pub old: Option, + /// If only new is set, the file was added. + pub new: Option, pub diff: Option, } @@ -39,12 +41,20 @@ impl Snapshot { .unwrap_or_else(|| self.path.as_os_str().to_string_lossy()) } - pub fn old_uri(&self) -> String { - self.old.to_uri() + pub fn added(&self) -> bool { + self.old.is_none() && self.new.is_some() } - pub fn new_uri(&self) -> String { - self.new.to_uri() + pub fn deleted(&self) -> bool { + self.old.is_some() && self.new.is_none() + } + + pub fn old_uri(&self) -> Option { + self.old.as_ref().map(|p| p.to_uri()) + } + + pub fn new_uri(&self) -> Option { + self.new.as_ref().map(|p| p.to_uri()) } pub fn file_diff_uri(&self) -> Option { @@ -53,17 +63,14 @@ impl Snapshot { .map(|p| format!("file://{}", p.display())) } - pub fn diff_uri(&self, use_file_if_available: bool, options: DiffOptions) -> String { + pub fn diff_uri(&self, use_file_if_available: bool, options: DiffOptions) -> Option { use_file_if_available .then(|| self.file_diff_uri()) .flatten() - .unwrap_or_else(|| { - diff_image_loader::DiffUri { - old: self.old_uri(), - new: self.new_uri(), - options, - } - .to_uri() + .or_else(|| { + self.old_uri() + .zip(self.new_uri()) + .map(|(old, new)| diff_image_loader::DiffUri { old, new, options }.to_uri()) }) } @@ -74,20 +81,24 @@ impl Snapshot { opacity: f32, show_all: bool, ) -> eframe::egui::Image { - eframe::egui::Image::new(uri) + let mut image = eframe::egui::Image::new(uri) .texture_options(eframe::egui::TextureOptions { magnification: state.settings.texture_magnification, ..eframe::egui::TextureOptions::default() }) - .fit_to_original_size(match state.settings.mode { - crate::settings::ImageMode::Pixel => 1.0 / state.egui_ctx.pixels_per_point(), - crate::settings::ImageMode::Fit => 0.0, - }) .tint(Color32::from_white_alpha(if show_all { u8::MAX } else { (255.0 * opacity) as u8 - })) + })); + + match state.settings.mode { + crate::settings::ImageMode::Pixel => { + image = image.fit_to_original_size(1.0 / state.egui_ctx.pixels_per_point()); + } + crate::settings::ImageMode::Fit => {} + } + image } pub fn old_image(&self, state: &AppStateRef<'_>) -> Option { @@ -96,7 +107,10 @@ impl Snapshot { }; let show_all = vs.view_filter.all(); let show_old = vs.view_filter.show_old; - (show_all || show_old).then(|| self.make_image(state, self.old_uri(), 1.0, show_all)) + (show_all || show_old) + .then(|| self.old_uri()) + .flatten() + .map(|uri| self.make_image(state, uri, state.settings.new_opacity, show_all)) } pub fn new_image(&self, state: &AppStateRef<'_>) -> Option { @@ -106,7 +120,9 @@ impl Snapshot { let show_all = vs.view_filter.all(); let show_new = vs.view_filter.show_new; (show_all || show_new) - .then(|| self.make_image(state, self.new_uri(), state.settings.new_opacity, show_all)) + .then(|| self.new_uri()) + .flatten() + .map(|new_uri| self.make_image(state, new_uri, state.settings.new_opacity, show_all)) } pub fn diff_image(&self, state: &AppStateRef<'_>) -> Option { @@ -115,9 +131,9 @@ impl Snapshot { }; let show_all = vs.view_filter.all(); let show_diff = vs.view_filter.show_diff; - (show_all || show_diff).then(|| { - let diff_uri = self.diff_uri(state.settings.use_original_diff, state.settings.options); - self.make_image(state, diff_uri, state.settings.diff_opacity, show_all) - }) + (show_all || show_diff) + .then(|| self.diff_uri(state.settings.use_original_diff, state.settings.options)) + .flatten() + .map(|diff_uri| self.make_image(state, diff_uri, state.settings.diff_opacity, show_all)) } } diff --git a/src/state.rs b/src/state.rs index c472d3d..61316af 100644 --- a/src/state.rs +++ b/src/state.rs @@ -208,7 +208,7 @@ impl AppState { SystemCommand::Open(source) => { let loader = source.load( ctx.clone(), - self.github_auth.get_auth_state().logged_in.as_ref(), + &self, ); self.page = Page::DiffViewer(ViewerState { filter: String::new(), diff --git a/src/viewer/diff_view.rs b/src/viewer/diff_view.rs index 01e006e..488ee09 100644 --- a/src/viewer/diff_view.rs +++ b/src/viewer/diff_view.rs @@ -11,7 +11,9 @@ pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { state.app.settings.options, ); - if let Some(info) = state.app.diff_image_loader.diff_info(&diff_uri) { + if let Some(info) = + diff_uri.and_then(|diff_uri| state.app.diff_image_loader.diff_info(&diff_uri)) + { if info.diff == 0 { ui.strong("All differences below threshold!"); } else { @@ -42,6 +44,8 @@ pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { let any_loading = is_loading(&old) || is_loading(&new) || is_loading(&diff); + dbg!(&old, &new); + if let Some(old) = old { ui.place(rect, old); } @@ -61,21 +65,18 @@ pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { .filtered_snapshots .get((state.active_filtered_index as isize + i) as usize) { - ui.ctx() - .try_load_image(&surrounding_snapshot.old_uri(), SizeHint::default()) - .ok(); - ui.ctx() - .try_load_image(&surrounding_snapshot.new_uri(), SizeHint::default()) - .ok(); - ui.ctx() - .try_load_image( - &surrounding_snapshot.diff_uri( - state.app.settings.use_original_diff, - state.app.settings.options, - ), - SizeHint::default(), - ) - .ok(); + if let Some(old_uri) = surrounding_snapshot.old_uri() { + ui.ctx().try_load_image(&old_uri, SizeHint::default()).ok(); + } + if let Some(new_uri) = surrounding_snapshot.new_uri() { + ui.ctx().try_load_image(&new_uri, SizeHint::default()).ok(); + } + if let Some(diff_uri) = surrounding_snapshot.diff_uri( + state.app.settings.use_original_diff, + state.app.settings.options, + ) { + ui.ctx().try_load_image(&diff_uri, SizeHint::default()).ok(); + } } } } From 6a3918537355672f647553d13bc2a88e830d8d0c Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 24 Sep 2025 14:42:04 +0200 Subject: [PATCH 03/25] Auth bar --- README.md | 2 +- src/app.rs | 70 ++++++++++++++++------- src/bar.rs | 29 ++++++++++ src/cli.rs | 8 ++- src/github_auth.rs | 61 +++++++++++++++----- src/lib.rs | 10 ++-- src/main.rs | 106 +++++++++++++++++------------------ src/snapshot.rs | 6 +- src/state.rs | 15 +++-- src/viewer/diff_view.rs | 2 - src/viewer/file_tree.rs | 44 ++++++++------- src/viewer/viewer_options.rs | 15 ++++- 12 files changed, 240 insertions(+), 128 deletions(-) create mode 100644 src/bar.rs diff --git a/README.md b/README.md index d5cf701..d141fef 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# kitdiff, a visual diffing tool +# kitdiff 📸🐱, a visual diffing tool I got frustrated with the experience of reviewing image snapshot changes (from egui_kittest, thus the name) in my ide and on github, so I made something really cool: diff --git a/src/app.rs b/src/app.rs index 85ebb1c..d1f98e6 100644 --- a/src/app.rs +++ b/src/app.rs @@ -5,11 +5,11 @@ use crate::github_auth::{GitHubAuth, github_artifact_api_url, parse_github_artif use crate::github_pr::{GithubPr, parse_github_pr_url}; use crate::settings::Settings; use crate::snapshot::{FileReference, Snapshot}; -use crate::state::{AppState, PageRef, SystemCommand}; -use crate::{DiffSource, PathOrBlob, home, viewer}; +use crate::state::{AppState, AppStateRef, PageRef, SystemCommand, ViewerSystemCommand}; +use crate::{DiffSource, PathOrBlob, home, viewer, bar}; use eframe::egui::panel::Side; use eframe::egui::{ - Align, Context, Image, ImageSource, Modifiers, RichText, ScrollArea, SizeHint, Slider, + Align, Context, Image, ImageSource, Key, Modifiers, RichText, ScrollArea, SizeHint, Slider, TextEdit, TextureFilter, TextureOptions, }; use eframe::{Frame, Storage, egui}; @@ -92,6 +92,9 @@ impl eframe::App for App { let state_ref = self .state .reference(ctx, &self.diff_loader, self.inbox.sender()); + + bar::bar(ctx, &state_ref); + match &state_ref.page { PageRef::Home => { home::home_view(ctx, &state_ref); @@ -100,6 +103,8 @@ impl eframe::App for App { viewer::viewer_ui(ctx, &diff.with_app(&state_ref)); } } + + Self::end_frame(ctx, &state_ref) } // for file in &ctx.input(|i| i.raw.dropped_files.clone()) { @@ -172,22 +177,49 @@ impl eframe::App for App { // // } // // } // } + } +} - // let mut new_index = None; - // if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowDown)) { - // // Find next snapshot that matches filter - // if current_filtered_index + 1 < filtered.len() { - // new_index = Some(filtered[current_filtered_index + 1].0); - // } - // } - // if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowUp)) { - // // Find previous snapshot that matches filter - // if current_filtered_index > 0 { - // new_index = Some(filtered[current_filtered_index - 1].0); - // } - // } - // if let Some(new_index) = new_index { - // self.index = new_index; - // } +impl App { + fn end_frame(ctx: &Context, state: &AppStateRef<'_>) { + match &state.page { + PageRef::Home => {} + PageRef::DiffViewer(vs) => { + let mut new_index = None; + if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowDown)) { + // Find next snapshot that matches filter + if vs.active_filtered_index + 1 < vs.filtered_snapshots.len() { + new_index = Some(vs.filtered_snapshots[vs.active_filtered_index + 1].0); + } + } + if ctx.input_mut(|i| i.consume_key(Modifiers::NONE, egui::Key::ArrowUp)) { + // Find previous snapshot that matches filter + if vs.active_filtered_index > 0 { + new_index = Some(vs.filtered_snapshots[vs.active_filtered_index - 1].0); + } + } + if let Some(new_index) = new_index { + state.send(ViewerSystemCommand::SelectSnapshot(new_index)); + } + + + let handle_key = |key: Key, toggle: &mut bool| { + if ctx.input_mut(|i| i.key_pressed(key)) { + *toggle = true; + } + if ctx.input_mut(|i| i.key_released(key)) { + *toggle = false; + } + }; + + let mut view_filter = vs.state.view_filter; + handle_key(Key::Num1, &mut view_filter.show_old); + handle_key(Key::Num2, &mut view_filter.show_new); + handle_key(Key::Num3, &mut view_filter.show_diff); + if view_filter != vs.state.view_filter { + state.send(ViewerSystemCommand::SetViewFilter(view_filter)); + } + } + } } } diff --git a/src/bar.rs b/src/bar.rs new file mode 100644 index 0000000..ee82321 --- /dev/null +++ b/src/bar.rs @@ -0,0 +1,29 @@ +use crate::github_auth::{AuthState, GithubAuthCommand, LoggedInState}; +use crate::state::{AppStateRef, SystemCommand}; +use eframe::egui; +use eframe::egui::panel::TopBottomSide; +use eframe::egui::{Context, Ui}; + +pub fn bar(ctx: &Context, state: &AppStateRef<'_>) { + egui::TopBottomPanel::top("top bar") + .resizable(false) + .show(ctx, |ui| egui::Sides::new().show(ui, |ui| {}, |ui| { + auth_ui(ui, state); + })); +} + +pub fn auth_ui(ui: &mut Ui, state: &AppStateRef<'_>) { + match &state.github_auth.get_auth_state().logged_in { + Some(logged_in) => { + if let Some(image) = &logged_in.user_image { + ui.image(image); + } + ui.label(&logged_in.username); + } + None => { + if ui.button("Log in with GitHub").clicked() { + state.send(GithubAuthCommand::Login); + } + } + } +} diff --git a/src/cli.rs b/src/cli.rs index 9c8d3a6..ab76c80 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -13,7 +13,9 @@ pub struct Cli { #[derive(Subcommand)] pub enum Commands { /// Compare snapshot test files (.png with .old/.new/.diff variants) (default) - Files, + Files { + directory: Option, + }, /// Compare images between current branch and default branch Git, /// Compare images between PR branches from GitHub PR URL (needs to be run from within the repo) @@ -27,7 +29,9 @@ pub enum Commands { impl Commands { pub fn to_source(&self) -> DiffSource { match self { - Commands::Files => DiffSource::Files, + Commands::Files {directory} => DiffSource::Files( + directory.clone().unwrap_or_else(|| ".".into()).into(), + ), Commands::Git => DiffSource::Git, Commands::Pr { url } => { // Check if the PR URL is actually a GitHub artifact URL diff --git a/src/github_auth.rs b/src/github_auth.rs index 585cb0c..015c36f 100644 --- a/src/github_auth.rs +++ b/src/github_auth.rs @@ -1,11 +1,21 @@ use crate::github_model::GithubRepoLink; +use crate::state::SystemCommand; use eframe::egui; use ehttp; use serde_json; use std::fmt; use std::sync::mpsc; -pub enum GithubAuthCommand {} +pub enum GithubAuthCommand { + Login, + Logout, +} + +impl From for SystemCommand { + fn from(cmd: GithubAuthCommand) -> Self { + SystemCommand::GithubAuth(cmd) + } +} #[derive(Debug, Clone, Default, PartialEq, serde::Serialize, serde::Deserialize)] pub struct AuthState { @@ -14,10 +24,11 @@ pub struct AuthState { #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub struct LoggedInState { - pub access_token: String, - pub provider_token: String, // GitHub OAuth token + pub supabase_token: String, + pub github_token: String, // GitHub OAuth token expires_at: u64, - username: String, + pub username: String, + pub user_image: Option, } #[derive(Debug)] @@ -30,14 +41,22 @@ pub struct GitHubAuth { } impl GitHubAuth { - pub fn client(&self) -> octocrab::Octocrab { - let mut builder = octocrab_wasm::builder(); + fn make_client(token: Option<&str>) -> octocrab::Octocrab { + let builder = octocrab_wasm::builder(); - if let Some(state) = &self.state.logged_in { - builder = builder.user_access_token(state.provider_token.clone()); + let mut client = builder.build().expect("Failed to build Octocrab client"); + + if let Some(token) = token { + client = client + .user_access_token(token.to_string()) + .expect("Invalid token"); } - builder.build().expect("Failed to build Octocrab client") + client + } + + pub fn client(&self) -> octocrab::Octocrab { + Self::make_client(self.get_token()) } } @@ -128,12 +147,27 @@ impl GitHubAuth { let (auth_sender, auth_receiver) = mpsc::channel(); - Self { + let mut this = Self { supabase_url, supabase_anon_key, state, auth_sender, auth_receiver, + }; + + this.check_for_auth_callback(); + + this + } + + pub fn handle(&mut self, cmd: GithubAuthCommand) { + match cmd { + GithubAuthCommand::Login => { + self.login_github(); + } + GithubAuthCommand::Logout => { + self.logout(); + } } } @@ -177,10 +211,11 @@ impl GitHubAuth { let expires_at = get_current_timestamp() + (24 * 60 * 60); // 24 hours let logged_in_state = LoggedInState { - access_token: access_token.clone(), - provider_token: github_token, + supabase_token: access_token.clone(), + github_token: github_token, expires_at, username, + user_image: None, // Could fetch user image if needed }; let auth_state = AuthState { logged_in: Some(logged_in_state), @@ -287,7 +322,7 @@ impl GitHubAuth { self.state .logged_in .as_ref() - .map(|s| s.provider_token.as_str()) + .map(|s| s.github_token.as_str()) } else { None } diff --git a/src/lib.rs b/src/lib.rs index 56717f6..5d152bd 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -4,6 +4,7 @@ use crate::snapshot::Snapshot; use eframe::egui::Context; use eframe::egui::load::Bytes; use std::any::Any; +use std::path::PathBuf; use std::sync::mpsc::Sender; use crate::github_model::{GithubPrLink, GithubRepoLink}; use crate::state::AppState; @@ -18,15 +19,16 @@ pub mod native_loaders; mod settings; pub mod snapshot; mod state; -mod github_model; +pub mod github_model; mod octokit; mod viewer; mod home; +mod bar; #[derive(Debug, Clone)] pub enum DiffSource { #[cfg(not(target_arch = "wasm32"))] - Files, + Files(PathBuf), #[cfg(not(target_arch = "wasm32"))] Git, Pr(GithubPrLink), @@ -46,8 +48,8 @@ impl DiffSource { ) -> SnapshotLoader { match self { #[cfg(not(target_arch = "wasm32"))] - DiffSource::Files => { - Box::new(native_loaders::file_loader::FileLoader::new(".")) + DiffSource::Files(path) => { + Box::new(native_loaders::file_loader::FileLoader::new(path)) } // #[cfg(not(target_arch = "wasm32"))] // DiffSource::Git => { diff --git a/src/main.rs b/src/main.rs index f25b7ee..5292543 100644 --- a/src/main.rs +++ b/src/main.rs @@ -5,10 +5,10 @@ mod cli; use eframe::NativeOptions; use kitdiff::DiffSource; use kitdiff::app::App; +use kitdiff::github_model::GithubPrLink; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { - let rt = tokio::runtime::Builder::new_multi_thread() .enable_all() .build() @@ -21,7 +21,7 @@ fn main() -> eframe::Result<()> { let source = mode .command .map(|c| c.to_source()) - .unwrap_or(DiffSource::Files); + .unwrap_or(DiffSource::Files(".".into())); eframe::run_native( "kitdiff", @@ -30,58 +30,52 @@ fn main() -> eframe::Result<()> { ) } -// #[cfg(target_arch = "wasm32")] -// fn parse_url_query_params() -> Option { -// use kitdiff::github_auth::parse_github_artifact_url; -// use kitdiff::github_pr::parse_github_pr_url; -// -// if let Some(window) = web_sys::window() { -// if let Ok(search) = window.location().search() { -// let search = search.strip_prefix('?').unwrap_or(&search); -// -// // Parse query parameters -// for param in search.split('&') { -// if let Some((key, value)) = param.split_once('=') { -// if key == "url" { -// // URL decode the value -// let decoded_url = js_sys::decode_uri_component(value).ok()?.as_string()?; -// -// // Try to parse as GitHub PR URL -// if let Ok((_user, _repo, _pr_number)) = parse_github_pr_url(&decoded_url) { -// return Some(DiffSource::Pr(decoded_url)); -// } -// -// // Try to parse as GitHub artifact URL -// if let Some((owner, repo, artifact_id)) = -// parse_github_artifact_url(&decoded_url) -// { -// return Some(DiffSource::GHArtifact { -// owner, -// repo, -// artifact_id, -// }); -// } -// -// // Try to parse as direct zip/tar.gz URL -// if decoded_url.ends_with(".zip") { -// return Some(DiffSource::Zip(kitdiff::PathOrBlob::Url( -// decoded_url, -// None, -// ))); -// } -// if decoded_url.ends_with(".tar.gz") || decoded_url.ends_with(".tgz") { -// return Some(DiffSource::TarGz(kitdiff::PathOrBlob::Url( -// decoded_url, -// None, -// ))); -// } -// } -// } -// } -// } -// } -// None -// } +#[cfg(target_arch = "wasm32")] +fn parse_url_query_params() -> Option { + use kitdiff::github_auth::parse_github_artifact_url; + use kitdiff::github_pr::parse_github_pr_url; + + if let Some(window) = web_sys::window() { + if let Ok(search) = window.location().search() { + let search = search.strip_prefix('?').unwrap_or(&search); + + // Parse query parameters + for param in search.split('&') { + if let Some((key, value)) = param.split_once('=') { + if key == "url" { + // URL decode the value + let decoded_url = js_sys::decode_uri_component(value).ok()?.as_string()?; + + // Try to parse as GitHub PR URL + if let Ok(link) = decoded_url.parse() { + return Some(DiffSource::Pr(link)); + } + + // Try to parse as GitHub artifact URL + if let Some((repo, artifact_id)) = parse_github_artifact_url(&decoded_url) { + return Some(DiffSource::GHArtifact { repo, artifact_id }); + } + + // Try to parse as direct zip/tar.gz URL + if decoded_url.ends_with(".zip") { + return Some(DiffSource::Zip(kitdiff::PathOrBlob::Url( + decoded_url, + None, + ))); + } + if decoded_url.ends_with(".tar.gz") || decoded_url.ends_with(".tgz") { + return Some(DiffSource::TarGz(kitdiff::PathOrBlob::Url( + decoded_url, + None, + ))); + } + } + } + } + } + } + None +} #[cfg(target_arch = "wasm32")] fn main() { @@ -98,8 +92,8 @@ fn main() { .unwrap(); // // Parse URL query parameters for DiffSource - // let diff_source = parse_url_query_params(); - let diff_source = None; + // let diff_source = None; + let diff_source = parse_url_query_params(); let start_result = eframe::WebRunner::new() .start( diff --git a/src/snapshot.rs b/src/snapshot.rs index 63a9737..5c25527 100644 --- a/src/snapshot.rs +++ b/src/snapshot.rs @@ -87,9 +87,9 @@ impl Snapshot { ..eframe::egui::TextureOptions::default() }) .tint(Color32::from_white_alpha(if show_all { - u8::MAX - } else { (255.0 * opacity) as u8 + } else { + u8::MAX })); match state.settings.mode { @@ -110,7 +110,7 @@ impl Snapshot { (show_all || show_old) .then(|| self.old_uri()) .flatten() - .map(|uri| self.make_image(state, uri, state.settings.new_opacity, show_all)) + .map(|uri| self.make_image(state, uri, 1.0, show_all)) } pub fn new_image(&self, state: &AppStateRef<'_>) -> Option { diff --git a/src/state.rs b/src/state.rs index 61316af..e815235 100644 --- a/src/state.rs +++ b/src/state.rs @@ -53,7 +53,7 @@ impl ViewerState { /// If any is true, only show those, but at full opacity /// /// If all are false, show all at their set opacities -#[derive(Default, Copy, Clone)] +#[derive(Default, Copy, Clone, PartialEq)] pub struct ViewFilter { pub show_old: bool, pub show_new: bool, @@ -194,6 +194,7 @@ pub enum SystemCommand { pub enum ViewerSystemCommand { SetFilter(String), SelectSnapshot(usize), + SetViewFilter(ViewFilter), } impl From for SystemCommand { @@ -206,10 +207,7 @@ impl AppState { pub fn handle(&mut self, ctx: &Context, command: SystemCommand) { match command { SystemCommand::Open(source) => { - let loader = source.load( - ctx.clone(), - &self, - ); + let loader = source.load(ctx.clone(), &self); self.page = Page::DiffViewer(ViewerState { filter: String::new(), index: 0, @@ -219,7 +217,7 @@ impl AppState { }); } SystemCommand::GithubAuth(auth) => { - todo!() + self.github_auth.handle(auth); } SystemCommand::LoadPrDetails(url) => { self.github_pr = Some(GithubPr::new( @@ -246,6 +244,8 @@ impl AppState { viewer.loader.update(ctx); viewer.index_just_selected = false; } + + self.github_auth.update(ctx); } } @@ -262,6 +262,9 @@ impl ViewerState { self.index_just_selected = true; } } + ViewerSystemCommand::SetViewFilter(view_filter) => { + self.view_filter = view_filter; + } } } } diff --git a/src/viewer/diff_view.rs b/src/viewer/diff_view.rs index 488ee09..e41de72 100644 --- a/src/viewer/diff_view.rs +++ b/src/viewer/diff_view.rs @@ -44,8 +44,6 @@ pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { let any_loading = is_loading(&old) || is_loading(&new) || is_loading(&diff); - dbg!(&old, &new); - if let Some(old) = old { ui.place(rect, old); } diff --git a/src/viewer/file_tree.rs b/src/viewer/file_tree.rs index 90833bc..92b69be 100644 --- a/src/viewer/file_tree.rs +++ b/src/viewer/file_tree.rs @@ -1,6 +1,6 @@ use crate::state::{FilteredSnapshot, ViewerAppStateRef, ViewerSystemCommand}; use eframe::egui; -use eframe::egui::{Id, TextEdit, Ui}; +use eframe::egui::{Id, ScrollArea, TextEdit, Ui}; use re_ui::UiExt; use re_ui::list_item::{LabelContent, ListItem}; use std::collections::BTreeMap; @@ -17,29 +17,31 @@ pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { state.app.send(ViewerSystemCommand::SetFilter(filter)); } - ui.list_item_scope("file_tree", |ui| { - let mut tree = BTreeMap::new(); + ScrollArea::vertical().show(ui, |ui| { + ui.list_item_scope("file_tree", |ui| { + let mut tree = BTreeMap::new(); - for (snapshot_index, snapshot) in &state.filtered_snapshots { - let prefix = snapshot.path.parent().and_then(|p| p.to_str()); - tree.entry(prefix) - .or_insert(vec![]) - .push((*snapshot_index, *snapshot)) - } + for (snapshot_index, snapshot) in &state.filtered_snapshots { + let prefix = snapshot.path.parent().and_then(|p| p.to_str()); + tree.entry(prefix) + .or_insert(vec![]) + .push((*snapshot_index, *snapshot)) + } - for (prefix, snapshots) in tree { - if let Some(prefix) = prefix { - ui.list_item().show_hierarchical_with_children( - ui, - Id::new(prefix), - true, - LabelContent::new(prefix), - |ui| show_prefix(ui, state, &snapshots), - ); - } else { - show_prefix(ui, state, &snapshots); + for (prefix, snapshots) in tree { + if let Some(prefix) = prefix { + ui.list_item().show_hierarchical_with_children( + ui, + Id::new(prefix), + true, + LabelContent::new(prefix), + |ui| show_prefix(ui, state, &snapshots), + ); + } else { + show_prefix(ui, state, &snapshots); + } } - } + }); }); } diff --git a/src/viewer/viewer_options.rs b/src/viewer/viewer_options.rs index 9eaca99..8c9e870 100644 --- a/src/viewer/viewer_options.rs +++ b/src/viewer/viewer_options.rs @@ -1,10 +1,23 @@ use crate::settings::ImageMode; use crate::state::{SystemCommand, ViewerAppStateRef, ViewerSystemCommand}; -use eframe::egui::{Slider, TextureFilter, Ui}; +use eframe::egui::{Key, KeyboardShortcut, Modifiers, Slider, TextureFilter, Ui}; pub fn viewer_options(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { let mut settings = state.app.settings.clone(); + ui.group(|ui| { + ui.strong("View only"); + let mut view_filter = state.view_filter; + ui.checkbox(&mut view_filter.show_old, "Old (1)"); + ui.checkbox(&mut view_filter.show_new, "New (2)"); + ui.checkbox(&mut view_filter.show_diff, "Diff (3)"); + if view_filter != state.view_filter { + state + .app + .send(ViewerSystemCommand::SetViewFilter(view_filter)); + } + }); + ui.add(Slider::new(&mut settings.new_opacity, 0.0..=1.0).text("New Opacity")); ui.add(Slider::new(&mut settings.diff_opacity, 0.0..=1.0).text("Diff Opacity")); From 2e4460138e2143f555444caa3824ac2e986dc7e1 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 24 Sep 2025 19:25:08 +0200 Subject: [PATCH 04/25] Get pr ui working --- .github/workflows/rust.yml | 2 +- Cargo.lock | 185 +++++++++------- Cargo.toml | 2 +- src/github_pr.rs | 438 ++++++++++++++++++++++--------------- src/loaders/mod.rs | 3 +- src/loaders/pr_loader.rs | 14 +- src/state.rs | 2 +- src/viewer/file_tree.rs | 2 + 8 files changed, 390 insertions(+), 258 deletions(-) diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml index 5fc56f5..fc6d0de 100644 --- a/.github/workflows/rust.yml +++ b/.github/workflows/rust.yml @@ -94,7 +94,7 @@ jobs: - uses: actions-rs/toolchain@v1 with: profile: minimal - toolchain: 1.85.0 + toolchain: 1.88.0 target: wasm32-unknown-unknown override: true - name: Download and install Trunk binary diff --git a/Cargo.lock b/Cargo.lock index 16e16f9..6bdf1a3 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -248,9 +248,9 @@ dependencies = [ [[package]] name = "anyhow" -version = "1.0.99" +version = "1.0.100" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "b0674a1ddeecb70197781e945de4b3b8ffb61fa939a5597bcf48503737663100" +checksum = "a23eb6b1614318a8071c9b2521f36b424b2c83db5eb3a0fead4a6c0809af6e61" [[package]] name = "arbitrary" @@ -1016,9 +1016,9 @@ dependencies = [ [[package]] name = "clap" -version = "4.5.47" +version = "4.5.48" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "7eac00902d9d136acd712710d71823fb8ac8004ca445a89e73a41d45aa712931" +checksum = "e2134bb3ea021b78629caa971416385309e0131b351b25e01dc16fb54e1b5fae" dependencies = [ "clap_builder", "clap_derive", @@ -1026,9 +1026,9 @@ dependencies = [ [[package]] name = "clap_builder" -version = "4.5.47" +version = "4.5.48" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "2ad9bbf750e73b5884fb8a211a9424a1906c1e156724260fdae972f31d70e1d6" +checksum = "c2ba64afa3c0a6df7fa517765e31314e983f51dda798ffba27b988194fb65dc9" dependencies = [ "anstream", "anstyle", @@ -1354,9 +1354,9 @@ checksum = "be1e0bca6c3637f992fc1cc7cbc52a78c1ef6db076dbf1059c4323d6a2048376" [[package]] name = "deranged" -version = "0.5.3" +version = "0.5.4" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d630bccd429a5bb5a64b5e94f693bfc48c9f8566418fda4c494cc94f911f87cc" +checksum = "a41953f86f8a05768a6cda24def994fd2f424b04ec5c719cf89989779f199071" dependencies = [ "powerfmt", ] @@ -1946,9 +1946,9 @@ dependencies = [ [[package]] name = "flatbuffers" -version = "25.2.10" +version = "25.9.23" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1045398c1bfd89168b5fd3f1fc11f6e70b34f6f66300c87d44d3de849463abf1" +checksum = "09b6620799e7340ebd9968d2e0708eb82cf1971e9a16821e2091b6d6e475eed5" dependencies = [ "bitflags 2.9.4", "rustc_version", @@ -2636,7 +2636,7 @@ dependencies = [ "js-sys", "log", "wasm-bindgen", - "windows-core 0.61.2", + "windows-core 0.62.0", ] [[package]] @@ -2813,9 +2813,9 @@ checksum = "edcd27d72f2f071c64249075f42e205ff93c9a4c5f6c6da53e79ed9f9832c285" [[package]] name = "imgref" -version = "1.11.0" +version = "1.12.0" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "d0263a3d970d5c054ed9312c0057b4f3bde9c0b33836d3637361d4a9e6e7a408" +checksum = "e7c5cedc30da3a610cac6b4ba17597bdf7152cf974e8aab3afb3d54455e371c8" [[package]] name = "indent" @@ -3007,9 +3007,9 @@ dependencies = [ [[package]] name = "js-sys" -version = "0.3.80" +version = "0.3.81" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "852f13bec5eba4ba9afbeb93fd7c13fe56147f055939ae21c43a29a0ecb2702e" +checksum = "ec48937a97411dcb524a265206ccd4c90bb711fca92b2792c407f268825b9305" dependencies = [ "once_cell", "wasm-bindgen", @@ -3183,9 +3183,9 @@ dependencies = [ [[package]] name = "libc" -version = "0.2.175" +version = "0.2.176" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "6a82ae493e598baaea5209805c49bbf2ea7de956d50d7da0da1164f9c6d28543" +checksum = "58f929b4d672ea937a23a1ab494143d968337a5f47e56d0815df1e0890ddf174" [[package]] name = "libfuzzer-sys" @@ -3213,12 +3213,12 @@ dependencies = [ [[package]] name = "libloading" -version = "0.8.8" +version = "0.8.9" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "07033963ba89ebaf1584d767badaa2e8fcec21aedea6b8c0346d487d49c28667" +checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55" dependencies = [ "cfg-if", - "windows-targets 0.53.3", + "windows-link 0.2.0", ] [[package]] @@ -4544,9 +4544,9 @@ dependencies = [ [[package]] name = "pxfm" -version = "0.1.23" +version = "0.1.24" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f55f4fedc84ed39cb7a489322318976425e42a147e2be79d8f878e2884f94e84" +checksum = "83f9b339b02259ada5c0f4a389b7fb472f933aa17ce176fd2ad98f28bb401fde" dependencies = [ "num-traits", ] @@ -4715,7 +4715,7 @@ dependencies = [ [[package]] name = "re_arrow_util" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "anyhow", "arrow", @@ -4728,7 +4728,7 @@ dependencies = [ [[package]] name = "re_build_info" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "re_byte_size", "serde", @@ -4737,7 +4737,7 @@ dependencies = [ [[package]] name = "re_build_tools" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "anyhow", "cargo_metadata", @@ -4751,7 +4751,7 @@ dependencies = [ [[package]] name = "re_byte_size" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "arrow", "half", @@ -4761,7 +4761,7 @@ dependencies = [ [[package]] name = "re_case" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "convert_case", ] @@ -4769,7 +4769,7 @@ dependencies = [ [[package]] name = "re_chunk" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "ahash", "anyhow", @@ -4800,7 +4800,7 @@ dependencies = [ [[package]] name = "re_chunk_store" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "ahash", "anyhow", @@ -4828,7 +4828,7 @@ dependencies = [ [[package]] name = "re_entity_db" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "ahash", "document-features", @@ -4859,12 +4859,12 @@ dependencies = [ [[package]] name = "re_error" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" [[package]] name = "re_format" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "half", "num-traits", @@ -4873,7 +4873,7 @@ dependencies = [ [[package]] name = "re_format_arrow" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "arrow", "comfy-table", @@ -4887,7 +4887,7 @@ dependencies = [ [[package]] name = "re_int_histogram" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "smallvec", "static_assertions", @@ -4896,7 +4896,7 @@ dependencies = [ [[package]] name = "re_log" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "env_filter", "env_logger", @@ -4911,7 +4911,7 @@ dependencies = [ [[package]] name = "re_log_encoding" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "arrow", "bytes", @@ -4934,7 +4934,7 @@ dependencies = [ [[package]] name = "re_log_types" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "ahash", "arrow", @@ -4969,7 +4969,7 @@ dependencies = [ [[package]] name = "re_protos" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "arrow", "jiff", @@ -4991,7 +4991,7 @@ dependencies = [ [[package]] name = "re_query" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "ahash", "anyhow", @@ -5018,7 +5018,7 @@ dependencies = [ [[package]] name = "re_smart_channel" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "crossbeam", "parking_lot", @@ -5032,7 +5032,7 @@ dependencies = [ [[package]] name = "re_sorbet" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "arrow", "itertools 0.14.0", @@ -5053,7 +5053,7 @@ dependencies = [ [[package]] name = "re_span" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "num-traits", ] @@ -5061,7 +5061,7 @@ dependencies = [ [[package]] name = "re_string_interner" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "ahash", "nohash-hasher", @@ -5073,7 +5073,7 @@ dependencies = [ [[package]] name = "re_tracing" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "puffin", ] @@ -5081,7 +5081,7 @@ dependencies = [ [[package]] name = "re_tuid" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "bytemuck", "document-features", @@ -5094,7 +5094,7 @@ dependencies = [ [[package]] name = "re_types_core" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "anyhow", "arrow", @@ -5118,7 +5118,7 @@ dependencies = [ [[package]] name = "re_ui" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "ahash", "anyhow", @@ -5153,7 +5153,7 @@ dependencies = [ [[package]] name = "re_uri" version = "0.26.0-alpha.1+dev" -source = "git+https://github.com/rerun-io/rerun?branch=main#c0794d9cdf84d2a441a205b2d6e592aa9594d826" +source = "git+https://github.com/rerun-io/rerun?branch=main#0416b9b8bdbf20bf6d9d18458ca218259deb0484" dependencies = [ "re_log", "re_log_types", @@ -5380,9 +5380,9 @@ dependencies = [ [[package]] name = "rustls" -version = "0.23.31" +version = "0.23.32" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "c0ebcbd2f03de0fc1122ad9bb24b127a5a6cd51d72604a3f3c50ac459762b6cc" +checksum = "cd3c25631629d034ce7cd9940adc9d45762d46de2b0f57193c4443b92c6d4d40" dependencies = [ "log", "once_cell", @@ -5402,7 +5402,7 @@ dependencies = [ "openssl-probe", "rustls-pki-types", "schannel", - "security-framework 3.4.0", + "security-framework 3.5.0", ] [[package]] @@ -5504,9 +5504,9 @@ dependencies = [ [[package]] name = "security-framework" -version = "3.4.0" +version = "3.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "60b369d18893388b345804dc0007963c99b7d665ae71d275812d828c6f089640" +checksum = "cc198e42d9b7510827939c9a15f5062a0c913f3371d765977e586d2fe6c16f4a" dependencies = [ "bitflags 2.9.4", "core-foundation 0.10.1", @@ -5543,9 +5543,9 @@ checksum = "1bc711410fbe7399f390ca1c3b60ad0f53f80e95c5eb935e52268a0e2cd49acc" [[package]] name = "serde" -version = "1.0.225" +version = "1.0.226" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "fd6c24dee235d0da097043389623fb913daddf92c76e9f5a1db88607a0bcbd1d" +checksum = "0dca6411025b24b60bfa7ec1fe1f8e710ac09782dca409ee8237ba74b51295fd" dependencies = [ "serde_core", "serde_derive", @@ -5553,18 +5553,18 @@ dependencies = [ [[package]] name = "serde_core" -version = "1.0.225" +version = "1.0.226" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "659356f9a0cb1e529b24c01e43ad2bdf520ec4ceaf83047b83ddcc2251f96383" +checksum = "ba2ba63999edb9dac981fb34b3e5c0d111a69b0924e253ed29d83f7c99e966a4" dependencies = [ "serde_derive", ] [[package]] name = "serde_derive" -version = "1.0.225" +version = "1.0.226" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "0ea936adf78b1f766949a4977b91d2f5595825bd6ec079aa9543ad2685fc4516" +checksum = "8db53ae22f34573731bafa1db20f04027b2d25e02d8205921b569171699cdb33" dependencies = [ "proc-macro2", "quote", @@ -5972,9 +5972,9 @@ checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1" [[package]] name = "tempfile" -version = "3.22.0" +version = "3.23.0" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "84fa4d11fadde498443cca10fd3ac23c951f0dc59e080e9f4b93d4df4e4eea53" +checksum = "2d31c77bdf42a745371d260a26ca7163f1e0924b64afa0b688e61b5a9fa02f16" dependencies = [ "fastrand", "getrandom 0.3.3", @@ -6599,9 +6599,9 @@ dependencies = [ [[package]] name = "wasm-bindgen" -version = "0.2.103" +version = "0.2.104" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ab10a69fbd0a177f5f649ad4d8d3305499c42bab9aef2f7ff592d0ec8f833819" +checksum = "c1da10c01ae9f1ae40cbfac0bac3b1e724b320abfcf52229f80b547c0d250e2d" dependencies = [ "cfg-if", "once_cell", @@ -6612,9 +6612,9 @@ dependencies = [ [[package]] name = "wasm-bindgen-backend" -version = "0.2.103" +version = "0.2.104" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "0bb702423545a6007bbc368fde243ba47ca275e549c8a28617f56f6ba53b1d1c" +checksum = "671c9a5a66f49d8a47345ab942e2cb93c7d1d0339065d4f8139c486121b43b19" dependencies = [ "bumpalo", "log", @@ -6626,9 +6626,9 @@ dependencies = [ [[package]] name = "wasm-bindgen-futures" -version = "0.4.53" +version = "0.4.54" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "a0b221ff421256839509adbb55998214a70d829d3a28c69b4a6672e9d2a42f67" +checksum = "7e038d41e478cc73bae0ff9b36c60cff1c98b8f38f8d7e8061e79ee63608ac5c" dependencies = [ "cfg-if", "js-sys", @@ -6639,9 +6639,9 @@ dependencies = [ [[package]] name = "wasm-bindgen-macro" -version = "0.2.103" +version = "0.2.104" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "fc65f4f411d91494355917b605e1480033152658d71f722a90647f56a70c88a0" +checksum = "7ca60477e4c59f5f2986c50191cd972e3a50d8a95603bc9434501cf156a9a119" dependencies = [ "quote", "wasm-bindgen-macro-support", @@ -6649,9 +6649,9 @@ dependencies = [ [[package]] name = "wasm-bindgen-macro-support" -version = "0.2.103" +version = "0.2.104" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "ffc003a991398a8ee604a401e194b6b3a39677b3173d6e74495eb51b82e99a32" +checksum = "9f07d2f20d4da7b26400c9f4a0511e6e0345b040694e8a75bd41d578fa4421d7" dependencies = [ "proc-macro2", "quote", @@ -6662,9 +6662,9 @@ dependencies = [ [[package]] name = "wasm-bindgen-shared" -version = "0.2.103" +version = "0.2.104" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "293c37f4efa430ca14db3721dfbe48d8c33308096bd44d80ebaa775ab71ba1cf" +checksum = "bad67dc8b2a1a6e5448428adec4c3e84c43e561d8c9ee8a9e5aabeb193ec41d1" dependencies = [ "unicode-ident", ] @@ -6780,9 +6780,9 @@ dependencies = [ [[package]] name = "web-sys" -version = "0.3.80" +version = "0.3.81" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "fbe734895e869dc429d78c4b433f8d17d95f8d05317440b4fad5ab2d33e596dc" +checksum = "9367c417a924a74cae129e6a2ae3b47fabb1f8995595ab474029da749a8be120" dependencies = [ "js-sys", "wasm-bindgen", @@ -7075,6 +7075,19 @@ dependencies = [ "windows-strings 0.4.2", ] +[[package]] +name = "windows-core" +version = "0.62.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "57fe7168f7de578d2d8a05b07fd61870d2e73b4020e9f49aa00da8471723497c" +dependencies = [ + "windows-implement 0.60.0", + "windows-interface 0.59.1", + "windows-link 0.2.0", + "windows-result 0.4.0", + "windows-strings 0.5.0", +] + [[package]] name = "windows-future" version = "0.2.1" @@ -7181,6 +7194,15 @@ dependencies = [ "windows-link 0.1.3", ] +[[package]] +name = "windows-result" +version = "0.4.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7084dcc306f89883455a206237404d3eaf961e5bd7e0f312f7c91f57eb44167f" +dependencies = [ + "windows-link 0.2.0", +] + [[package]] name = "windows-strings" version = "0.1.0" @@ -7200,6 +7222,15 @@ dependencies = [ "windows-link 0.1.3", ] +[[package]] +name = "windows-strings" +version = "0.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7218c655a553b0bed4426cf54b20d7ba363ef543b52d515b3e48d7fd55318dda" +dependencies = [ + "windows-link 0.2.0", +] + [[package]] name = "windows-sys" version = "0.45.0" @@ -7547,9 +7578,9 @@ checksum = "ea6fc2961e4ef194dcbfe56bb845534d0dc8098940c7e5c012a258bfec6701bd" [[package]] name = "xattr" -version = "1.5.1" +version = "1.6.1" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "af3a19837351dc82ba89f8a125e22a3c475f05aba604acc023d62b2739ae2909" +checksum = "32e45ad4206f6d2479085147f02bc2ef834ac85886624a23575ae137c8aa8156" dependencies = [ "libc", "rustix 1.1.2", diff --git a/Cargo.toml b/Cargo.toml index fd849cf..60e4feb 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -4,7 +4,7 @@ version = "0.1.0" authors = ["Lucas Meurer "] edition = "2024" homepage = "https://github.com/rerun-io/kitdiff" -rust-version = "1.85" +rust-version = "1.88" categories = ["gui", "development-tools", "multimedia::images", "graphics"] description = "A visual diffing tool" include = ["LICENSE-APACHE", "LICENSE-MIT", "**/*.rs", "Cargo.toml"] diff --git a/src/github_pr.rs b/src/github_pr.rs index 41eab92..52f9155 100644 --- a/src/github_pr.rs +++ b/src/github_pr.rs @@ -1,10 +1,11 @@ use crate::DiffSource; use eframe::egui; -use eframe::egui::{Context, Popup}; +use eframe::egui::{Button, Context, Popup, Spinner}; use egui_inbox::UiInbox; use futures::stream::FuturesUnordered; use futures::{StreamExt, TryStreamExt}; -use octocrab::{AuthState, Error, Octocrab}; +use octocrab::{AuthState, Error, Octocrab, Page}; +use re_ui::egui_ext::boxed_widget::BoxedWidgetLocalExt; use std::collections::HashMap; use std::future::ready; use std::pin::pin; @@ -14,11 +15,18 @@ use std::task::Poll; // Import octocrab models use crate::github_model::{GithubPrLink, PrNumber}; use crate::octokit::RepoClient; +use crate::state::{AppStateRef, SystemCommand}; +use octocrab::models::commits::GithubCommitStatus; use octocrab::models::{ + CombinedStatus, Status, StatusState, pulls::PullRequest, repos::RepoCommit, workflows::{Run, WorkflowListArtifact}, }; +use octocrab::params::repos::Reference; +use octocrab::workflows::ListRunsBuilder; +use re_ui::list_item::{LabelContent, ListItemContentButtonsExt, list_item_scope}; +use re_ui::{OnResponseExt, UiExt, icons}; pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { // Parse URLs like: https://github.com/rerun-io/rerun/pull/11253 @@ -42,20 +50,16 @@ pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { Ok((user, repo, pr_number)) } -#[derive(Debug, Clone)] -pub enum GithubPrMessage { - FetchedDetails(PrDetails), - FetchedCommits(Vec), - Error(String), -} - -#[derive(Debug, Clone)] -pub struct PrDetails { - pub title: String, - pub head_ref: String, - pub base_ref: String, - pub state: String, - pub html_url: String, +#[derive(Debug)] +pub enum GithubPrCommand { + FetchedData(Result), + FetchedCommitArtifacts { + sha: String, + artifacts: Result, octocrab::Error>, + }, + FetchCommitArtifacts { + sha: String, + }, } #[derive(Debug, Clone)] @@ -77,205 +81,291 @@ pub struct GithubArtifact { pub struct GithubPr { link: GithubPrLink, - pub auth_token: Option, - inbox: UiInbox>, - pub data: Poll>, + inbox: UiInbox, + pub data: Poll>, + client: Octocrab, } -impl GithubPr { - pub fn new(link: GithubPrLink, auth_token: Option) -> Self { - let mut client = octocrab_wasm::builder() - .build() - .expect("Failed to build Octocrab client"); - - if let Some(token) = &auth_token { - client = client - .user_access_token(token.to_owned()) - .expect("Failed to set token"); - } +#[derive(Debug)] +struct PrWithCommits { + pr: PullRequest, + commits: Vec, +} + +#[derive(Debug)] +struct CommitWithArtifacts { + commit: RepoCommit, + status: CombinedStatus, + artifacts: Option, octocrab::Error>>>, +} + +#[derive(Debug, Clone)] +struct ArtifactData { + artifact: WorkflowListArtifact, + run: Run, +} +impl GithubPr { + pub fn new(link: GithubPrLink, client: Octocrab) -> Self { let mut inbox = UiInbox::new(); { - let client = RepoClient::new(client, link.repo.clone()); + let client = RepoClient::new(client.clone(), link.repo.clone()); inbox.spawn(|tx| async move { let details = get_all_pr_artifacts(&client, link.pr_number).await; - let _ = tx.send(details); + let _ = tx.send(GithubPrCommand::FetchedData(details)); }); } Self { link, - auth_token: auth_token.clone(), inbox, data: Poll::Pending, + client, } } - /// Display details about the PR and allow selecting an artifact to load - pub fn ui(&mut self, ui: &mut eframe::egui::Ui) -> Option { - if let Some(data) = self.inbox.read(ui).last() { - self.data = Poll::Ready(data); - } - - let mut selected_source = None; - - ui.group(|ui| { - ui.heading(format!("GitHub PR #{}", self.link.pr_number)); - - match &self.data { - Poll::Ready(Ok(data)) => { - let details = &data.pr; - - if let Some(title) = &details.title { - ui.label(title); - } - - ui.separator(); - - if let Some(html_url) = &details.html_url { - if ui.button("Compare PR Branches").clicked() { - selected_source = - Some(DiffSource::Pr(html_url.to_string().parse().unwrap())); + pub fn update(&mut self, _ctx: &Context) { + for command in self.inbox.read(_ctx) { + match command { + GithubPrCommand::FetchedData(data) => { + self.data = Poll::Ready(data); + } + GithubPrCommand::FetchedCommitArtifacts { sha, artifacts } => { + if let Poll::Ready(Ok(pr_data)) = &mut self.data { + for commit in &mut pr_data.commits { + if commit.commit.sha == sha { + commit.artifacts = Some(Poll::Ready(artifacts)); + break; + } } } - - ui.separator(); - ui.heading("Recent Commits & Artifacts"); - - ui.style_mut().wrap_mode = Some(egui::TextWrapMode::Truncate); - - for (commit, artifacts) in &data.artifacts_by_commit { - egui::Sides::new().shrink_left().show( - ui, - |ui| { - ui.label(&commit.commit.message); - }, - |ui| { - if artifacts.len() > 0 { - let response = - ui.link(format!("{} artifacts", artifacts.len())); - Popup::menu(&response).show(|ui| { - for artifact in artifacts { - if ui.button(&artifact.name).clicked() { - selected_source = Some(DiffSource::GHArtifact { - repo: self.link.repo.clone(), - artifact_id: artifact.id.to_string(), - }); - } - } - }); + } + GithubPrCommand::FetchCommitArtifacts { sha } => { + match &mut self.data { + Poll::Ready(Ok(pr_data)) => { + for commit in &mut pr_data.commits { + if commit.commit.sha == sha { + commit.artifacts = Some(Poll::Pending); + break; } - }, - ); + } + } + _ => {} } - } - Poll::Ready(Err(error)) => { - ui.colored_label(ui.visuals().error_fg_color, format!("Error: {}", error)); - } - Poll::Pending => { - ui.spinner(); + + let client = RepoClient::new(self.client.clone(), self.link.repo.clone()); + self.inbox.spawn(move |tx| async move { + let artifacts = fetch_commit_artifacts(&client, &sha).await; + let _ = tx.send(GithubPrCommand::FetchedCommitArtifacts { sha, artifacts }); + }); } } - }); - - selected_source + } } } -async fn get_pr_runs_by_commit( +// Get all commits for a PR to get a complete picture +async fn get_pr_commits( + repo: &RepoClient, + pr: PrNumber, +) -> octocrab::Result> { + let page = repo.pulls().pr_commits(pr).send().await?; + let commits: Vec<_> = page + .into_stream(repo) + .map_ok(|commit| async move { + let status = repo + .get( + format!( + "/repos/{}/{}/commits/{}/status", + repo.repo().owner, + repo.repo().repo, + commit.sha + ), + None::<&()>, + ) + .await?; + Ok(CommitWithArtifacts { + commit, + status, + artifacts: None, + }) + }) + .try_buffered(10) + .try_collect() + .await?; + + Ok(commits) +} + +async fn get_all_pr_artifacts( repo: &RepoClient, pr_number: PrNumber, -) -> octocrab::Result>> { - // First, get the PR to find the head branch +) -> octocrab::Result { let pr = repo.pulls().get(pr_number).await?; + let commits = get_pr_commits(repo, pr_number).await?; - // Get the branch name from the PR - let branch_name = &pr.head.ref_field; + Ok(PrWithCommits { pr, commits }) +} - // List all workflow runs for this branch - let mut runs_by_commit: HashMap> = HashMap::new(); +#[derive(serde::Serialize)] +struct ListWorkflowRunsHeadSha { + head_sha: String, +} - let page = repo - .workflows() - .list_all_runs() - .branch(branch_name) - .per_page(100) - .send() - .await? - .into_stream(&repo); +async fn fetch_commit_artifacts( + repo: &RepoClient, + sha: &str, +) -> octocrab::Result> { + + let workflow_runs: Page = repo + .get( + // Unfortunately octocrab is missing the head_sha filter + format!( + "/repos/{}/{}/actions/runs", + repo.repo().owner, + repo.repo().repo + ), + Some(&ListWorkflowRunsHeadSha { + head_sha: sha.to_string(), + }), + ) + .await?; - let mut page = pin!(page); + let runs: Vec = workflow_runs.into_stream(repo).try_collect().await?; + + let artifacts = FuturesUnordered::from_iter(runs.into_iter().map(|run| async move { + let artifacts_page = repo + .actions() + .list_workflow_run_artifacts(&repo.repo().owner, &repo.repo().repo, run.id) + .send() + .await? + .value + .expect("No etag was provided, so we should have a value"); + + let stream = artifacts_page + .into_stream(repo) + .map_ok(move |artifact| ArtifactData { + artifact, + run: run.clone(), + }); - while let Some(run) = page.next().await.transpose()? { - runs_by_commit - .entry(run.head_sha.clone()) - .or_insert_with(Vec::new) - .push(run); - } + Ok(stream) + })) + .try_flatten() + .try_collect::>() + .await?; - Ok(runs_by_commit) + Ok(artifacts) } -// Get all commits for a PR to get a complete picture -async fn get_pr_commits_with_runs( - repo: &RepoClient, - pr: PrNumber, -) -> octocrab::Result)>> { - // Get all commits in the PR - let commits = repo.pulls().pr_commits(pr).send().await?; - - // Get all runs grouped by commit - let runs_by_commit = get_pr_runs_by_commit(repo, pr).await?; - - Ok(commits - .items - .into_iter() - .map(|commit| { - let runs = runs_by_commit - .get(&commit.sha) - .cloned() - .unwrap_or_else(Vec::new); - (commit, runs) - }) - .collect()) -} +pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { + let mut selected_source = None; -struct PrWithArtifacts { - pr: PullRequest, - artifacts_by_commit: Vec<(RepoCommit, Vec)>, -} + ui.group(|ui| { + ui.heading(format!("GitHub PR #{}", pr.link.pr_number)); -async fn get_all_pr_artifacts( - repo: &RepoClient, - pr: PrNumber, -) -> octocrab::Result { - let commits_with_runs = get_pr_commits_with_runs(repo, pr).await?; - - let mut artifacts_by_commit = Vec::new(); - for (commit, runs) in commits_with_runs { - let artifacts = FuturesUnordered::from_iter(runs.into_iter().map(|run| async move { - repo.actions() - .list_workflow_run_artifacts(&repo.repo().owner, &repo.repo().repo, run.id) - .send() - .await - })) - .try_filter_map(|item| { - ready(Ok(item - .value - .map(|page| futures::stream::iter(page.items).map(Ok)))) - }) - .try_flatten() - .try_collect::>() - .await?; + match &pr.data { + Poll::Ready(Ok(data)) => { + let details = &data.pr; - artifacts_by_commit.push((commit, artifacts)); - } + if let Some(title) = &details.title { + ui.label(title); + } - let pr = repo.pulls().get(pr).await?; + ui.separator(); - Ok(PrWithArtifacts { - pr, - artifacts_by_commit, - }) + if let Some(html_url) = &details.html_url { + if ui.button("Compare PR Branches").clicked() { + selected_source = + Some(DiffSource::Pr(html_url.to_string().parse().unwrap())); + } + } + + ui.separator(); + ui.heading("Recent Commits & Artifacts"); + + ui.style_mut().wrap_mode = Some(egui::TextWrapMode::Truncate); + + list_item_scope(ui, "pr_info", |ui| { + for commit in data.commits.iter().rev() { + let item = ui.list_item(); + + let button = match &commit.status.state { + StatusState::Failure | StatusState::Error => Button::image( + icons::ERROR.as_image().tint(ui.tokens().alert_error.icon), + ) + .boxed_local(), + StatusState::Pending => Spinner::new().boxed_local(), + StatusState::Success => Button::image( + icons::SUCCESS + .as_image() + .tint(ui.tokens().alert_success.icon), + ) + .boxed_local(), + _ => Button::image(icons::HELP.as_image()).boxed_local(), + }; + + let button = button.on_menu(|ui| { + ui.set_min_width(250.0); + match &commit.artifacts { + None => { + pr.inbox + .sender() + .send(GithubPrCommand::FetchCommitArtifacts { + sha: commit.commit.sha.clone(), + }) + .ok(); + } + Some(Poll::Pending) => { + ui.spinner(); + } + Some(Poll::Ready(Err(error))) => { + ui.colored_label( + ui.visuals().error_fg_color, + format!("Error: {}", error), + ); + } + Some(Poll::Ready(Ok(artifacts))) => { + if artifacts.is_empty() { + ui.label("No artifacts found"); + } else { + for artifact in artifacts { + // let label = format!( + // "{} (from run: {})", + // artifact.artifact.name, artifact.run.name + // ); + + if ui.button(&artifact.artifact.name).clicked() { + selected_source = Some(DiffSource::GHArtifact { + repo: pr.link.repo.clone(), + artifact_id: artifact.artifact.id.to_string(), + }); + } + } + } + } + } + }); + + let content = LabelContent::new(&commit.commit.commit.message) + .with_button(button) + .with_always_show_buttons(true); + + let response = item.show_hierarchical(ui, content); + } + }); + } + Poll::Ready(Err(error)) => { + ui.colored_label(ui.visuals().error_fg_color, format!("Error: {}", error)); + } + Poll::Pending => { + ui.spinner(); + } + } + }); + + if let Some(source) = selected_source { + state.send(SystemCommand::Open(source)); + } } diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index 2c13f60..d6d9a44 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -1,6 +1,7 @@ use crate::snapshot::Snapshot; use eframe::egui; use std::task::Poll; +use crate::state::AppStateRef; pub mod tar_loader; pub mod zip_loader; @@ -14,7 +15,7 @@ pub trait LoadSnapshots { /// State is separate so that snapshots can be streamed in fn state(&self) -> Poll>; - fn extra_ui(&mut self, ui: &mut egui::Ui) {} + fn extra_ui(&self, ui: &mut egui::Ui, state: &AppStateRef<'_>) {} } pub type SnapshotLoader = Box; \ No newline at end of file diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs index 9626287..617a98a 100644 --- a/src/loaders/pr_loader.rs +++ b/src/loaders/pr_loader.rs @@ -1,9 +1,10 @@ use crate::github_model::{GithubPrLink, GithubRepoLink}; +use crate::github_pr::{pr_ui, GithubPr}; use crate::loaders::{LoadSnapshots, SnapshotLoader}; use crate::octokit::RepoClient; use crate::snapshot::{FileReference, Snapshot}; use anyhow::Error; -use eframe::egui::Context; +use eframe::egui::{Context, Ui}; use egui_inbox::{UiInbox, UiInboxSender}; use futures::StreamExt; use octocrab::Octocrab; @@ -12,18 +13,20 @@ use std::ops::Deref; use std::path::Path; use std::pin::pin; use std::task::Poll; +use crate::state::AppStateRef; pub struct PrLoader { snapshots: Vec, inbox: UiInbox>, loading: bool, link: GithubPrLink, + pr_info: GithubPr, } impl PrLoader { pub fn new(link: GithubPrLink, client: Octocrab) -> Self { let mut inbox = UiInbox::new(); - let repo_client = RepoClient::new(client, link.repo.clone()); + let repo_client = RepoClient::new(client.clone(), link.repo.clone()); inbox.spawn(|tx| async move { let result = stream_files(repo_client, link.pr_number, tx).await; @@ -36,6 +39,7 @@ impl PrLoader { snapshots: Vec::new(), inbox, loading: true, + pr_info: GithubPr::new(link.clone(), client), link, } } @@ -87,7 +91,6 @@ async fn stream_files( new: new_url.map(|url| FileReference::Source(url.into())), diff: None, }; - dbg!(&snapshot); sender.send(Some(snapshot)).ok(); } } @@ -112,6 +115,7 @@ impl LoadSnapshots for PrLoader { None => self.loading = false, } } + self.pr_info.update(ctx); } fn snapshots(&self) -> &[Snapshot] { @@ -125,4 +129,8 @@ impl LoadSnapshots for PrLoader { Poll::Ready(Ok(())) } } + + fn extra_ui(&self, ui: &mut Ui, state: &AppStateRef<'_>) { + pr_ui(ui, state, &self.pr_info); + } } diff --git a/src/state.rs b/src/state.rs index e815235..50a160c 100644 --- a/src/state.rs +++ b/src/state.rs @@ -222,7 +222,7 @@ impl AppState { SystemCommand::LoadPrDetails(url) => { self.github_pr = Some(GithubPr::new( url, - self.github_auth.get_token().map(ToString::to_string), + self.github_auth.client(), )); } SystemCommand::UpdateSettings(settings) => { diff --git a/src/viewer/file_tree.rs b/src/viewer/file_tree.rs index 92b69be..349bf56 100644 --- a/src/viewer/file_tree.rs +++ b/src/viewer/file_tree.rs @@ -8,6 +8,8 @@ use std::collections::BTreeMap; pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { ui.style_mut().wrap_mode = Some(egui::TextWrapMode::Truncate); + state.loader.extra_ui(ui, state.app); + let mut filter = state.filter.clone(); TextEdit::singleline(&mut filter) .hint_text("Filter") From f935fdd8f49448c180aea9c4b97d6b09a7d82fe7 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Thu, 25 Sep 2025 13:14:54 +0200 Subject: [PATCH 05/25] Use graphql to speed things up --- .gitignore | 2 + Cargo.lock | 179 +- Cargo.toml | 2 + github.graphql | 30577 +++++++++++++++++++++++++++++++++++++ graphql.config.yml | 11 + src/github_pr.graphql | 41 + src/github_pr.rs | 449 +- src/loaders/pr_loader.rs | 9 +- src/viewer/file_tree.rs | 4 +- src/viewer/mod.rs | 1 - 10 files changed, 31012 insertions(+), 263 deletions(-) create mode 100644 github.graphql create mode 100644 graphql.config.yml create mode 100644 src/github_pr.graphql diff --git a/.gitignore b/.gitignore index 54ace48..a487503 100644 --- a/.gitignore +++ b/.gitignore @@ -11,3 +11,5 @@ target_wasm # https://github.com/lycheeverse/lychee .lycheecache + +.env diff --git a/Cargo.lock b/Cargo.lock index 6bdf1a3..a84cfe0 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -295,7 +295,7 @@ checksum = "0ae92a5119aa49cdbcf6b9f893fe4e1d98b04ccbf82ee0584ad948a44a734dea" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -586,7 +586,7 @@ checksum = "3b43422f69d8ff38f95f1b2bb76517c91589a924d1559a0e935d7c8ce0274c11" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -621,7 +621,7 @@ checksum = "9035ad2d096bed7955a320ee7e2230574d28fd3c3a0f186cbea1ff3c7eed5dbb" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -872,7 +872,7 @@ checksum = "4f154e572231cb6ba2bd1176980827e3d5dc04cc183a75dea38109fbdd672d29" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1042,10 +1042,10 @@ version = "4.5.47" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bbfd7eae0b0f1a6e63d4b13c9c478de77c2eb546fba158ad50b4203dc24b9f9c" dependencies = [ - "heck", + "heck 0.5.0", "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1136,7 +1136,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "f76990911f2267d837d9d0ad060aa63aaad170af40904b29461734c339030d4d" dependencies = [ "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1369,7 +1369,7 @@ checksum = "1e567bd82dcff979e4b03460c307b3cdc9e96fde3d73bed1496d2bc75d9dd62a" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1419,7 +1419,7 @@ checksum = "97369cbbc041bc366949bc74d34658d6cda5621039731c6310521892a3a20ae0" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1709,7 +1709,7 @@ checksum = "f282cfdfe92516eb26c2af8589c274c7c17681f5ecc03c18255fe741c6aa64eb" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1730,7 +1730,7 @@ checksum = "67c78a4d8fdf9953a5c9d458f9efe940fd97a0cab0941c075a813ac594733827" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1741,7 +1741,7 @@ checksum = "2f9ed6b3789237c8a0c1c505af1c7eb2c560df6186f01b098c3a1064ea532f38" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1808,7 +1808,7 @@ checksum = "44f23cf4b44bfce11a86ace86f8a73ffdec849c9fd00a386a53d278bd9e81fb3" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -1901,7 +1901,7 @@ checksum = "a0aca10fb742cb43f9e7bb8467c91aa9bcb8e3ffbc6a6f7389bb93ffc920577d" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -2010,7 +2010,7 @@ checksum = "1a5c6c585bc94aaf2c7b51dd4c2ba22680844aba4c687be581871a6f518c5742" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -2112,7 +2112,7 @@ checksum = "162ee34ebcb7c64a8abebc059ce0fee27c2262618d7b60ed8faf72fef13c3650" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -2391,6 +2391,64 @@ dependencies = [ "bitflags 2.9.4", ] +[[package]] +name = "graphql-introspection-query" +version = "0.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7f2a4732cf5140bd6c082434494f785a19cfb566ab07d1382c3671f5812fed6d" +dependencies = [ + "serde", +] + +[[package]] +name = "graphql-parser" +version = "0.4.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7a818c0d883d7c0801df27be910917750932be279c7bc82dc541b8769425f409" +dependencies = [ + "combine", + "thiserror 1.0.69", +] + +[[package]] +name = "graphql_client" +version = "0.14.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a50cfdc7f34b7f01909d55c2dcb71d4c13cbcbb4a1605d6c8bd760d654c1144b" +dependencies = [ + "graphql_query_derive", + "serde", + "serde_json", +] + +[[package]] +name = "graphql_client_codegen" +version = "0.14.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5e27ed0c2cf0c0cc52c6bcf3b45c907f433015e580879d14005386251842fb0a" +dependencies = [ + "graphql-introspection-query", + "graphql-parser", + "heck 0.4.1", + "lazy_static", + "proc-macro2", + "quote", + "serde", + "serde_json", + "syn 1.0.109", +] + +[[package]] +name = "graphql_query_derive" +version = "0.14.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "83febfa838f898cfa73dfaa7a8eb69ff3409021ac06ee94cfb3d622f6eeb1a97" +dependencies = [ + "graphql_client_codegen", + "proc-macro2", + "syn 1.0.109", +] + [[package]] name = "h2" version = "0.4.12" @@ -2437,6 +2495,12 @@ version = "0.16.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5419bdc4f6a9207fbeba6d11b604d481addf78ecd10c11ad51e76c2f6482748d" +[[package]] +name = "heck" +version = "0.4.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8" + [[package]] name = "heck" version = "0.5.0" @@ -2861,7 +2925,7 @@ checksum = "c34819042dc3d3971c46c2190835914dfbe0c3c13f61449b2997f4e9722dfa60" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -2955,7 +3019,7 @@ checksum = "03343451ff899767262ec32146f6d559dd759fdadf42ff0e227c7c48f72594b4" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -3064,6 +3128,7 @@ dependencies = [ "futures", "getrandom 0.3.3", "git2", + "graphql_client", "ignore", "image", "js-sys", @@ -3074,6 +3139,7 @@ dependencies = [ "serde_json", "tar", "tempfile", + "thiserror 1.0.69", "tokio", "wasm-bindgen", "wasm-bindgen-futures", @@ -3653,7 +3719,7 @@ checksum = "ed3955f1a9c7c0c15e092f9c887db08b1fc683305fdf6eb6684f22555355e202" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -3716,7 +3782,7 @@ dependencies = [ "proc-macro-crate", "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -4149,7 +4215,7 @@ checksum = "a948666b637a0f465e8564c73e89d4dde00d72d4d473cc972f390fc3dcee7d9c" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -4288,7 +4354,7 @@ dependencies = [ "phf_shared", "proc-macro2", "quote", - "syn", + "syn 2.0.106", "unicase", ] @@ -4325,7 +4391,7 @@ checksum = "6e918e4ff8c4549eb882f14b3a4bc8c8bc93de829416eacf579f1207a8fbf861" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -4482,7 +4548,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "52717f9a02b6965224f95ca2a81e2e0c5c43baacd28ca057577988930b6c3d5b" dependencies = [ "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -4505,7 +4571,7 @@ dependencies = [ "itertools 0.14.0", "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -5568,7 +5634,7 @@ checksum = "8db53ae22f34573731bafa1db20f04027b2d25e02d8205921b569171699cdb33" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -5603,7 +5669,7 @@ checksum = "175ee3e80ae9982737ca543e96133087cbd9a485eecc3bc4de9c1a37b47ea59c" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -5776,10 +5842,10 @@ version = "0.8.9" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "c1c97747dbf44bb1ca44a561ece23508e99cb592e862f22222dcf42f51d1e451" dependencies = [ - "heck", + "heck 0.5.0", "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -5853,11 +5919,11 @@ version = "0.26.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "4c6bee85a5a24955dc440386795aa378cd9cf82acd5f764469152d2270e581be" dependencies = [ - "heck", + "heck 0.5.0", "proc-macro2", "quote", "rustversion", - "syn", + "syn 2.0.106", ] [[package]] @@ -5882,6 +5948,17 @@ dependencies = [ "siphasher", ] +[[package]] +name = "syn" +version = "1.0.109" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237" +dependencies = [ + "proc-macro2", + "quote", + "unicode-ident", +] + [[package]] name = "syn" version = "2.0.106" @@ -5910,7 +5987,7 @@ checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -5941,7 +6018,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a3e535eb8dded36d55ec13eddacd30dec501792ff23a0b1682c38601b8cf2349" dependencies = [ "cfg-expr", - "heck", + "heck 0.5.0", "pkg-config", "toml", "version-compare", @@ -6018,7 +6095,7 @@ checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -6029,7 +6106,7 @@ checksum = "6c5e1be1c48b9172ee610da68fd9cd2770e7a4056cb3fc98710ee6906f0c7960" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -6150,7 +6227,7 @@ checksum = "6e06d43f1345a3bcd39f6a56dbb7dcab2ba47e68e8ac134855e7e2bdbaf8cab8" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -6359,7 +6436,7 @@ checksum = "81383ab64e72a7a8b8e13130c49e3dab29def6d0c7d76a03087b3cf71c5c6903" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -6620,7 +6697,7 @@ dependencies = [ "log", "proc-macro2", "quote", - "syn", + "syn 2.0.106", "wasm-bindgen-shared", ] @@ -6655,7 +6732,7 @@ checksum = "9f07d2f20d4da7b26400c9f4a0511e6e0345b040694e8a75bd41d578fa4421d7" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", "wasm-bindgen-backend", "wasm-bindgen-shared", ] @@ -7107,7 +7184,7 @@ checksum = "2bbd5b46c938e506ecbce286b6628a02171d56153ba733b6c741fc627ec9579b" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -7118,7 +7195,7 @@ checksum = "a47fddd13af08290e67f4acabf4b459f647552718f683a7b415d290ac744a836" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -7129,7 +7206,7 @@ checksum = "053c4c462dc91d3b1504c6fe5a726dd15e216ba718e84a0e46a88fbe5ded3515" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -7140,7 +7217,7 @@ checksum = "bd9211b69f8dcdfa817bfd14bf1c97c9188afa36f4750130fcdf3f400eca9fa8" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -7643,7 +7720,7 @@ checksum = "38da3c9736e16c5d3c8c597a9aaa5d1fa565d0532ae05e27c24aa62fb32c0ab6" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", "synstructure", ] @@ -7698,7 +7775,7 @@ checksum = "dc6821851fa840b708b4cbbaf6241868cabc85a2dc22f426361b0292bfc0b836" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", "zbus-lockstep", "zbus_xml", "zvariant", @@ -7713,7 +7790,7 @@ dependencies = [ "proc-macro-crate", "proc-macro2", "quote", - "syn", + "syn 2.0.106", "zbus_names", "zvariant", "zvariant_utils", @@ -7761,7 +7838,7 @@ checksum = "88d2b8d9c68ad2b9e4340d7832716a4d21a22a1154777ad56ea55c51a9cf3831" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -7781,7 +7858,7 @@ checksum = "d71e5d6e06ab090c67b5e44993ec16b72dcbaabc526db883a360057678b48502" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", "synstructure", ] @@ -7821,7 +7898,7 @@ checksum = "5b96237efa0c878c64bd89c436f661be4e46b2f3eff1ebb976f7ef2321d2f58f" dependencies = [ "proc-macro2", "quote", - "syn", + "syn 2.0.106", ] [[package]] @@ -7903,7 +7980,7 @@ dependencies = [ "proc-macro-crate", "proc-macro2", "quote", - "syn", + "syn 2.0.106", "zvariant_utils", ] @@ -7916,6 +7993,6 @@ dependencies = [ "proc-macro2", "quote", "serde", - "syn", + "syn 2.0.106", "winnow", ] diff --git a/Cargo.toml b/Cargo.toml index 60e4feb..1f4c41e 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -37,6 +37,8 @@ futures = "0.3" re_ui = "0.26.0-alpha.1+dev" getrandom = { version = "0.3", features = ["wasm_js"] } anyhow = "1.0.99" +graphql_client = "0.14.0" +thiserror = "1.0.69" # native: [target.'cfg(not(target_arch = "wasm32"))'.dependencies] diff --git a/github.graphql b/github.graphql new file mode 100644 index 0000000..749dee2 --- /dev/null +++ b/github.graphql @@ -0,0 +1,30577 @@ +# This file was generated. Do not edit manually. + +schema { + query: Query + mutation: Mutation +} + +"Requires that exactly one field must be supplied and that field must not be `null`." +directive @oneOf on INPUT_OBJECT + +"Represents an object which can take actions on GitHub. Typically a User or Bot." +interface Actor { + "A URL pointing to the actor's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "The username of the actor." + login: String! + "The HTTP path for this actor." + resourcePath: URI! + "The HTTP URL for this actor." + url: URI! +} + +"An object that can have users assigned to it." +interface Assignable { + "A list of actors assigned to this object." + assignedActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): AssigneeConnection! + "A list of Users assigned to this object." + assignees( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "A list of suggested actors to assign to this object" + suggestedActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "If provided, searches users by login or profile name" + query: String + ): AssigneeConnection! +} + +"An entry in the audit log." +interface AuditEntry { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"An object that can be closed" +interface Closable { + "Indicates if the object is closed (definition of closed may depend on type)" + closed: Boolean! + "Identifies the date and time when the object was closed." + closedAt: DateTime + "Indicates if the object can be closed by the viewer." + viewerCanClose: Boolean! + "Indicates if the object can be reopened by the viewer." + viewerCanReopen: Boolean! +} + +"Represents a comment." +interface Comment { + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "The body as Markdown." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "The actor who edited the comment." + editor: Actor + "The Node ID of the Comment object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Identifies when the comment was published at." + publishedAt: DateTime + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Did the viewer author this comment." + viewerDidAuthor: Boolean! +} + +"Represents a contribution a user made on GitHub, such as opening an issue." +interface Contribution { + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "When this contribution was made." + occurredAt: DateTime! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"Entities that can be deleted." +interface Deletable { + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! +} + +"Metadata for an audit entry containing enterprise account information." +interface EnterpriseAuditEntryData { + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI +} + +"Represents a Git object." +interface GitObject { + "An abbreviated version of the Git object ID" + abbreviatedOid: String! + "The HTTP path for this Git object" + commitResourcePath: URI! + "The HTTP URL for this Git object" + commitUrl: URI! + "The Node ID of the GitObject object" + id: ID! + "The Git object ID" + oid: GitObjectID! + "The Repository the Git object belongs to" + repository: Repository! +} + +"Information about a signature (GPG or S/MIME) on a Commit or Tag." +interface GitSignature { + "Email used to sign this object." + email: String! + "True if the signature is valid and verified by GitHub." + isValid: Boolean! + "Payload for GPG signing object. Raw ODB object without the signature header." + payload: String! + "ASCII-armored signature header from object." + signature: String! + "GitHub user corresponding to the email signing this commit." + signer: User + "The state of this signature. `VALID` if signature is valid and verified by GitHub, otherwise represents reason why signature is considered invalid." + state: GitSignatureState! + "The date the signature was verified, if valid" + verifiedAt: DateTime + "True if the signature was made with GitHub's signing key." + wasSignedByGitHub: Boolean! +} + +"An individual line of a hovercard" +interface HovercardContext { + "A string describing this context" + message: String! + "An octicon to accompany this context" + octicon: String! +} + +"An object that can have labels assigned to it." +interface Labelable { + "A list of labels associated with the object." + labels( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for labels returned from the connection." + orderBy: LabelOrder = {field: CREATED_AT, direction: ASC} + ): LabelConnection + "Indicates if the viewer can edit labels for this object." + viewerCanLabel: Boolean! +} + +"An object that can be locked." +interface Lockable { + "Reason that the conversation was locked." + activeLockReason: LockReason + "`true` if the object is locked" + locked: Boolean! +} + +"Entities that have members who can set status messages." +interface MemberStatusable { + "Get the status messages members of this entity have set that are either public or visible only to the organization." + memberStatuses( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for user statuses returned from the connection." + orderBy: UserStatusOrder = {field: UPDATED_AT, direction: DESC} + ): UserStatusConnection! +} + +"Represents a GitHub Enterprise Importer (GEI) migration." +interface Migration { + "The migration flag to continue on error." + continueOnError: Boolean! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: String + "The reason the migration failed." + failureReason: String + "The Node ID of the Migration object" + id: ID! + "The URL for the migration log (expires 1 day after migration completes)." + migrationLogUrl: URI + "The migration source." + migrationSource: MigrationSource! + "The target repository name." + repositoryName: String! + "The migration source URL, for example `https://github.com` or `https://monalisa.ghe.com`." + sourceUrl: URI! + "The migration state." + state: MigrationState! + "The number of warnings encountered for this migration. To review the warnings, check the [Migration Log](https://docs.github.com/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer)." + warningsCount: Int! +} + +"Entities that can be minimized." +interface Minimizable { + "Returns whether or not a comment has been minimized." + isMinimized: Boolean! + "Returns why the comment was minimized. One of `abuse`, `off-topic`, `outdated`, `resolved`, `duplicate` and `spam`. Note that the case and formatting of these values differs from the inputs to the `MinimizeComment` mutation." + minimizedReason: String + "Check if the current viewer can minimize this object." + viewerCanMinimize: Boolean! + "Check if the current viewer can unminimize this object." + viewerCanUnminimize: Boolean! +} + +"An object with an ID." +interface Node { + "ID of the object." + id: ID! +} + +"Metadata for an audit entry with action oauth_application.*" +interface OauthApplicationAuditEntryData { + "The name of the OAuth application." + oauthApplicationName: String + "The HTTP path for the OAuth application" + oauthApplicationResourcePath: URI + "The HTTP URL for the OAuth application" + oauthApplicationUrl: URI +} + +"Metadata for an audit entry with action org.*" +interface OrganizationAuditEntryData { + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Represents an owner of a package." +interface PackageOwner { + "The Node ID of the PackageOwner object" + id: ID! + "A list of packages under the owner." + packages( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Find packages by their names." + names: [String], + "Ordering of the returned packages." + orderBy: PackageOrder = {field: CREATED_AT, direction: DESC}, + "Filter registry package by type." + packageType: PackageType, + "Find packages in a repository by ID." + repositoryId: ID + ): PackageConnection! +} + +"Represents any entity on GitHub that has a profile page." +interface ProfileOwner { + "Determine if this repository owner has any items that can be pinned to their profile." + anyPinnableItems( + "Filter to only a particular kind of pinnable item." + type: PinnableItemType + ): Boolean! + "The public profile email." + email: String + "The Node ID of the ProfileOwner object" + id: ID! + "Showcases a selection of repositories and gists that the profile owner has either curated or that have been selected automatically based on popularity." + itemShowcase: ProfileItemShowcase! + "The public profile location." + location: String + "The username used to login." + login: String! + "The public profile name." + name: String + "A list of repositories and gists this profile owner can pin to their profile." + pinnableItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter the types of pinnable items that are returned." + types: [PinnableItemType!] + ): PinnableItemConnection! + "A list of repositories and gists this profile owner has pinned to their profile" + pinnedItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter the types of pinned items that are returned." + types: [PinnableItemType!] + ): PinnableItemConnection! + "Returns how many more items this profile owner can pin to their profile." + pinnedItemsRemaining: Int! + "Can the viewer pin repositories and gists to the profile?" + viewerCanChangePinnedItems: Boolean! + "The public profile website URL." + websiteUrl: URI +} + +"Represents an owner of a Project." +interface ProjectOwner { + "The Node ID of the ProjectOwner object" + id: ID! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Find project by number." + project( + "The project number to find." + number: Int! + ): Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "A list of projects under the owner." + projects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for projects returned from the connection" + orderBy: ProjectOrder, + "Query to search projects by, currently only searching by name." + search: String, + "A list of states to filter the projects by." + states: [ProjectState!] + ): ProjectConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP path listing owners projects" + projectsResourcePath: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP URL listing owners projects" + projectsUrl: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Can the current viewer create new projects on this owner." + viewerCanCreateProjects: Boolean! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"Common fields across different project field types" +interface ProjectV2FieldCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The field's type." + dataType: ProjectV2FieldType! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the ProjectV2FieldCommon object" + id: ID! + "The project field's name." + name: String! + "The project that contains this field." + project: ProjectV2! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"Common fields across different project field value types" +interface ProjectV2ItemFieldValueCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the item." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int + "The project field that contains this value." + field: ProjectV2FieldConfiguration! + "The Node ID of the ProjectV2ItemFieldValueCommon object" + id: ID! + "The project item that contains this value." + item: ProjectV2Item! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"Represents an owner of a project." +interface ProjectV2Owner { + "The Node ID of the ProjectV2Owner object" + id: ID! + "Find a project by number." + projectV2( + "The project number." + number: Int! + ): ProjectV2 + "A list of projects under the owner." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter projects based on user role." + minPermissionLevel: ProjectV2PermissionLevel = READ, + "How to order the returned projects." + orderBy: ProjectV2Order = {field: NUMBER, direction: DESC}, + "A project to search for under the owner." + query: String + ): ProjectV2Connection! +} + +"Recent projects for the owner." +interface ProjectV2Recent { + "Recent projects that this user has modified in the context of the owner." + recentProjects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2Connection! +} + +"Represents a subject that can be reacted on." +interface Reactable { + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the Reactable object" + id: ID! + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "Can user react to this subject" + viewerCanReact: Boolean! +} + +"Metadata for an audit entry with action repo.*" +interface RepositoryAuditEntryData { + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI +} + +"Represents an author of discussions in repositories." +interface RepositoryDiscussionAuthor { + "Discussions this user has started." + repositoryDiscussions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Filter discussions to only those that have been answered or not. Defaults to including both answered and unanswered discussions." + answered: Boolean, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for discussions returned from the connection." + orderBy: DiscussionOrder = {field: CREATED_AT, direction: DESC}, + "Filter discussions to only those in a specific repository." + repositoryId: ID, + "A list of states to filter the discussions by." + states: [DiscussionState!] = [] + ): DiscussionConnection! +} + +"Represents an author of discussion comments in repositories." +interface RepositoryDiscussionCommentAuthor { + "Discussion comments this user has authored." + repositoryDiscussionComments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter discussion comments to only those that were marked as the answer" + onlyAnswers: Boolean = false, + "Filter discussion comments to only those in a specific repository." + repositoryId: ID + ): DiscussionCommentConnection! +} + +"A subset of repository info." +interface RepositoryInfo { + "Identifies the date and time when the repository was archived." + archivedAt: DateTime + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The description of the repository." + description: String + "The description of the repository rendered to HTML." + descriptionHTML: HTML! + "Returns how many forks there are of this repository in the whole network." + forkCount: Int! + "Indicates if the repository has the Discussions feature enabled." + hasDiscussionsEnabled: Boolean! + "Indicates if the repository has issues feature enabled." + hasIssuesEnabled: Boolean! + "Indicates if the repository has the Projects feature enabled." + hasProjectsEnabled: Boolean! + "Indicates if the repository displays a Sponsor button for financial contributions." + hasSponsorshipsEnabled: Boolean! + "Indicates if the repository has wiki feature enabled." + hasWikiEnabled: Boolean! + "The repository's URL." + homepageUrl: URI + "Indicates if the repository is unmaintained." + isArchived: Boolean! + "Identifies if the repository is a fork." + isFork: Boolean! + "Indicates if a repository is either owned by an organization, or is a private fork of an organization repository." + isInOrganization: Boolean! + "Indicates if the repository has been locked or not." + isLocked: Boolean! + "Identifies if the repository is a mirror." + isMirror: Boolean! + "Identifies if the repository is private or internal." + isPrivate: Boolean! + "Identifies if the repository is a template that can be used to generate new repositories." + isTemplate: Boolean! + "The license associated with the repository" + licenseInfo: License + "The reason the repository has been locked." + lockReason: RepositoryLockReason + "The repository's original mirror URL." + mirrorUrl: URI + "The name of the repository." + name: String! + "The repository's name with owner." + nameWithOwner: String! + "The image used to represent this repository in Open Graph data." + openGraphImageUrl: URI! + "The User owner of the repository." + owner: RepositoryOwner! + "Identifies the date and time when the repository was last pushed to." + pushedAt: DateTime + "The HTTP path for this repository" + resourcePath: URI! + "A description of the repository, rendered to HTML without any links in it." + shortDescriptionHTML( + "How many characters to return." + limit: Int = 200 + ): HTML! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this repository" + url: URI! + "Whether this repository has a custom image to use with Open Graph as opposed to being represented by the owner's avatar." + usesCustomOpenGraphImage: Boolean! + "Indicates the repository's visibility level." + visibility: RepositoryVisibility! +} + +"Represents a object that belongs to a repository." +interface RepositoryNode { + "The repository associated with this node." + repository: Repository! +} + +"Represents an owner of a Repository." +interface RepositoryOwner { + "A URL pointing to the owner's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "The Node ID of the RepositoryOwner object" + id: ID! + "The username used to login." + login: String! + "A list of repositories that the user owns." + repositories( + "Array of viewer's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the current viewer owns." + affiliations: [RepositoryAffiliation], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "If non-null, filters repositories according to whether they have issues enabled" + hasIssuesEnabled: Boolean, + "If non-null, filters repositories according to whether they are archived and not maintained" + isArchived: Boolean, + "If non-null, filters repositories according to whether they are forks of another repository" + isFork: Boolean, + "If non-null, filters repositories according to whether they have been locked" + isLocked: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder, + "Array of owner's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the organization or user being viewed owns." + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR], + "If non-null, filters repositories according to privacy. Internal repositories are considered private; consider using the visibility argument if only internal repositories are needed. Cannot be combined with the visibility argument." + privacy: RepositoryPrivacy, + "If non-null, filters repositories according to visibility. Cannot be combined with the privacy argument." + visibility: RepositoryVisibility + ): RepositoryConnection! + "Find Repository." + repository( + "Follow repository renames. If disabled, a repository referenced by its old name will return an error." + followRenames: Boolean = true, + "Name of Repository to find." + name: String! + ): Repository + "The HTTP URL for the owner." + resourcePath: URI! + "The HTTP URL for the owner." + url: URI! +} + +"Represents a type that can be required by a pull request for merging." +interface RequirableByPullRequest { + "Whether this is required to pass before merging for a specific pull request." + isRequired( + "The id of the pull request this is required for" + pullRequestId: ID, + "The number of the pull request this is required for" + pullRequestNumber: Int + ): Boolean! +} + +"Entities that can sponsor or be sponsored through GitHub Sponsors." +interface Sponsorable { + "The estimated next GitHub Sponsors payout for this user/organization in cents (USD)." + estimatedNextSponsorsPayoutInCents: Int! + "True if this user/organization has a GitHub Sponsors listing." + hasSponsorsListing: Boolean! + "Whether the given account is sponsoring this user/organization." + isSponsoredBy( + "The target account's login." + accountLogin: String! + ): Boolean! + "True if the viewer is sponsored by this user/organization." + isSponsoringViewer: Boolean! + "Calculate how much each sponsor has ever paid total to this maintainer via GitHub Sponsors. Does not include sponsorships paid via Patreon." + lifetimeReceivedSponsorshipValues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for results returned from the connection." + orderBy: SponsorAndLifetimeValueOrder = {field: SPONSOR_LOGIN, direction: ASC} + ): SponsorAndLifetimeValueConnection! + "The estimated monthly GitHub Sponsors income for this user/organization in cents (USD)." + monthlyEstimatedSponsorsIncomeInCents: Int! + "List of users and organizations this entity is sponsoring." + sponsoring( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the users and organizations returned from the connection." + orderBy: SponsorOrder = {field: RELEVANCE, direction: DESC} + ): SponsorConnection! + "List of sponsors for this user or organization." + sponsors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsors returned from the connection." + orderBy: SponsorOrder = {field: RELEVANCE, direction: DESC}, + "If given, will filter for sponsors at the given tier. Will only return sponsors whose tier the viewer is permitted to see." + tierId: ID + ): SponsorConnection! + "Events involving this sponsorable, such as new sponsorships." + sponsorsActivities( + "Filter activities to only the specified actions." + actions: [SponsorsActivityAction!] = [], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether to include those events where this sponsorable acted as the sponsor. Defaults to only including events where this sponsorable was the recipient of a sponsorship." + includeAsSponsor: Boolean = false, + "Whether or not to include private activities in the result set. Defaults to including public and private activities." + includePrivate: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for activity returned from the connection." + orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}, + "Filter activities returned to only those that occurred in the most recent specified time period. Set to ALL to avoid filtering by when the activity occurred. Will be ignored if `since` or `until` is given." + period: SponsorsActivityPeriod = MONTH, + "Filter activities to those that occurred on or after this time." + since: DateTime, + "Filter activities to those that occurred before this time." + until: DateTime + ): SponsorsActivityConnection! + "The GitHub Sponsors listing for this user or organization." + sponsorsListing: SponsorsListing + "The sponsorship from the viewer to this user/organization; that is, the sponsorship where you're the sponsor." + sponsorshipForViewerAsSponsor( + "Whether to return the sponsorship only if it's still active. Pass false to get the viewer's sponsorship back even if it has been cancelled." + activeOnly: Boolean = true + ): Sponsorship + "The sponsorship from this user/organization to the viewer; that is, the sponsorship you're receiving." + sponsorshipForViewerAsSponsorable( + "Whether to return the sponsorship only if it's still active. Pass false to get the sponsorship back even if it has been cancelled." + activeOnly: Boolean = true + ): Sponsorship + "List of sponsorship updates sent from this sponsorable to sponsors." + sponsorshipNewsletters( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsorship updates returned from the connection." + orderBy: SponsorshipNewsletterOrder = {field: CREATED_AT, direction: DESC} + ): SponsorshipNewsletterConnection! + "The sponsorships where this user or organization is the maintainer receiving the funds." + sponsorshipsAsMaintainer( + "Whether to include only sponsorships that are active right now, versus all sponsorships this maintainer has ever received." + activeOnly: Boolean = true, + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether or not to include private sponsorships in the result set" + includePrivate: Boolean = false, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsorships returned from this connection. If left blank, the sponsorships will be ordered based on relevancy to the viewer." + orderBy: SponsorshipOrder + ): SponsorshipConnection! + "The sponsorships where this user or organization is the funder." + sponsorshipsAsSponsor( + "Whether to include only sponsorships that are active right now, versus all sponsorships this sponsor has ever made." + activeOnly: Boolean = true, + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter sponsorships returned to those for the specified maintainers. That is, the recipient of the sponsorship is a user or organization with one of the given logins." + maintainerLogins: [String!], + "Ordering options for sponsorships returned from this connection. If left blank, the sponsorships will be ordered based on relevancy to the viewer." + orderBy: SponsorshipOrder + ): SponsorshipConnection! + "The amount in United States cents (e.g., 500 = $5.00 USD) that this entity has spent on GitHub to fund sponsorships. Only returns a value when viewed by the user themselves or by a user who can manage sponsorships for the requested organization." + totalSponsorshipAmountAsSponsorInCents( + "Filter payments to those that occurred on or after this time." + since: DateTime, + "Filter payments to those made to the users or organizations with the specified usernames." + sponsorableLogins: [String!] = [], + "Filter payments to those that occurred before this time." + until: DateTime + ): Int + "Whether or not the viewer is able to sponsor this user/organization." + viewerCanSponsor: Boolean! + "True if the viewer is sponsoring this user/organization." + viewerIsSponsoring: Boolean! +} + +"Things that can be starred." +interface Starrable { + "The Node ID of the Starrable object" + id: ID! + """ + + Returns a count of how many stargazers there are on this object + """ + stargazerCount: Int! + "A list of users who have starred this starrable." + stargazers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: StarOrder + ): StargazerConnection! + "Returns a boolean indicating whether the viewing user has starred this starrable." + viewerHasStarred: Boolean! +} + +"Entities that can be subscribed to for web and email notifications." +interface Subscribable { + "The Node ID of the Subscribable object" + id: ID! + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState +} + +"Entities that can be subscribed to for web and email notifications." +interface SubscribableThread { + "The Node ID of the SubscribableThread object" + id: ID! + "Identifies the viewer's thread subscription form action." + viewerThreadSubscriptionFormAction: ThreadSubscriptionFormAction + "Identifies the viewer's thread subscription status." + viewerThreadSubscriptionStatus: ThreadSubscriptionState +} + +"Metadata for an audit entry with action team.*" +interface TeamAuditEntryData { + "The team associated with the action" + team: Team + "The name of the team" + teamName: String + "The HTTP path for this team" + teamResourcePath: URI + "The HTTP URL for this team" + teamUrl: URI +} + +"Metadata for an audit entry with a topic." +interface TopicAuditEntryData { + "The name of the topic added to the repository" + topic: Topic + "The name of the topic added to the repository" + topicName: String +} + +"Represents a type that can be retrieved by a URL." +interface UniformResourceLocatable { + "The HTML path to this resource." + resourcePath: URI! + "The URL to this resource." + url: URI! +} + +"Entities that can be updated." +interface Updatable { + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! +} + +"Comments that can be updated." +interface UpdatableComment { + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! +} + +"A subject that may be upvoted." +interface Votable { + "Number of upvotes that this subject has received." + upvoteCount: Int! + "Whether or not the current user can add or remove an upvote on this subject." + viewerCanUpvote: Boolean! + "Whether or not the current user has already upvoted this subject." + viewerHasUpvoted: Boolean! +} + +"Types that can be assigned to issues." +union Assignee = Bot | Mannequin | Organization | User + +"Types that can initiate an audit log event." +union AuditEntryActor = Bot | Organization | User + +"Types which can be actors for `BranchActorAllowance` objects." +union BranchActorAllowanceActor = App | Team | User + +"Types that can represent a repository ruleset bypass actor." +union BypassActor = App | Team + +"An object which can have its data claimed or claim data from another." +union Claimable = Mannequin | User + +"The object which triggered a `ClosedEvent`." +union Closer = Commit | ProjectV2 | PullRequest + +"Represents either a issue the viewer can access or a restricted contribution." +union CreatedIssueOrRestrictedContribution = CreatedIssueContribution | RestrictedContribution + +"Represents either a pull request the viewer can access or a restricted contribution." +union CreatedPullRequestOrRestrictedContribution = CreatedPullRequestContribution | RestrictedContribution + +"Represents either a repository the viewer can access or a restricted contribution." +union CreatedRepositoryOrRestrictedContribution = CreatedRepositoryContribution | RestrictedContribution + +"Users and teams." +union DeploymentReviewer = Team | User + +"An object that is a member of an enterprise." +union EnterpriseMember = EnterpriseUserAccount | User + +"Types that can own an IP allow list." +union IpAllowListOwner = App | Enterprise | Organization + +"Used for return value of Repository.issueOrPullRequest." +union IssueOrPullRequest = Issue | PullRequest + +"An item in an issue timeline" +union IssueTimelineItem = AssignedEvent | ClosedEvent | Commit | CrossReferencedEvent | DemilestonedEvent | IssueComment | LabeledEvent | LockedEvent | MilestonedEvent | ReferencedEvent | RenamedTitleEvent | ReopenedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnsubscribedEvent | UserBlockedEvent + +"An item in an issue timeline" +union IssueTimelineItems = AddedToProjectEvent | AssignedEvent | BlockedByAddedEvent | BlockedByRemovedEvent | BlockingAddedEvent | BlockingRemovedEvent | ClosedEvent | CommentDeletedEvent | ConnectedEvent | ConvertedNoteToIssueEvent | ConvertedToDiscussionEvent | CrossReferencedEvent | DemilestonedEvent | DisconnectedEvent | IssueComment | IssueTypeAddedEvent | IssueTypeChangedEvent | IssueTypeRemovedEvent | LabeledEvent | LockedEvent | MarkedAsDuplicateEvent | MentionedEvent | MilestonedEvent | MovedColumnsInProjectEvent | ParentIssueAddedEvent | ParentIssueRemovedEvent | PinnedEvent | ReferencedEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | SubIssueAddedEvent | SubIssueRemovedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnmarkedAsDuplicateEvent | UnpinnedEvent | UnsubscribedEvent | UserBlockedEvent + +"Types that can be inside a Milestone." +union MilestoneItem = Issue | PullRequest + +"Types of memberships that can be restored for an Organization member." +union OrgRestoreMemberAuditEntryMembership = OrgRestoreMemberMembershipOrganizationAuditEntryData | OrgRestoreMemberMembershipRepositoryAuditEntryData | OrgRestoreMemberMembershipTeamAuditEntryData + +"An audit entry in an organization audit log." +union OrganizationAuditEntry = MembersCanDeleteReposClearAuditEntry | MembersCanDeleteReposDisableAuditEntry | MembersCanDeleteReposEnableAuditEntry | OauthApplicationCreateAuditEntry | OrgAddBillingManagerAuditEntry | OrgAddMemberAuditEntry | OrgBlockUserAuditEntry | OrgConfigDisableCollaboratorsOnlyAuditEntry | OrgConfigEnableCollaboratorsOnlyAuditEntry | OrgCreateAuditEntry | OrgDisableOauthAppRestrictionsAuditEntry | OrgDisableSamlAuditEntry | OrgDisableTwoFactorRequirementAuditEntry | OrgEnableOauthAppRestrictionsAuditEntry | OrgEnableSamlAuditEntry | OrgEnableTwoFactorRequirementAuditEntry | OrgInviteMemberAuditEntry | OrgInviteToBusinessAuditEntry | OrgOauthAppAccessApprovedAuditEntry | OrgOauthAppAccessBlockedAuditEntry | OrgOauthAppAccessDeniedAuditEntry | OrgOauthAppAccessRequestedAuditEntry | OrgOauthAppAccessUnblockedAuditEntry | OrgRemoveBillingManagerAuditEntry | OrgRemoveMemberAuditEntry | OrgRemoveOutsideCollaboratorAuditEntry | OrgRestoreMemberAuditEntry | OrgUnblockUserAuditEntry | OrgUpdateDefaultRepositoryPermissionAuditEntry | OrgUpdateMemberAuditEntry | OrgUpdateMemberRepositoryCreationPermissionAuditEntry | OrgUpdateMemberRepositoryInvitationPermissionAuditEntry | PrivateRepositoryForkingDisableAuditEntry | PrivateRepositoryForkingEnableAuditEntry | RepoAccessAuditEntry | RepoAddMemberAuditEntry | RepoAddTopicAuditEntry | RepoArchivedAuditEntry | RepoChangeMergeSettingAuditEntry | RepoConfigDisableAnonymousGitAccessAuditEntry | RepoConfigDisableCollaboratorsOnlyAuditEntry | RepoConfigDisableContributorsOnlyAuditEntry | RepoConfigDisableSockpuppetDisallowedAuditEntry | RepoConfigEnableAnonymousGitAccessAuditEntry | RepoConfigEnableCollaboratorsOnlyAuditEntry | RepoConfigEnableContributorsOnlyAuditEntry | RepoConfigEnableSockpuppetDisallowedAuditEntry | RepoConfigLockAnonymousGitAccessAuditEntry | RepoConfigUnlockAnonymousGitAccessAuditEntry | RepoCreateAuditEntry | RepoDestroyAuditEntry | RepoRemoveMemberAuditEntry | RepoRemoveTopicAuditEntry | RepositoryVisibilityChangeDisableAuditEntry | RepositoryVisibilityChangeEnableAuditEntry | TeamAddMemberAuditEntry | TeamAddRepositoryAuditEntry | TeamChangeParentTeamAuditEntry | TeamRemoveMemberAuditEntry | TeamRemoveRepositoryAuditEntry + +"Used for argument of CreateProjectV2 mutation." +union OrganizationOrUser = Organization | User + +"Types that can grant permissions on a repository to a user" +union PermissionGranter = Organization | Repository | Team + +"Types that can be pinned to a profile page." +union PinnableItem = Gist | Repository + +"Types that can be inside Project Cards." +union ProjectCardItem = Issue | PullRequest + +"Possible collaborators for a project." +union ProjectV2Actor = Team | User + +"Configurations for project fields." +union ProjectV2FieldConfiguration = ProjectV2Field | ProjectV2IterationField | ProjectV2SingleSelectField + +"Types that can be inside Project Items." +union ProjectV2ItemContent = DraftIssue | Issue | PullRequest + +"Project field values" +union ProjectV2ItemFieldValue = ProjectV2ItemFieldDateValue | ProjectV2ItemFieldIterationValue | ProjectV2ItemFieldLabelValue | ProjectV2ItemFieldMilestoneValue | ProjectV2ItemFieldNumberValue | ProjectV2ItemFieldPullRequestValue | ProjectV2ItemFieldRepositoryValue | ProjectV2ItemFieldReviewerValue | ProjectV2ItemFieldSingleSelectValue | ProjectV2ItemFieldTextValue | ProjectV2ItemFieldUserValue + +"An item in a pull request timeline" +union PullRequestTimelineItem = AssignedEvent | BaseRefDeletedEvent | BaseRefForcePushedEvent | ClosedEvent | Commit | CommitCommentThread | CrossReferencedEvent | DemilestonedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | IssueComment | LabeledEvent | LockedEvent | MergedEvent | MilestonedEvent | PullRequestReview | PullRequestReviewComment | PullRequestReviewThread | ReferencedEvent | RenamedTitleEvent | ReopenedEvent | ReviewDismissedEvent | ReviewRequestRemovedEvent | ReviewRequestedEvent | SubscribedEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnsubscribedEvent | UserBlockedEvent + +"An item in a pull request timeline" +union PullRequestTimelineItems = AddedToMergeQueueEvent | AddedToProjectEvent | AssignedEvent | AutoMergeDisabledEvent | AutoMergeEnabledEvent | AutoRebaseEnabledEvent | AutoSquashEnabledEvent | AutomaticBaseChangeFailedEvent | AutomaticBaseChangeSucceededEvent | BaseRefChangedEvent | BaseRefDeletedEvent | BaseRefForcePushedEvent | BlockedByAddedEvent | BlockedByRemovedEvent | BlockingAddedEvent | BlockingRemovedEvent | ClosedEvent | CommentDeletedEvent | ConnectedEvent | ConvertToDraftEvent | ConvertedNoteToIssueEvent | ConvertedToDiscussionEvent | CrossReferencedEvent | DemilestonedEvent | DeployedEvent | DeploymentEnvironmentChangedEvent | DisconnectedEvent | HeadRefDeletedEvent | HeadRefForcePushedEvent | HeadRefRestoredEvent | IssueComment | IssueTypeAddedEvent | IssueTypeChangedEvent | IssueTypeRemovedEvent | LabeledEvent | LockedEvent | MarkedAsDuplicateEvent | MentionedEvent | MergedEvent | MilestonedEvent | MovedColumnsInProjectEvent | ParentIssueAddedEvent | ParentIssueRemovedEvent | PinnedEvent | PullRequestCommit | PullRequestCommitCommentThread | PullRequestReview | PullRequestReviewThread | PullRequestRevisionMarker | ReadyForReviewEvent | ReferencedEvent | RemovedFromMergeQueueEvent | RemovedFromProjectEvent | RenamedTitleEvent | ReopenedEvent | ReviewDismissedEvent | ReviewRequestRemovedEvent | ReviewRequestedEvent | SubIssueAddedEvent | SubIssueRemovedEvent | SubscribedEvent | TransferredEvent | UnassignedEvent | UnlabeledEvent | UnlockedEvent | UnmarkedAsDuplicateEvent | UnpinnedEvent | UnsubscribedEvent | UserBlockedEvent + +"Types that can be an actor." +union PushAllowanceActor = App | Team | User + +"Types that can be assigned to reactions." +union Reactor = Bot | Mannequin | Organization | User + +"Any referencable object" +union ReferencedSubject = Issue | PullRequest + +"An object which has a renamable title" +union RenamedTitleSubject = Issue | PullRequest + +"Types that can be requested reviewers." +union RequestedReviewer = Bot | Mannequin | Team | User + +"Types that can be an actor." +union ReviewDismissalAllowanceActor = App | Team | User + +"Types which can be parameters for `RepositoryRule` objects." +union RuleParameters = BranchNamePatternParameters | CodeScanningParameters | CommitAuthorEmailPatternParameters | CommitMessagePatternParameters | CommitterEmailPatternParameters | CopilotCodeReviewParameters | FileExtensionRestrictionParameters | FilePathRestrictionParameters | MaxFilePathLengthParameters | MaxFileSizeParameters | MergeQueueParameters | PullRequestParameters | RequiredDeploymentsParameters | RequiredStatusChecksParameters | TagNamePatternParameters | UpdateParameters | WorkflowsParameters + +"Types which can have `RepositoryRule` objects." +union RuleSource = Enterprise | Organization | Repository + +"The results of a search." +union SearchResultItem = App | Discussion | Issue | MarketplaceListing | Organization | PullRequest | Repository | User + +"Entities that can sponsor others via GitHub Sponsors" +union Sponsor = Organization | User + +"Entities that can be sponsored via GitHub Sponsors" +union SponsorableItem = Organization | User + +"A record that can be featured on a GitHub Sponsors profile." +union SponsorsListingFeatureableItem = Repository | User + +"Types that can be inside a StatusCheckRollup context." +union StatusCheckRollupContext = CheckRun | StatusContext + +"Types that can be added to a user list." +union UserListItems = Repository + +"Types that can own a verifiable domain." +union VerifiableDomainOwner = Enterprise | Organization + +"Autogenerated return type of AbortQueuedMigrations." +type AbortQueuedMigrationsPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Did the operation succeed?" + success: Boolean +} + +"Autogenerated return type of AbortRepositoryMigration." +type AbortRepositoryMigrationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Did the operation succeed?" + success: Boolean +} + +"Autogenerated return type of AcceptEnterpriseAdministratorInvitation." +type AcceptEnterpriseAdministratorInvitationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The invitation that was accepted." + invitation: EnterpriseAdministratorInvitation + "A message confirming the result of accepting an administrator invitation." + message: String +} + +"Autogenerated return type of AcceptEnterpriseMemberInvitation." +type AcceptEnterpriseMemberInvitationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The invitation that was accepted." + invitation: EnterpriseMemberInvitation + "A message confirming the result of accepting an unaffiliated member invitation." + message: String +} + +"Autogenerated return type of AcceptTopicSuggestion." +type AcceptTopicSuggestionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The accepted topic." + topic: Topic @deprecated(reason: "Suggested topics are no longer supported Removal on 2024-04-01 UTC.") +} + +"Autogenerated return type of AccessUserNamespaceRepository." +type AccessUserNamespaceRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The time that repository access expires at" + expiresAt: DateTime + "The repository that is temporarily accessible." + repository: Repository +} + +"The connection type for Actor." +type ActorConnection { + "A list of edges." + edges: [ActorEdge] + "A list of nodes." + nodes: [Actor] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ActorEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Actor +} + +"Location information for an actor" +type ActorLocation { + "City" + city: String + "Country name" + country: String + "Country code" + countryCode: String + "Region name" + region: String + "Region or state code" + regionCode: String +} + +"Autogenerated return type of AddAssigneesToAssignable." +type AddAssigneesToAssignablePayload { + "The item that was assigned." + assignable: Assignable + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of AddBlockedBy." +type AddBlockedByPayload { + "The issue that is blocking the given issue." + blockingIssue: Issue + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue that is blocked." + issue: Issue +} + +"Autogenerated return type of AddComment." +type AddCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The edge from the subject's comment connection." + commentEdge: IssueCommentEdge + "The subject" + subject: Node + "The edge from the subject's timeline connection." + timelineEdge: IssueTimelineItemEdge +} + +"Autogenerated return type of AddDiscussionComment." +type AddDiscussionCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created discussion comment." + comment: DiscussionComment +} + +"Autogenerated return type of AddDiscussionPollVote." +type AddDiscussionPollVotePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The poll option that a vote was added to." + pollOption: DiscussionPollOption +} + +"Autogenerated return type of AddEnterpriseOrganizationMember." +type AddEnterpriseOrganizationMemberPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The users who were added to the organization." + users: [User!] +} + +"Autogenerated return type of AddEnterpriseSupportEntitlement." +type AddEnterpriseSupportEntitlementPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A message confirming the result of adding the support entitlement." + message: String +} + +"Autogenerated return type of AddLabelsToLabelable." +type AddLabelsToLabelablePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item that was labeled." + labelable: Labelable +} + +"Autogenerated return type of AddProjectCard." +type AddProjectCardPayload { + "The edge from the ProjectColumn's card connection." + cardEdge: ProjectCardEdge + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ProjectColumn" + projectColumn: ProjectColumn +} + +"Autogenerated return type of AddProjectColumn." +type AddProjectColumnPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The edge from the project's column connection." + columnEdge: ProjectColumnEdge + "The project" + project: Project +} + +"Autogenerated return type of AddProjectV2DraftIssue." +type AddProjectV2DraftIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The draft issue added to the project." + projectItem: ProjectV2Item +} + +"Autogenerated return type of AddProjectV2ItemById." +type AddProjectV2ItemByIdPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item added to the project." + item: ProjectV2Item +} + +"Autogenerated return type of AddPullRequestReviewComment." +type AddPullRequestReviewCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created comment." + comment: PullRequestReviewComment + "The edge from the review's comment connection." + commentEdge: PullRequestReviewCommentEdge +} + +"Autogenerated return type of AddPullRequestReview." +type AddPullRequestReviewPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created pull request review." + pullRequestReview: PullRequestReview + "The edge from the pull request's review connection." + reviewEdge: PullRequestReviewEdge +} + +"Autogenerated return type of AddPullRequestReviewThread." +type AddPullRequestReviewThreadPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created thread." + thread: PullRequestReviewThread +} + +"Autogenerated return type of AddPullRequestReviewThreadReply." +type AddPullRequestReviewThreadReplyPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created reply." + comment: PullRequestReviewComment +} + +"Autogenerated return type of AddReaction." +type AddReactionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The reaction object." + reaction: Reaction + "The reaction groups for the subject." + reactionGroups: [ReactionGroup!] + "The reactable subject." + subject: Reactable +} + +"Autogenerated return type of AddStar." +type AddStarPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The starrable." + starrable: Starrable +} + +"Autogenerated return type of AddSubIssue." +type AddSubIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The parent issue that the sub-issue was added to." + issue: Issue + "The sub-issue of the parent." + subIssue: Issue +} + +"Autogenerated return type of AddUpvote." +type AddUpvotePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The votable subject." + subject: Votable +} + +"Autogenerated return type of AddVerifiableDomain." +type AddVerifiableDomainPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The verifiable domain that was added." + domain: VerifiableDomain +} + +"Represents an 'added_to_merge_queue' event on a given pull request." +type AddedToMergeQueueEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The user who added this Pull Request to the merge queue" + enqueuer: User + "The Node ID of the AddedToMergeQueueEvent object" + id: ID! + "The merge queue where this pull request was added to." + mergeQueue: MergeQueue + "PullRequest referenced by event." + pullRequest: PullRequest +} + +"Represents a 'added_to_project' event on a given issue or pull request." +type AddedToProjectEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The Node ID of the AddedToProjectEvent object" + id: ID! + "Project referenced by event." + project: Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Project card referenced by this project event." + projectCard: ProjectCard @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Column name referenced by this project event." + projectColumnName: String! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"An announcement banner for an enterprise or organization." +type AnnouncementBanner { + "The date the announcement was created" + createdAt: DateTime! + "The expiration date of the announcement, if any" + expiresAt: DateTime + "Whether the announcement can be dismissed by the user" + isUserDismissible: Boolean! + "The text of the announcement" + message: String +} + +"A GitHub App." +type App implements Node { + "The client ID of the app." + clientId: String + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The description of the app." + description: String + "The Node ID of the App object" + id: ID! + "The IP addresses of the app." + ipAllowListEntries( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for IP allow list entries returned." + orderBy: IpAllowListEntryOrder = {field: ALLOW_LIST_VALUE, direction: ASC} + ): IpAllowListEntryConnection! + "The hex color code, without the leading '#', for the logo background." + logoBackgroundColor: String! + "A URL pointing to the app's logo." + logoUrl( + "The size of the resulting image." + size: Int + ): URI! + "The name of the app." + name: String! + "A slug based on the name of the app for use in URLs." + slug: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The URL to the app's homepage." + url: URI! +} + +"Autogenerated return type of ApproveDeployments." +type ApproveDeploymentsPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The affected deployments." + deployments: [Deployment!] +} + +"Autogenerated return type of ApproveVerifiableDomain." +type ApproveVerifiableDomainPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The verifiable domain that was approved." + domain: VerifiableDomain +} + +"Autogenerated return type of ArchiveProjectV2Item." +type ArchiveProjectV2ItemPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item archived from the project." + item: ProjectV2Item +} + +"Autogenerated return type of ArchiveRepository." +type ArchiveRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository that was marked as archived." + repository: Repository +} + +"Represents an 'assigned' event on any assignable object." +type AssignedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the assignable associated with the event." + assignable: Assignable! + "Identifies the user or mannequin that was assigned." + assignee: Assignee + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the AssignedEvent object" + id: ID! + "Identifies the user who was assigned." + user: User @deprecated(reason: "Assignees can now be mannequins. Use the `assignee` field instead. Removal on 2020-01-01 UTC.") +} + +"The connection type for Assignee." +type AssigneeConnection { + "A list of edges." + edges: [AssigneeEdge] + "A list of nodes." + nodes: [Assignee] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type AssigneeEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Assignee +} + +"Represents a 'auto_merge_disabled' event on a given pull request." +type AutoMergeDisabledEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The user who disabled auto-merge for this Pull Request" + disabler: User + "The Node ID of the AutoMergeDisabledEvent object" + id: ID! + "PullRequest referenced by event" + pullRequest: PullRequest + "The reason auto-merge was disabled" + reason: String + "The reason_code relating to why auto-merge was disabled" + reasonCode: String +} + +"Represents a 'auto_merge_enabled' event on a given pull request." +type AutoMergeEnabledEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The user who enabled auto-merge for this Pull Request" + enabler: User + "The Node ID of the AutoMergeEnabledEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest +} + +"Represents an auto-merge request for a pull request" +type AutoMergeRequest { + "The email address of the author of this auto-merge request." + authorEmail: String + "The commit message of the auto-merge request. If a merge queue is required by the base branch, this value will be set by the merge queue when merging." + commitBody: String + "The commit title of the auto-merge request. If a merge queue is required by the base branch, this value will be set by the merge queue when merging" + commitHeadline: String + "When was this auto-merge request was enabled." + enabledAt: DateTime + "The actor who created the auto-merge request." + enabledBy: Actor + "The merge method of the auto-merge request. If a merge queue is required by the base branch, this value will be set by the merge queue when merging." + mergeMethod: PullRequestMergeMethod! + "The pull request that this auto-merge request is set against." + pullRequest: PullRequest! +} + +"Represents a 'auto_rebase_enabled' event on a given pull request." +type AutoRebaseEnabledEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The user who enabled auto-merge (rebase) for this Pull Request" + enabler: User + "The Node ID of the AutoRebaseEnabledEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest +} + +"Represents a 'auto_squash_enabled' event on a given pull request." +type AutoSquashEnabledEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The user who enabled auto-merge (squash) for this Pull Request" + enabler: User + "The Node ID of the AutoSquashEnabledEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest +} + +"Represents a 'automatic_base_change_failed' event on a given pull request." +type AutomaticBaseChangeFailedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the AutomaticBaseChangeFailedEvent object" + id: ID! + "The new base for this PR" + newBase: String! + "The old base for this PR" + oldBase: String! + "PullRequest referenced by event." + pullRequest: PullRequest! +} + +"Represents a 'automatic_base_change_succeeded' event on a given pull request." +type AutomaticBaseChangeSucceededEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the AutomaticBaseChangeSucceededEvent object" + id: ID! + "The new base for this PR" + newBase: String! + "The old base for this PR" + oldBase: String! + "PullRequest referenced by event." + pullRequest: PullRequest! +} + +"Represents a 'base_ref_changed' event on a given issue or pull request." +type BaseRefChangedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the name of the base ref for the pull request after it was changed." + currentRefName: String! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the BaseRefChangedEvent object" + id: ID! + "Identifies the name of the base ref for the pull request before it was changed." + previousRefName: String! + "PullRequest referenced by event." + pullRequest: PullRequest! +} + +"Represents a 'base_ref_deleted' event on a given pull request." +type BaseRefDeletedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the name of the Ref associated with the `base_ref_deleted` event." + baseRefName: String + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the BaseRefDeletedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest +} + +"Represents a 'base_ref_force_pushed' event on a given pull request." +type BaseRefForcePushedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the after commit SHA for the 'base_ref_force_pushed' event." + afterCommit: Commit + "Identifies the before commit SHA for the 'base_ref_force_pushed' event." + beforeCommit: Commit + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the BaseRefForcePushedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! + "Identifies the fully qualified ref name for the 'base_ref_force_pushed' event." + ref: Ref +} + +"Represents a Git blame." +type Blame { + "The list of ranges from a Git blame." + ranges: [BlameRange!]! +} + +"Represents a range of information from a Git blame." +type BlameRange { + "Identifies the recency of the change, from 1 (new) to 10 (old). This is calculated as a 2-quantile and determines the length of distance between the median age of all the changes in the file and the recency of the current range's change." + age: Int! + "Identifies the line author" + commit: Commit! + "The ending line for the range" + endingLine: Int! + "The starting line for the range" + startingLine: Int! +} + +"Represents a Git blob." +type Blob implements GitObject & Node { + "An abbreviated version of the Git object ID" + abbreviatedOid: String! + "Byte size of Blob object" + byteSize: Int! + "The HTTP path for this Git object" + commitResourcePath: URI! + "The HTTP URL for this Git object" + commitUrl: URI! + "The Node ID of the Blob object" + id: ID! + "Indicates whether the Blob is binary or text. Returns null if unable to determine the encoding." + isBinary: Boolean + "Indicates whether the contents is truncated" + isTruncated: Boolean! + "The Git object ID" + oid: GitObjectID! + "The Repository the Git object belongs to" + repository: Repository! + "UTF8 text data or null if the Blob is binary" + text: String +} + +"Represents a 'blocked_by_added' event on a given issue." +type BlockedByAddedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "The blocking issue that was added." + blockingIssue: Issue + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the BlockedByAddedEvent object" + id: ID! +} + +"Represents a 'blocked_by_removed' event on a given issue." +type BlockedByRemovedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "The blocking issue that was removed." + blockingIssue: Issue + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the BlockedByRemovedEvent object" + id: ID! +} + +"Represents a 'blocking_added' event on a given issue." +type BlockingAddedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "The blocked issue that was added." + blockedIssue: Issue + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the BlockingAddedEvent object" + id: ID! +} + +"Represents a 'blocking_removed' event on a given issue." +type BlockingRemovedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "The blocked issue that was removed." + blockedIssue: Issue + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the BlockingRemovedEvent object" + id: ID! +} + +"A special type of user which takes actions on behalf of GitHub Apps." +type Bot implements Actor & Node & UniformResourceLocatable { + "A URL pointing to the GitHub App's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the Bot object" + id: ID! + "The username of the actor." + login: String! + "The HTTP path for this bot" + resourcePath: URI! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this bot" + url: URI! +} + +"Parameters to be used for the branch_name_pattern rule" +type BranchNamePatternParameters { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean! + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"A branch protection rule." +type BranchProtectionRule implements Node { + "Can this branch be deleted." + allowsDeletions: Boolean! + "Are force pushes allowed on this branch." + allowsForcePushes: Boolean! + "Is branch creation a protected operation." + blocksCreations: Boolean! + "A list of conflicts matching branches protection rule and other branch protection rules" + branchProtectionRuleConflicts( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): BranchProtectionRuleConflictConnection! + "A list of actors able to force push for this branch protection rule." + bypassForcePushAllowances( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): BypassForcePushAllowanceConnection! + "A list of actors able to bypass PRs for this branch protection rule." + bypassPullRequestAllowances( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): BypassPullRequestAllowanceConnection! + "The actor who created this branch protection rule." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int + "Will new commits pushed to matching branches dismiss pull request review approvals." + dismissesStaleReviews: Boolean! + "The Node ID of the BranchProtectionRule object" + id: ID! + "Can admins override branch protection." + isAdminEnforced: Boolean! + "Whether users can pull changes from upstream when the branch is locked. Set to `true` to allow fork syncing. Set to `false` to prevent fork syncing." + lockAllowsFetchAndMerge: Boolean! + "Whether to set the branch as read-only. If this is true, users will not be able to push to the branch." + lockBranch: Boolean! + "Repository refs that are protected by this rule" + matchingRefs( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filters refs with query on name" + query: String + ): RefConnection! + "Identifies the protection rule pattern." + pattern: String! + "A list push allowances for this branch protection rule." + pushAllowances( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PushAllowanceConnection! + "The repository associated with this branch protection rule." + repository: Repository + "Whether the most recent push must be approved by someone other than the person who pushed it" + requireLastPushApproval: Boolean! + "Number of approving reviews required to update matching branches." + requiredApprovingReviewCount: Int + "List of required deployment environments that must be deployed successfully to update matching branches" + requiredDeploymentEnvironments: [String] + "List of required status check contexts that must pass for commits to be accepted to matching branches." + requiredStatusCheckContexts: [String] + "List of required status checks that must pass for commits to be accepted to matching branches." + requiredStatusChecks: [RequiredStatusCheckDescription!] + "Are approving reviews required to update matching branches." + requiresApprovingReviews: Boolean! + "Are reviews from code owners required to update matching branches." + requiresCodeOwnerReviews: Boolean! + "Are commits required to be signed." + requiresCommitSignatures: Boolean! + "Are conversations required to be resolved before merging." + requiresConversationResolution: Boolean! + "Does this branch require deployment to specific environments before merging" + requiresDeployments: Boolean! + "Are merge commits prohibited from being pushed to this branch." + requiresLinearHistory: Boolean! + "Are status checks required to update matching branches." + requiresStatusChecks: Boolean! + "Are branches required to be up to date before merging." + requiresStrictStatusChecks: Boolean! + "Is pushing to matching branches restricted." + restrictsPushes: Boolean! + "Is dismissal of pull request reviews restricted." + restrictsReviewDismissals: Boolean! + "A list review dismissal allowances for this branch protection rule." + reviewDismissalAllowances( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ReviewDismissalAllowanceConnection! +} + +"A conflict between two branch protection rules." +type BranchProtectionRuleConflict { + "Identifies the branch protection rule." + branchProtectionRule: BranchProtectionRule + "Identifies the conflicting branch protection rule." + conflictingBranchProtectionRule: BranchProtectionRule + "Identifies the branch ref that has conflicting rules" + ref: Ref +} + +"The connection type for BranchProtectionRuleConflict." +type BranchProtectionRuleConflictConnection { + "A list of edges." + edges: [BranchProtectionRuleConflictEdge] + "A list of nodes." + nodes: [BranchProtectionRuleConflict] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type BranchProtectionRuleConflictEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: BranchProtectionRuleConflict +} + +"The connection type for BranchProtectionRule." +type BranchProtectionRuleConnection { + "A list of edges." + edges: [BranchProtectionRuleEdge] + "A list of nodes." + nodes: [BranchProtectionRule] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type BranchProtectionRuleEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: BranchProtectionRule +} + +"A user, team, or app who has the ability to bypass a force push requirement on a protected branch." +type BypassForcePushAllowance implements Node { + "The actor that can force push." + actor: BranchActorAllowanceActor + "Identifies the branch protection rule associated with the allowed user, team, or app." + branchProtectionRule: BranchProtectionRule + "The Node ID of the BypassForcePushAllowance object" + id: ID! +} + +"The connection type for BypassForcePushAllowance." +type BypassForcePushAllowanceConnection { + "A list of edges." + edges: [BypassForcePushAllowanceEdge] + "A list of nodes." + nodes: [BypassForcePushAllowance] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type BypassForcePushAllowanceEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: BypassForcePushAllowance +} + +"A user, team, or app who has the ability to bypass a pull request requirement on a protected branch." +type BypassPullRequestAllowance implements Node { + "The actor that can bypass." + actor: BranchActorAllowanceActor + "Identifies the branch protection rule associated with the allowed user, team, or app." + branchProtectionRule: BranchProtectionRule + "The Node ID of the BypassPullRequestAllowance object" + id: ID! +} + +"The connection type for BypassPullRequestAllowance." +type BypassPullRequestAllowanceConnection { + "A list of edges." + edges: [BypassPullRequestAllowanceEdge] + "A list of nodes." + nodes: [BypassPullRequestAllowance] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type BypassPullRequestAllowanceEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: BypassPullRequestAllowance +} + +"The Common Vulnerability Scoring System" +type CVSS { + "The CVSS score associated with this advisory" + score: Float! + "The CVSS vector string associated with this advisory" + vectorString: String +} + +"A common weakness enumeration" +type CWE implements Node { + "The id of the CWE" + cweId: String! + "A detailed description of this CWE" + description: String! + "The Node ID of the CWE object" + id: ID! + "The name of this CWE" + name: String! +} + +"The connection type for CWE." +type CWEConnection { + "A list of edges." + edges: [CWEEdge] + "A list of nodes." + nodes: [CWE] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CWEEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CWE +} + +"Autogenerated return type of CancelEnterpriseAdminInvitation." +type CancelEnterpriseAdminInvitationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The invitation that was canceled." + invitation: EnterpriseAdministratorInvitation + "A message confirming the result of canceling an administrator invitation." + message: String +} + +"Autogenerated return type of CancelEnterpriseMemberInvitation." +type CancelEnterpriseMemberInvitationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The invitation that was canceled." + invitation: EnterpriseMemberInvitation + "A message confirming the result of canceling an member invitation." + message: String +} + +"Autogenerated return type of CancelSponsorship." +type CancelSponsorshipPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The tier that was being used at the time of cancellation." + sponsorsTier: SponsorsTier +} + +"Autogenerated return type of ChangeUserStatus." +type ChangeUserStatusPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Your updated status." + status: UserStatus +} + +"A single check annotation." +type CheckAnnotation { + "The annotation's severity level." + annotationLevel: CheckAnnotationLevel + "The path to the file that this annotation was made on." + blobUrl: URI! + "Identifies the primary key from the database." + databaseId: Int + "The position of this annotation." + location: CheckAnnotationSpan! + "The annotation's message." + message: String! + "The path that this annotation was made on." + path: String! + "Additional information about the annotation." + rawDetails: String + "The annotation's title" + title: String +} + +"The connection type for CheckAnnotation." +type CheckAnnotationConnection { + "A list of edges." + edges: [CheckAnnotationEdge] + "A list of nodes." + nodes: [CheckAnnotation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CheckAnnotationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CheckAnnotation +} + +"A character position in a check annotation." +type CheckAnnotationPosition { + "Column number (1 indexed)." + column: Int + "Line number (1 indexed)." + line: Int! +} + +"An inclusive pair of positions for a check annotation." +type CheckAnnotationSpan { + "End position (inclusive)." + end: CheckAnnotationPosition! + "Start position (inclusive)." + start: CheckAnnotationPosition! +} + +"A check run." +type CheckRun implements Node & RequirableByPullRequest & UniformResourceLocatable { + "The check run's annotations" + annotations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CheckAnnotationConnection + "The check suite that this run is a part of." + checkSuite: CheckSuite! + "Identifies the date and time when the check run was completed." + completedAt: DateTime + "The conclusion of the check run." + conclusion: CheckConclusionState + "Identifies the primary key from the database." + databaseId: Int + "The corresponding deployment for this job, if any" + deployment: Deployment + "The URL from which to find full details of the check run on the integrator's site." + detailsUrl: URI + "A reference for the check run on the integrator's system." + externalId: String + "The Node ID of the CheckRun object" + id: ID! + "Whether this is required to pass before merging for a specific pull request." + isRequired( + "The id of the pull request this is required for" + pullRequestId: ID, + "The number of the pull request this is required for" + pullRequestNumber: Int + ): Boolean! + "The name of the check for this check run." + name: String! + "Information about a pending deployment, if any, in this check run" + pendingDeploymentRequest: DeploymentRequest + "The permalink to the check run summary." + permalink: URI! + "The repository associated with this check run." + repository: Repository! + "The HTTP path for this check run." + resourcePath: URI! + "Identifies the date and time when the check run was started." + startedAt: DateTime + "The current status of the check run." + status: CheckStatusState! + "The check run's steps" + steps( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Step number" + number: Int + ): CheckStepConnection + "A string representing the check run's summary" + summary: String + "A string representing the check run's text" + text: String + "A string representing the check run" + title: String + "The HTTP URL for this check run." + url: URI! +} + +"The connection type for CheckRun." +type CheckRunConnection { + "A list of edges." + edges: [CheckRunEdge] + "A list of nodes." + nodes: [CheckRun] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CheckRunEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CheckRun +} + +"Represents a count of the state of a check run." +type CheckRunStateCount { + "The number of check runs with this state." + count: Int! + "The state of a check run." + state: CheckRunState! +} + +"A single check step." +type CheckStep { + "Identifies the date and time when the check step was completed." + completedAt: DateTime + "The conclusion of the check step." + conclusion: CheckConclusionState + "A reference for the check step on the integrator's system." + externalId: String + "The step's name." + name: String! + "The index of the step in the list of steps of the parent check run." + number: Int! + "Number of seconds to completion." + secondsToCompletion: Int + "Identifies the date and time when the check step was started." + startedAt: DateTime + "The current status of the check step." + status: CheckStatusState! +} + +"The connection type for CheckStep." +type CheckStepConnection { + "A list of edges." + edges: [CheckStepEdge] + "A list of nodes." + nodes: [CheckStep] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CheckStepEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CheckStep +} + +"A check suite." +type CheckSuite implements Node { + "The GitHub App which created this check suite." + app: App + "The name of the branch for this check suite." + branch: Ref + "The check runs associated with a check suite." + checkRuns( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filters the check runs by this type." + filterBy: CheckRunFilter, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CheckRunConnection + "The commit for this check suite" + commit: Commit! + "The conclusion of this check suite." + conclusion: CheckConclusionState + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The user who triggered the check suite." + creator: User + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the CheckSuite object" + id: ID! + "A list of open pull requests matching the check suite." + matchingPullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "The base ref name to filter the pull requests by." + baseRefName: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "The head ref name to filter the pull requests by." + headRefName: String, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the pull requests by." + states: [PullRequestState!] + ): PullRequestConnection + "The push that triggered this check suite." + push: Push + "The repository associated with this check suite." + repository: Repository! + "The HTTP path for this check suite" + resourcePath: URI! + "The status of this check suite." + status: CheckStatusState! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this check suite" + url: URI! + "The workflow run associated with this check suite." + workflowRun: WorkflowRun +} + +"The connection type for CheckSuite." +type CheckSuiteConnection { + "A list of edges." + edges: [CheckSuiteEdge] + "A list of nodes." + nodes: [CheckSuite] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CheckSuiteEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CheckSuite +} + +"Autogenerated return type of ClearLabelsFromLabelable." +type ClearLabelsFromLabelablePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item that was unlabeled." + labelable: Labelable +} + +"Autogenerated return type of ClearProjectV2ItemFieldValue." +type ClearProjectV2ItemFieldValuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated item." + projectV2Item: ProjectV2Item +} + +"Autogenerated return type of CloneProject." +type CloneProjectPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the JobStatus for populating cloned fields." + jobStatusId: String + "The new cloned project." + project: Project +} + +"Autogenerated return type of CloneTemplateRepository." +type CloneTemplateRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new repository." + repository: Repository +} + +"Autogenerated return type of CloseDiscussion." +type CloseDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion that was closed." + discussion: Discussion +} + +"Autogenerated return type of CloseIssue." +type CloseIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue that was closed." + issue: Issue +} + +"Autogenerated return type of ClosePullRequest." +type ClosePullRequestPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request that was closed." + pullRequest: PullRequest +} + +"Represents a 'closed' event on any `Closable`." +type ClosedEvent implements Node & UniformResourceLocatable { + "Identifies the actor who performed the event." + actor: Actor + "Object that was closed." + closable: Closable! + "Object which triggered the creation of this event." + closer: Closer + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The issue or pull request that this issue was marked as a duplicate of." + duplicateOf: IssueOrPullRequest + "The Node ID of the ClosedEvent object" + id: ID! + "The HTTP path for this closed event." + resourcePath: URI! + "The reason the issue state was changed to closed." + stateReason: IssueStateReason + "The HTTP URL for this closed event." + url: URI! +} + +"The Code of Conduct for a repository" +type CodeOfConduct implements Node { + "The body of the Code of Conduct" + body: String + "The Node ID of the CodeOfConduct object" + id: ID! + "The key for the Code of Conduct" + key: String! + "The formal name of the Code of Conduct" + name: String! + "The HTTP path for this Code of Conduct" + resourcePath: URI + "The HTTP URL for this Code of Conduct" + url: URI +} + +"Choose which tools must provide code scanning results before the reference is updated. When configured, code scanning must be enabled and have results for both the commit and the reference being updated." +type CodeScanningParameters { + "Tools that must provide code scanning results for this rule to pass." + codeScanningTools: [CodeScanningTool!]! +} + +"A tool that must provide code scanning results for this rule to pass." +type CodeScanningTool { + "The severity level at which code scanning results that raise alerts block a reference update. For more information on alert severity levels, see \"[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels).\"" + alertsThreshold: String! + "The severity level at which code scanning results that raise security alerts block a reference update. For more information on security severity levels, see \"[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels).\"" + securityAlertsThreshold: String! + "The name of a code scanning tool" + tool: String! +} + +"Represents a 'comment_deleted' event on a given issue or pull request." +type CommentDeletedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The user who authored the deleted comment." + deletedCommentAuthor: Actor + "The Node ID of the CommentDeletedEvent object" + id: ID! +} + +"Represents a Git commit." +type Commit implements GitObject & Node & Subscribable & UniformResourceLocatable { + "An abbreviated version of the Git object ID" + abbreviatedOid: String! + "The number of additions in this commit." + additions: Int! + "The merged Pull Request that introduced the commit to the repository. If the commit is not present in the default branch, additionally returns open Pull Requests associated with the commit" + associatedPullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests." + orderBy: PullRequestOrder = {field: CREATED_AT, direction: ASC} + ): PullRequestConnection + "Authorship details of the commit." + author: GitActor + "Check if the committer and the author match." + authoredByCommitter: Boolean! + "The datetime when this commit was authored." + authoredDate: DateTime! + """ + + The list of authors for this commit based on the git author and the Co-authored-by + message trailer. The git author will always be first. + """ + authors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): GitActorConnection! + "Fetches `git blame` information." + blame( + "The file whose Git blame information you want." + path: String! + ): Blame! + "We recommend using the `changedFilesIfAvailable` field instead of `changedFiles`, as `changedFiles` will cause your request to return an error if GitHub is unable to calculate the number of changed files." + changedFiles: Int! @deprecated(reason: "`changedFiles` will be removed. Use `changedFilesIfAvailable` instead. Removal on 2023-01-01 UTC.") + "The number of changed files in this commit. If GitHub is unable to calculate the number of changed files (for example due to a timeout), this will return `null`. We recommend using this field instead of `changedFiles`." + changedFilesIfAvailable: Int + "The check suites associated with a commit." + checkSuites( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filters the check suites by this type." + filterBy: CheckSuiteFilter, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CheckSuiteConnection + "Comments made on the commit." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CommitCommentConnection! + "The HTTP path for this Git object" + commitResourcePath: URI! + "The HTTP URL for this Git object" + commitUrl: URI! + "The datetime when this commit was committed." + committedDate: DateTime! + "Check if committed via GitHub web UI." + committedViaWeb: Boolean! + "Committer details of the commit." + committer: GitActor + "The number of deletions in this commit." + deletions: Int! + "The deployments associated with a commit." + deployments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Environments to list deployments for" + environments: [String!], + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for deployments returned from the connection." + orderBy: DeploymentOrder = {field: CREATED_AT, direction: ASC} + ): DeploymentConnection + "The tree entry representing the file located at the given path." + file( + "The path for the file" + path: String! + ): TreeEntry + "The linear commit history starting from (and including) this commit, in the same order as `git log`." + history( + "Returns the elements in the list that come after the specified cursor." + after: String, + "If non-null, filters history to only show commits with matching authorship." + author: CommitAuthor, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "If non-null, filters history to only show commits touching files under this path." + path: String, + "Allows specifying a beginning time or date for fetching commits. Unexpected results may be returned for dates not between 1970-01-01 and 2099-12-13 (inclusive)." + since: GitTimestamp, + "Allows specifying an ending time or date for fetching commits. Unexpected results may be returned for dates not between 1970-01-01 and 2099-12-13 (inclusive)." + until: GitTimestamp + ): CommitHistoryConnection! + "The Node ID of the Commit object" + id: ID! + "The Git commit message" + message: String! + "The Git commit message body" + messageBody: String! + "The commit message body rendered to HTML." + messageBodyHTML: HTML! + "The Git commit message headline" + messageHeadline: String! + "The commit message headline rendered to HTML." + messageHeadlineHTML: HTML! + "The Git object ID" + oid: GitObjectID! + "The organization this commit was made on behalf of." + onBehalfOf: Organization + "The parents of a commit." + parents( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CommitConnection! + "The datetime when this commit was pushed." + pushedDate: DateTime @deprecated(reason: "`pushedDate` is no longer supported. Removal on 2023-07-01 UTC.") + "The Repository this commit belongs to" + repository: Repository! + "The HTTP path for this commit" + resourcePath: URI! + "Commit signing information, if present." + signature: GitSignature + "Status information for this commit" + status: Status + "Check and Status rollup information for this commit." + statusCheckRollup: StatusCheckRollup + "Returns a list of all submodules in this repository as of this Commit parsed from the .gitmodules file." + submodules( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): SubmoduleConnection! + """ + + Returns a URL to download a tarball archive for a repository. + Note: For private repositories, these links are temporary and expire after five minutes. + """ + tarballUrl: URI! + "Commit's root Tree" + tree: Tree! + "The HTTP path for the tree of this commit" + treeResourcePath: URI! + "The HTTP URL for the tree of this commit" + treeUrl: URI! + "The HTTP URL for this commit" + url: URI! + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState + """ + + Returns a URL to download a zipball archive for a repository. + Note: For private repositories, these links are temporary and expire after five minutes. + """ + zipballUrl: URI! +} + +"Parameters to be used for the commit_author_email_pattern rule" +type CommitAuthorEmailPatternParameters { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean! + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"Represents a comment on a given Commit." +type CommitComment implements Comment & Deletable & Minimizable & Node & Reactable & RepositoryNode & Updatable & UpdatableComment { + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "Identifies the comment body." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "Identifies the commit associated with the comment, if the commit exists." + commit: Commit + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The actor who edited the comment." + editor: Actor + "The Node ID of the CommitComment object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Returns whether or not a comment has been minimized." + isMinimized: Boolean! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Returns why the comment was minimized. One of `abuse`, `off-topic`, `outdated`, `resolved`, `duplicate` and `spam`. Note that the case and formatting of these values differs from the inputs to the `MinimizeComment` mutation." + minimizedReason: String + "Identifies the file path associated with the comment." + path: String + "Identifies the line position associated with the comment." + position: Int + "Identifies when the comment was published at." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The repository associated with this node." + repository: Repository! + "The HTTP path permalink for this commit comment." + resourcePath: URI! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL permalink for this commit comment." + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Check if the current viewer can minimize this object." + viewerCanMinimize: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Check if the current viewer can unminimize this object." + viewerCanUnminimize: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! +} + +"The connection type for CommitComment." +type CommitCommentConnection { + "A list of edges." + edges: [CommitCommentEdge] + "A list of nodes." + nodes: [CommitComment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CommitCommentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CommitComment +} + +"A thread of comments on a commit." +type CommitCommentThread implements Node & RepositoryNode { + "The comments that exist in this thread." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CommitCommentConnection! + "The commit the comments were made on." + commit: Commit + "The Node ID of the CommitCommentThread object" + id: ID! + "The file the comments were made on." + path: String + "The position in the diff for the commit that the comment was made on." + position: Int + "The repository associated with this node." + repository: Repository! +} + +"The connection type for Commit." +type CommitConnection { + "A list of edges." + edges: [CommitEdge] + "A list of nodes." + nodes: [Commit] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"This aggregates commits made by a user within one repository." +type CommitContributionsByRepository { + "The commit contributions, each representing a day." + contributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for commit contributions returned from the connection." + orderBy: CommitContributionOrder = {field: OCCURRED_AT, direction: DESC} + ): CreatedCommitContributionConnection! + "The repository in which the commits were made." + repository: Repository! + "The HTTP path for the user's commits to the repository in this time range." + resourcePath: URI! + "The HTTP URL for the user's commits to the repository in this time range." + url: URI! +} + +"An edge in a connection." +type CommitEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Commit +} + +"The connection type for Commit." +type CommitHistoryConnection { + "A list of edges." + edges: [CommitEdge] + "A list of nodes." + nodes: [Commit] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Parameters to be used for the commit_message_pattern rule" +type CommitMessagePatternParameters { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean! + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"Parameters to be used for the committer_email_pattern rule" +type CommitterEmailPatternParameters { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean! + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"Represents a comparison between two commit revisions." +type Comparison implements Node { + "The number of commits ahead of the base branch." + aheadBy: Int! + "The base revision of this comparison." + baseTarget: GitObject! + "The number of commits behind the base branch." + behindBy: Int! + "The commits which compose this comparison." + commits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ComparisonCommitConnection! + "The head revision of this comparison." + headTarget: GitObject! + "The Node ID of the Comparison object" + id: ID! + "The status of this comparison." + status: ComparisonStatus! +} + +"The connection type for Commit." +type ComparisonCommitConnection { + "The total count of authors and co-authors across all commits." + authorCount: Int! + "A list of edges." + edges: [CommitEdge] + "A list of nodes." + nodes: [Commit] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a 'connected' event on a given issue or pull request." +type ConnectedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ConnectedEvent object" + id: ID! + "Reference originated in a different repository." + isCrossRepository: Boolean! + "Issue or pull request that made the reference." + source: ReferencedSubject! + "Issue or pull request which was connected." + subject: ReferencedSubject! +} + +"The Contributing Guidelines for a repository." +type ContributingGuidelines { + "The body of the Contributing Guidelines." + body: String + "The HTTP path for the Contributing Guidelines." + resourcePath: URI + "The HTTP URL for the Contributing Guidelines." + url: URI +} + +"A calendar of contributions made on GitHub by a user." +type ContributionCalendar { + "A list of hex color codes used in this calendar. The darker the color, the more contributions it represents." + colors: [String!]! + "Determine if the color set was chosen because it's currently Halloween." + isHalloween: Boolean! + "A list of the months of contributions in this calendar." + months: [ContributionCalendarMonth!]! + "The count of total contributions in the calendar." + totalContributions: Int! + "A list of the weeks of contributions in this calendar." + weeks: [ContributionCalendarWeek!]! +} + +"Represents a single day of contributions on GitHub by a user." +type ContributionCalendarDay { + "The hex color code that represents how many contributions were made on this day compared to others in the calendar." + color: String! + "How many contributions were made by the user on this day." + contributionCount: Int! + "Indication of contributions, relative to other days. Can be used to indicate which color to represent this day on a calendar." + contributionLevel: ContributionLevel! + "The day this square represents." + date: Date! + "A number representing which day of the week this square represents, e.g., 1 is Monday." + weekday: Int! +} + +"A month of contributions in a user's contribution graph." +type ContributionCalendarMonth { + "The date of the first day of this month." + firstDay: Date! + "The name of the month." + name: String! + "How many weeks started in this month." + totalWeeks: Int! + "The year the month occurred in." + year: Int! +} + +"A week of contributions in a user's contribution graph." +type ContributionCalendarWeek { + "The days of contributions in this week." + contributionDays: [ContributionCalendarDay!]! + "The date of the earliest square in this week." + firstDay: Date! +} + +""" + +A collection of contributions made by a user, including opened issues, commits, and pull requests. +Contributions in private and internal repositories are only included with the optional read:user scope. +""" +type ContributionsCollection { + "Commit contributions made by the user, grouped by repository." + commitContributionsByRepository( + "How many repositories should be included." + maxRepositories: Int = 25 + ): [CommitContributionsByRepository!]! + "A calendar of this user's contributions on GitHub." + contributionCalendar: ContributionCalendar! + "The years the user has been making contributions with the most recent year first." + contributionYears: [Int!]! + """ + + Determine if this collection's time span ends in the current month. + """ + doesEndInCurrentMonth: Boolean! + "The date of the first restricted contribution the user made in this time period. Can only be non-null when the user has enabled private contribution counts." + earliestRestrictedContributionDate: Date + "The ending date and time of this collection." + endedAt: DateTime! + "The first issue the user opened on GitHub. This will be null if that issue was opened outside the collection's time range and ignoreTimeRange is false. If the issue is not visible but the user has opted to show private contributions, a RestrictedContribution will be returned." + firstIssueContribution: CreatedIssueOrRestrictedContribution + "The first pull request the user opened on GitHub. This will be null if that pull request was opened outside the collection's time range and ignoreTimeRange is not true. If the pull request is not visible but the user has opted to show private contributions, a RestrictedContribution will be returned." + firstPullRequestContribution: CreatedPullRequestOrRestrictedContribution + "The first repository the user created on GitHub. This will be null if that first repository was created outside the collection's time range and ignoreTimeRange is false. If the repository is not visible, then a RestrictedContribution is returned." + firstRepositoryContribution: CreatedRepositoryOrRestrictedContribution + "Does the user have any more activity in the timeline that occurred prior to the collection's time range?" + hasActivityInThePast: Boolean! + "Determine if there are any contributions in this collection." + hasAnyContributions: Boolean! + "Determine if the user made any contributions in this time frame whose details are not visible because they were made in a private repository. Can only be true if the user enabled private contribution counts." + hasAnyRestrictedContributions: Boolean! + "Whether or not the collector's time span is all within the same day." + isSingleDay: Boolean! + "A list of issues the user opened." + issueContributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Should the user's first issue ever be excluded from the result." + excludeFirst: Boolean = false, + "Should the user's most commented issue be excluded from the result." + excludePopular: Boolean = false, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for contributions returned from the connection." + orderBy: ContributionOrder = {direction: DESC} + ): CreatedIssueContributionConnection! + "Issue contributions made by the user, grouped by repository." + issueContributionsByRepository( + "Should the user's first issue ever be excluded from the result." + excludeFirst: Boolean = false, + "Should the user's most commented issue be excluded from the result." + excludePopular: Boolean = false, + "How many repositories should be included." + maxRepositories: Int = 25 + ): [IssueContributionsByRepository!]! + "When the user signed up for GitHub. This will be null if that sign up date falls outside the collection's time range and ignoreTimeRange is false." + joinedGitHubContribution: JoinedGitHubContribution + "The date of the most recent restricted contribution the user made in this time period. Can only be non-null when the user has enabled private contribution counts." + latestRestrictedContributionDate: Date + """ + + When this collection's time range does not include any activity from the user, use this + to get a different collection from an earlier time range that does have activity. + """ + mostRecentCollectionWithActivity: ContributionsCollection + """ + + Returns a different contributions collection from an earlier time range than this one + that does not have any contributions. + """ + mostRecentCollectionWithoutActivity: ContributionsCollection + """ + + The issue the user opened on GitHub that received the most comments in the specified + time frame. + """ + popularIssueContribution: CreatedIssueContribution + """ + + The pull request the user opened on GitHub that received the most comments in the + specified time frame. + """ + popularPullRequestContribution: CreatedPullRequestContribution + "Pull request contributions made by the user." + pullRequestContributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Should the user's first pull request ever be excluded from the result." + excludeFirst: Boolean = false, + "Should the user's most commented pull request be excluded from the result." + excludePopular: Boolean = false, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for contributions returned from the connection." + orderBy: ContributionOrder = {direction: DESC} + ): CreatedPullRequestContributionConnection! + "Pull request contributions made by the user, grouped by repository." + pullRequestContributionsByRepository( + "Should the user's first pull request ever be excluded from the result." + excludeFirst: Boolean = false, + "Should the user's most commented pull request be excluded from the result." + excludePopular: Boolean = false, + "How many repositories should be included." + maxRepositories: Int = 25 + ): [PullRequestContributionsByRepository!]! + """ + + Pull request review contributions made by the user. Returns the most recently + submitted review for each PR reviewed by the user. + """ + pullRequestReviewContributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for contributions returned from the connection." + orderBy: ContributionOrder = {direction: DESC} + ): CreatedPullRequestReviewContributionConnection! + "Pull request review contributions made by the user, grouped by repository." + pullRequestReviewContributionsByRepository( + "How many repositories should be included." + maxRepositories: Int = 25 + ): [PullRequestReviewContributionsByRepository!]! + "A list of repositories owned by the user that the user created in this time range." + repositoryContributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Should the user's first repository ever be excluded from the result." + excludeFirst: Boolean = false, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for contributions returned from the connection." + orderBy: ContributionOrder = {direction: DESC} + ): CreatedRepositoryContributionConnection! + "A count of contributions made by the user that the viewer cannot access. Only non-zero when the user has chosen to share their private contribution counts." + restrictedContributionsCount: Int! + "The beginning date and time of this collection." + startedAt: DateTime! + "How many commits were made by the user in this time span." + totalCommitContributions: Int! + "How many issues the user opened." + totalIssueContributions( + "Should the user's first issue ever be excluded from this count." + excludeFirst: Boolean = false, + "Should the user's most commented issue be excluded from this count." + excludePopular: Boolean = false + ): Int! + "How many pull requests the user opened." + totalPullRequestContributions( + "Should the user's first pull request ever be excluded from this count." + excludeFirst: Boolean = false, + "Should the user's most commented pull request be excluded from this count." + excludePopular: Boolean = false + ): Int! + "How many pull request reviews the user left." + totalPullRequestReviewContributions: Int! + "How many different repositories the user committed to." + totalRepositoriesWithContributedCommits: Int! + "How many different repositories the user opened issues in." + totalRepositoriesWithContributedIssues( + "Should the user's first issue ever be excluded from this count." + excludeFirst: Boolean = false, + "Should the user's most commented issue be excluded from this count." + excludePopular: Boolean = false + ): Int! + "How many different repositories the user left pull request reviews in." + totalRepositoriesWithContributedPullRequestReviews: Int! + "How many different repositories the user opened pull requests in." + totalRepositoriesWithContributedPullRequests( + "Should the user's first pull request ever be excluded from this count." + excludeFirst: Boolean = false, + "Should the user's most commented pull request be excluded from this count." + excludePopular: Boolean = false + ): Int! + "How many repositories the user created." + totalRepositoryContributions( + "Should the user's first repository ever be excluded from this count." + excludeFirst: Boolean = false + ): Int! + "The user who made the contributions in this collection." + user: User! +} + +"Autogenerated return type of ConvertProjectCardNoteToIssue." +type ConvertProjectCardNoteToIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated ProjectCard." + projectCard: ProjectCard +} + +"Autogenerated return type of ConvertProjectV2DraftIssueItemToIssue." +type ConvertProjectV2DraftIssueItemToIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated project item." + item: ProjectV2Item +} + +"Autogenerated return type of ConvertPullRequestToDraft." +type ConvertPullRequestToDraftPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request that is now a draft." + pullRequest: PullRequest +} + +"Represents a 'convert_to_draft' event on a given pull request." +type ConvertToDraftEvent implements Node & UniformResourceLocatable { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ConvertToDraftEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! + "The HTTP path for this convert to draft event." + resourcePath: URI! + "The HTTP URL for this convert to draft event." + url: URI! +} + +"Represents a 'converted_note_to_issue' event on a given issue or pull request." +type ConvertedNoteToIssueEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the ConvertedNoteToIssueEvent object" + id: ID! + "Project referenced by event." + project: Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Project card referenced by this project event." + projectCard: ProjectCard @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Column name referenced by this project event." + projectColumnName: String! +} + +"Represents a 'converted_to_discussion' event on a given issue." +type ConvertedToDiscussionEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The discussion that the issue was converted into." + discussion: Discussion + "The Node ID of the ConvertedToDiscussionEvent object" + id: ID! +} + +"Request Copilot code review for new pull requests automatically if the author has access to Copilot code review." +type CopilotCodeReviewParameters { + "Copilot automatically reviews draft pull requests before they are marked as ready for review." + reviewDraftPullRequests: Boolean! + "Copilot automatically reviews each new push to the pull request." + reviewOnPush: Boolean! +} + +"Copilot endpoint information" +type CopilotEndpoints { + "Copilot API endpoint" + api: String! + "Copilot origin tracker endpoint" + originTracker: String! + "Copilot proxy endpoint" + proxy: String! + "Copilot telemetry endpoint" + telemetry: String! +} + +"Autogenerated return type of CopyProjectV2." +type CopyProjectV2Payload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The copied project." + projectV2: ProjectV2 +} + +"Autogenerated return type of CreateAttributionInvitation." +type CreateAttributionInvitationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The owner scoping the reattributable data." + owner: Organization + "The account owning the data to reattribute." + source: Claimable + "The account which may claim the data." + target: Claimable +} + +"Autogenerated return type of CreateBranchProtectionRule." +type CreateBranchProtectionRulePayload { + "The newly created BranchProtectionRule." + branchProtectionRule: BranchProtectionRule + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of CreateCheckRun." +type CreateCheckRunPayload { + "The newly created check run." + checkRun: CheckRun + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of CreateCheckSuite." +type CreateCheckSuitePayload { + "The newly created check suite." + checkSuite: CheckSuite + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of CreateCommitOnBranch." +type CreateCommitOnBranchPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new commit." + commit: Commit + "The ref which has been updated to point to the new commit." + ref: Ref +} + +"Autogenerated return type of CreateDeployment." +type CreateDeploymentPayload { + "True if the default branch has been auto-merged into the deployment ref." + autoMerged: Boolean + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new deployment." + deployment: Deployment +} + +"Autogenerated return type of CreateDeploymentStatus." +type CreateDeploymentStatusPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new deployment status." + deploymentStatus: DeploymentStatus +} + +"Autogenerated return type of CreateDiscussion." +type CreateDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion that was just created." + discussion: Discussion +} + +"Autogenerated return type of CreateEnterpriseOrganization." +type CreateEnterpriseOrganizationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise that owns the created organization." + enterprise: Enterprise + "The organization that was created." + organization: Organization +} + +"Autogenerated return type of CreateEnvironment." +type CreateEnvironmentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new or existing environment." + environment: Environment +} + +"Autogenerated return type of CreateIpAllowListEntry." +type CreateIpAllowListEntryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The IP allow list entry that was created." + ipAllowListEntry: IpAllowListEntry +} + +"Autogenerated return type of CreateIssue." +type CreateIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new issue." + issue: Issue +} + +"Autogenerated return type of CreateIssueType." +type CreateIssueTypePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created issue type" + issueType: IssueType +} + +"Autogenerated return type of CreateLabel." +type CreateLabelPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new label." + label: Label +} + +"Autogenerated return type of CreateLinkedBranch." +type CreateLinkedBranchPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue that was linked to." + issue: Issue + "The new branch issue reference." + linkedBranch: LinkedBranch +} + +"Autogenerated return type of CreateMigrationSource." +type CreateMigrationSourcePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The created migration source." + migrationSource: MigrationSource +} + +"Autogenerated return type of CreateProject." +type CreateProjectPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new project." + project: Project +} + +"Autogenerated return type of CreateProjectV2Field." +type CreateProjectV2FieldPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new field." + projectV2Field: ProjectV2FieldConfiguration +} + +"Autogenerated return type of CreateProjectV2." +type CreateProjectV2Payload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new project." + projectV2: ProjectV2 +} + +"Autogenerated return type of CreateProjectV2StatusUpdate." +type CreateProjectV2StatusUpdatePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The status update updated in the project." + statusUpdate: ProjectV2StatusUpdate +} + +"Autogenerated return type of CreatePullRequest." +type CreatePullRequestPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new pull request." + pullRequest: PullRequest +} + +"Autogenerated return type of CreateRef." +type CreateRefPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created ref." + ref: Ref +} + +"Autogenerated return type of CreateRepository." +type CreateRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new repository." + repository: Repository +} + +"Autogenerated return type of CreateRepositoryRuleset." +type CreateRepositoryRulesetPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created Ruleset." + ruleset: RepositoryRuleset +} + +"Autogenerated return type of CreateSponsorsListing." +type CreateSponsorsListingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new GitHub Sponsors profile." + sponsorsListing: SponsorsListing +} + +"Autogenerated return type of CreateSponsorsTier." +type CreateSponsorsTierPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new tier." + sponsorsTier: SponsorsTier +} + +"Autogenerated return type of CreateSponsorship." +type CreateSponsorshipPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The sponsorship that was started." + sponsorship: Sponsorship +} + +"Autogenerated return type of CreateSponsorships." +type CreateSponsorshipsPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The users and organizations who received a sponsorship." + sponsorables: [Sponsorable!] +} + +"Autogenerated return type of CreateTeamDiscussionComment." +type CreateTeamDiscussionCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new comment." + teamDiscussionComment: TeamDiscussionComment @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") +} + +"Autogenerated return type of CreateTeamDiscussion." +type CreateTeamDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new discussion." + teamDiscussion: TeamDiscussion @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") +} + +"Autogenerated return type of CreateUserList." +type CreateUserListPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The list that was just created" + list: UserList + "The user who created the list" + viewer: User +} + +"Represents the contribution a user made by committing to a repository." +type CreatedCommitContribution implements Contribution { + "How many commits were made on this day to this repository by the user." + commitCount: Int! + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "When this contribution was made." + occurredAt: DateTime! + "The repository the user made a commit in." + repository: Repository! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"The connection type for CreatedCommitContribution." +type CreatedCommitContributionConnection { + "A list of edges." + edges: [CreatedCommitContributionEdge] + "A list of nodes." + nodes: [CreatedCommitContribution] + "Information to aid in pagination." + pageInfo: PageInfo! + """ + + Identifies the total count of commits across days and repositories in the connection. + """ + totalCount: Int! +} + +"An edge in a connection." +type CreatedCommitContributionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CreatedCommitContribution +} + +"Represents the contribution a user made on GitHub by opening an issue." +type CreatedIssueContribution implements Contribution { + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "The issue that was opened." + issue: Issue! + "When this contribution was made." + occurredAt: DateTime! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"The connection type for CreatedIssueContribution." +type CreatedIssueContributionConnection { + "A list of edges." + edges: [CreatedIssueContributionEdge] + "A list of nodes." + nodes: [CreatedIssueContribution] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CreatedIssueContributionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CreatedIssueContribution +} + +"Represents the contribution a user made on GitHub by opening a pull request." +type CreatedPullRequestContribution implements Contribution { + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "When this contribution was made." + occurredAt: DateTime! + "The pull request that was opened." + pullRequest: PullRequest! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"The connection type for CreatedPullRequestContribution." +type CreatedPullRequestContributionConnection { + "A list of edges." + edges: [CreatedPullRequestContributionEdge] + "A list of nodes." + nodes: [CreatedPullRequestContribution] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CreatedPullRequestContributionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CreatedPullRequestContribution +} + +"Represents the contribution a user made by leaving a review on a pull request." +type CreatedPullRequestReviewContribution implements Contribution { + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "When this contribution was made." + occurredAt: DateTime! + "The pull request the user reviewed." + pullRequest: PullRequest! + "The review the user left on the pull request." + pullRequestReview: PullRequestReview! + "The repository containing the pull request that the user reviewed." + repository: Repository! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"The connection type for CreatedPullRequestReviewContribution." +type CreatedPullRequestReviewContributionConnection { + "A list of edges." + edges: [CreatedPullRequestReviewContributionEdge] + "A list of nodes." + nodes: [CreatedPullRequestReviewContribution] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CreatedPullRequestReviewContributionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CreatedPullRequestReviewContribution +} + +"Represents the contribution a user made on GitHub by creating a repository." +type CreatedRepositoryContribution implements Contribution { + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "When this contribution was made." + occurredAt: DateTime! + "The repository that was created." + repository: Repository! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"The connection type for CreatedRepositoryContribution." +type CreatedRepositoryContributionConnection { + "A list of edges." + edges: [CreatedRepositoryContributionEdge] + "A list of nodes." + nodes: [CreatedRepositoryContribution] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type CreatedRepositoryContributionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: CreatedRepositoryContribution +} + +"Represents a mention made by one issue or pull request to another." +type CrossReferencedEvent implements Node & UniformResourceLocatable { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the CrossReferencedEvent object" + id: ID! + "Reference originated in a different repository." + isCrossRepository: Boolean! + "Identifies when the reference was made." + referencedAt: DateTime! + "The HTTP path for this pull request." + resourcePath: URI! + "Issue or pull request that made the reference." + source: ReferencedSubject! + "Issue or pull request to which the reference was made." + target: ReferencedSubject! + "The HTTP URL for this pull request." + url: URI! + "Checks if the target will be closed when the source is merged." + willCloseTarget: Boolean! +} + +"The Common Vulnerability Scoring System" +type CvssSeverities { + "The CVSS v3 severity associated with this advisory" + cvssV3: CVSS + "The CVSS v4 severity associated with this advisory" + cvssV4: CVSS +} + +"Autogenerated return type of DeclineTopicSuggestion." +type DeclineTopicSuggestionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The declined topic." + topic: Topic @deprecated(reason: "Suggested topics are no longer supported Removal on 2024-04-01 UTC.") +} + +"Autogenerated return type of DeleteBranchProtectionRule." +type DeleteBranchProtectionRulePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteDeployment." +type DeleteDeploymentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteDiscussionComment." +type DeleteDiscussionCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion comment that was just deleted." + comment: DiscussionComment +} + +"Autogenerated return type of DeleteDiscussion." +type DeleteDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion that was just deleted." + discussion: Discussion +} + +"Autogenerated return type of DeleteEnvironment." +type DeleteEnvironmentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteIpAllowListEntry." +type DeleteIpAllowListEntryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The IP allow list entry that was deleted." + ipAllowListEntry: IpAllowListEntry +} + +"Autogenerated return type of DeleteIssueComment." +type DeleteIssueCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteIssue." +type DeleteIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository the issue belonged to" + repository: Repository +} + +"Autogenerated return type of DeleteIssueType." +type DeleteIssueTypePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the deleted issue type" + deletedIssueTypeId: ID +} + +"Autogenerated return type of DeleteLabel." +type DeleteLabelPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteLinkedBranch." +type DeleteLinkedBranchPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue the linked branch was unlinked from." + issue: Issue +} + +"Autogenerated return type of DeletePackageVersion." +type DeletePackageVersionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether or not the operation succeeded." + success: Boolean +} + +"Autogenerated return type of DeleteProjectCard." +type DeleteProjectCardPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The column the deleted card was in." + column: ProjectColumn + "The deleted card ID." + deletedCardId: ID +} + +"Autogenerated return type of DeleteProjectColumn." +type DeleteProjectColumnPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The deleted column ID." + deletedColumnId: ID + "The project the deleted column was in." + project: Project +} + +"Autogenerated return type of DeleteProject." +type DeleteProjectPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository or organization the project was removed from." + owner: ProjectOwner +} + +"Autogenerated return type of DeleteProjectV2Field." +type DeleteProjectV2FieldPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The deleted field." + projectV2Field: ProjectV2FieldConfiguration +} + +"Autogenerated return type of DeleteProjectV2Item." +type DeleteProjectV2ItemPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the deleted item." + deletedItemId: ID +} + +"Autogenerated return type of DeleteProjectV2." +type DeleteProjectV2Payload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The deleted Project." + projectV2: ProjectV2 +} + +"Autogenerated return type of DeleteProjectV2StatusUpdate." +type DeleteProjectV2StatusUpdatePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the deleted status update." + deletedStatusUpdateId: ID + "The project the deleted status update was in." + projectV2: ProjectV2 +} + +"Autogenerated return type of DeleteProjectV2Workflow." +type DeleteProjectV2WorkflowPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the deleted workflow." + deletedWorkflowId: ID + "The project the deleted workflow was in." + projectV2: ProjectV2 +} + +"Autogenerated return type of DeletePullRequestReviewComment." +type DeletePullRequestReviewCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request review the deleted comment belonged to." + pullRequestReview: PullRequestReview + "The deleted pull request review comment." + pullRequestReviewComment: PullRequestReviewComment +} + +"Autogenerated return type of DeletePullRequestReview." +type DeletePullRequestReviewPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The deleted pull request review." + pullRequestReview: PullRequestReview +} + +"Autogenerated return type of DeleteRef." +type DeleteRefPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteRepositoryRuleset." +type DeleteRepositoryRulesetPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteTeamDiscussionComment." +type DeleteTeamDiscussionCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteTeamDiscussion." +type DeleteTeamDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of DeleteUserList." +type DeleteUserListPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The owner of the list that will be deleted" + user: User +} + +"Autogenerated return type of DeleteVerifiableDomain." +type DeleteVerifiableDomainPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The owning account from which the domain was deleted." + owner: VerifiableDomainOwner +} + +"Represents a 'demilestoned' event on a given issue or pull request." +type DemilestonedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the DemilestonedEvent object" + id: ID! + "Identifies the milestone title associated with the 'demilestoned' event." + milestoneTitle: String! + "Object referenced by event." + subject: MilestoneItem! +} + +"A Dependabot Update for a dependency in a repository" +type DependabotUpdate implements RepositoryNode { + "The error from a dependency update" + error: DependabotUpdateError + "The associated pull request" + pullRequest: PullRequest + "The repository associated with this node." + repository: Repository! +} + +"An error produced from a Dependabot Update" +type DependabotUpdateError { + "The body of the error" + body: String! + "The error code" + errorType: String! + "The title of the error" + title: String! +} + +"A dependency manifest entry" +type DependencyGraphDependency { + "Does the dependency itself have dependencies?" + hasDependencies: Boolean! + "The original name of the package, as it appears in the manifest." + packageLabel: String! @deprecated(reason: "`packageLabel` will be removed. Use normalized `packageName` field instead. Removal on 2022-10-01 UTC.") + "The dependency package manager" + packageManager: String + "The name of the package in the canonical form used by the package manager." + packageName: String! + "Public preview: The dependency package URL" + packageUrl: URI + "Public preview: The relationship of the dependency. Can be direct, transitive, or unknown" + relationship: String! + "The repository containing the package" + repository: Repository + "The dependency version requirements" + requirements: String! +} + +"The connection type for DependencyGraphDependency." +type DependencyGraphDependencyConnection { + "A list of edges." + edges: [DependencyGraphDependencyEdge] + "A list of nodes." + nodes: [DependencyGraphDependency] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DependencyGraphDependencyEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DependencyGraphDependency +} + +"Dependency manifest for a repository" +type DependencyGraphManifest implements Node { + "Path to view the manifest file blob" + blobPath: String! + "A list of manifest dependencies" + dependencies( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DependencyGraphDependencyConnection + "The number of dependencies listed in the manifest" + dependenciesCount: Int + "Is the manifest too big to parse?" + exceedsMaxSize: Boolean! + "Fully qualified manifest filename" + filename: String! + "The Node ID of the DependencyGraphManifest object" + id: ID! + "Were we able to parse the manifest?" + parseable: Boolean! + "The repository containing the manifest" + repository: Repository! +} + +"The connection type for DependencyGraphManifest." +type DependencyGraphManifestConnection { + "A list of edges." + edges: [DependencyGraphManifestEdge] + "A list of nodes." + nodes: [DependencyGraphManifest] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DependencyGraphManifestEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DependencyGraphManifest +} + +"A repository deploy key." +type DeployKey implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Whether or not the deploy key is enabled by policy at the Enterprise or Organization level." + enabled: Boolean! + "The Node ID of the DeployKey object" + id: ID! + "The deploy key." + key: String! + "Whether or not the deploy key is read only." + readOnly: Boolean! + "The deploy key title." + title: String! + "Whether or not the deploy key has been verified." + verified: Boolean! +} + +"The connection type for DeployKey." +type DeployKeyConnection { + "A list of edges." + edges: [DeployKeyEdge] + "A list of nodes." + nodes: [DeployKey] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DeployKeyEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DeployKey +} + +"Represents a 'deployed' event on a given pull request." +type DeployedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The deployment associated with the 'deployed' event." + deployment: Deployment! + "The Node ID of the DeployedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! + "The ref associated with the 'deployed' event." + ref: Ref +} + +"Represents triggered deployment instance." +type Deployment implements Node { + "Identifies the commit sha of the deployment." + commit: Commit + "Identifies the oid of the deployment commit, even if the commit has been deleted." + commitOid: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the actor who triggered the deployment." + creator: Actor! + "Identifies the primary key from the database." + databaseId: Int + "The deployment description." + description: String + "The latest environment to which this deployment was made." + environment: String + "The Node ID of the Deployment object" + id: ID! + "The latest environment to which this deployment was made." + latestEnvironment: String + "The latest status of this deployment." + latestStatus: DeploymentStatus + "The original environment to which this deployment was made." + originalEnvironment: String + "Extra information that a deployment system might need." + payload: String + "Identifies the Ref of the deployment, if the deployment was created by ref." + ref: Ref + "Identifies the repository associated with the deployment." + repository: Repository! + "The current state of the deployment." + state: DeploymentState + "A list of statuses associated with the deployment." + statuses( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DeploymentStatusConnection + "The deployment task." + task: String + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for Deployment." +type DeploymentConnection { + "A list of edges." + edges: [DeploymentEdge] + "A list of nodes." + nodes: [Deployment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DeploymentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Deployment +} + +"Represents a 'deployment_environment_changed' event on a given pull request." +type DeploymentEnvironmentChangedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The deployment status that updated the deployment environment." + deploymentStatus: DeploymentStatus! + "The Node ID of the DeploymentEnvironmentChangedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! +} + +"A protection rule." +type DeploymentProtectionRule { + "Identifies the primary key from the database." + databaseId: Int + "Whether deployments to this environment can be approved by the user who created the deployment." + preventSelfReview: Boolean + "The teams or users that can review the deployment" + reviewers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DeploymentReviewerConnection! + "The timeout in minutes for this protection rule." + timeout: Int! + "The type of protection rule." + type: DeploymentProtectionRuleType! +} + +"The connection type for DeploymentProtectionRule." +type DeploymentProtectionRuleConnection { + "A list of edges." + edges: [DeploymentProtectionRuleEdge] + "A list of nodes." + nodes: [DeploymentProtectionRule] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DeploymentProtectionRuleEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DeploymentProtectionRule +} + +"A request to deploy a workflow run to an environment." +type DeploymentRequest { + "Whether or not the current user can approve the deployment" + currentUserCanApprove: Boolean! + "The target environment of the deployment" + environment: Environment! + "The teams or users that can review the deployment" + reviewers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DeploymentReviewerConnection! + "The wait timer in minutes configured in the environment" + waitTimer: Int! + "The wait timer in minutes configured in the environment" + waitTimerStartedAt: DateTime +} + +"The connection type for DeploymentRequest." +type DeploymentRequestConnection { + "A list of edges." + edges: [DeploymentRequestEdge] + "A list of nodes." + nodes: [DeploymentRequest] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DeploymentRequestEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DeploymentRequest +} + +"A deployment review." +type DeploymentReview implements Node { + "The comment the user left." + comment: String! + "Identifies the primary key from the database." + databaseId: Int + "The environments approved or rejected" + environments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): EnvironmentConnection! + "The Node ID of the DeploymentReview object" + id: ID! + "The decision of the user." + state: DeploymentReviewState! + "The user that reviewed the deployment." + user: User! +} + +"The connection type for DeploymentReview." +type DeploymentReviewConnection { + "A list of edges." + edges: [DeploymentReviewEdge] + "A list of nodes." + nodes: [DeploymentReview] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DeploymentReviewEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DeploymentReview +} + +"The connection type for DeploymentReviewer." +type DeploymentReviewerConnection { + "A list of edges." + edges: [DeploymentReviewerEdge] + "A list of nodes." + nodes: [DeploymentReviewer] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DeploymentReviewerEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DeploymentReviewer +} + +"Describes the status of a given deployment attempt." +type DeploymentStatus implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the actor who triggered the deployment." + creator: Actor! + "Identifies the deployment associated with status." + deployment: Deployment! + "Identifies the description of the deployment." + description: String + "Identifies the environment of the deployment at the time of this deployment status" + environment: String + "Identifies the environment URL of the deployment." + environmentUrl: URI + "The Node ID of the DeploymentStatus object" + id: ID! + "Identifies the log URL of the deployment." + logUrl: URI + "Identifies the current state of the deployment." + state: DeploymentStatusState! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for DeploymentStatus." +type DeploymentStatusConnection { + "A list of edges." + edges: [DeploymentStatusEdge] + "A list of nodes." + nodes: [DeploymentStatus] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DeploymentStatusEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DeploymentStatus +} + +"Autogenerated return type of DequeuePullRequest." +type DequeuePullRequestPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The merge queue entry of the dequeued pull request." + mergeQueueEntry: MergeQueueEntry +} + +"Autogenerated return type of DisablePullRequestAutoMerge." +type DisablePullRequestAutoMergePayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request auto merge was disabled on." + pullRequest: PullRequest +} + +"Represents a 'disconnected' event on a given issue or pull request." +type DisconnectedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the DisconnectedEvent object" + id: ID! + "Reference originated in a different repository." + isCrossRepository: Boolean! + "Issue or pull request from which the issue was disconnected." + source: ReferencedSubject! + "Issue or pull request which was disconnected." + subject: ReferencedSubject! +} + +"A discussion in a repository." +type Discussion implements Closable & Comment & Deletable & Labelable & Lockable & Node & Reactable & RepositoryNode & Subscribable & Updatable & Votable { + "Reason that the conversation was locked." + activeLockReason: LockReason + "The comment chosen as this discussion's answer, if any." + answer: DiscussionComment + "The time when a user chose this discussion's answer, if answered." + answerChosenAt: DateTime + "The user who chose this discussion's answer, if answered." + answerChosenBy: Actor + "The actor who authored the discussion." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "The main text of the discussion post." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "The category for this discussion." + category: DiscussionCategory! + "Indicates if the object is closed (definition of closed may depend on type)" + closed: Boolean! + "Identifies the date and time when the object was closed." + closedAt: DateTime + "The replies to the discussion." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DiscussionCommentConnection! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The actor who edited the comment." + editor: Actor + "The Node ID of the Discussion object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Only return answered/unanswered discussions" + isAnswered: Boolean + "A list of labels associated with the object." + labels( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for labels returned from the connection." + orderBy: LabelOrder = {field: CREATED_AT, direction: ASC} + ): LabelConnection + "The moment the editor made the last edit" + lastEditedAt: DateTime + "`true` if the object is locked" + locked: Boolean! + "The number identifying this discussion within the repository." + number: Int! + "The poll associated with this discussion, if one exists." + poll: DiscussionPoll + "Identifies when the comment was published at." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The repository associated with this node." + repository: Repository! + "The path for this discussion." + resourcePath: URI! + "Identifies the reason for the discussion's state." + stateReason: DiscussionStateReason + "The title of this discussion." + title: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "Number of upvotes that this subject has received." + upvoteCount: Int! + "The URL for this discussion." + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Indicates if the object can be closed by the viewer." + viewerCanClose: Boolean! + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Indicates if the viewer can edit labels for this object." + viewerCanLabel: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Indicates if the object can be reopened by the viewer." + viewerCanReopen: Boolean! + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Whether or not the current user can add or remove an upvote on this subject." + viewerCanUpvote: Boolean! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! + "Whether or not the current user has already upvoted this subject." + viewerHasUpvoted: Boolean! + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState +} + +"A category for discussions in a repository." +type DiscussionCategory implements Node & RepositoryNode { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "A description of this category." + description: String + "An emoji representing this category." + emoji: String! + "This category's emoji rendered as HTML." + emojiHTML: HTML! + "The Node ID of the DiscussionCategory object" + id: ID! + "Whether or not discussions in this category support choosing an answer with the markDiscussionCommentAsAnswer mutation." + isAnswerable: Boolean! + "The name of this category." + name: String! + "The repository associated with this node." + repository: Repository! + "The slug of this category." + slug: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for DiscussionCategory." +type DiscussionCategoryConnection { + "A list of edges." + edges: [DiscussionCategoryEdge] + "A list of nodes." + nodes: [DiscussionCategory] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DiscussionCategoryEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DiscussionCategory +} + +"A comment on a discussion." +type DiscussionComment implements Comment & Deletable & Minimizable & Node & Reactable & Updatable & UpdatableComment & Votable { + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "The body as Markdown." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The time when this replied-to comment was deleted" + deletedAt: DateTime + "The discussion this comment was created in" + discussion: Discussion + "The actor who edited the comment." + editor: Actor + "The Node ID of the DiscussionComment object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Has this comment been chosen as the answer of its discussion?" + isAnswer: Boolean! + "Returns whether or not a comment has been minimized." + isMinimized: Boolean! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Returns why the comment was minimized. One of `abuse`, `off-topic`, `outdated`, `resolved`, `duplicate` and `spam`. Note that the case and formatting of these values differs from the inputs to the `MinimizeComment` mutation." + minimizedReason: String + "Identifies when the comment was published at." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The threaded replies to this comment." + replies( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DiscussionCommentConnection! + "The discussion comment this comment is a reply to" + replyTo: DiscussionComment + "The path for this discussion comment." + resourcePath: URI! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "Number of upvotes that this subject has received." + upvoteCount: Int! + "The URL for this discussion comment." + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Can the current user mark this comment as an answer?" + viewerCanMarkAsAnswer: Boolean! + "Check if the current viewer can minimize this object." + viewerCanMinimize: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Can the current user unmark this comment as an answer?" + viewerCanUnmarkAsAnswer: Boolean! + "Check if the current viewer can unminimize this object." + viewerCanUnminimize: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Whether or not the current user can add or remove an upvote on this subject." + viewerCanUpvote: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! + "Whether or not the current user has already upvoted this subject." + viewerHasUpvoted: Boolean! +} + +"The connection type for DiscussionComment." +type DiscussionCommentConnection { + "A list of edges." + edges: [DiscussionCommentEdge] + "A list of nodes." + nodes: [DiscussionComment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DiscussionCommentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DiscussionComment +} + +"The connection type for Discussion." +type DiscussionConnection { + "A list of edges." + edges: [DiscussionEdge] + "A list of nodes." + nodes: [Discussion] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DiscussionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Discussion +} + +"A poll for a discussion." +type DiscussionPoll implements Node { + "The discussion that this poll belongs to." + discussion: Discussion + "The Node ID of the DiscussionPoll object" + id: ID! + "The options for this poll." + options( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "How to order the options for the discussion poll." + orderBy: DiscussionPollOptionOrder = {field: AUTHORED_ORDER, direction: ASC} + ): DiscussionPollOptionConnection + "The question that is being asked by this poll." + question: String! + "The total number of votes that have been cast for this poll." + totalVoteCount: Int! + "Indicates if the viewer has permission to vote in this poll." + viewerCanVote: Boolean! + "Indicates if the viewer has voted for any option in this poll." + viewerHasVoted: Boolean! +} + +"An option for a discussion poll." +type DiscussionPollOption implements Node { + "The Node ID of the DiscussionPollOption object" + id: ID! + "The text for this option." + option: String! + "The discussion poll that this option belongs to." + poll: DiscussionPoll + "The total number of votes that have been cast for this option." + totalVoteCount: Int! + "Indicates if the viewer has voted for this option in the poll." + viewerHasVoted: Boolean! +} + +"The connection type for DiscussionPollOption." +type DiscussionPollOptionConnection { + "A list of edges." + edges: [DiscussionPollOptionEdge] + "A list of nodes." + nodes: [DiscussionPollOption] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type DiscussionPollOptionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: DiscussionPollOption +} + +"Autogenerated return type of DismissPullRequestReview." +type DismissPullRequestReviewPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The dismissed pull request review." + pullRequestReview: PullRequestReview +} + +"Autogenerated return type of DismissRepositoryVulnerabilityAlert." +type DismissRepositoryVulnerabilityAlertPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Dependabot alert that was dismissed" + repositoryVulnerabilityAlert: RepositoryVulnerabilityAlert +} + +"A draft issue within a project." +type DraftIssue implements Node { + "A list of users to assigned to this draft issue." + assignees( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "The body of the draft issue." + body: String! + "The body of the draft issue rendered to HTML." + bodyHTML: HTML! + "The body of the draft issue rendered to text." + bodyText: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created this draft issue." + creator: Actor + "The Node ID of the DraftIssue object" + id: ID! + "List of items linked with the draft issue (currently draft issue can be linked to only one item)." + projectV2Items( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2ItemConnection! + "Projects that link to this draft issue (currently draft issue can be linked to only one project)." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2Connection! + "The title of the draft issue" + title: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The Exploit Prediction Scoring System" +type EPSS { + "The EPSS percentage represents the likelihood of a CVE being exploited." + percentage: Float + "The EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs." + percentile: Float +} + +"Autogenerated return type of EnablePullRequestAutoMerge." +type EnablePullRequestAutoMergePayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request auto-merge was enabled on." + pullRequest: PullRequest +} + +"Autogenerated return type of EnqueuePullRequest." +type EnqueuePullRequestPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The merge queue entry for the enqueued pull request." + mergeQueueEntry: MergeQueueEntry +} + +"An account to manage multiple organizations with consolidated policy and billing." +type Enterprise implements Node { + "The announcement banner set on this enterprise, if any. Only visible to members of the enterprise." + announcementBanner: AnnouncementBanner + "A URL pointing to the enterprise's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "The enterprise's billing email." + billingEmail: String + "Enterprise billing information visible to enterprise billing managers." + billingInfo: EnterpriseBillingInfo + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The description of the enterprise." + description: String + "The description of the enterprise as HTML." + descriptionHTML: HTML! + "The Node ID of the Enterprise object" + id: ID! + "The location of the enterprise." + location: String + "A list of users who are members of this enterprise." + members( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Only return members within the selected GitHub Enterprise deployment" + deployment: EnterpriseUserDeployment, + "Returns the first _n_ elements from the list." + first: Int, + """ + + Only return members with this two-factor authentication status. Does not include members who only have an account on a GitHub Enterprise Server instance. + + **Upcoming Change on 2025-04-01 UTC** + **Description:** `hasTwoFactorEnabled` will be removed. Use `two_factor_method_security` instead. + **Reason:** `has_two_factor_enabled` will be removed. + """ + hasTwoFactorEnabled: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for members returned from the connection." + orderBy: EnterpriseMemberOrder = {field: LOGIN, direction: ASC}, + "Only return members within the organizations with these logins" + organizationLogins: [String!], + "The search string to look for." + query: String, + "The role of the user in the enterprise organization or server." + role: EnterpriseUserAccountMembershipRole, + "Only return members with this type of two-factor authentication method. Does not include members who only have an account on a GitHub Enterprise Server instance." + twoFactorMethodSecurity: TwoFactorCredentialSecurityType + ): EnterpriseMemberConnection! + "The name of the enterprise." + name: String! + "A list of organizations that belong to this enterprise." + organizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations returned from the connection." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The search string to look for." + query: String, + "The viewer's role in an organization." + viewerOrganizationRole: RoleInOrganization + ): OrganizationConnection! + "Enterprise information visible to enterprise owners or enterprise owners' personal access tokens (classic) with read:enterprise or admin:enterprise scope." + ownerInfo: EnterpriseOwnerInfo + "The raw content of the enterprise README." + readme: String + "The content of the enterprise README as HTML." + readmeHTML: HTML! + "The HTTP path for this enterprise." + resourcePath: URI! + "Returns a single ruleset from the current enterprise by ID." + ruleset( + "The ID of the ruleset to be returned." + databaseId: Int! + ): RepositoryRuleset + "A list of rulesets for this enterprise." + rulesets( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): RepositoryRulesetConnection + "The enterprise's security contact email address." + securityContactEmail: String + "The URL-friendly identifier for the enterprise." + slug: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this enterprise." + url: URI! + "A list of repositories that belong to users. Only available for enterprises with Enterprise Managed Users." + userNamespaceRepositories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection." + orderBy: RepositoryOrder = {field: NAME, direction: ASC}, + "The search string to look for." + query: String + ): UserNamespaceRepositoryConnection! + "Is the current viewer an admin of this enterprise?" + viewerIsAdmin: Boolean! + "The URL of the enterprise website." + websiteUrl: URI +} + +"The connection type for User." +type EnterpriseAdministratorConnection { + "A list of edges." + edges: [EnterpriseAdministratorEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"A User who is an administrator of an enterprise." +type EnterpriseAdministratorEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: User + "The role of the administrator." + role: EnterpriseAdministratorRole! +} + +"An invitation for a user to become an owner or billing manager of an enterprise." +type EnterpriseAdministratorInvitation implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The email of the person who was invited to the enterprise." + email: String + "The enterprise the invitation is for." + enterprise: Enterprise! + "The Node ID of the EnterpriseAdministratorInvitation object" + id: ID! + "The user who was invited to the enterprise." + invitee: User + "The user who created the invitation." + inviter: User + "The invitee's pending role in the enterprise (owner or billing_manager)." + role: EnterpriseAdministratorRole! +} + +"The connection type for EnterpriseAdministratorInvitation." +type EnterpriseAdministratorInvitationConnection { + "A list of edges." + edges: [EnterpriseAdministratorInvitationEdge] + "A list of nodes." + nodes: [EnterpriseAdministratorInvitation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseAdministratorInvitationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseAdministratorInvitation +} + +"Enterprise billing information visible to enterprise billing managers and owners." +type EnterpriseBillingInfo { + "The number of licenseable users/emails across the enterprise." + allLicensableUsersCount: Int! + "The number of data packs used by all organizations owned by the enterprise." + assetPacks: Int! + "The bandwidth quota in GB for all organizations owned by the enterprise." + bandwidthQuota: Float! + "The bandwidth usage in GB for all organizations owned by the enterprise." + bandwidthUsage: Float! + "The bandwidth usage as a percentage of the bandwidth quota." + bandwidthUsagePercentage: Int! + "The storage quota in GB for all organizations owned by the enterprise." + storageQuota: Float! + "The storage usage in GB for all organizations owned by the enterprise." + storageUsage: Float! + "The storage usage as a percentage of the storage quota." + storageUsagePercentage: Int! + "The number of available licenses across all owned organizations based on the unique number of billable users." + totalAvailableLicenses: Int! + "The total number of licenses allocated." + totalLicenses: Int! +} + +"The connection type for Enterprise." +type EnterpriseConnection { + "A list of edges." + edges: [EnterpriseEdge] + "A list of nodes." + nodes: [Enterprise] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Enterprise +} + +"The connection type for OrganizationInvitation." +type EnterpriseFailedInvitationConnection { + "A list of edges." + edges: [EnterpriseFailedInvitationEdge] + "A list of nodes." + nodes: [OrganizationInvitation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "Identifies the total count of unique users in the connection." + totalUniqueUserCount: Int! +} + +"A failed invitation to be a member in an enterprise organization." +type EnterpriseFailedInvitationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: OrganizationInvitation +} + +"An identity provider configured to provision identities for an enterprise. Visible to enterprise owners or enterprise owners' personal access tokens (classic) with read:enterprise or admin:enterprise scope." +type EnterpriseIdentityProvider implements Node { + "The digest algorithm used to sign SAML requests for the identity provider." + digestMethod: SamlDigestAlgorithm + "The enterprise this identity provider belongs to." + enterprise: Enterprise + "ExternalIdentities provisioned by this identity provider." + externalIdentities( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter to external identities with the users login" + login: String, + "Filter to external identities with valid org membership only" + membersOnly: Boolean, + "Filter to external identities with the users userName/NameID attribute" + userName: String + ): ExternalIdentityConnection! + "The Node ID of the EnterpriseIdentityProvider object" + id: ID! + "The x509 certificate used by the identity provider to sign assertions and responses." + idpCertificate: X509Certificate + "The Issuer Entity ID for the SAML identity provider." + issuer: String + "Recovery codes that can be used by admins to access the enterprise if the identity provider is unavailable." + recoveryCodes: [String!] + "The signature algorithm used to sign SAML requests for the identity provider." + signatureMethod: SamlSignatureAlgorithm + "The URL endpoint for the identity provider's SAML SSO." + ssoUrl: URI +} + +"The connection type for EnterpriseMember." +type EnterpriseMemberConnection { + "A list of edges." + edges: [EnterpriseMemberEdge] + "A list of nodes." + nodes: [EnterpriseMember] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"A User who is a member of an enterprise through one or more organizations." +type EnterpriseMemberEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseMember +} + +"An invitation for a user to become an unaffiliated member of an enterprise." +type EnterpriseMemberInvitation implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The email of the person who was invited to the enterprise." + email: String + "The enterprise the invitation is for." + enterprise: Enterprise! + "The Node ID of the EnterpriseMemberInvitation object" + id: ID! + "The user who was invited to the enterprise." + invitee: User + "The user who created the invitation." + inviter: User +} + +"The connection type for EnterpriseMemberInvitation." +type EnterpriseMemberInvitationConnection { + "A list of edges." + edges: [EnterpriseMemberInvitationEdge] + "A list of nodes." + nodes: [EnterpriseMemberInvitation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseMemberInvitationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseMemberInvitation +} + +"The connection type for Organization." +type EnterpriseOrganizationMembershipConnection { + "A list of edges." + edges: [EnterpriseOrganizationMembershipEdge] + "A list of nodes." + nodes: [Organization] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An enterprise organization that a user is a member of." +type EnterpriseOrganizationMembershipEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Organization + "The role of the user in the enterprise membership." + role: EnterpriseUserAccountMembershipRole! +} + +"The connection type for User." +type EnterpriseOutsideCollaboratorConnection { + "A list of edges." + edges: [EnterpriseOutsideCollaboratorEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"A User who is an outside collaborator of an enterprise through one or more organizations." +type EnterpriseOutsideCollaboratorEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: User + "The enterprise organization repositories this user is a member of." + repositories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories." + orderBy: RepositoryOrder = {field: NAME, direction: ASC} + ): EnterpriseRepositoryInfoConnection! +} + +"Enterprise information visible to enterprise owners or enterprise owners' personal access tokens (classic) with read:enterprise or admin:enterprise scope." +type EnterpriseOwnerInfo { + "A list of all of the administrators for this enterprise." + admins( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + """ + + Only return administrators with this two-factor authentication status. + + **Upcoming Change on 2025-04-01 UTC** + **Description:** `hasTwoFactorEnabled` will be removed. Use `two_factor_method_security` instead. + **Reason:** `has_two_factor_enabled` will be removed. + """ + hasTwoFactorEnabled: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for administrators returned from the connection." + orderBy: EnterpriseMemberOrder = {field: LOGIN, direction: ASC}, + "Only return members within the organizations with these logins" + organizationLogins: [String!], + "The search string to look for." + query: String, + "The role to filter by." + role: EnterpriseAdministratorRole, + "Only return outside collaborators with this type of two-factor authentication method." + twoFactorMethodSecurity: TwoFactorCredentialSecurityType + ): EnterpriseAdministratorConnection! + "A list of users in the enterprise who currently have two-factor authentication disabled." + affiliatedUsersWithTwoFactorDisabled( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "Whether or not affiliated users with two-factor authentication disabled exist in the enterprise." + affiliatedUsersWithTwoFactorDisabledExist: Boolean! + "The setting value for whether private repository forking is enabled for repositories in organizations in this enterprise." + allowPrivateRepositoryForkingSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided private repository forking setting value." + allowPrivateRepositoryForkingSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The value for the allow private repository forking policy on the enterprise." + allowPrivateRepositoryForkingSettingPolicyValue: EnterpriseAllowPrivateRepositoryForkingPolicyValue + "The setting value for base repository permissions for organizations in this enterprise." + defaultRepositoryPermissionSetting: EnterpriseDefaultRepositoryPermissionSettingValue! + "A list of enterprise organizations configured with the provided base repository permission." + defaultRepositoryPermissionSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The permission to find organizations for." + value: DefaultRepositoryPermissionField! + ): OrganizationConnection! + "A list of domains owned by the enterprise. Visible to enterprise owners or enterprise owners' personal access tokens (classic) with admin:enterprise scope." + domains( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Filter whether or not the domain is approved." + isApproved: Boolean, + "Filter whether or not the domain is verified." + isVerified: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for verifiable domains returned." + orderBy: VerifiableDomainOrder = {field: DOMAIN, direction: ASC} + ): VerifiableDomainConnection! + "Enterprise Server installations owned by the enterprise." + enterpriseServerInstallations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Whether or not to only return installations discovered via GitHub Connect." + connectedOnly: Boolean = false, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for Enterprise Server installations returned." + orderBy: EnterpriseServerInstallationOrder = {field: HOST_NAME, direction: ASC} + ): EnterpriseServerInstallationConnection! + "A list of failed invitations in the enterprise." + failedInvitations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "The search string to look for." + query: String + ): EnterpriseFailedInvitationConnection! + "The setting value for whether the enterprise has an IP allow list enabled." + ipAllowListEnabledSetting: IpAllowListEnabledSettingValue! + "The IP addresses that are allowed to access resources owned by the enterprise. Visible to enterprise owners or enterprise owners' personal access tokens (classic) with admin:enterprise scope." + ipAllowListEntries( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for IP allow list entries returned." + orderBy: IpAllowListEntryOrder = {field: ALLOW_LIST_VALUE, direction: ASC} + ): IpAllowListEntryConnection! + "The setting value for whether the enterprise has IP allow list configuration for installed GitHub Apps enabled." + ipAllowListForInstalledAppsEnabledSetting: IpAllowListForInstalledAppsEnabledSettingValue! + "Whether or not the base repository permission is currently being updated." + isUpdatingDefaultRepositoryPermission: Boolean! + "Whether the two-factor authentication requirement is currently being enforced." + isUpdatingTwoFactorRequirement: Boolean! + "The setting value for whether organization members with admin permissions on a repository can change repository visibility." + membersCanChangeRepositoryVisibilitySetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided can change repository visibility setting value." + membersCanChangeRepositoryVisibilitySettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The setting value for whether members of organizations in the enterprise can create internal repositories." + membersCanCreateInternalRepositoriesSetting: Boolean + "The setting value for whether members of organizations in the enterprise can create private repositories." + membersCanCreatePrivateRepositoriesSetting: Boolean + "The setting value for whether members of organizations in the enterprise can create public repositories." + membersCanCreatePublicRepositoriesSetting: Boolean + "The setting value for whether members of organizations in the enterprise can create repositories." + membersCanCreateRepositoriesSetting: EnterpriseMembersCanCreateRepositoriesSettingValue + "A list of enterprise organizations configured with the provided repository creation setting value." + membersCanCreateRepositoriesSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting to find organizations for." + value: OrganizationMembersCanCreateRepositoriesSettingValue! + ): OrganizationConnection! + "The setting value for whether members with admin permissions for repositories can delete issues." + membersCanDeleteIssuesSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided members can delete issues setting value." + membersCanDeleteIssuesSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The setting value for whether members with admin permissions for repositories can delete or transfer repositories." + membersCanDeleteRepositoriesSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided members can delete repositories setting value." + membersCanDeleteRepositoriesSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The setting value for whether members of organizations in the enterprise can invite outside collaborators." + membersCanInviteCollaboratorsSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided members can invite collaborators setting value." + membersCanInviteCollaboratorsSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "Indicates whether members of this enterprise's organizations can purchase additional services for those organizations." + membersCanMakePurchasesSetting: EnterpriseMembersCanMakePurchasesSettingValue! + "The setting value for whether members with admin permissions for repositories can update protected branches." + membersCanUpdateProtectedBranchesSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided members can update protected branches setting value." + membersCanUpdateProtectedBranchesSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The setting value for whether members can view dependency insights." + membersCanViewDependencyInsightsSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided members can view dependency insights setting value." + membersCanViewDependencyInsightsSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "Indicates if email notification delivery for this enterprise is restricted to verified or approved domains." + notificationDeliveryRestrictionEnabledSetting: NotificationRestrictionSettingValue! + "The OIDC Identity Provider for the enterprise." + oidcProvider: OIDCProvider + "The setting value for whether organization projects are enabled for organizations in this enterprise." + organizationProjectsSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided organization projects setting value." + organizationProjectsSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "A list of outside collaborators across the repositories in the enterprise." + outsideCollaborators( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + """ + + Only return outside collaborators with this two-factor authentication status. + + **Upcoming Change on 2025-04-01 UTC** + **Description:** `hasTwoFactorEnabled` will be removed. Use `two_factor_method_security` instead. + **Reason:** `has_two_factor_enabled` will be removed. + """ + hasTwoFactorEnabled: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "The login of one specific outside collaborator." + login: String, + "Ordering options for outside collaborators returned from the connection." + orderBy: EnterpriseMemberOrder = {field: LOGIN, direction: ASC}, + "Only return outside collaborators within the organizations with these logins" + organizationLogins: [String!], + "The search string to look for." + query: String, + "Only return outside collaborators with this type of two-factor authentication method." + twoFactorMethodSecurity: TwoFactorCredentialSecurityType, + "Only return outside collaborators on repositories with this visibility." + visibility: RepositoryVisibility + ): EnterpriseOutsideCollaboratorConnection! + "A list of pending administrator invitations for the enterprise." + pendingAdminInvitations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pending enterprise administrator invitations returned from the connection." + orderBy: EnterpriseAdministratorInvitationOrder = {field: CREATED_AT, direction: DESC}, + "The search string to look for." + query: String, + "The role to filter by." + role: EnterpriseAdministratorRole + ): EnterpriseAdministratorInvitationConnection! + "A list of pending collaborator invitations across the repositories in the enterprise." + pendingCollaboratorInvitations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pending repository collaborator invitations returned from the connection." + orderBy: RepositoryInvitationOrder = {field: CREATED_AT, direction: DESC}, + "The search string to look for." + query: String + ): RepositoryInvitationConnection! + "A list of pending member invitations for organizations in the enterprise." + pendingMemberInvitations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Only return invitations matching this invitation source" + invitationSource: OrganizationInvitationSource, + "Returns the last _n_ elements from the list." + last: Int, + "Only return invitations within the organizations with these logins" + organizationLogins: [String!], + "The search string to look for." + query: String + ): EnterprisePendingMemberInvitationConnection! + "A list of pending unaffiliated member invitations for the enterprise." + pendingUnaffiliatedMemberInvitations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pending enterprise member invitations returned from the connection." + orderBy: EnterpriseMemberInvitationOrder = {field: CREATED_AT, direction: DESC}, + "The search string to look for." + query: String + ): EnterpriseMemberInvitationConnection! + "The setting value for whether deploy keys are enabled for repositories in organizations in this enterprise." + repositoryDeployKeySetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided deploy keys setting value." + repositoryDeployKeySettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The setting value for whether repository projects are enabled in this enterprise." + repositoryProjectsSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided repository projects setting value." + repositoryProjectsSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The SAML Identity Provider for the enterprise." + samlIdentityProvider: EnterpriseIdentityProvider + "A list of enterprise organizations configured with the SAML single sign-on setting value." + samlIdentityProviderSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: IdentityProviderConfigurationState! + ): OrganizationConnection! + "A list of members with a support entitlement." + supportEntitlements( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for support entitlement users returned from the connection." + orderBy: EnterpriseMemberOrder = {field: LOGIN, direction: ASC} + ): EnterpriseMemberConnection! + "The setting value for whether team discussions are enabled for organizations in this enterprise." + teamDiscussionsSetting: EnterpriseEnabledDisabledSettingValue! + "A list of enterprise organizations configured with the provided team discussions setting value." + teamDiscussionsSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! + "The setting value for what methods of two-factor authentication the enterprise prevents its users from having." + twoFactorDisallowedMethodsSetting: EnterpriseDisallowedMethodsSettingValue! + "The setting value for whether the enterprise requires two-factor authentication for its organizations and users." + twoFactorRequiredSetting: EnterpriseEnabledSettingValue! + "A list of enterprise organizations configured with the two-factor authentication setting value." + twoFactorRequiredSettingOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations with this setting." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The setting value to find organizations for." + value: Boolean! + ): OrganizationConnection! +} + +"The connection type for OrganizationInvitation." +type EnterprisePendingMemberInvitationConnection { + "A list of edges." + edges: [EnterprisePendingMemberInvitationEdge] + "A list of nodes." + nodes: [OrganizationInvitation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "Identifies the total count of unique users in the connection." + totalUniqueUserCount: Int! +} + +"An invitation to be a member in an enterprise organization." +type EnterprisePendingMemberInvitationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: OrganizationInvitation +} + +"A subset of repository information queryable from an enterprise." +type EnterpriseRepositoryInfo implements Node { + "The Node ID of the EnterpriseRepositoryInfo object" + id: ID! + "Identifies if the repository is private or internal." + isPrivate: Boolean! + "The repository's name." + name: String! + "The repository's name with owner." + nameWithOwner: String! +} + +"The connection type for EnterpriseRepositoryInfo." +type EnterpriseRepositoryInfoConnection { + "A list of edges." + edges: [EnterpriseRepositoryInfoEdge] + "A list of nodes." + nodes: [EnterpriseRepositoryInfo] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseRepositoryInfoEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseRepositoryInfo +} + +"An Enterprise Server installation." +type EnterpriseServerInstallation implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The customer name to which the Enterprise Server installation belongs." + customerName: String! + "The host name of the Enterprise Server installation." + hostName: String! + "The Node ID of the EnterpriseServerInstallation object" + id: ID! + "Whether or not the installation is connected to an Enterprise Server installation via GitHub Connect." + isConnected: Boolean! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "User accounts on this Enterprise Server installation." + userAccounts( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for Enterprise Server user accounts returned from the connection." + orderBy: EnterpriseServerUserAccountOrder = {field: LOGIN, direction: ASC} + ): EnterpriseServerUserAccountConnection! + "User accounts uploads for the Enterprise Server installation." + userAccountsUploads( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for Enterprise Server user accounts uploads returned from the connection." + orderBy: EnterpriseServerUserAccountsUploadOrder = {field: CREATED_AT, direction: DESC} + ): EnterpriseServerUserAccountsUploadConnection! +} + +"The connection type for EnterpriseServerInstallation." +type EnterpriseServerInstallationConnection { + "A list of edges." + edges: [EnterpriseServerInstallationEdge] + "A list of nodes." + nodes: [EnterpriseServerInstallation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseServerInstallationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseServerInstallation +} + +"The connection type for EnterpriseServerInstallation." +type EnterpriseServerInstallationMembershipConnection { + "A list of edges." + edges: [EnterpriseServerInstallationMembershipEdge] + "A list of nodes." + nodes: [EnterpriseServerInstallation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An Enterprise Server installation that a user is a member of." +type EnterpriseServerInstallationMembershipEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseServerInstallation + "The role of the user in the enterprise membership." + role: EnterpriseUserAccountMembershipRole! +} + +"A user account on an Enterprise Server installation." +type EnterpriseServerUserAccount implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "User emails belonging to this user account." + emails( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for Enterprise Server user account emails returned from the connection." + orderBy: EnterpriseServerUserAccountEmailOrder = {field: EMAIL, direction: ASC} + ): EnterpriseServerUserAccountEmailConnection! + "The Enterprise Server installation on which this user account exists." + enterpriseServerInstallation: EnterpriseServerInstallation! + "The Node ID of the EnterpriseServerUserAccount object" + id: ID! + "Whether the user account is a site administrator on the Enterprise Server installation." + isSiteAdmin: Boolean! + "The login of the user account on the Enterprise Server installation." + login: String! + "The profile name of the user account on the Enterprise Server installation." + profileName: String + "The date and time when the user account was created on the Enterprise Server installation." + remoteCreatedAt: DateTime! + "The ID of the user account on the Enterprise Server installation." + remoteUserId: Int! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for EnterpriseServerUserAccount." +type EnterpriseServerUserAccountConnection { + "A list of edges." + edges: [EnterpriseServerUserAccountEdge] + "A list of nodes." + nodes: [EnterpriseServerUserAccount] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseServerUserAccountEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseServerUserAccount +} + +"An email belonging to a user account on an Enterprise Server installation." +type EnterpriseServerUserAccountEmail implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The email address." + email: String! + "The Node ID of the EnterpriseServerUserAccountEmail object" + id: ID! + "Indicates whether this is the primary email of the associated user account." + isPrimary: Boolean! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The user account to which the email belongs." + userAccount: EnterpriseServerUserAccount! +} + +"The connection type for EnterpriseServerUserAccountEmail." +type EnterpriseServerUserAccountEmailConnection { + "A list of edges." + edges: [EnterpriseServerUserAccountEmailEdge] + "A list of nodes." + nodes: [EnterpriseServerUserAccountEmail] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseServerUserAccountEmailEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseServerUserAccountEmail +} + +"A user accounts upload from an Enterprise Server installation." +type EnterpriseServerUserAccountsUpload implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The enterprise to which this upload belongs." + enterprise: Enterprise! + "The Enterprise Server installation for which this upload was generated." + enterpriseServerInstallation: EnterpriseServerInstallation! + "The Node ID of the EnterpriseServerUserAccountsUpload object" + id: ID! + "The name of the file uploaded." + name: String! + "The synchronization state of the upload" + syncState: EnterpriseServerUserAccountsUploadSyncState! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for EnterpriseServerUserAccountsUpload." +type EnterpriseServerUserAccountsUploadConnection { + "A list of edges." + edges: [EnterpriseServerUserAccountsUploadEdge] + "A list of nodes." + nodes: [EnterpriseServerUserAccountsUpload] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnterpriseServerUserAccountsUploadEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: EnterpriseServerUserAccountsUpload +} + +"An account for a user who is an admin of an enterprise or a member of an enterprise through one or more organizations." +type EnterpriseUserAccount implements Actor & Node { + "A URL pointing to the enterprise user account's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The enterprise in which this user account exists." + enterprise: Enterprise! + "A list of Enterprise Server installations this user is a member of." + enterpriseInstallations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for installations returned from the connection." + orderBy: EnterpriseServerInstallationOrder = {field: HOST_NAME, direction: ASC}, + "The search string to look for." + query: String, + "The role of the user in the installation." + role: EnterpriseUserAccountMembershipRole + ): EnterpriseServerInstallationMembershipConnection! + "The Node ID of the EnterpriseUserAccount object" + id: ID! + "An identifier for the enterprise user account, a login or email address" + login: String! + "The name of the enterprise user account" + name: String + "A list of enterprise organizations this user is a member of." + organizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for organizations returned from the connection." + orderBy: OrganizationOrder = {field: LOGIN, direction: ASC}, + "The search string to look for." + query: String, + "The role of the user in the enterprise organization." + role: EnterpriseUserAccountMembershipRole + ): EnterpriseOrganizationMembershipConnection! + "The HTTP path for this user." + resourcePath: URI! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this user." + url: URI! + "The user within the enterprise." + user: User +} + +"An environment." +type Environment implements Node { + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the Environment object" + id: ID! + "Indicates whether or not this environment is currently pinned to the repository" + isPinned: Boolean + "The latest completed deployment with status success, failure, or error if it exists" + latestCompletedDeployment: Deployment + "The name of the environment" + name: String! + "The position of the environment if it is pinned, null if it is not pinned" + pinnedPosition: Int + "The protection rules defined for this environment" + protectionRules( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DeploymentProtectionRuleConnection! +} + +"The connection type for Environment." +type EnvironmentConnection { + "A list of edges." + edges: [EnvironmentEdge] + "A list of nodes." + nodes: [Environment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type EnvironmentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Environment +} + +"An external identity provisioned by SAML SSO or SCIM. If SAML is configured on the organization, the external identity is visible to (1) organization owners, (2) organization owners' personal access tokens (classic) with read:org or admin:org scope, (3) GitHub App with an installation token with read or write access to members. If SAML is configured on the enterprise, the external identity is visible to (1) enterprise owners, (2) enterprise owners' personal access tokens (classic) with read:enterprise or admin:enterprise scope." +type ExternalIdentity implements Node { + "The GUID for this identity" + guid: String! + "The Node ID of the ExternalIdentity object" + id: ID! + "Organization invitation for this SCIM-provisioned external identity" + organizationInvitation: OrganizationInvitation + "SAML Identity attributes" + samlIdentity: ExternalIdentitySamlAttributes + "SCIM Identity attributes" + scimIdentity: ExternalIdentityScimAttributes + "User linked to this external identity. Will be NULL if this identity has not been claimed by an organization member." + user: User +} + +"An attribute for the External Identity attributes collection" +type ExternalIdentityAttribute { + "The attribute metadata as JSON" + metadata: String + "The attribute name" + name: String! + "The attribute value" + value: String! +} + +"The connection type for ExternalIdentity." +type ExternalIdentityConnection { + "A list of edges." + edges: [ExternalIdentityEdge] + "A list of nodes." + nodes: [ExternalIdentity] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ExternalIdentityEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ExternalIdentity +} + +"SAML attributes for the External Identity" +type ExternalIdentitySamlAttributes { + "SAML Identity attributes" + attributes: [ExternalIdentityAttribute!]! + "The emails associated with the SAML identity" + emails: [UserEmailMetadata!] + "Family name of the SAML identity" + familyName: String + "Given name of the SAML identity" + givenName: String + "The groups linked to this identity in IDP" + groups: [String!] + "The NameID of the SAML identity" + nameId: String + "The userName of the SAML identity" + username: String +} + +"SCIM attributes for the External Identity" +type ExternalIdentityScimAttributes { + "The emails associated with the SCIM identity" + emails: [UserEmailMetadata!] + "Family name of the SCIM identity" + familyName: String + "Given name of the SCIM identity" + givenName: String + "The groups linked to this identity in IDP" + groups: [String!] + "The userName of the SCIM identity" + username: String +} + +"Prevent commits that include files with specified file extensions from being pushed to the commit graph." +type FileExtensionRestrictionParameters { + "The file extensions that are restricted from being pushed to the commit graph." + restrictedFileExtensions: [String!]! +} + +"Prevent commits that include changes in specified file and folder paths from being pushed to the commit graph. This includes absolute paths that contain file names." +type FilePathRestrictionParameters { + "The file paths that are restricted from being pushed to the commit graph." + restrictedFilePaths: [String!]! +} + +"Autogenerated return type of FollowOrganization." +type FollowOrganizationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The organization that was followed." + organization: Organization +} + +"Autogenerated return type of FollowUser." +type FollowUserPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The user that was followed." + user: User +} + +"The connection type for User." +type FollowerConnection { + "A list of edges." + edges: [UserEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"The connection type for User." +type FollowingConnection { + "A list of edges." + edges: [UserEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"A funding platform link for a repository." +type FundingLink { + "The funding platform this link is for." + platform: FundingPlatform! + "The configured URL for this funding link." + url: URI! +} + +"A generic hovercard context with a message and icon" +type GenericHovercardContext implements HovercardContext { + "A string describing this context" + message: String! + "An octicon to accompany this context" + octicon: String! +} + +"A Gist." +type Gist implements Node & Starrable & UniformResourceLocatable { + "A list of comments associated with the gist" + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): GistCommentConnection! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The gist description." + description: String + "The files in this gist." + files( + "The maximum number of files to return." + limit: Int = 10, + "The oid of the files to return" + oid: GitObjectID + ): [GistFile] + "A list of forks associated with the gist" + forks( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for gists returned from the connection" + orderBy: GistOrder + ): GistConnection! + "The Node ID of the Gist object" + id: ID! + "Identifies if the gist is a fork." + isFork: Boolean! + "Whether the gist is public or not." + isPublic: Boolean! + "The gist name." + name: String! + "The gist owner." + owner: RepositoryOwner + "Identifies when the gist was last pushed to." + pushedAt: DateTime + "The HTML path to this resource." + resourcePath: URI! + """ + + Returns a count of how many stargazers there are on this object + """ + stargazerCount: Int! + "A list of users who have starred this starrable." + stargazers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: StarOrder + ): StargazerConnection! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this Gist." + url: URI! + "Returns a boolean indicating whether the viewing user has starred this starrable." + viewerHasStarred: Boolean! +} + +"Represents a comment on an Gist." +type GistComment implements Comment & Deletable & Minimizable & Node & Updatable & UpdatableComment { + "The actor who authored the comment." + author: Actor + "Author's association with the gist." + authorAssociation: CommentAuthorAssociation! + "Identifies the comment body." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The actor who edited the comment." + editor: Actor + "The associated gist." + gist: Gist! + "The Node ID of the GistComment object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Returns whether or not a comment has been minimized." + isMinimized: Boolean! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Returns why the comment was minimized. One of `abuse`, `off-topic`, `outdated`, `resolved`, `duplicate` and `spam`. Note that the case and formatting of these values differs from the inputs to the `MinimizeComment` mutation." + minimizedReason: String + "Identifies when the comment was published at." + publishedAt: DateTime + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Check if the current viewer can minimize this object." + viewerCanMinimize: Boolean! + "Check if the current viewer can unminimize this object." + viewerCanUnminimize: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! +} + +"The connection type for GistComment." +type GistCommentConnection { + "A list of edges." + edges: [GistCommentEdge] + "A list of nodes." + nodes: [GistComment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type GistCommentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: GistComment +} + +"The connection type for Gist." +type GistConnection { + "A list of edges." + edges: [GistEdge] + "A list of nodes." + nodes: [Gist] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type GistEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Gist +} + +"A file in a gist." +type GistFile { + "The file name encoded to remove characters that are invalid in URL paths." + encodedName: String + "The gist file encoding." + encoding: String + "The file extension from the file name." + extension: String + "Indicates if this file is an image." + isImage: Boolean! + "Whether the file's contents were truncated." + isTruncated: Boolean! + "The programming language this file is written in." + language: Language + "The gist file name." + name: String + "The gist file size in bytes." + size: Int + "UTF8 text data or null if the file is binary" + text( + "Optionally truncate the returned file to this length." + truncate: Int + ): String +} + +"Represents an actor in a Git commit (ie. an author or committer)." +type GitActor { + "A URL pointing to the author's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "The timestamp of the Git action (authoring or committing)." + date: GitTimestamp + "The email in the Git commit." + email: String + "The name in the Git commit." + name: String + "The GitHub user corresponding to the email field. Null if no such user exists." + user: User +} + +"The connection type for GitActor." +type GitActorConnection { + "A list of edges." + edges: [GitActorEdge] + "A list of nodes." + nodes: [GitActor] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type GitActorEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: GitActor +} + +"Represents information about the GitHub instance." +type GitHubMetadata { + "Returns a String that's a SHA of `github-services`" + gitHubServicesSha: GitObjectID! + "IP addresses that users connect to for git operations" + gitIpAddresses: [String!] + "IP addresses that GitHub Enterprise Importer uses for outbound connections" + githubEnterpriseImporterIpAddresses: [String!] + "IP addresses that service hooks are sent from" + hookIpAddresses: [String!] + "IP addresses that the importer connects from" + importerIpAddresses: [String!] + "Whether or not users are verified" + isPasswordAuthenticationVerifiable: Boolean! + "IP addresses for GitHub Pages' A records" + pagesIpAddresses: [String!] +} + +"Represents a GPG signature on a Commit or Tag." +type GpgSignature implements GitSignature { + "Email used to sign this object." + email: String! + "True if the signature is valid and verified by GitHub." + isValid: Boolean! + "Hex-encoded ID of the key that signed this object." + keyId: String + "Payload for GPG signing object. Raw ODB object without the signature header." + payload: String! + "ASCII-armored signature header from object." + signature: String! + "GitHub user corresponding to the email signing this commit." + signer: User + "The state of this signature. `VALID` if signature is valid and verified by GitHub, otherwise represents reason why signature is considered invalid." + state: GitSignatureState! + "The date the signature was verified, if valid" + verifiedAt: DateTime + "True if the signature was made with GitHub's signing key." + wasSignedByGitHub: Boolean! +} + +"Autogenerated return type of GrantEnterpriseOrganizationsMigratorRole." +type GrantEnterpriseOrganizationsMigratorRolePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The organizations that had the migrator role applied to for the given user." + organizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): OrganizationConnection +} + +"Autogenerated return type of GrantMigratorRole." +type GrantMigratorRolePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Did the operation succeed?" + success: Boolean +} + +"Represents a 'head_ref_deleted' event on a given pull request." +type HeadRefDeletedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the Ref associated with the `head_ref_deleted` event." + headRef: Ref + "Identifies the name of the Ref associated with the `head_ref_deleted` event." + headRefName: String! + "The Node ID of the HeadRefDeletedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! +} + +"Represents a 'head_ref_force_pushed' event on a given pull request." +type HeadRefForcePushedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the after commit SHA for the 'head_ref_force_pushed' event." + afterCommit: Commit + "Identifies the before commit SHA for the 'head_ref_force_pushed' event." + beforeCommit: Commit + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the HeadRefForcePushedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! + "Identifies the fully qualified ref name for the 'head_ref_force_pushed' event." + ref: Ref +} + +"Represents a 'head_ref_restored' event on a given pull request." +type HeadRefRestoredEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the HeadRefRestoredEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! +} + +"Detail needed to display a hovercard for a user" +type Hovercard { + "Each of the contexts for this hovercard" + contexts: [HovercardContext!]! +} + +"Autogenerated return type of ImportProject." +type ImportProjectPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new Project!" + project: Project +} + +"Autogenerated return type of InviteEnterpriseAdmin." +type InviteEnterpriseAdminPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The created enterprise administrator invitation." + invitation: EnterpriseAdministratorInvitation +} + +"Autogenerated return type of InviteEnterpriseMember." +type InviteEnterpriseMemberPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The created enterprise member invitation." + invitation: EnterpriseMemberInvitation +} + +"An IP address or range of addresses that is allowed to access an owner's resources." +type IpAllowListEntry implements Node { + "A single IP address or range of IP addresses in CIDR notation." + allowListValue: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the IpAllowListEntry object" + id: ID! + "Whether the entry is currently active." + isActive: Boolean! + "The name of the IP allow list entry." + name: String + "The owner of the IP allow list entry." + owner: IpAllowListOwner! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for IpAllowListEntry." +type IpAllowListEntryConnection { + "A list of edges." + edges: [IpAllowListEntryEdge] + "A list of nodes." + nodes: [IpAllowListEntry] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type IpAllowListEntryEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: IpAllowListEntry +} + +"An Issue is a place to discuss ideas, enhancements, tasks, and bugs for a project." +type Issue implements Assignable & Closable & Comment & Deletable & Labelable & Lockable & Node & ProjectV2Owner & Reactable & RepositoryNode & Subscribable & SubscribableThread & UniformResourceLocatable & Updatable & UpdatableComment { + "Reason that the conversation was locked." + activeLockReason: LockReason + "A list of actors assigned to this object." + assignedActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): AssigneeConnection! + "A list of Users assigned to this object." + assignees( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "A list of issues that are blocking this issue." + blockedBy( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for dependencies" + orderBy: IssueDependencyOrder = {field: DEPENDENCY_ADDED_AT, direction: DESC} + ): IssueConnection! + "A list of issues that this issue is blocking." + blocking( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for dependencies" + orderBy: IssueDependencyOrder = {field: DEPENDENCY_ADDED_AT, direction: DESC} + ): IssueConnection! + "Identifies the body of the issue." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The http path for this issue body" + bodyResourcePath: URI! + "Identifies the body of the issue rendered to text." + bodyText: String! + "The http URL for this issue body" + bodyUrl: URI! + "Indicates if the object is closed (definition of closed may depend on type)" + closed: Boolean! + "Identifies the date and time when the object was closed." + closedAt: DateTime + "List of open pull requests referenced from this issue" + closedByPullRequestsReferences( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Include closed PRs in results" + includeClosedPrs: Boolean = false, + "Returns the last _n_ elements from the list." + last: Int, + "Return results ordered by state" + orderByState: Boolean = false, + "Return only manually linked PRs" + userLinkedOnly: Boolean = false + ): PullRequestConnection + "A list of comments associated with the Issue." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issue comments returned from the connection." + orderBy: IssueCommentOrder + ): IssueCommentConnection! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "A reference to the original issue that this issue has been marked as a duplicate of." + duplicateOf: Issue + "The actor who edited the comment." + editor: Actor + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The hovercard information for this issue" + hovercard( + "Whether or not to include notification contexts" + includeNotificationContexts: Boolean = true + ): Hovercard! + "The Node ID of the Issue object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Indicates whether or not this issue is currently pinned to the repository issues list" + isPinned: Boolean + "Is this issue read by the viewer" + isReadByViewer: Boolean + "Summary of the state of an issue's dependencies" + issueDependenciesSummary: IssueDependenciesSummary! + "The issue type for this Issue" + issueType: IssueType + "A list of labels associated with the object." + labels( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for labels returned from the connection." + orderBy: LabelOrder = {field: CREATED_AT, direction: ASC} + ): LabelConnection + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Branches linked to this issue." + linkedBranches( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): LinkedBranchConnection! + "`true` if the object is locked" + locked: Boolean! + "Identifies the milestone associated with the issue." + milestone: Milestone + "Identifies the issue number." + number: Int! + "The parent entity of the issue." + parent: Issue + "A list of Users that are participating in the Issue conversation." + participants( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "List of project cards associated with this issue." + projectCards( + "Returns the elements in the list that come after the specified cursor." + after: String, + "A list of archived states to filter the cards by" + archivedStates: [ProjectCardArchivedState] = [ARCHIVED, NOT_ARCHIVED], + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectCardConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "List of project items associated with this issue." + projectItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Include archived items." + includeArchived: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2ItemConnection! + "Find a project by number." + projectV2( + "The project number." + number: Int! + ): ProjectV2 + "A list of projects under the owner." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter projects based on user role." + minPermissionLevel: ProjectV2PermissionLevel = READ, + "How to order the returned projects." + orderBy: ProjectV2Order = {field: NUMBER, direction: DESC}, + "A project to search for under the owner." + query: String + ): ProjectV2Connection! + "Identifies when the comment was published at." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The repository associated with this node." + repository: Repository! + "The HTTP path for this issue" + resourcePath: URI! + "Identifies the state of the issue." + state: IssueState! + "Identifies the reason for the issue state." + stateReason( + """ + + Whether or not to return state reason for duplicates + + **Upcoming Change on 2025-10-01 UTC** + **Description:** `enableDuplicate` will be removed. + **Reason:** The state reason for duplicate issue is now returned by default. + """ + enableDuplicate: Boolean = false + ): IssueStateReason + "A list of sub-issues associated with the Issue." + subIssues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): IssueConnection! + "Summary of the state of an issue's sub-issues" + subIssuesSummary: SubIssuesSummary! + "A list of suggested actors to assign to this object" + suggestedActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "If provided, searches users by login or profile name" + query: String + ): AssigneeConnection! + "A list of events, comments, commits, etc. associated with the issue." + timeline( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows filtering timeline events by a `since` timestamp." + since: DateTime + ): IssueTimelineConnection! @deprecated(reason: "`timeline` will be removed Use Issue.timelineItems instead. Removal on 2020-10-01 UTC.") + "A list of events, comments, commits, etc. associated with the issue." + timelineItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Filter timeline items by type." + itemTypes: [IssueTimelineItemsItemType!], + "Returns the last _n_ elements from the list." + last: Int, + "Filter timeline items by a `since` timestamp." + since: DateTime, + "Skips the first _n_ elements in the list." + skip: Int + ): IssueTimelineItemsConnection! + "Identifies the issue title." + title: String! + "Identifies the issue title rendered to HTML." + titleHTML: String! + "A list of issues that track this issue" + trackedInIssues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): IssueConnection! + "A list of issues tracked inside the current issue" + trackedIssues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): IssueConnection! + "The number of tracked issues for this issue" + trackedIssuesCount( + "Limit the count to tracked issues with the specified states." + states: [TrackedIssueStates] + ): Int! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this issue" + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Indicates if the object can be closed by the viewer." + viewerCanClose: Boolean! + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Indicates if the viewer can edit labels for this object." + viewerCanLabel: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Indicates if the object can be reopened by the viewer." + viewerCanReopen: Boolean! + "Check if the current viewer can set fields on the issue." + viewerCanSetFields: Boolean + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState + "Identifies the viewer's thread subscription form action." + viewerThreadSubscriptionFormAction: ThreadSubscriptionFormAction + "Identifies the viewer's thread subscription status." + viewerThreadSubscriptionStatus: ThreadSubscriptionState +} + +"Represents a comment on an Issue." +type IssueComment implements Comment & Deletable & Minimizable & Node & Reactable & RepositoryNode & Updatable & UpdatableComment { + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "The body as Markdown." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The actor who edited the comment." + editor: Actor + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the IssueComment object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Returns whether or not a comment has been minimized." + isMinimized: Boolean! + "Identifies the issue associated with the comment." + issue: Issue! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Returns why the comment was minimized. One of `abuse`, `off-topic`, `outdated`, `resolved`, `duplicate` and `spam`. Note that the case and formatting of these values differs from the inputs to the `MinimizeComment` mutation." + minimizedReason: String + "Identifies when the comment was published at." + publishedAt: DateTime + """ + + Returns the pull request associated with the comment, if this comment was made on a + pull request. + """ + pullRequest: PullRequest + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The repository associated with this node." + repository: Repository! + "The HTTP path for this issue comment" + resourcePath: URI! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this issue comment" + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Check if the current viewer can minimize this object." + viewerCanMinimize: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Check if the current viewer can unminimize this object." + viewerCanUnminimize: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! +} + +"The connection type for IssueComment." +type IssueCommentConnection { + "A list of edges." + edges: [IssueCommentEdge] + "A list of nodes." + nodes: [IssueComment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type IssueCommentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: IssueComment +} + +"The connection type for Issue." +type IssueConnection { + "A list of edges." + edges: [IssueEdge] + "A list of nodes." + nodes: [Issue] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"This aggregates issues opened by a user within one repository." +type IssueContributionsByRepository { + "The issue contributions." + contributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for contributions returned from the connection." + orderBy: ContributionOrder = {direction: DESC} + ): CreatedIssueContributionConnection! + "The repository in which the issues were opened." + repository: Repository! +} + +"Summary of the state of an issue's dependencies" +type IssueDependenciesSummary { + "Count of issues this issue is blocked by" + blockedBy: Int! + "Count of issues this issue is blocking" + blocking: Int! +} + +"An edge in a connection." +type IssueEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Issue +} + +"A repository issue template." +type IssueTemplate { + "The template purpose." + about: String + "The suggested assignees." + assignees( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "The suggested issue body." + body: String + "The template filename." + filename: String! + "The suggested issue labels" + labels( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for labels returned from the connection." + orderBy: LabelOrder = {field: CREATED_AT, direction: ASC} + ): LabelConnection + "The template name." + name: String! + "The suggested issue title." + title: String + "The suggested issue type" + type: IssueType +} + +"The connection type for IssueTimelineItem." +type IssueTimelineConnection { + "A list of edges." + edges: [IssueTimelineItemEdge] + "A list of nodes." + nodes: [IssueTimelineItem] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type IssueTimelineItemEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: IssueTimelineItem +} + +"The connection type for IssueTimelineItems." +type IssueTimelineItemsConnection { + "A list of edges." + edges: [IssueTimelineItemsEdge] + "Identifies the count of items after applying `before` and `after` filters." + filteredCount: Int! + "A list of nodes." + nodes: [IssueTimelineItems] + "Identifies the count of items after applying `before`/`after` filters and `first`/`last`/`skip` slicing." + pageCount: Int! + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "Identifies the date and time when the timeline was last updated." + updatedAt: DateTime! +} + +"An edge in a connection." +type IssueTimelineItemsEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: IssueTimelineItems +} + +"Represents the type of Issue." +type IssueType implements Node { + "The issue type's color." + color: IssueTypeColor! + "The issue type's description." + description: String + "The Node ID of the IssueType object" + id: ID! + "The issue type's enabled state." + isEnabled: Boolean! + "Whether the issue type is publicly visible." + isPrivate: Boolean! @deprecated(reason: "Private issue types are being deprecated and can no longer be created. Removal on 2025-04-01 UTC.") + "The issues with this issue type in the given repository." + issues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filtering options for issues returned from the connection." + filterBy: IssueFilters, + "Returns the first _n_ elements from the list." + first: Int, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issues returned from the connection." + orderBy: IssueOrder, + "Target repository to load the issues from." + repositoryId: ID!, + "A list of states to filter the issues by." + states: [IssueState!] + ): IssueConnection! + "The issue type's name." + name: String! +} + +"Represents a 'issue_type_added' event on a given issue." +type IssueTypeAddedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the IssueTypeAddedEvent object" + id: ID! + "The issue type added." + issueType: IssueType +} + +"Represents a 'issue_type_changed' event on a given issue." +type IssueTypeChangedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the IssueTypeChangedEvent object" + id: ID! + "The issue type added." + issueType: IssueType + "The issue type removed." + prevIssueType: IssueType +} + +"The connection type for IssueType." +type IssueTypeConnection { + "A list of edges." + edges: [IssueTypeEdge] + "A list of nodes." + nodes: [IssueType] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type IssueTypeEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: IssueType +} + +"Represents a 'issue_type_removed' event on a given issue." +type IssueTypeRemovedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the IssueTypeRemovedEvent object" + id: ID! + "The issue type removed." + issueType: IssueType +} + +"Represents a user signing up for a GitHub account." +type JoinedGitHubContribution implements Contribution { + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "When this contribution was made." + occurredAt: DateTime! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"A label for categorizing Issues, Pull Requests, Milestones, or Discussions with a given Repository." +type Label implements Node { + "Identifies the label color." + color: String! + "Identifies the date and time when the label was created." + createdAt: DateTime + "A brief description of this label." + description: String + "The Node ID of the Label object" + id: ID! + "Indicates whether or not this is a default label." + isDefault: Boolean! + "A list of issues associated with this label." + issues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filtering options for issues returned from the connection." + filterBy: IssueFilters, + "Returns the first _n_ elements from the list." + first: Int, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issues returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the issues by." + states: [IssueState!] + ): IssueConnection! + "Identifies the label name." + name: String! + "A list of pull requests associated with this label." + pullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "The base ref name to filter the pull requests by." + baseRefName: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "The head ref name to filter the pull requests by." + headRefName: String, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the pull requests by." + states: [PullRequestState!] + ): PullRequestConnection! + "The repository associated with this label." + repository: Repository! + "The HTTP path for this label." + resourcePath: URI! + "Identifies the date and time when the label was last updated." + updatedAt: DateTime + "The HTTP URL for this label." + url: URI! +} + +"The connection type for Label." +type LabelConnection { + "A list of edges." + edges: [LabelEdge] + "A list of nodes." + nodes: [Label] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type LabelEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Label +} + +"Represents a 'labeled' event on a given issue or pull request." +type LabeledEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the LabeledEvent object" + id: ID! + "Identifies the label associated with the 'labeled' event." + label: Label! + "Identifies the `Labelable` associated with the event." + labelable: Labelable! +} + +"Represents a given language found in repositories." +type Language implements Node { + "The color defined for the current language." + color: String + "The Node ID of the Language object" + id: ID! + "The name of the current language." + name: String! +} + +"A list of languages associated with the parent." +type LanguageConnection { + "A list of edges." + edges: [LanguageEdge] + "A list of nodes." + nodes: [Language] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "The total size in bytes of files written in that language." + totalSize: Int! +} + +"Represents the language of a repository." +type LanguageEdge { + cursor: String! + node: Language! + "The number of bytes of code written in the language." + size: Int! +} + +"A repository's open source license" +type License implements Node { + "The full text of the license" + body: String! + "The conditions set by the license" + conditions: [LicenseRule]! + "A human-readable description of the license" + description: String + "Whether the license should be featured" + featured: Boolean! + "Whether the license should be displayed in license pickers" + hidden: Boolean! + "The Node ID of the License object" + id: ID! + "Instructions on how to implement the license" + implementation: String + "The lowercased SPDX ID of the license" + key: String! + "The limitations set by the license" + limitations: [LicenseRule]! + "The license full name specified by " + name: String! + "Customary short name if applicable (e.g, GPLv3)" + nickname: String + "The permissions set by the license" + permissions: [LicenseRule]! + "Whether the license is a pseudo-license placeholder (e.g., other, no-license)" + pseudoLicense: Boolean! + "Short identifier specified by " + spdxId: String + "URL to the license on " + url: URI +} + +"Describes a License's conditions, permissions, and limitations" +type LicenseRule { + "A description of the rule" + description: String! + "The machine-readable rule key" + key: String! + "The human-readable rule label" + label: String! +} + +"Autogenerated return type of LinkProjectV2ToRepository." +type LinkProjectV2ToRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository the project is linked to." + repository: Repository +} + +"Autogenerated return type of LinkProjectV2ToTeam." +type LinkProjectV2ToTeamPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The team the project is linked to" + team: Team +} + +"Autogenerated return type of LinkRepositoryToProject." +type LinkRepositoryToProjectPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The linked Project." + project: Project + "The linked Repository." + repository: Repository +} + +"A branch linked to an issue." +type LinkedBranch implements Node { + "The Node ID of the LinkedBranch object" + id: ID! + "The branch's ref." + ref: Ref +} + +"A list of branches linked to an issue." +type LinkedBranchConnection { + "A list of edges." + edges: [LinkedBranchEdge] + "A list of nodes." + nodes: [LinkedBranch] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type LinkedBranchEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: LinkedBranch +} + +"Autogenerated return type of LockLockable." +type LockLockablePayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item that was locked." + lockedRecord: Lockable +} + +"Represents a 'locked' event on a given issue or pull request." +type LockedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the LockedEvent object" + id: ID! + "Reason that the conversation was locked (optional)." + lockReason: LockReason + "Object that was locked." + lockable: Lockable! +} + +"A placeholder user for attribution of imported data on GitHub." +type Mannequin implements Actor & Node & UniformResourceLocatable { + "A URL pointing to the GitHub App's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "The user that has claimed the data attributed to this mannequin." + claimant: User + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The mannequin's email on the source instance." + email: String + "The Node ID of the Mannequin object" + id: ID! + "The username of the actor." + login: String! + "The display name of the imported mannequin." + name: String + "The HTML path to this resource." + resourcePath: URI! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The URL to this resource." + url: URI! +} + +"A list of mannequins." +type MannequinConnection { + "A list of edges." + edges: [MannequinEdge] + "A list of nodes." + nodes: [Mannequin] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a mannequin." +type MannequinEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Mannequin +} + +"Autogenerated return type of MarkDiscussionCommentAsAnswer." +type MarkDiscussionCommentAsAnswerPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion that includes the chosen comment." + discussion: Discussion +} + +"Autogenerated return type of MarkFileAsViewed." +type MarkFileAsViewedPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated pull request." + pullRequest: PullRequest +} + +"Autogenerated return type of MarkProjectV2AsTemplate." +type MarkProjectV2AsTemplatePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The project." + projectV2: ProjectV2 +} + +"Autogenerated return type of MarkPullRequestReadyForReview." +type MarkPullRequestReadyForReviewPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request that is ready for review." + pullRequest: PullRequest +} + +"Represents a 'marked_as_duplicate' event on a given issue or pull request." +type MarkedAsDuplicateEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "The authoritative issue or pull request which has been duplicated by another." + canonical: IssueOrPullRequest + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The issue or pull request which has been marked as a duplicate of another." + duplicate: IssueOrPullRequest + "The Node ID of the MarkedAsDuplicateEvent object" + id: ID! + "Canonical and duplicate belong to different repositories." + isCrossRepository: Boolean! +} + +"A public description of a Marketplace category." +type MarketplaceCategory implements Node { + "The category's description." + description: String + "The technical description of how apps listed in this category work with GitHub." + howItWorks: String + "The Node ID of the MarketplaceCategory object" + id: ID! + "The category's name." + name: String! + "How many Marketplace listings have this as their primary category." + primaryListingCount: Int! + "The HTTP path for this Marketplace category." + resourcePath: URI! + "How many Marketplace listings have this as their secondary category." + secondaryListingCount: Int! + "The short name of the category used in its URL." + slug: String! + "The HTTP URL for this Marketplace category." + url: URI! +} + +"A listing in the GitHub integration marketplace." +type MarketplaceListing implements Node { + "The GitHub App this listing represents." + app: App + "URL to the listing owner's company site." + companyUrl: URI + "The HTTP path for configuring access to the listing's integration or OAuth app" + configurationResourcePath: URI! + "The HTTP URL for configuring access to the listing's integration or OAuth app" + configurationUrl: URI! + "URL to the listing's documentation." + documentationUrl: URI + "The listing's detailed description." + extendedDescription: String + "The listing's detailed description rendered to HTML." + extendedDescriptionHTML: HTML! + "The listing's introductory description." + fullDescription: String! + "The listing's introductory description rendered to HTML." + fullDescriptionHTML: HTML! + "Does this listing have any plans with a free trial?" + hasPublishedFreeTrialPlans: Boolean! + "Does this listing have a terms of service link?" + hasTermsOfService: Boolean! + "Whether the creator of the app is a verified org" + hasVerifiedOwner: Boolean! + "A technical description of how this app works with GitHub." + howItWorks: String + "The listing's technical description rendered to HTML." + howItWorksHTML: HTML! + "The Node ID of the MarketplaceListing object" + id: ID! + "URL to install the product to the viewer's account or organization." + installationUrl: URI + "Whether this listing's app has been installed for the current viewer" + installedForViewer: Boolean! + "Whether this listing has been removed from the Marketplace." + isArchived: Boolean! + "Whether this listing is still an editable draft that has not been submitted for review and is not publicly visible in the Marketplace." + isDraft: Boolean! + "Whether the product this listing represents is available as part of a paid plan." + isPaid: Boolean! + "Whether this listing has been approved for display in the Marketplace." + isPublic: Boolean! + "Whether this listing has been rejected by GitHub for display in the Marketplace." + isRejected: Boolean! + "Whether this listing has been approved for unverified display in the Marketplace." + isUnverified: Boolean! + "Whether this draft listing has been submitted for review for approval to be unverified in the Marketplace." + isUnverifiedPending: Boolean! + "Whether this draft listing has been submitted for review from GitHub for approval to be verified in the Marketplace." + isVerificationPendingFromDraft: Boolean! + "Whether this unverified listing has been submitted for review from GitHub for approval to be verified in the Marketplace." + isVerificationPendingFromUnverified: Boolean! + "Whether this listing has been approved for verified display in the Marketplace." + isVerified: Boolean! + "The hex color code, without the leading '#', for the logo background." + logoBackgroundColor: String! + "URL for the listing's logo image." + logoUrl( + "The size in pixels of the resulting square image." + size: Int = 400 + ): URI + "The listing's full name." + name: String! + "The listing's very short description without a trailing period or ampersands." + normalizedShortDescription: String! + "URL to the listing's detailed pricing." + pricingUrl: URI + "The category that best describes the listing." + primaryCategory: MarketplaceCategory! + "URL to the listing's privacy policy, may return an empty string for listings that do not require a privacy policy URL." + privacyPolicyUrl: URI! + "The HTTP path for the Marketplace listing." + resourcePath: URI! + "The URLs for the listing's screenshots." + screenshotUrls: [String]! + "An alternate category that describes the listing." + secondaryCategory: MarketplaceCategory + "The listing's very short description." + shortDescription: String! + "The short name of the listing used in its URL." + slug: String! + "URL to the listing's status page." + statusUrl: URI + "An email address for support for this listing's app." + supportEmail: String + "Either a URL or an email address for support for this listing's app, may return an empty string for listings that do not require a support URL." + supportUrl: URI! + "URL to the listing's terms of service." + termsOfServiceUrl: URI + "The HTTP URL for the Marketplace listing." + url: URI! + "Can the current viewer add plans for this Marketplace listing." + viewerCanAddPlans: Boolean! + "Can the current viewer approve this Marketplace listing." + viewerCanApprove: Boolean! + "Can the current viewer delist this Marketplace listing." + viewerCanDelist: Boolean! + "Can the current viewer edit this Marketplace listing." + viewerCanEdit: Boolean! + """ + + Can the current viewer edit the primary and secondary category of this + Marketplace listing. + """ + viewerCanEditCategories: Boolean! + "Can the current viewer edit the plans for this Marketplace listing." + viewerCanEditPlans: Boolean! + """ + + Can the current viewer return this Marketplace listing to draft state + so it becomes editable again. + """ + viewerCanRedraft: Boolean! + """ + + Can the current viewer reject this Marketplace listing by returning it to + an editable draft state or rejecting it entirely. + """ + viewerCanReject: Boolean! + """ + + Can the current viewer request this listing be reviewed for display in + the Marketplace as verified. + """ + viewerCanRequestApproval: Boolean! + """ + + Indicates whether the current user has an active subscription to this Marketplace listing. + """ + viewerHasPurchased: Boolean! + """ + + Indicates if the current user has purchased a subscription to this Marketplace listing + for all of the organizations the user owns. + """ + viewerHasPurchasedForAllOrganizations: Boolean! + """ + + Does the current viewer role allow them to administer this Marketplace listing. + """ + viewerIsListingAdmin: Boolean! +} + +"Look up Marketplace Listings" +type MarketplaceListingConnection { + "A list of edges." + edges: [MarketplaceListingEdge] + "A list of nodes." + nodes: [MarketplaceListing] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type MarketplaceListingEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: MarketplaceListing +} + +"Prevent commits that include file paths that exceed the specified character limit from being pushed to the commit graph." +type MaxFilePathLengthParameters { + "The maximum amount of characters allowed in file paths." + maxFilePathLength: Int! +} + +"Prevent commits with individual files that exceed the specified limit from being pushed to the commit graph." +type MaxFileSizeParameters { + "The maximum file size allowed in megabytes. This limit does not apply to Git Large File Storage (Git LFS)." + maxFileSize: Int! +} + +"Represents a member feature request notification" +type MemberFeatureRequestNotification implements Node { + "Represents member feature request body containing entity name and the number of feature requests" + body: String! + "The Node ID of the MemberFeatureRequestNotification object" + id: ID! + "Represents member feature request notification title" + title: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"Audit log entry for a members_can_delete_repos.clear event." +type MembersCanDeleteReposClearAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the MembersCanDeleteReposClearAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a members_can_delete_repos.disable event." +type MembersCanDeleteReposDisableAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the MembersCanDeleteReposDisableAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a members_can_delete_repos.enable event." +type MembersCanDeleteReposEnableAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the MembersCanDeleteReposEnableAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Represents a 'mentioned' event on a given issue or pull request." +type MentionedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the MentionedEvent object" + id: ID! +} + +"Autogenerated return type of MergeBranch." +type MergeBranchPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The resulting merge Commit." + mergeCommit: Commit +} + +"Autogenerated return type of MergePullRequest." +type MergePullRequestPayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request that was merged." + pullRequest: PullRequest +} + +"The queue of pull request entries to be merged into a protected branch in a repository." +type MergeQueue implements Node { + "The configuration for this merge queue" + configuration: MergeQueueConfiguration + "The entries in the queue" + entries( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): MergeQueueEntryConnection + "The Node ID of the MergeQueue object" + id: ID! + "The estimated time in seconds until a newly added entry would be merged" + nextEntryEstimatedTimeToMerge: Int + "The repository this merge queue belongs to" + repository: Repository + "The HTTP path for this merge queue" + resourcePath: URI! + "The HTTP URL for this merge queue" + url: URI! +} + +"Configuration for a MergeQueue" +type MergeQueueConfiguration { + "The amount of time in minutes to wait for a check response before considering it a failure." + checkResponseTimeout: Int + "The maximum number of entries to build at once." + maximumEntriesToBuild: Int + "The maximum number of entries to merge at once." + maximumEntriesToMerge: Int + "The merge method to use for this queue." + mergeMethod: PullRequestMergeMethod + "The strategy to use when merging entries." + mergingStrategy: MergeQueueMergingStrategy + "The minimum number of entries required to merge at once." + minimumEntriesToMerge: Int + "The amount of time in minutes to wait before ignoring the minumum number of entries in the queue requirement and merging a collection of entries" + minimumEntriesToMergeWaitTime: Int +} + +"Entries in a MergeQueue" +type MergeQueueEntry implements Node { + "The base commit for this entry" + baseCommit: Commit + "The date and time this entry was added to the merge queue" + enqueuedAt: DateTime! + "The actor that enqueued this entry" + enqueuer: Actor! + "The estimated time in seconds until this entry will be merged" + estimatedTimeToMerge: Int + "The head commit for this entry" + headCommit: Commit + "The Node ID of the MergeQueueEntry object" + id: ID! + "Whether this pull request should jump the queue" + jump: Boolean! + "The merge queue that this entry belongs to" + mergeQueue: MergeQueue + "The position of this entry in the queue" + position: Int! + "The pull request that will be added to a merge group" + pullRequest: PullRequest + "Does this pull request need to be deployed on its own" + solo: Boolean! + "The state of this entry in the queue" + state: MergeQueueEntryState! +} + +"The connection type for MergeQueueEntry." +type MergeQueueEntryConnection { + "A list of edges." + edges: [MergeQueueEntryEdge] + "A list of nodes." + nodes: [MergeQueueEntry] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type MergeQueueEntryEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: MergeQueueEntry +} + +"Merges must be performed via a merge queue." +type MergeQueueParameters { + "Maximum time for a required status check to report a conclusion. After this much time has elapsed, checks that have not reported a conclusion will be assumed to have failed" + checkResponseTimeoutMinutes: Int! + "When set to ALLGREEN, the merge commit created by merge queue for each PR in the group must pass all required checks to merge. When set to HEADGREEN, only the commit at the head of the merge group, i.e. the commit containing changes from all of the PRs in the group, must pass its required checks to merge." + groupingStrategy: MergeQueueGroupingStrategy! + "Limit the number of queued pull requests requesting checks and workflow runs at the same time." + maxEntriesToBuild: Int! + "The maximum number of PRs that will be merged together in a group." + maxEntriesToMerge: Int! + "Method to use when merging changes from queued pull requests." + mergeMethod: MergeQueueMergeMethod! + "The minimum number of PRs that will be merged together in a group." + minEntriesToMerge: Int! + "The time merge queue should wait after the first PR is added to the queue for the minimum group size to be met. After this time has elapsed, the minimum group size will be ignored and a smaller group will be merged." + minEntriesToMergeWaitMinutes: Int! +} + +"Represents a 'merged' event on a given pull request." +type MergedEvent implements Node & UniformResourceLocatable { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the commit associated with the `merge` event." + commit: Commit + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the MergedEvent object" + id: ID! + "Identifies the Ref associated with the `merge` event." + mergeRef: Ref + "Identifies the name of the Ref associated with the `merge` event." + mergeRefName: String! + "PullRequest referenced by event." + pullRequest: PullRequest! + "The HTTP path for this merged event." + resourcePath: URI! + "The HTTP URL for this merged event." + url: URI! +} + +"A GitHub Enterprise Importer (GEI) migration source." +type MigrationSource implements Node { + "The Node ID of the MigrationSource object" + id: ID! + "The migration source name." + name: String! + "The migration source type." + type: MigrationSourceType! + "The migration source URL, for example `https://github.com` or `https://monalisa.ghe.com`." + url: URI! +} + +"Represents a Milestone object on a given repository." +type Milestone implements Closable & Node & UniformResourceLocatable { + "Indicates if the object is closed (definition of closed may depend on type)" + closed: Boolean! + "Identifies the date and time when the object was closed." + closedAt: DateTime + "Identifies the number of closed issues associated with the milestone." + closedIssueCount: Int! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the actor who created the milestone." + creator: Actor + "Identifies the description of the milestone." + description: String + "The HTML rendered description of the milestone using GitHub Flavored Markdown." + descriptionHTML: String + "Identifies the due date of the milestone." + dueOn: DateTime + "The Node ID of the Milestone object" + id: ID! + "A list of issues associated with the milestone." + issues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filtering options for issues returned from the connection." + filterBy: IssueFilters, + "Returns the first _n_ elements from the list." + first: Int, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issues returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the issues by." + states: [IssueState!] + ): IssueConnection! + "Identifies the number of the milestone." + number: Int! + "Identifies the number of open issues associated with the milestone." + openIssueCount: Int! + "Identifies the percentage complete for the milestone" + progressPercentage: Float! + "A list of pull requests associated with the milestone." + pullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "The base ref name to filter the pull requests by." + baseRefName: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "The head ref name to filter the pull requests by." + headRefName: String, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the pull requests by." + states: [PullRequestState!] + ): PullRequestConnection! + "The repository associated with this milestone." + repository: Repository! + "The HTTP path for this milestone" + resourcePath: URI! + "Identifies the state of the milestone." + state: MilestoneState! + "Identifies the title of the milestone." + title: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this milestone" + url: URI! + "Indicates if the object can be closed by the viewer." + viewerCanClose: Boolean! + "Indicates if the object can be reopened by the viewer." + viewerCanReopen: Boolean! +} + +"The connection type for Milestone." +type MilestoneConnection { + "A list of edges." + edges: [MilestoneEdge] + "A list of nodes." + nodes: [Milestone] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type MilestoneEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Milestone +} + +"Represents a 'milestoned' event on a given issue or pull request." +type MilestonedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the MilestonedEvent object" + id: ID! + "Identifies the milestone title associated with the 'milestoned' event." + milestoneTitle: String! + "Object referenced by event." + subject: MilestoneItem! +} + +"Autogenerated return type of MinimizeComment." +type MinimizeCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The comment that was minimized." + minimizedComment: Minimizable +} + +"Autogenerated return type of MoveProjectCard." +type MoveProjectCardPayload { + "The new edge of the moved card." + cardEdge: ProjectCardEdge + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of MoveProjectColumn." +type MoveProjectColumnPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new edge of the moved column." + columnEdge: ProjectColumnEdge +} + +"Represents a 'moved_columns_in_project' event on a given issue or pull request." +type MovedColumnsInProjectEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The Node ID of the MovedColumnsInProjectEvent object" + id: ID! + "Column name the issue or pull request was moved from." + previousProjectColumnName: String! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Project referenced by event." + project: Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Project card referenced by this project event." + projectCard: ProjectCard @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Column name the issue or pull request was moved to." + projectColumnName: String! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"The root query for implementing GraphQL mutations." +type Mutation { + "Clear all of a customer's queued migrations" + abortQueuedMigrations( + "Parameters for AbortQueuedMigrations" + input: AbortQueuedMigrationsInput! + ): AbortQueuedMigrationsPayload + "Abort a repository migration queued or in progress." + abortRepositoryMigration( + "Parameters for AbortRepositoryMigration" + input: AbortRepositoryMigrationInput! + ): AbortRepositoryMigrationPayload + "Accepts a pending invitation for a user to become an administrator of an enterprise." + acceptEnterpriseAdministratorInvitation( + "Parameters for AcceptEnterpriseAdministratorInvitation" + input: AcceptEnterpriseAdministratorInvitationInput! + ): AcceptEnterpriseAdministratorInvitationPayload + "Accepts a pending invitation for a user to become an unaffiliated member of an enterprise." + acceptEnterpriseMemberInvitation( + "Parameters for AcceptEnterpriseMemberInvitation" + input: AcceptEnterpriseMemberInvitationInput! + ): AcceptEnterpriseMemberInvitationPayload + "Applies a suggested topic to the repository." + acceptTopicSuggestion( + "Parameters for AcceptTopicSuggestion" + input: AcceptTopicSuggestionInput! + ): AcceptTopicSuggestionPayload + "Access user namespace repository for a temporary duration." + accessUserNamespaceRepository( + "Parameters for AccessUserNamespaceRepository" + input: AccessUserNamespaceRepositoryInput! + ): AccessUserNamespaceRepositoryPayload + "Adds assignees to an assignable object." + addAssigneesToAssignable( + "Parameters for AddAssigneesToAssignable" + input: AddAssigneesToAssignableInput! + ): AddAssigneesToAssignablePayload + "Adds a 'blocked by' relationship to an issue." + addBlockedBy( + "Parameters for AddBlockedBy" + input: AddBlockedByInput! + ): AddBlockedByPayload + "Adds a comment to an Issue or Pull Request." + addComment( + "Parameters for AddComment" + input: AddCommentInput! + ): AddCommentPayload + "Adds a comment to a Discussion, possibly as a reply to another comment." + addDiscussionComment( + "Parameters for AddDiscussionComment" + input: AddDiscussionCommentInput! + ): AddDiscussionCommentPayload + "Vote for an option in a discussion poll." + addDiscussionPollVote( + "Parameters for AddDiscussionPollVote" + input: AddDiscussionPollVoteInput! + ): AddDiscussionPollVotePayload + "Adds enterprise members to an organization within the enterprise." + addEnterpriseOrganizationMember( + "Parameters for AddEnterpriseOrganizationMember" + input: AddEnterpriseOrganizationMemberInput! + ): AddEnterpriseOrganizationMemberPayload + "Adds a support entitlement to an enterprise member." + addEnterpriseSupportEntitlement( + "Parameters for AddEnterpriseSupportEntitlement" + input: AddEnterpriseSupportEntitlementInput! + ): AddEnterpriseSupportEntitlementPayload + "Adds labels to a labelable object." + addLabelsToLabelable( + "Parameters for AddLabelsToLabelable" + input: AddLabelsToLabelableInput! + ): AddLabelsToLabelablePayload + "Adds a card to a ProjectColumn. Either `contentId` or `note` must be provided but **not** both." + addProjectCard( + "Parameters for AddProjectCard" + input: AddProjectCardInput! + ): AddProjectCardPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Adds a column to a Project." + addProjectColumn( + "Parameters for AddProjectColumn" + input: AddProjectColumnInput! + ): AddProjectColumnPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Creates a new draft issue and add it to a Project." + addProjectV2DraftIssue( + "Parameters for AddProjectV2DraftIssue" + input: AddProjectV2DraftIssueInput! + ): AddProjectV2DraftIssuePayload + "Links an existing content instance to a Project." + addProjectV2ItemById( + "Parameters for AddProjectV2ItemById" + input: AddProjectV2ItemByIdInput! + ): AddProjectV2ItemByIdPayload + "Adds a review to a Pull Request." + addPullRequestReview( + "Parameters for AddPullRequestReview" + input: AddPullRequestReviewInput! + ): AddPullRequestReviewPayload + "Adds a comment to a review." + addPullRequestReviewComment( + "Parameters for AddPullRequestReviewComment" + input: AddPullRequestReviewCommentInput! + ): AddPullRequestReviewCommentPayload + "Adds a new thread to a pending Pull Request Review." + addPullRequestReviewThread( + "Parameters for AddPullRequestReviewThread" + input: AddPullRequestReviewThreadInput! + ): AddPullRequestReviewThreadPayload + "Adds a reply to an existing Pull Request Review Thread." + addPullRequestReviewThreadReply( + "Parameters for AddPullRequestReviewThreadReply" + input: AddPullRequestReviewThreadReplyInput! + ): AddPullRequestReviewThreadReplyPayload + "Adds a reaction to a subject." + addReaction( + "Parameters for AddReaction" + input: AddReactionInput! + ): AddReactionPayload + "Adds a star to a Starrable." + addStar( + "Parameters for AddStar" + input: AddStarInput! + ): AddStarPayload + "Adds a sub-issue to a given issue" + addSubIssue( + "Parameters for AddSubIssue" + input: AddSubIssueInput! + ): AddSubIssuePayload + "Add an upvote to a discussion or discussion comment." + addUpvote( + "Parameters for AddUpvote" + input: AddUpvoteInput! + ): AddUpvotePayload + "Adds a verifiable domain to an owning account." + addVerifiableDomain( + "Parameters for AddVerifiableDomain" + input: AddVerifiableDomainInput! + ): AddVerifiableDomainPayload + "Approve all pending deployments under one or more environments" + approveDeployments( + "Parameters for ApproveDeployments" + input: ApproveDeploymentsInput! + ): ApproveDeploymentsPayload + "Approve a verifiable domain for notification delivery." + approveVerifiableDomain( + "Parameters for ApproveVerifiableDomain" + input: ApproveVerifiableDomainInput! + ): ApproveVerifiableDomainPayload + "Archives a ProjectV2Item" + archiveProjectV2Item( + "Parameters for ArchiveProjectV2Item" + input: ArchiveProjectV2ItemInput! + ): ArchiveProjectV2ItemPayload + "Marks a repository as archived." + archiveRepository( + "Parameters for ArchiveRepository" + input: ArchiveRepositoryInput! + ): ArchiveRepositoryPayload + "Cancels a pending invitation for an administrator to join an enterprise." + cancelEnterpriseAdminInvitation( + "Parameters for CancelEnterpriseAdminInvitation" + input: CancelEnterpriseAdminInvitationInput! + ): CancelEnterpriseAdminInvitationPayload + "Cancels a pending invitation for an unaffiliated member to join an enterprise." + cancelEnterpriseMemberInvitation( + "Parameters for CancelEnterpriseMemberInvitation" + input: CancelEnterpriseMemberInvitationInput! + ): CancelEnterpriseMemberInvitationPayload + "Cancel an active sponsorship." + cancelSponsorship( + "Parameters for CancelSponsorship" + input: CancelSponsorshipInput! + ): CancelSponsorshipPayload + "Update your status on GitHub." + changeUserStatus( + "Parameters for ChangeUserStatus" + input: ChangeUserStatusInput! + ): ChangeUserStatusPayload + "Clears all labels from a labelable object." + clearLabelsFromLabelable( + "Parameters for ClearLabelsFromLabelable" + input: ClearLabelsFromLabelableInput! + ): ClearLabelsFromLabelablePayload + "This mutation clears the value of a field for an item in a Project. Currently only text, number, date, assignees, labels, single-select, iteration and milestone fields are supported." + clearProjectV2ItemFieldValue( + "Parameters for ClearProjectV2ItemFieldValue" + input: ClearProjectV2ItemFieldValueInput! + ): ClearProjectV2ItemFieldValuePayload + "Creates a new project by cloning configuration from an existing project." + cloneProject( + "Parameters for CloneProject" + input: CloneProjectInput! + ): CloneProjectPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Create a new repository with the same files and directory structure as a template repository." + cloneTemplateRepository( + "Parameters for CloneTemplateRepository" + input: CloneTemplateRepositoryInput! + ): CloneTemplateRepositoryPayload + "Close a discussion." + closeDiscussion( + "Parameters for CloseDiscussion" + input: CloseDiscussionInput! + ): CloseDiscussionPayload + "Close an issue." + closeIssue( + "Parameters for CloseIssue" + input: CloseIssueInput! + ): CloseIssuePayload + "Close a pull request." + closePullRequest( + "Parameters for ClosePullRequest" + input: ClosePullRequestInput! + ): ClosePullRequestPayload + "Convert a project note card to one associated with a newly created issue." + convertProjectCardNoteToIssue( + "Parameters for ConvertProjectCardNoteToIssue" + input: ConvertProjectCardNoteToIssueInput! + ): ConvertProjectCardNoteToIssuePayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Converts a projectV2 draft issue item to an issue." + convertProjectV2DraftIssueItemToIssue( + "Parameters for ConvertProjectV2DraftIssueItemToIssue" + input: ConvertProjectV2DraftIssueItemToIssueInput! + ): ConvertProjectV2DraftIssueItemToIssuePayload + "Converts a pull request to draft" + convertPullRequestToDraft( + "Parameters for ConvertPullRequestToDraft" + input: ConvertPullRequestToDraftInput! + ): ConvertPullRequestToDraftPayload + "Copy a project." + copyProjectV2( + "Parameters for CopyProjectV2" + input: CopyProjectV2Input! + ): CopyProjectV2Payload + "Invites a user to claim reattributable data" + createAttributionInvitation( + "Parameters for CreateAttributionInvitation" + input: CreateAttributionInvitationInput! + ): CreateAttributionInvitationPayload + "Create a new branch protection rule" + createBranchProtectionRule( + "Parameters for CreateBranchProtectionRule" + input: CreateBranchProtectionRuleInput! + ): CreateBranchProtectionRulePayload + "Create a check run." + createCheckRun( + "Parameters for CreateCheckRun" + input: CreateCheckRunInput! + ): CreateCheckRunPayload + "Create a check suite" + createCheckSuite( + "Parameters for CreateCheckSuite" + input: CreateCheckSuiteInput! + ): CreateCheckSuitePayload + """ + + Appends a commit to the given branch as the authenticated user. + + This mutation creates a commit whose parent is the HEAD of the provided + branch and also updates that branch to point to the new commit. + It can be thought of as similar to `git commit`. + + ### Locating a Branch + + Commits are appended to a `branch` of type `Ref`. + This must refer to a git branch (i.e. the fully qualified path must + begin with `refs/heads/`, although including this prefix is optional. + + Callers may specify the `branch` to commit to either by its global node + ID or by passing both of `repositoryNameWithOwner` and `refName`. For + more details see the documentation for `CommittableBranch`. + + ### Describing Changes + + `fileChanges` are specified as a `FilesChanges` object describing + `FileAdditions` and `FileDeletions`. + + Please see the documentation for `FileChanges` for more information on + how to use this argument to describe any set of file changes. + + ### Authorship + + Similar to the web commit interface, this mutation does not support + specifying the author or committer of the commit and will not add + support for this in the future. + + A commit created by a successful execution of this mutation will be + authored by the owner of the credential which authenticates the API + request. The committer will be identical to that of commits authored + using the web interface. + + If you need full control over author and committer information, please + use the Git Database REST API instead. + + ### Commit Signing + + Commits made using this mutation are automatically signed by GitHub if + supported and will be marked as verified in the user interface. + """ + createCommitOnBranch( + "Parameters for CreateCommitOnBranch" + input: CreateCommitOnBranchInput! + ): CreateCommitOnBranchPayload + "Creates a new deployment event." + createDeployment( + "Parameters for CreateDeployment" + input: CreateDeploymentInput! + ): CreateDeploymentPayload + "Create a deployment status." + createDeploymentStatus( + "Parameters for CreateDeploymentStatus" + input: CreateDeploymentStatusInput! + ): CreateDeploymentStatusPayload + "Create a discussion." + createDiscussion( + "Parameters for CreateDiscussion" + input: CreateDiscussionInput! + ): CreateDiscussionPayload + "Creates an organization as part of an enterprise account. A personal access token used to create an organization is implicitly permitted to update the organization it created, if the organization is part of an enterprise that has SAML enabled or uses Enterprise Managed Users. If the organization is not part of such an enterprise, and instead has SAML enabled for it individually, the token will then require SAML authorization to continue working against that organization." + createEnterpriseOrganization( + "Parameters for CreateEnterpriseOrganization" + input: CreateEnterpriseOrganizationInput! + ): CreateEnterpriseOrganizationPayload + "Creates an environment or simply returns it if already exists." + createEnvironment( + "Parameters for CreateEnvironment" + input: CreateEnvironmentInput! + ): CreateEnvironmentPayload + "Creates a new IP allow list entry." + createIpAllowListEntry( + "Parameters for CreateIpAllowListEntry" + input: CreateIpAllowListEntryInput! + ): CreateIpAllowListEntryPayload + "Creates a new issue." + createIssue( + "Parameters for CreateIssue" + input: CreateIssueInput! + ): CreateIssuePayload + "Creates a new issue type" + createIssueType( + "Parameters for CreateIssueType" + input: CreateIssueTypeInput! + ): CreateIssueTypePayload + "Creates a new label." + createLabel( + "Parameters for CreateLabel" + input: CreateLabelInput! + ): CreateLabelPayload + "Create a branch linked to an issue." + createLinkedBranch( + "Parameters for CreateLinkedBranch" + input: CreateLinkedBranchInput! + ): CreateLinkedBranchPayload + "Creates a GitHub Enterprise Importer (GEI) migration source." + createMigrationSource( + "Parameters for CreateMigrationSource" + input: CreateMigrationSourceInput! + ): CreateMigrationSourcePayload + "Creates a new project." + createProject( + "Parameters for CreateProject" + input: CreateProjectInput! + ): CreateProjectPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Creates a new project." + createProjectV2( + "Parameters for CreateProjectV2" + input: CreateProjectV2Input! + ): CreateProjectV2Payload + "Create a new project field." + createProjectV2Field( + "Parameters for CreateProjectV2Field" + input: CreateProjectV2FieldInput! + ): CreateProjectV2FieldPayload + "Creates a status update within a Project." + createProjectV2StatusUpdate( + "Parameters for CreateProjectV2StatusUpdate" + input: CreateProjectV2StatusUpdateInput! + ): CreateProjectV2StatusUpdatePayload + "Create a new pull request" + createPullRequest( + "Parameters for CreatePullRequest" + input: CreatePullRequestInput! + ): CreatePullRequestPayload + "Create a new Git Ref." + createRef( + "Parameters for CreateRef" + input: CreateRefInput! + ): CreateRefPayload + "Create a new repository." + createRepository( + "Parameters for CreateRepository" + input: CreateRepositoryInput! + ): CreateRepositoryPayload + "Create a repository ruleset" + createRepositoryRuleset( + "Parameters for CreateRepositoryRuleset" + input: CreateRepositoryRulesetInput! + ): CreateRepositoryRulesetPayload + "Create a GitHub Sponsors profile to allow others to sponsor you or your organization." + createSponsorsListing( + "Parameters for CreateSponsorsListing" + input: CreateSponsorsListingInput! + ): CreateSponsorsListingPayload + "Create a new payment tier for your GitHub Sponsors profile." + createSponsorsTier( + "Parameters for CreateSponsorsTier" + input: CreateSponsorsTierInput! + ): CreateSponsorsTierPayload + "Start a new sponsorship of a maintainer in GitHub Sponsors, or reactivate a past sponsorship." + createSponsorship( + "Parameters for CreateSponsorship" + input: CreateSponsorshipInput! + ): CreateSponsorshipPayload + "Make many sponsorships for different sponsorable users or organizations at once. Can only sponsor those who have a public GitHub Sponsors profile." + createSponsorships( + "Parameters for CreateSponsorships" + input: CreateSponsorshipsInput! + ): CreateSponsorshipsPayload + "Creates a new team discussion." + createTeamDiscussion( + "Parameters for CreateTeamDiscussion" + input: CreateTeamDiscussionInput! + ): CreateTeamDiscussionPayload + "Creates a new team discussion comment." + createTeamDiscussionComment( + "Parameters for CreateTeamDiscussionComment" + input: CreateTeamDiscussionCommentInput! + ): CreateTeamDiscussionCommentPayload + "Creates a new user list." + createUserList( + "Parameters for CreateUserList" + input: CreateUserListInput! + ): CreateUserListPayload + "Rejects a suggested topic for the repository." + declineTopicSuggestion( + "Parameters for DeclineTopicSuggestion" + input: DeclineTopicSuggestionInput! + ): DeclineTopicSuggestionPayload + "Delete a branch protection rule" + deleteBranchProtectionRule( + "Parameters for DeleteBranchProtectionRule" + input: DeleteBranchProtectionRuleInput! + ): DeleteBranchProtectionRulePayload + "Deletes a deployment." + deleteDeployment( + "Parameters for DeleteDeployment" + input: DeleteDeploymentInput! + ): DeleteDeploymentPayload + "Delete a discussion and all of its replies." + deleteDiscussion( + "Parameters for DeleteDiscussion" + input: DeleteDiscussionInput! + ): DeleteDiscussionPayload + "Delete a discussion comment. If it has replies, wipe it instead." + deleteDiscussionComment( + "Parameters for DeleteDiscussionComment" + input: DeleteDiscussionCommentInput! + ): DeleteDiscussionCommentPayload + "Deletes an environment" + deleteEnvironment( + "Parameters for DeleteEnvironment" + input: DeleteEnvironmentInput! + ): DeleteEnvironmentPayload + "Deletes an IP allow list entry." + deleteIpAllowListEntry( + "Parameters for DeleteIpAllowListEntry" + input: DeleteIpAllowListEntryInput! + ): DeleteIpAllowListEntryPayload + "Deletes an Issue object." + deleteIssue( + "Parameters for DeleteIssue" + input: DeleteIssueInput! + ): DeleteIssuePayload + "Deletes an IssueComment object." + deleteIssueComment( + "Parameters for DeleteIssueComment" + input: DeleteIssueCommentInput! + ): DeleteIssueCommentPayload + "Delete an issue type" + deleteIssueType( + "Parameters for DeleteIssueType" + input: DeleteIssueTypeInput! + ): DeleteIssueTypePayload + "Deletes a label." + deleteLabel( + "Parameters for DeleteLabel" + input: DeleteLabelInput! + ): DeleteLabelPayload + "Unlink a branch from an issue." + deleteLinkedBranch( + "Parameters for DeleteLinkedBranch" + input: DeleteLinkedBranchInput! + ): DeleteLinkedBranchPayload + "Delete a package version." + deletePackageVersion( + "Parameters for DeletePackageVersion" + input: DeletePackageVersionInput! + ): DeletePackageVersionPayload + "Deletes a project." + deleteProject( + "Parameters for DeleteProject" + input: DeleteProjectInput! + ): DeleteProjectPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Deletes a project card." + deleteProjectCard( + "Parameters for DeleteProjectCard" + input: DeleteProjectCardInput! + ): DeleteProjectCardPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Deletes a project column." + deleteProjectColumn( + "Parameters for DeleteProjectColumn" + input: DeleteProjectColumnInput! + ): DeleteProjectColumnPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Delete a project." + deleteProjectV2( + "Parameters for DeleteProjectV2" + input: DeleteProjectV2Input! + ): DeleteProjectV2Payload + "Delete a project field." + deleteProjectV2Field( + "Parameters for DeleteProjectV2Field" + input: DeleteProjectV2FieldInput! + ): DeleteProjectV2FieldPayload + "Deletes an item from a Project." + deleteProjectV2Item( + "Parameters for DeleteProjectV2Item" + input: DeleteProjectV2ItemInput! + ): DeleteProjectV2ItemPayload + "Deletes a project status update." + deleteProjectV2StatusUpdate( + "Parameters for DeleteProjectV2StatusUpdate" + input: DeleteProjectV2StatusUpdateInput! + ): DeleteProjectV2StatusUpdatePayload + "Deletes a project workflow." + deleteProjectV2Workflow( + "Parameters for DeleteProjectV2Workflow" + input: DeleteProjectV2WorkflowInput! + ): DeleteProjectV2WorkflowPayload + "Deletes a pull request review." + deletePullRequestReview( + "Parameters for DeletePullRequestReview" + input: DeletePullRequestReviewInput! + ): DeletePullRequestReviewPayload + "Deletes a pull request review comment." + deletePullRequestReviewComment( + "Parameters for DeletePullRequestReviewComment" + input: DeletePullRequestReviewCommentInput! + ): DeletePullRequestReviewCommentPayload + "Delete a Git Ref." + deleteRef( + "Parameters for DeleteRef" + input: DeleteRefInput! + ): DeleteRefPayload + "Delete a repository ruleset" + deleteRepositoryRuleset( + "Parameters for DeleteRepositoryRuleset" + input: DeleteRepositoryRulesetInput! + ): DeleteRepositoryRulesetPayload + "Deletes a team discussion." + deleteTeamDiscussion( + "Parameters for DeleteTeamDiscussion" + input: DeleteTeamDiscussionInput! + ): DeleteTeamDiscussionPayload + "Deletes a team discussion comment." + deleteTeamDiscussionComment( + "Parameters for DeleteTeamDiscussionComment" + input: DeleteTeamDiscussionCommentInput! + ): DeleteTeamDiscussionCommentPayload + "Deletes a user list." + deleteUserList( + "Parameters for DeleteUserList" + input: DeleteUserListInput! + ): DeleteUserListPayload + "Deletes a verifiable domain." + deleteVerifiableDomain( + "Parameters for DeleteVerifiableDomain" + input: DeleteVerifiableDomainInput! + ): DeleteVerifiableDomainPayload + "Remove a pull request from the merge queue." + dequeuePullRequest( + "Parameters for DequeuePullRequest" + input: DequeuePullRequestInput! + ): DequeuePullRequestPayload + "Disable auto merge on the given pull request" + disablePullRequestAutoMerge( + "Parameters for DisablePullRequestAutoMerge" + input: DisablePullRequestAutoMergeInput! + ): DisablePullRequestAutoMergePayload + "Dismisses an approved or rejected pull request review." + dismissPullRequestReview( + "Parameters for DismissPullRequestReview" + input: DismissPullRequestReviewInput! + ): DismissPullRequestReviewPayload + "Dismisses the Dependabot alert." + dismissRepositoryVulnerabilityAlert( + "Parameters for DismissRepositoryVulnerabilityAlert" + input: DismissRepositoryVulnerabilityAlertInput! + ): DismissRepositoryVulnerabilityAlertPayload + "Enable the default auto-merge on a pull request." + enablePullRequestAutoMerge( + "Parameters for EnablePullRequestAutoMerge" + input: EnablePullRequestAutoMergeInput! + ): EnablePullRequestAutoMergePayload + "Add a pull request to the merge queue." + enqueuePullRequest( + "Parameters for EnqueuePullRequest" + input: EnqueuePullRequestInput! + ): EnqueuePullRequestPayload + "Follow an organization." + followOrganization( + "Parameters for FollowOrganization" + input: FollowOrganizationInput! + ): FollowOrganizationPayload + "Follow a user." + followUser( + "Parameters for FollowUser" + input: FollowUserInput! + ): FollowUserPayload + "Grant the migrator role to a user for all organizations under an enterprise account." + grantEnterpriseOrganizationsMigratorRole( + "Parameters for GrantEnterpriseOrganizationsMigratorRole" + input: GrantEnterpriseOrganizationsMigratorRoleInput! + ): GrantEnterpriseOrganizationsMigratorRolePayload + "Grant the migrator role to a user or a team." + grantMigratorRole( + "Parameters for GrantMigratorRole" + input: GrantMigratorRoleInput! + ): GrantMigratorRolePayload + "Creates a new project by importing columns and a list of issues/PRs." + importProject( + "Parameters for ImportProject" + input: ImportProjectInput! + ): ImportProjectPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Invite someone to become an administrator of the enterprise." + inviteEnterpriseAdmin( + "Parameters for InviteEnterpriseAdmin" + input: InviteEnterpriseAdminInput! + ): InviteEnterpriseAdminPayload + "Invite someone to become an unaffiliated member of the enterprise." + inviteEnterpriseMember( + "Parameters for InviteEnterpriseMember" + input: InviteEnterpriseMemberInput! + ): InviteEnterpriseMemberPayload + "Links a project to a repository." + linkProjectV2ToRepository( + "Parameters for LinkProjectV2ToRepository" + input: LinkProjectV2ToRepositoryInput! + ): LinkProjectV2ToRepositoryPayload + "Links a project to a team." + linkProjectV2ToTeam( + "Parameters for LinkProjectV2ToTeam" + input: LinkProjectV2ToTeamInput! + ): LinkProjectV2ToTeamPayload + "Creates a repository link for a project." + linkRepositoryToProject( + "Parameters for LinkRepositoryToProject" + input: LinkRepositoryToProjectInput! + ): LinkRepositoryToProjectPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Lock a lockable object" + lockLockable( + "Parameters for LockLockable" + input: LockLockableInput! + ): LockLockablePayload + "Mark a discussion comment as the chosen answer for discussions in an answerable category." + markDiscussionCommentAsAnswer( + "Parameters for MarkDiscussionCommentAsAnswer" + input: MarkDiscussionCommentAsAnswerInput! + ): MarkDiscussionCommentAsAnswerPayload + "Mark a pull request file as viewed" + markFileAsViewed( + "Parameters for MarkFileAsViewed" + input: MarkFileAsViewedInput! + ): MarkFileAsViewedPayload + "Mark a project as a template. Note that only projects which are owned by an Organization can be marked as a template." + markProjectV2AsTemplate( + "Parameters for MarkProjectV2AsTemplate" + input: MarkProjectV2AsTemplateInput! + ): MarkProjectV2AsTemplatePayload + "Marks a pull request ready for review." + markPullRequestReadyForReview( + "Parameters for MarkPullRequestReadyForReview" + input: MarkPullRequestReadyForReviewInput! + ): MarkPullRequestReadyForReviewPayload + "Merge a head into a branch." + mergeBranch( + "Parameters for MergeBranch" + input: MergeBranchInput! + ): MergeBranchPayload + "Merge a pull request." + mergePullRequest( + "Parameters for MergePullRequest" + input: MergePullRequestInput! + ): MergePullRequestPayload + "Minimizes a comment on an Issue, Commit, Pull Request, or Gist" + minimizeComment( + "Parameters for MinimizeComment" + input: MinimizeCommentInput! + ): MinimizeCommentPayload + "Moves a project card to another place." + moveProjectCard( + "Parameters for MoveProjectCard" + input: MoveProjectCardInput! + ): MoveProjectCardPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Moves a project column to another place." + moveProjectColumn( + "Parameters for MoveProjectColumn" + input: MoveProjectColumnInput! + ): MoveProjectColumnPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Pin an environment to a repository" + pinEnvironment( + "Parameters for PinEnvironment" + input: PinEnvironmentInput! + ): PinEnvironmentPayload + "Pin an issue to a repository" + pinIssue( + "Parameters for PinIssue" + input: PinIssueInput! + ): PinIssuePayload + "Publish an existing sponsorship tier that is currently still a draft to a GitHub Sponsors profile." + publishSponsorsTier( + "Parameters for PublishSponsorsTier" + input: PublishSponsorsTierInput! + ): PublishSponsorsTierPayload + "Regenerates the identity provider recovery codes for an enterprise" + regenerateEnterpriseIdentityProviderRecoveryCodes( + "Parameters for RegenerateEnterpriseIdentityProviderRecoveryCodes" + input: RegenerateEnterpriseIdentityProviderRecoveryCodesInput! + ): RegenerateEnterpriseIdentityProviderRecoveryCodesPayload + "Regenerates a verifiable domain's verification token." + regenerateVerifiableDomainToken( + "Parameters for RegenerateVerifiableDomainToken" + input: RegenerateVerifiableDomainTokenInput! + ): RegenerateVerifiableDomainTokenPayload + "Reject all pending deployments under one or more environments" + rejectDeployments( + "Parameters for RejectDeployments" + input: RejectDeploymentsInput! + ): RejectDeploymentsPayload + "Removes assignees from an assignable object." + removeAssigneesFromAssignable( + "Parameters for RemoveAssigneesFromAssignable" + input: RemoveAssigneesFromAssignableInput! + ): RemoveAssigneesFromAssignablePayload + "Removes a 'blocked by' relationship from an issue." + removeBlockedBy( + "Parameters for RemoveBlockedBy" + input: RemoveBlockedByInput! + ): RemoveBlockedByPayload + "Removes an administrator from the enterprise." + removeEnterpriseAdmin( + "Parameters for RemoveEnterpriseAdmin" + input: RemoveEnterpriseAdminInput! + ): RemoveEnterpriseAdminPayload + "Removes the identity provider from an enterprise. Owners of enterprises both with and without Enterprise Managed Users may use this mutation." + removeEnterpriseIdentityProvider( + "Parameters for RemoveEnterpriseIdentityProvider" + input: RemoveEnterpriseIdentityProviderInput! + ): RemoveEnterpriseIdentityProviderPayload + "Completely removes a user from the enterprise" + removeEnterpriseMember( + "Parameters for RemoveEnterpriseMember" + input: RemoveEnterpriseMemberInput! + ): RemoveEnterpriseMemberPayload + "Removes an organization from the enterprise" + removeEnterpriseOrganization( + "Parameters for RemoveEnterpriseOrganization" + input: RemoveEnterpriseOrganizationInput! + ): RemoveEnterpriseOrganizationPayload + "Removes a support entitlement from an enterprise member." + removeEnterpriseSupportEntitlement( + "Parameters for RemoveEnterpriseSupportEntitlement" + input: RemoveEnterpriseSupportEntitlementInput! + ): RemoveEnterpriseSupportEntitlementPayload + "Removes labels from a Labelable object." + removeLabelsFromLabelable( + "Parameters for RemoveLabelsFromLabelable" + input: RemoveLabelsFromLabelableInput! + ): RemoveLabelsFromLabelablePayload + "Removes outside collaborator from all repositories in an organization." + removeOutsideCollaborator( + "Parameters for RemoveOutsideCollaborator" + input: RemoveOutsideCollaboratorInput! + ): RemoveOutsideCollaboratorPayload + "Removes a reaction from a subject." + removeReaction( + "Parameters for RemoveReaction" + input: RemoveReactionInput! + ): RemoveReactionPayload + "Removes a star from a Starrable." + removeStar( + "Parameters for RemoveStar" + input: RemoveStarInput! + ): RemoveStarPayload + "Removes a sub-issue from a given issue" + removeSubIssue( + "Parameters for RemoveSubIssue" + input: RemoveSubIssueInput! + ): RemoveSubIssuePayload + "Remove an upvote to a discussion or discussion comment." + removeUpvote( + "Parameters for RemoveUpvote" + input: RemoveUpvoteInput! + ): RemoveUpvotePayload + "Reopen a discussion." + reopenDiscussion( + "Parameters for ReopenDiscussion" + input: ReopenDiscussionInput! + ): ReopenDiscussionPayload + "Reopen a issue." + reopenIssue( + "Parameters for ReopenIssue" + input: ReopenIssueInput! + ): ReopenIssuePayload + "Reopen a pull request." + reopenPullRequest( + "Parameters for ReopenPullRequest" + input: ReopenPullRequestInput! + ): ReopenPullRequestPayload + "Reorder a pinned repository environment" + reorderEnvironment( + "Parameters for ReorderEnvironment" + input: ReorderEnvironmentInput! + ): ReorderEnvironmentPayload + "Replaces all actors for assignable object." + replaceActorsForAssignable( + "Parameters for ReplaceActorsForAssignable" + input: ReplaceActorsForAssignableInput! + ): ReplaceActorsForAssignablePayload + "Reprioritizes a sub-issue to a different position in the parent list." + reprioritizeSubIssue( + "Parameters for ReprioritizeSubIssue" + input: ReprioritizeSubIssueInput! + ): ReprioritizeSubIssuePayload + "Set review requests on a pull request." + requestReviews( + "Parameters for RequestReviews" + input: RequestReviewsInput! + ): RequestReviewsPayload + "Rerequests an existing check suite." + rerequestCheckSuite( + "Parameters for RerequestCheckSuite" + input: RerequestCheckSuiteInput! + ): RerequestCheckSuitePayload + "Marks a review thread as resolved." + resolveReviewThread( + "Parameters for ResolveReviewThread" + input: ResolveReviewThreadInput! + ): ResolveReviewThreadPayload + "Retire a published payment tier from your GitHub Sponsors profile so it cannot be used to start new sponsorships." + retireSponsorsTier( + "Parameters for RetireSponsorsTier" + input: RetireSponsorsTierInput! + ): RetireSponsorsTierPayload + "Create a pull request that reverts the changes from a merged pull request." + revertPullRequest( + "Parameters for RevertPullRequest" + input: RevertPullRequestInput! + ): RevertPullRequestPayload + "Revoke the migrator role to a user for all organizations under an enterprise account." + revokeEnterpriseOrganizationsMigratorRole( + "Parameters for RevokeEnterpriseOrganizationsMigratorRole" + input: RevokeEnterpriseOrganizationsMigratorRoleInput! + ): RevokeEnterpriseOrganizationsMigratorRolePayload + "Revoke the migrator role from a user or a team." + revokeMigratorRole( + "Parameters for RevokeMigratorRole" + input: RevokeMigratorRoleInput! + ): RevokeMigratorRolePayload + "Creates or updates the identity provider for an enterprise." + setEnterpriseIdentityProvider( + "Parameters for SetEnterpriseIdentityProvider" + input: SetEnterpriseIdentityProviderInput! + ): SetEnterpriseIdentityProviderPayload + "Set an organization level interaction limit for an organization's public repositories." + setOrganizationInteractionLimit( + "Parameters for SetOrganizationInteractionLimit" + input: SetOrganizationInteractionLimitInput! + ): SetOrganizationInteractionLimitPayload + "Sets an interaction limit setting for a repository." + setRepositoryInteractionLimit( + "Parameters for SetRepositoryInteractionLimit" + input: SetRepositoryInteractionLimitInput! + ): SetRepositoryInteractionLimitPayload + "Set a user level interaction limit for an user's public repositories." + setUserInteractionLimit( + "Parameters for SetUserInteractionLimit" + input: SetUserInteractionLimitInput! + ): SetUserInteractionLimitPayload + "Starts a GitHub Enterprise Importer organization migration." + startOrganizationMigration( + "Parameters for StartOrganizationMigration" + input: StartOrganizationMigrationInput! + ): StartOrganizationMigrationPayload + "Starts a GitHub Enterprise Importer (GEI) repository migration." + startRepositoryMigration( + "Parameters for StartRepositoryMigration" + input: StartRepositoryMigrationInput! + ): StartRepositoryMigrationPayload + "Submits a pending pull request review." + submitPullRequestReview( + "Parameters for SubmitPullRequestReview" + input: SubmitPullRequestReviewInput! + ): SubmitPullRequestReviewPayload + "Transfer an organization from one enterprise to another enterprise." + transferEnterpriseOrganization( + "Parameters for TransferEnterpriseOrganization" + input: TransferEnterpriseOrganizationInput! + ): TransferEnterpriseOrganizationPayload + "Transfer an issue to a different repository" + transferIssue( + "Parameters for TransferIssue" + input: TransferIssueInput! + ): TransferIssuePayload + "Unarchives a ProjectV2Item" + unarchiveProjectV2Item( + "Parameters for UnarchiveProjectV2Item" + input: UnarchiveProjectV2ItemInput! + ): UnarchiveProjectV2ItemPayload + "Unarchives a repository." + unarchiveRepository( + "Parameters for UnarchiveRepository" + input: UnarchiveRepositoryInput! + ): UnarchiveRepositoryPayload + "Unfollow an organization." + unfollowOrganization( + "Parameters for UnfollowOrganization" + input: UnfollowOrganizationInput! + ): UnfollowOrganizationPayload + "Unfollow a user." + unfollowUser( + "Parameters for UnfollowUser" + input: UnfollowUserInput! + ): UnfollowUserPayload + "Unlinks a project from a repository." + unlinkProjectV2FromRepository( + "Parameters for UnlinkProjectV2FromRepository" + input: UnlinkProjectV2FromRepositoryInput! + ): UnlinkProjectV2FromRepositoryPayload + "Unlinks a project to a team." + unlinkProjectV2FromTeam( + "Parameters for UnlinkProjectV2FromTeam" + input: UnlinkProjectV2FromTeamInput! + ): UnlinkProjectV2FromTeamPayload + "Deletes a repository link from a project." + unlinkRepositoryFromProject( + "Parameters for UnlinkRepositoryFromProject" + input: UnlinkRepositoryFromProjectInput! + ): UnlinkRepositoryFromProjectPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Unlock a lockable object" + unlockLockable( + "Parameters for UnlockLockable" + input: UnlockLockableInput! + ): UnlockLockablePayload + "Unmark a discussion comment as the chosen answer for discussions in an answerable category." + unmarkDiscussionCommentAsAnswer( + "Parameters for UnmarkDiscussionCommentAsAnswer" + input: UnmarkDiscussionCommentAsAnswerInput! + ): UnmarkDiscussionCommentAsAnswerPayload + "Unmark a pull request file as viewed" + unmarkFileAsViewed( + "Parameters for UnmarkFileAsViewed" + input: UnmarkFileAsViewedInput! + ): UnmarkFileAsViewedPayload + "Unmark an issue as a duplicate of another issue." + unmarkIssueAsDuplicate( + "Parameters for UnmarkIssueAsDuplicate" + input: UnmarkIssueAsDuplicateInput! + ): UnmarkIssueAsDuplicatePayload + "Unmark a project as a template." + unmarkProjectV2AsTemplate( + "Parameters for UnmarkProjectV2AsTemplate" + input: UnmarkProjectV2AsTemplateInput! + ): UnmarkProjectV2AsTemplatePayload + "Unminimizes a comment on an Issue, Commit, Pull Request, or Gist" + unminimizeComment( + "Parameters for UnminimizeComment" + input: UnminimizeCommentInput! + ): UnminimizeCommentPayload + "Unpin a pinned issue from a repository" + unpinIssue( + "Parameters for UnpinIssue" + input: UnpinIssueInput! + ): UnpinIssuePayload + "Marks a review thread as unresolved." + unresolveReviewThread( + "Parameters for UnresolveReviewThread" + input: UnresolveReviewThreadInput! + ): UnresolveReviewThreadPayload + "Update a branch protection rule" + updateBranchProtectionRule( + "Parameters for UpdateBranchProtectionRule" + input: UpdateBranchProtectionRuleInput! + ): UpdateBranchProtectionRulePayload + "Update a check run" + updateCheckRun( + "Parameters for UpdateCheckRun" + input: UpdateCheckRunInput! + ): UpdateCheckRunPayload + "Modifies the settings of an existing check suite" + updateCheckSuitePreferences( + "Parameters for UpdateCheckSuitePreferences" + input: UpdateCheckSuitePreferencesInput! + ): UpdateCheckSuitePreferencesPayload + "Update a discussion" + updateDiscussion( + "Parameters for UpdateDiscussion" + input: UpdateDiscussionInput! + ): UpdateDiscussionPayload + "Update the contents of a comment on a Discussion" + updateDiscussionComment( + "Parameters for UpdateDiscussionComment" + input: UpdateDiscussionCommentInput! + ): UpdateDiscussionCommentPayload + "Updates the role of an enterprise administrator." + updateEnterpriseAdministratorRole( + "Parameters for UpdateEnterpriseAdministratorRole" + input: UpdateEnterpriseAdministratorRoleInput! + ): UpdateEnterpriseAdministratorRolePayload + "Sets whether private repository forks are enabled for an enterprise." + updateEnterpriseAllowPrivateRepositoryForkingSetting( + "Parameters for UpdateEnterpriseAllowPrivateRepositoryForkingSetting" + input: UpdateEnterpriseAllowPrivateRepositoryForkingSettingInput! + ): UpdateEnterpriseAllowPrivateRepositoryForkingSettingPayload + "Sets the base repository permission for organizations in an enterprise." + updateEnterpriseDefaultRepositoryPermissionSetting( + "Parameters for UpdateEnterpriseDefaultRepositoryPermissionSetting" + input: UpdateEnterpriseDefaultRepositoryPermissionSettingInput! + ): UpdateEnterpriseDefaultRepositoryPermissionSettingPayload + "Sets whether deploy keys are allowed to be created and used for an enterprise." + updateEnterpriseDeployKeySetting( + "Parameters for UpdateEnterpriseDeployKeySetting" + input: UpdateEnterpriseDeployKeySettingInput! + ): UpdateEnterpriseDeployKeySettingPayload + "Sets whether organization members with admin permissions on a repository can change repository visibility." + updateEnterpriseMembersCanChangeRepositoryVisibilitySetting( + "Parameters for UpdateEnterpriseMembersCanChangeRepositoryVisibilitySetting" + input: UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingInput! + ): UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingPayload + "Sets the members can create repositories setting for an enterprise." + updateEnterpriseMembersCanCreateRepositoriesSetting( + "Parameters for UpdateEnterpriseMembersCanCreateRepositoriesSetting" + input: UpdateEnterpriseMembersCanCreateRepositoriesSettingInput! + ): UpdateEnterpriseMembersCanCreateRepositoriesSettingPayload + "Sets the members can delete issues setting for an enterprise." + updateEnterpriseMembersCanDeleteIssuesSetting( + "Parameters for UpdateEnterpriseMembersCanDeleteIssuesSetting" + input: UpdateEnterpriseMembersCanDeleteIssuesSettingInput! + ): UpdateEnterpriseMembersCanDeleteIssuesSettingPayload + "Sets the members can delete repositories setting for an enterprise." + updateEnterpriseMembersCanDeleteRepositoriesSetting( + "Parameters for UpdateEnterpriseMembersCanDeleteRepositoriesSetting" + input: UpdateEnterpriseMembersCanDeleteRepositoriesSettingInput! + ): UpdateEnterpriseMembersCanDeleteRepositoriesSettingPayload + "Sets whether members can invite collaborators are enabled for an enterprise." + updateEnterpriseMembersCanInviteCollaboratorsSetting( + "Parameters for UpdateEnterpriseMembersCanInviteCollaboratorsSetting" + input: UpdateEnterpriseMembersCanInviteCollaboratorsSettingInput! + ): UpdateEnterpriseMembersCanInviteCollaboratorsSettingPayload + "Sets whether or not an organization owner can make purchases." + updateEnterpriseMembersCanMakePurchasesSetting( + "Parameters for UpdateEnterpriseMembersCanMakePurchasesSetting" + input: UpdateEnterpriseMembersCanMakePurchasesSettingInput! + ): UpdateEnterpriseMembersCanMakePurchasesSettingPayload + "Sets the members can update protected branches setting for an enterprise." + updateEnterpriseMembersCanUpdateProtectedBranchesSetting( + "Parameters for UpdateEnterpriseMembersCanUpdateProtectedBranchesSetting" + input: UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingInput! + ): UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingPayload + "Sets the members can view dependency insights for an enterprise." + updateEnterpriseMembersCanViewDependencyInsightsSetting( + "Parameters for UpdateEnterpriseMembersCanViewDependencyInsightsSetting" + input: UpdateEnterpriseMembersCanViewDependencyInsightsSettingInput! + ): UpdateEnterpriseMembersCanViewDependencyInsightsSettingPayload + "Sets whether organization projects are enabled for an enterprise." + updateEnterpriseOrganizationProjectsSetting( + "Parameters for UpdateEnterpriseOrganizationProjectsSetting" + input: UpdateEnterpriseOrganizationProjectsSettingInput! + ): UpdateEnterpriseOrganizationProjectsSettingPayload + "Updates the role of an enterprise owner with an organization." + updateEnterpriseOwnerOrganizationRole( + "Parameters for UpdateEnterpriseOwnerOrganizationRole" + input: UpdateEnterpriseOwnerOrganizationRoleInput! + ): UpdateEnterpriseOwnerOrganizationRolePayload + "Updates an enterprise's profile." + updateEnterpriseProfile( + "Parameters for UpdateEnterpriseProfile" + input: UpdateEnterpriseProfileInput! + ): UpdateEnterpriseProfilePayload + "Sets whether repository projects are enabled for a enterprise." + updateEnterpriseRepositoryProjectsSetting( + "Parameters for UpdateEnterpriseRepositoryProjectsSetting" + input: UpdateEnterpriseRepositoryProjectsSettingInput! + ): UpdateEnterpriseRepositoryProjectsSettingPayload + "Sets whether team discussions are enabled for an enterprise." + updateEnterpriseTeamDiscussionsSetting( + "Parameters for UpdateEnterpriseTeamDiscussionsSetting" + input: UpdateEnterpriseTeamDiscussionsSettingInput! + ): UpdateEnterpriseTeamDiscussionsSettingPayload + "Sets the two-factor authentication methods that users of an enterprise may not use." + updateEnterpriseTwoFactorAuthenticationDisallowedMethodsSetting( + "Parameters for UpdateEnterpriseTwoFactorAuthenticationDisallowedMethodsSetting" + input: UpdateEnterpriseTwoFactorAuthenticationDisallowedMethodsSettingInput! + ): UpdateEnterpriseTwoFactorAuthenticationDisallowedMethodsSettingPayload + "Sets whether two factor authentication is required for all users in an enterprise." + updateEnterpriseTwoFactorAuthenticationRequiredSetting( + "Parameters for UpdateEnterpriseTwoFactorAuthenticationRequiredSetting" + input: UpdateEnterpriseTwoFactorAuthenticationRequiredSettingInput! + ): UpdateEnterpriseTwoFactorAuthenticationRequiredSettingPayload + "Updates an environment." + updateEnvironment( + "Parameters for UpdateEnvironment" + input: UpdateEnvironmentInput! + ): UpdateEnvironmentPayload + "Sets whether an IP allow list is enabled on an owner." + updateIpAllowListEnabledSetting( + "Parameters for UpdateIpAllowListEnabledSetting" + input: UpdateIpAllowListEnabledSettingInput! + ): UpdateIpAllowListEnabledSettingPayload + "Updates an IP allow list entry." + updateIpAllowListEntry( + "Parameters for UpdateIpAllowListEntry" + input: UpdateIpAllowListEntryInput! + ): UpdateIpAllowListEntryPayload + "Sets whether IP allow list configuration for installed GitHub Apps is enabled on an owner." + updateIpAllowListForInstalledAppsEnabledSetting( + "Parameters for UpdateIpAllowListForInstalledAppsEnabledSetting" + input: UpdateIpAllowListForInstalledAppsEnabledSettingInput! + ): UpdateIpAllowListForInstalledAppsEnabledSettingPayload + "Updates an Issue." + updateIssue( + "Parameters for UpdateIssue" + input: UpdateIssueInput! + ): UpdateIssuePayload + "Updates an IssueComment object." + updateIssueComment( + "Parameters for UpdateIssueComment" + input: UpdateIssueCommentInput! + ): UpdateIssueCommentPayload + "Updates the issue type on an issue" + updateIssueIssueType( + "Parameters for UpdateIssueIssueType" + input: UpdateIssueIssueTypeInput! + ): UpdateIssueIssueTypePayload + "Update an issue type" + updateIssueType( + "Parameters for UpdateIssueType" + input: UpdateIssueTypeInput! + ): UpdateIssueTypePayload + "Updates an existing label." + updateLabel( + "Parameters for UpdateLabel" + input: UpdateLabelInput! + ): UpdateLabelPayload + "Update the setting to restrict notifications to only verified or approved domains available to an owner." + updateNotificationRestrictionSetting( + "Parameters for UpdateNotificationRestrictionSetting" + input: UpdateNotificationRestrictionSettingInput! + ): UpdateNotificationRestrictionSettingPayload + "Sets whether private repository forks are enabled for an organization." + updateOrganizationAllowPrivateRepositoryForkingSetting( + "Parameters for UpdateOrganizationAllowPrivateRepositoryForkingSetting" + input: UpdateOrganizationAllowPrivateRepositoryForkingSettingInput! + ): UpdateOrganizationAllowPrivateRepositoryForkingSettingPayload + "Sets whether contributors are required to sign off on web-based commits for repositories in an organization." + updateOrganizationWebCommitSignoffSetting( + "Parameters for UpdateOrganizationWebCommitSignoffSetting" + input: UpdateOrganizationWebCommitSignoffSettingInput! + ): UpdateOrganizationWebCommitSignoffSettingPayload + "Toggle the setting for your GitHub Sponsors profile that allows other GitHub accounts to sponsor you on GitHub while paying for the sponsorship on Patreon. Only applicable when you have a GitHub Sponsors profile and have connected your GitHub account with Patreon." + updatePatreonSponsorability( + "Parameters for UpdatePatreonSponsorability" + input: UpdatePatreonSponsorabilityInput! + ): UpdatePatreonSponsorabilityPayload + "Updates an existing project." + updateProject( + "Parameters for UpdateProject" + input: UpdateProjectInput! + ): UpdateProjectPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Updates an existing project card." + updateProjectCard( + "Parameters for UpdateProjectCard" + input: UpdateProjectCardInput! + ): UpdateProjectCardPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Updates an existing project column." + updateProjectColumn( + "Parameters for UpdateProjectColumn" + input: UpdateProjectColumnInput! + ): UpdateProjectColumnPayload @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Updates an existing project." + updateProjectV2( + "Parameters for UpdateProjectV2" + input: UpdateProjectV2Input! + ): UpdateProjectV2Payload + "Update the collaborators on a team or a project" + updateProjectV2Collaborators( + "Parameters for UpdateProjectV2Collaborators" + input: UpdateProjectV2CollaboratorsInput! + ): UpdateProjectV2CollaboratorsPayload + "Updates a draft issue within a Project." + updateProjectV2DraftIssue( + "Parameters for UpdateProjectV2DraftIssue" + input: UpdateProjectV2DraftIssueInput! + ): UpdateProjectV2DraftIssuePayload + "Update a project field." + updateProjectV2Field( + "Parameters for UpdateProjectV2Field" + input: UpdateProjectV2FieldInput! + ): UpdateProjectV2FieldPayload + "This mutation updates the value of a field for an item in a Project. Currently only single-select, text, number, date, and iteration fields are supported." + updateProjectV2ItemFieldValue( + "Parameters for UpdateProjectV2ItemFieldValue" + input: UpdateProjectV2ItemFieldValueInput! + ): UpdateProjectV2ItemFieldValuePayload + "This mutation updates the position of the item in the project, where the position represents the priority of an item." + updateProjectV2ItemPosition( + "Parameters for UpdateProjectV2ItemPosition" + input: UpdateProjectV2ItemPositionInput! + ): UpdateProjectV2ItemPositionPayload + "Updates a status update within a Project." + updateProjectV2StatusUpdate( + "Parameters for UpdateProjectV2StatusUpdate" + input: UpdateProjectV2StatusUpdateInput! + ): UpdateProjectV2StatusUpdatePayload + "Update a pull request" + updatePullRequest( + "Parameters for UpdatePullRequest" + input: UpdatePullRequestInput! + ): UpdatePullRequestPayload + "Merge or Rebase HEAD from upstream branch into pull request branch" + updatePullRequestBranch( + "Parameters for UpdatePullRequestBranch" + input: UpdatePullRequestBranchInput! + ): UpdatePullRequestBranchPayload + "Updates the body of a pull request review." + updatePullRequestReview( + "Parameters for UpdatePullRequestReview" + input: UpdatePullRequestReviewInput! + ): UpdatePullRequestReviewPayload + "Updates a pull request review comment." + updatePullRequestReviewComment( + "Parameters for UpdatePullRequestReviewComment" + input: UpdatePullRequestReviewCommentInput! + ): UpdatePullRequestReviewCommentPayload + "Update a Git Ref." + updateRef( + "Parameters for UpdateRef" + input: UpdateRefInput! + ): UpdateRefPayload + """ + + Creates, updates and/or deletes multiple refs in a repository. + + This mutation takes a list of `RefUpdate`s and performs these updates + on the repository. All updates are performed atomically, meaning that + if one of them is rejected, no other ref will be modified. + + `RefUpdate.beforeOid` specifies that the given reference needs to point + to the given value before performing any updates. A value of + `0000000000000000000000000000000000000000` can be used to verify that + the references should not exist. + + `RefUpdate.afterOid` specifies the value that the given reference + will point to after performing all updates. A value of + `0000000000000000000000000000000000000000` can be used to delete a + reference. + + If `RefUpdate.force` is set to `true`, a non-fast-forward updates + for the given reference will be allowed. + """ + updateRefs( + "Parameters for UpdateRefs" + input: UpdateRefsInput! + ): UpdateRefsPayload + "Update information about a repository." + updateRepository( + "Parameters for UpdateRepository" + input: UpdateRepositoryInput! + ): UpdateRepositoryPayload + "Update a repository ruleset" + updateRepositoryRuleset( + "Parameters for UpdateRepositoryRuleset" + input: UpdateRepositoryRulesetInput! + ): UpdateRepositoryRulesetPayload + "Sets whether contributors are required to sign off on web-based commits for a repository." + updateRepositoryWebCommitSignoffSetting( + "Parameters for UpdateRepositoryWebCommitSignoffSetting" + input: UpdateRepositoryWebCommitSignoffSettingInput! + ): UpdateRepositoryWebCommitSignoffSettingPayload + "Change visibility of your sponsorship and opt in or out of email updates from the maintainer." + updateSponsorshipPreferences( + "Parameters for UpdateSponsorshipPreferences" + input: UpdateSponsorshipPreferencesInput! + ): UpdateSponsorshipPreferencesPayload + "Updates the state for subscribable subjects." + updateSubscription( + "Parameters for UpdateSubscription" + input: UpdateSubscriptionInput! + ): UpdateSubscriptionPayload + "Updates a team discussion." + updateTeamDiscussion( + "Parameters for UpdateTeamDiscussion" + input: UpdateTeamDiscussionInput! + ): UpdateTeamDiscussionPayload + "Updates a discussion comment." + updateTeamDiscussionComment( + "Parameters for UpdateTeamDiscussionComment" + input: UpdateTeamDiscussionCommentInput! + ): UpdateTeamDiscussionCommentPayload + "Updates team review assignment." + updateTeamReviewAssignment( + "Parameters for UpdateTeamReviewAssignment" + input: UpdateTeamReviewAssignmentInput! + ): UpdateTeamReviewAssignmentPayload + "Update team repository." + updateTeamsRepository( + "Parameters for UpdateTeamsRepository" + input: UpdateTeamsRepositoryInput! + ): UpdateTeamsRepositoryPayload + "Replaces the repository's topics with the given topics." + updateTopics( + "Parameters for UpdateTopics" + input: UpdateTopicsInput! + ): UpdateTopicsPayload + "Updates an existing user list." + updateUserList( + "Parameters for UpdateUserList" + input: UpdateUserListInput! + ): UpdateUserListPayload + "Updates which of the viewer's lists an item belongs to" + updateUserListsForItem( + "Parameters for UpdateUserListsForItem" + input: UpdateUserListsForItemInput! + ): UpdateUserListsForItemPayload + "Verify that a verifiable domain has the expected DNS record." + verifyVerifiableDomain( + "Parameters for VerifyVerifiableDomain" + input: VerifyVerifiableDomainInput! + ): VerifyVerifiableDomainPayload +} + +"An OIDC identity provider configured to provision identities for an enterprise. Visible to enterprise owners or enterprise owners' personal access tokens (classic) with read:enterprise or admin:enterprise scope." +type OIDCProvider implements Node { + "The enterprise this identity provider belongs to." + enterprise: Enterprise + "ExternalIdentities provisioned by this identity provider." + externalIdentities( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter to external identities with the users login" + login: String, + "Filter to external identities with valid org membership only" + membersOnly: Boolean, + "Filter to external identities with the users userName/NameID attribute" + userName: String + ): ExternalIdentityConnection! + "The Node ID of the OIDCProvider object" + id: ID! + "The OIDC identity provider type" + providerType: OIDCProviderType! + "The id of the tenant this provider is attached to" + tenantId: String! +} + +"Audit log entry for a oauth_application.create event." +type OauthApplicationCreateAuditEntry implements AuditEntry & Node & OauthApplicationAuditEntryData & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The application URL of the OAuth application." + applicationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The callback URL of the OAuth application." + callbackUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OauthApplicationCreateAuditEntry object" + id: ID! + "The name of the OAuth application." + oauthApplicationName: String + "The HTTP path for the OAuth application" + oauthApplicationResourcePath: URI + "The HTTP URL for the OAuth application" + oauthApplicationUrl: URI + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The rate limit of the OAuth application." + rateLimit: Int @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The state of the OAuth application." + state: OauthApplicationCreateAuditEntryState @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.add_billing_manager" +type OrgAddBillingManagerAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgAddBillingManagerAuditEntry object" + id: ID! + "The email address used to invite a billing manager for the organization." + invitationEmail: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.add_member" +type OrgAddMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgAddMemberAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The permission level of the member added to the organization." + permission: OrgAddMemberAuditEntryPermission @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.block_user" +type OrgBlockUserAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The blocked user." + blockedUser: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the blocked user." + blockedUserName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the blocked user." + blockedUserResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the blocked user." + blockedUserUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgBlockUserAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.config.disable_collaborators_only event." +type OrgConfigDisableCollaboratorsOnlyAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgConfigDisableCollaboratorsOnlyAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.config.enable_collaborators_only event." +type OrgConfigEnableCollaboratorsOnlyAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgConfigEnableCollaboratorsOnlyAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.create event." +type OrgCreateAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The billing plan for the Organization." + billingPlan: OrgCreateAuditEntryBillingPlan @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgCreateAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.disable_oauth_app_restrictions event." +type OrgDisableOauthAppRestrictionsAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgDisableOauthAppRestrictionsAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.disable_saml event." +type OrgDisableSamlAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The SAML provider's digest algorithm URL." + digestMethodUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgDisableSamlAuditEntry object" + id: ID! + "The SAML provider's issuer URL." + issuerUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The SAML provider's signature algorithm URL." + signatureMethodUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The SAML provider's single sign-on URL." + singleSignOnUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.disable_two_factor_requirement event." +type OrgDisableTwoFactorRequirementAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgDisableTwoFactorRequirementAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.enable_oauth_app_restrictions event." +type OrgEnableOauthAppRestrictionsAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgEnableOauthAppRestrictionsAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.enable_saml event." +type OrgEnableSamlAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The SAML provider's digest algorithm URL." + digestMethodUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgEnableSamlAuditEntry object" + id: ID! + "The SAML provider's issuer URL." + issuerUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The SAML provider's signature algorithm URL." + signatureMethodUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The SAML provider's single sign-on URL." + singleSignOnUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.enable_two_factor_requirement event." +type OrgEnableTwoFactorRequirementAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgEnableTwoFactorRequirementAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.invite_member event." +type OrgInviteMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The email address of the organization invitation." + email: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgInviteMemberAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The organization invitation." + organizationInvitation: OrganizationInvitation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.invite_to_business event." +type OrgInviteToBusinessAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the OrgInviteToBusinessAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.oauth_app_access_approved event." +type OrgOauthAppAccessApprovedAuditEntry implements AuditEntry & Node & OauthApplicationAuditEntryData & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgOauthAppAccessApprovedAuditEntry object" + id: ID! + "The name of the OAuth application." + oauthApplicationName: String + "The HTTP path for the OAuth application" + oauthApplicationResourcePath: URI + "The HTTP URL for the OAuth application" + oauthApplicationUrl: URI + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.oauth_app_access_blocked event." +type OrgOauthAppAccessBlockedAuditEntry implements AuditEntry & Node & OauthApplicationAuditEntryData & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgOauthAppAccessBlockedAuditEntry object" + id: ID! + "The name of the OAuth application." + oauthApplicationName: String + "The HTTP path for the OAuth application" + oauthApplicationResourcePath: URI + "The HTTP URL for the OAuth application" + oauthApplicationUrl: URI + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.oauth_app_access_denied event." +type OrgOauthAppAccessDeniedAuditEntry implements AuditEntry & Node & OauthApplicationAuditEntryData & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgOauthAppAccessDeniedAuditEntry object" + id: ID! + "The name of the OAuth application." + oauthApplicationName: String + "The HTTP path for the OAuth application" + oauthApplicationResourcePath: URI + "The HTTP URL for the OAuth application" + oauthApplicationUrl: URI + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.oauth_app_access_requested event." +type OrgOauthAppAccessRequestedAuditEntry implements AuditEntry & Node & OauthApplicationAuditEntryData & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgOauthAppAccessRequestedAuditEntry object" + id: ID! + "The name of the OAuth application." + oauthApplicationName: String + "The HTTP path for the OAuth application" + oauthApplicationResourcePath: URI + "The HTTP URL for the OAuth application" + oauthApplicationUrl: URI + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.oauth_app_access_unblocked event." +type OrgOauthAppAccessUnblockedAuditEntry implements AuditEntry & Node & OauthApplicationAuditEntryData & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgOauthAppAccessUnblockedAuditEntry object" + id: ID! + "The name of the OAuth application." + oauthApplicationName: String + "The HTTP path for the OAuth application" + oauthApplicationResourcePath: URI + "The HTTP URL for the OAuth application" + oauthApplicationUrl: URI + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.remove_billing_manager event." +type OrgRemoveBillingManagerAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgRemoveBillingManagerAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The reason for the billing manager being removed." + reason: OrgRemoveBillingManagerAuditEntryReason @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.remove_member event." +type OrgRemoveMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgRemoveMemberAuditEntry object" + id: ID! + "The types of membership the member has with the organization." + membershipTypes: [OrgRemoveMemberAuditEntryMembershipType!] @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The reason for the member being removed." + reason: OrgRemoveMemberAuditEntryReason @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.remove_outside_collaborator event." +type OrgRemoveOutsideCollaboratorAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgRemoveOutsideCollaboratorAuditEntry object" + id: ID! + "The types of membership the outside collaborator has with the organization." + membershipTypes: [OrgRemoveOutsideCollaboratorAuditEntryMembershipType!] @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The reason for the outside collaborator being removed from the Organization." + reason: OrgRemoveOutsideCollaboratorAuditEntryReason @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.restore_member event." +type OrgRestoreMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgRestoreMemberAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The number of custom email routings for the restored member." + restoredCustomEmailRoutingsCount: Int @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The number of issue assignments for the restored member." + restoredIssueAssignmentsCount: Int @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "Restored organization membership objects." + restoredMemberships: [OrgRestoreMemberAuditEntryMembership!] @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The number of restored memberships." + restoredMembershipsCount: Int @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The number of repositories of the restored member." + restoredRepositoriesCount: Int @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The number of starred repositories for the restored member." + restoredRepositoryStarsCount: Int @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The number of watched repositories for the restored member." + restoredRepositoryWatchesCount: Int @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Metadata for an organization membership for org.restore_member actions" +type OrgRestoreMemberMembershipOrganizationAuditEntryData implements OrganizationAuditEntryData { + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Metadata for a repository membership for org.restore_member actions" +type OrgRestoreMemberMembershipRepositoryAuditEntryData implements RepositoryAuditEntryData { + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI +} + +"Metadata for a team membership for org.restore_member actions" +type OrgRestoreMemberMembershipTeamAuditEntryData implements TeamAuditEntryData { + "The team associated with the action" + team: Team + "The name of the team" + teamName: String + "The HTTP path for this team" + teamResourcePath: URI + "The HTTP URL for this team" + teamUrl: URI +} + +"Audit log entry for a org.unblock_user" +type OrgUnblockUserAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user being unblocked by the organization." + blockedUser: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the blocked user." + blockedUserName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the blocked user." + blockedUserResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the blocked user." + blockedUserUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgUnblockUserAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.update_default_repository_permission" +type OrgUpdateDefaultRepositoryPermissionAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgUpdateDefaultRepositoryPermissionAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The new base repository permission level for the organization." + permission: OrgUpdateDefaultRepositoryPermissionAuditEntryPermission @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The former base repository permission level for the organization." + permissionWas: OrgUpdateDefaultRepositoryPermissionAuditEntryPermission @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.update_member event." +type OrgUpdateMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgUpdateMemberAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The new member permission level for the organization." + permission: OrgUpdateMemberAuditEntryPermission @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The former member permission level for the organization." + permissionWas: OrgUpdateMemberAuditEntryPermission @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.update_member_repository_creation_permission event." +type OrgUpdateMemberRepositoryCreationPermissionAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "Can members create repositories in the organization." + canCreateRepositories: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgUpdateMemberRepositoryCreationPermissionAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The permission for visibility level of repositories for this organization." + visibility: OrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a org.update_member_repository_invitation_permission event." +type OrgUpdateMemberRepositoryInvitationPermissionAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "Can outside collaborators be invited to repositories in the organization." + canInviteOutsideCollaboratorsToRepositories: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the OrgUpdateMemberRepositoryInvitationPermissionAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"An account on GitHub, with one or more owners, that has repositories, members and teams." +type Organization implements Actor & MemberStatusable & Node & PackageOwner & ProfileOwner & ProjectOwner & ProjectV2Owner & ProjectV2Recent & RepositoryDiscussionAuthor & RepositoryDiscussionCommentAuthor & RepositoryOwner & Sponsorable & UniformResourceLocatable { + "The announcement banner set on this organization, if any. Only visible to members of the organization's enterprise." + announcementBanner: AnnouncementBanner + "Determine if this repository owner has any items that can be pinned to their profile." + anyPinnableItems( + "Filter to only a particular kind of pinnable item." + type: PinnableItemType + ): Boolean! + "Identifies the date and time when the organization was archived." + archivedAt: DateTime + "Audit log entries of the organization" + auditLog( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the returned audit log entries." + orderBy: AuditLogOrder = {field: CREATED_AT, direction: DESC}, + "The query string to filter audit entries" + query: String + ): OrganizationAuditEntryConnection! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A URL pointing to the organization's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The organization's public profile description." + description: String + "The organization's public profile description rendered to HTML." + descriptionHTML: String + "A list of domains owned by the organization." + domains( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Filter by if the domain is approved." + isApproved: Boolean, + "Filter by if the domain is verified." + isVerified: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for verifiable domains returned." + orderBy: VerifiableDomainOrder = {field: DOMAIN, direction: ASC} + ): VerifiableDomainConnection + "The organization's public email." + email: String + "A list of owners of the organization's enterprise account." + enterpriseOwners( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for enterprise owners returned from the connection." + orderBy: OrgEnterpriseOwnerOrder = {field: LOGIN, direction: ASC}, + "The organization role to filter by." + organizationRole: RoleInOrganization, + "The search string to look for." + query: String + ): OrganizationEnterpriseOwnerConnection! + "The estimated next GitHub Sponsors payout for this user/organization in cents (USD)." + estimatedNextSponsorsPayoutInCents: Int! + "True if this user/organization has a GitHub Sponsors listing." + hasSponsorsListing: Boolean! + "The Node ID of the Organization object" + id: ID! + "The interaction ability settings for this organization." + interactionAbility: RepositoryInteractionAbility + "The setting value for whether the organization has an IP allow list enabled." + ipAllowListEnabledSetting: IpAllowListEnabledSettingValue! + "The IP addresses that are allowed to access resources owned by the organization." + ipAllowListEntries( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for IP allow list entries returned." + orderBy: IpAllowListEntryOrder = {field: ALLOW_LIST_VALUE, direction: ASC} + ): IpAllowListEntryConnection! + "The setting value for whether the organization has IP allow list configuration for installed GitHub Apps enabled." + ipAllowListForInstalledAppsEnabledSetting: IpAllowListForInstalledAppsEnabledSettingValue! + "Whether the given account is sponsoring this user/organization." + isSponsoredBy( + "The target account's login." + accountLogin: String! + ): Boolean! + "True if the viewer is sponsored by this user/organization." + isSponsoringViewer: Boolean! + "Whether the organization has verified its profile email and website." + isVerified: Boolean! + "A list of the organization's issue types" + issueTypes( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issue types returned from the connection." + orderBy: IssueTypeOrder = {field: CREATED_AT, direction: ASC} + ): IssueTypeConnection + "Showcases a selection of repositories and gists that the profile owner has either curated or that have been selected automatically based on popularity." + itemShowcase: ProfileItemShowcase! + "Calculate how much each sponsor has ever paid total to this maintainer via GitHub Sponsors. Does not include sponsorships paid via Patreon." + lifetimeReceivedSponsorshipValues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for results returned from the connection." + orderBy: SponsorAndLifetimeValueOrder = {field: SPONSOR_LOGIN, direction: ASC} + ): SponsorAndLifetimeValueConnection! + "The organization's public profile location." + location: String + "The organization's login name." + login: String! + "A list of all mannequins for this organization." + mannequins( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter mannequins by login." + login: String, + "Ordering options for mannequins returned from the connection." + orderBy: MannequinOrder = {field: CREATED_AT, direction: ASC} + ): MannequinConnection! + "Get the status messages members of this entity have set that are either public or visible only to the organization." + memberStatuses( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for user statuses returned from the connection." + orderBy: UserStatusOrder = {field: UPDATED_AT, direction: DESC} + ): UserStatusConnection! + "Members can fork private repositories in this organization" + membersCanForkPrivateRepositories: Boolean! + "A list of users who are members of this organization." + membersWithRole( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): OrganizationMemberConnection! + "The estimated monthly GitHub Sponsors income for this user/organization in cents (USD)." + monthlyEstimatedSponsorsIncomeInCents: Int! + "The organization's public profile name." + name: String + "The HTTP path creating a new team" + newTeamResourcePath: URI! + "The HTTP URL creating a new team" + newTeamUrl: URI! + "Indicates if email notification delivery for this organization is restricted to verified or approved domains." + notificationDeliveryRestrictionEnabledSetting: NotificationRestrictionSettingValue! + "The billing email for the organization." + organizationBillingEmail: String + "A list of packages under the owner." + packages( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Find packages by their names." + names: [String], + "Ordering of the returned packages." + orderBy: PackageOrder = {field: CREATED_AT, direction: DESC}, + "Filter registry package by type." + packageType: PackageType, + "Find packages in a repository by ID." + repositoryId: ID + ): PackageConnection! + "A list of users who have been invited to join this organization." + pendingMembers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "A list of repositories and gists this profile owner can pin to their profile." + pinnableItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter the types of pinnable items that are returned." + types: [PinnableItemType!] + ): PinnableItemConnection! + "A list of repositories and gists this profile owner has pinned to their profile" + pinnedItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter the types of pinned items that are returned." + types: [PinnableItemType!] + ): PinnableItemConnection! + "Returns how many more items this profile owner can pin to their profile." + pinnedItemsRemaining: Int! + "Find project by number." + project( + "The project number to find." + number: Int! + ): Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Find a project by number." + projectV2( + "The project number." + number: Int! + ): ProjectV2 + "A list of projects under the owner." + projects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for projects returned from the connection" + orderBy: ProjectOrder, + "Query to search projects by, currently only searching by name." + search: String, + "A list of states to filter the projects by." + states: [ProjectState!] + ): ProjectConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP path listing organization's projects" + projectsResourcePath: URI! + "The HTTP URL listing organization's projects" + projectsUrl: URI! + "A list of projects under the owner." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter projects based on user role." + minPermissionLevel: ProjectV2PermissionLevel = READ, + "How to order the returned projects." + orderBy: ProjectV2Order = {field: NUMBER, direction: DESC}, + "A project to search for under the owner." + query: String + ): ProjectV2Connection! + "Recent projects that this user has modified in the context of the owner." + recentProjects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2Connection! + "A list of repositories that the user owns." + repositories( + "Array of viewer's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the current viewer owns." + affiliations: [RepositoryAffiliation], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "If non-null, filters repositories according to whether they have issues enabled" + hasIssuesEnabled: Boolean, + "If non-null, filters repositories according to whether they are archived and not maintained" + isArchived: Boolean, + "If non-null, filters repositories according to whether they are forks of another repository" + isFork: Boolean, + "If non-null, filters repositories according to whether they have been locked" + isLocked: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder, + "Array of owner's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the organization or user being viewed owns." + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR], + "If non-null, filters repositories according to privacy. Internal repositories are considered private; consider using the visibility argument if only internal repositories are needed. Cannot be combined with the visibility argument." + privacy: RepositoryPrivacy, + "If non-null, filters repositories according to visibility. Cannot be combined with the privacy argument." + visibility: RepositoryVisibility + ): RepositoryConnection! + "Find Repository." + repository( + "Follow repository renames. If disabled, a repository referenced by its old name will return an error." + followRenames: Boolean = true, + "Name of Repository to find." + name: String! + ): Repository + "Discussion comments this user has authored." + repositoryDiscussionComments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter discussion comments to only those that were marked as the answer" + onlyAnswers: Boolean = false, + "Filter discussion comments to only those in a specific repository." + repositoryId: ID + ): DiscussionCommentConnection! + "Discussions this user has started." + repositoryDiscussions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Filter discussions to only those that have been answered or not. Defaults to including both answered and unanswered discussions." + answered: Boolean, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for discussions returned from the connection." + orderBy: DiscussionOrder = {field: CREATED_AT, direction: DESC}, + "Filter discussions to only those in a specific repository." + repositoryId: ID, + "A list of states to filter the discussions by." + states: [DiscussionState!] = [] + ): DiscussionConnection! + "A list of all repository migrations for this organization." + repositoryMigrations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repository migrations returned." + orderBy: RepositoryMigrationOrder = {field: CREATED_AT, direction: ASC}, + "Filter repository migrations by repository name." + repositoryName: String, + "Filter repository migrations by state." + state: MigrationState + ): RepositoryMigrationConnection! + "When true the organization requires all members, billing managers, and outside collaborators to enable two-factor authentication." + requiresTwoFactorAuthentication: Boolean + "The HTTP path for this organization." + resourcePath: URI! + "Returns a single ruleset from the current organization by ID." + ruleset( + "The ID of the ruleset to be returned." + databaseId: Int!, + "Include rulesets configured at higher levels that apply to this organization." + includeParents: Boolean = true + ): RepositoryRuleset + "A list of rulesets for this organization." + rulesets( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Return rulesets configured at higher levels that apply to this organization" + includeParents: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int, + "Return rulesets that apply to the specified target" + targets: [RepositoryRulesetTarget!] + ): RepositoryRulesetConnection + "The Organization's SAML identity provider. Visible to (1) organization owners, (2) organization owners' personal access tokens (classic) with read:org or admin:org scope, (3) GitHub App with an installation token with read or write access to members." + samlIdentityProvider: OrganizationIdentityProvider + "List of users and organizations this entity is sponsoring." + sponsoring( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the users and organizations returned from the connection." + orderBy: SponsorOrder = {field: RELEVANCE, direction: DESC} + ): SponsorConnection! + "List of sponsors for this user or organization." + sponsors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsors returned from the connection." + orderBy: SponsorOrder = {field: RELEVANCE, direction: DESC}, + "If given, will filter for sponsors at the given tier. Will only return sponsors whose tier the viewer is permitted to see." + tierId: ID + ): SponsorConnection! + "Events involving this sponsorable, such as new sponsorships." + sponsorsActivities( + "Filter activities to only the specified actions." + actions: [SponsorsActivityAction!] = [], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether to include those events where this sponsorable acted as the sponsor. Defaults to only including events where this sponsorable was the recipient of a sponsorship." + includeAsSponsor: Boolean = false, + "Whether or not to include private activities in the result set. Defaults to including public and private activities." + includePrivate: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for activity returned from the connection." + orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}, + "Filter activities returned to only those that occurred in the most recent specified time period. Set to ALL to avoid filtering by when the activity occurred. Will be ignored if `since` or `until` is given." + period: SponsorsActivityPeriod = MONTH, + "Filter activities to those that occurred on or after this time." + since: DateTime, + "Filter activities to those that occurred before this time." + until: DateTime + ): SponsorsActivityConnection! + "The GitHub Sponsors listing for this user or organization." + sponsorsListing: SponsorsListing + "The sponsorship from the viewer to this user/organization; that is, the sponsorship where you're the sponsor." + sponsorshipForViewerAsSponsor( + "Whether to return the sponsorship only if it's still active. Pass false to get the viewer's sponsorship back even if it has been cancelled." + activeOnly: Boolean = true + ): Sponsorship + "The sponsorship from this user/organization to the viewer; that is, the sponsorship you're receiving." + sponsorshipForViewerAsSponsorable( + "Whether to return the sponsorship only if it's still active. Pass false to get the sponsorship back even if it has been cancelled." + activeOnly: Boolean = true + ): Sponsorship + "List of sponsorship updates sent from this sponsorable to sponsors." + sponsorshipNewsletters( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsorship updates returned from the connection." + orderBy: SponsorshipNewsletterOrder = {field: CREATED_AT, direction: DESC} + ): SponsorshipNewsletterConnection! + "The sponsorships where this user or organization is the maintainer receiving the funds." + sponsorshipsAsMaintainer( + "Whether to include only sponsorships that are active right now, versus all sponsorships this maintainer has ever received." + activeOnly: Boolean = true, + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether or not to include private sponsorships in the result set" + includePrivate: Boolean = false, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsorships returned from this connection. If left blank, the sponsorships will be ordered based on relevancy to the viewer." + orderBy: SponsorshipOrder + ): SponsorshipConnection! + "The sponsorships where this user or organization is the funder." + sponsorshipsAsSponsor( + "Whether to include only sponsorships that are active right now, versus all sponsorships this sponsor has ever made." + activeOnly: Boolean = true, + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter sponsorships returned to those for the specified maintainers. That is, the recipient of the sponsorship is a user or organization with one of the given logins." + maintainerLogins: [String!], + "Ordering options for sponsorships returned from this connection. If left blank, the sponsorships will be ordered based on relevancy to the viewer." + orderBy: SponsorshipOrder + ): SponsorshipConnection! + "Find an organization's team by its slug." + team( + "The name or slug of the team to find." + slug: String! + ): Team + "A list of teams in this organization." + teams( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "If true, filters teams that are mapped to an LDAP Group (Enterprise only)" + ldapMapped: Boolean, + "If non-null, filters teams according to notification setting" + notificationSetting: TeamNotificationSetting, + "Ordering options for teams returned from the connection" + orderBy: TeamOrder, + "If non-null, filters teams according to privacy" + privacy: TeamPrivacy, + "If non-null, filters teams with query on team name and team slug" + query: String, + "If non-null, filters teams according to whether the viewer is an admin or member on team" + role: TeamRole, + "If true, restrict to only root teams" + rootTeamsOnly: Boolean = false, + "User logins to filter by" + userLogins: [String!] + ): TeamConnection! + "The HTTP path listing organization's teams" + teamsResourcePath: URI! + "The HTTP URL listing organization's teams" + teamsUrl: URI! + "The amount in United States cents (e.g., 500 = $5.00 USD) that this entity has spent on GitHub to fund sponsorships. Only returns a value when viewed by the user themselves or by a user who can manage sponsorships for the requested organization." + totalSponsorshipAmountAsSponsorInCents( + "Filter payments to those that occurred on or after this time." + since: DateTime, + "Filter payments to those made to the users or organizations with the specified usernames." + sponsorableLogins: [String!] = [], + "Filter payments to those that occurred before this time." + until: DateTime + ): Int + "The organization's Twitter username." + twitterUsername: String + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this organization." + url: URI! + "Organization is adminable by the viewer." + viewerCanAdminister: Boolean! + "Can the viewer pin repositories and gists to the profile?" + viewerCanChangePinnedItems: Boolean! + "Can the current viewer create new projects on this owner." + viewerCanCreateProjects: Boolean! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Viewer can create repositories on this organization" + viewerCanCreateRepositories: Boolean! + "Viewer can create teams on this organization." + viewerCanCreateTeams: Boolean! + "Whether or not the viewer is able to sponsor this user/organization." + viewerCanSponsor: Boolean! + "Viewer is an active member of this organization." + viewerIsAMember: Boolean! + "Whether or not this Organization is followed by the viewer." + viewerIsFollowing: Boolean! + "True if the viewer is sponsoring this user/organization." + viewerIsSponsoring: Boolean! + "Whether contributors are required to sign off on web-based commits for repositories in this organization." + webCommitSignoffRequired: Boolean! + "The organization's public profile URL." + websiteUrl: URI +} + +"The connection type for OrganizationAuditEntry." +type OrganizationAuditEntryConnection { + "A list of edges." + edges: [OrganizationAuditEntryEdge] + "A list of nodes." + nodes: [OrganizationAuditEntry] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type OrganizationAuditEntryEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: OrganizationAuditEntry +} + +"A list of organizations managed by an enterprise." +type OrganizationConnection { + "A list of edges." + edges: [OrganizationEdge] + "A list of nodes." + nodes: [Organization] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type OrganizationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Organization +} + +"The connection type for User." +type OrganizationEnterpriseOwnerConnection { + "A list of edges." + edges: [OrganizationEnterpriseOwnerEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An enterprise owner in the context of an organization that is part of the enterprise." +type OrganizationEnterpriseOwnerEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: User + "The role of the owner with respect to the organization." + organizationRole: RoleInOrganization! +} + +"An Identity Provider configured to provision SAML and SCIM identities for Organizations. Visible to (1) organization owners, (2) organization owners' personal access tokens (classic) with read:org or admin:org scope, (3) GitHub App with an installation token with read or write access to members." +type OrganizationIdentityProvider implements Node { + "The digest algorithm used to sign SAML requests for the Identity Provider." + digestMethod: URI + "External Identities provisioned by this Identity Provider" + externalIdentities( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter to external identities with the users login" + login: String, + "Filter to external identities with valid org membership only" + membersOnly: Boolean, + "Filter to external identities with the users userName/NameID attribute" + userName: String + ): ExternalIdentityConnection! + "The Node ID of the OrganizationIdentityProvider object" + id: ID! + "The x509 certificate used by the Identity Provider to sign assertions and responses." + idpCertificate: X509Certificate + "The Issuer Entity ID for the SAML Identity Provider" + issuer: String + "Organization this Identity Provider belongs to" + organization: Organization + "The signature algorithm used to sign SAML requests for the Identity Provider." + signatureMethod: URI + "The URL endpoint for the Identity Provider's SAML SSO." + ssoUrl: URI +} + +"An Invitation for a user to an organization." +type OrganizationInvitation implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The email address of the user invited to the organization." + email: String + "The Node ID of the OrganizationInvitation object" + id: ID! + "The source of the invitation." + invitationSource: OrganizationInvitationSource! + "The type of invitation that was sent (e.g. email, user)." + invitationType: OrganizationInvitationType! + "The user who was invited to the organization." + invitee: User + "The user who created the invitation." + inviter: User! @deprecated(reason: "`inviter` will be removed. `inviter` will be replaced by `inviterActor`. Removal on 2024-07-01 UTC.") + "The user who created the invitation." + inviterActor: User + "The organization the invite is for" + organization: Organization! + "The user's pending role in the organization (e.g. member, owner)." + role: OrganizationInvitationRole! +} + +"The connection type for OrganizationInvitation." +type OrganizationInvitationConnection { + "A list of edges." + edges: [OrganizationInvitationEdge] + "A list of nodes." + nodes: [OrganizationInvitation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type OrganizationInvitationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: OrganizationInvitation +} + +"A list of users who belong to the organization." +type OrganizationMemberConnection { + "A list of edges." + edges: [OrganizationMemberEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a user within an organization." +type OrganizationMemberEdge { + "A cursor for use in pagination." + cursor: String! + "Whether the organization member has two factor enabled or not. Returns null if information is not available to viewer." + hasTwoFactorEnabled: Boolean + "The item at the end of the edge." + node: User + "The role this user has in the organization." + role: OrganizationMemberRole +} + +"A GitHub Enterprise Importer (GEI) organization migration." +type OrganizationMigration implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: String + "The reason the organization migration failed." + failureReason: String + "The Node ID of the OrganizationMigration object" + id: ID! + "The remaining amount of repos to be migrated." + remainingRepositoriesCount: Int + "The name of the source organization to be migrated." + sourceOrgName: String! + "The URL of the source organization to migrate." + sourceOrgUrl: URI! + "The migration state." + state: OrganizationMigrationState! + "The name of the target organization." + targetOrgName: String! + "The total amount of repositories to be migrated." + totalRepositoriesCount: Int +} + +"An organization teams hovercard context" +type OrganizationTeamsHovercardContext implements HovercardContext { + "A string describing this context" + message: String! + "An octicon to accompany this context" + octicon: String! + "Teams in this organization the user is a member of that are relevant" + relevantTeams( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): TeamConnection! + "The path for the full team list for this user" + teamsResourcePath: URI! + "The URL for the full team list for this user" + teamsUrl: URI! + "The total number of teams the user is on in the organization" + totalTeamCount: Int! +} + +"An organization list hovercard context" +type OrganizationsHovercardContext implements HovercardContext { + "A string describing this context" + message: String! + "An octicon to accompany this context" + octicon: String! + "Organizations this user is a member of that are relevant" + relevantOrganizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the User's organizations." + orderBy: OrganizationOrder + ): OrganizationConnection! + "The total number of organizations this user is in" + totalOrganizationCount: Int! +} + +"Information for an uploaded package." +type Package implements Node { + "The Node ID of the Package object" + id: ID! + "Find the latest version for the package." + latestVersion: PackageVersion + "Identifies the name of the package." + name: String! + "Identifies the type of the package." + packageType: PackageType! + "The repository this package belongs to." + repository: Repository + "Statistics about package activity." + statistics: PackageStatistics + "Find package version by version string." + version( + "The package version." + version: String! + ): PackageVersion + "list of versions for this package" + versions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering of the returned packages." + orderBy: PackageVersionOrder = {field: CREATED_AT, direction: DESC} + ): PackageVersionConnection! +} + +"The connection type for Package." +type PackageConnection { + "A list of edges." + edges: [PackageEdge] + "A list of nodes." + nodes: [Package] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PackageEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Package +} + +"A file in a package version." +type PackageFile implements Node { + "The Node ID of the PackageFile object" + id: ID! + "MD5 hash of the file." + md5: String + "Name of the file." + name: String! + "The package version this file belongs to." + packageVersion: PackageVersion + "SHA1 hash of the file." + sha1: String + "SHA256 hash of the file." + sha256: String + "Size of the file in bytes." + size: Int + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "URL to download the asset." + url: URI +} + +"The connection type for PackageFile." +type PackageFileConnection { + "A list of edges." + edges: [PackageFileEdge] + "A list of nodes." + nodes: [PackageFile] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PackageFileEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PackageFile +} + +"Represents a object that contains package activity statistics such as downloads." +type PackageStatistics { + "Number of times the package was downloaded since it was created." + downloadsTotalCount: Int! +} + +"A version tag contains the mapping between a tag name and a version." +type PackageTag implements Node { + "The Node ID of the PackageTag object" + id: ID! + "Identifies the tag name of the version." + name: String! + "Version that the tag is associated with." + version: PackageVersion +} + +"Information about a specific package version." +type PackageVersion implements Node { + "List of files associated with this package version" + files( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering of the returned package files." + orderBy: PackageFileOrder = {field: CREATED_AT, direction: ASC} + ): PackageFileConnection! + "The Node ID of the PackageVersion object" + id: ID! + "The package associated with this version." + package: Package + "The platform this version was built for." + platform: String + "Whether or not this version is a pre-release." + preRelease: Boolean! + "The README of this package version." + readme: String + "The release associated with this package version." + release: Release + "Statistics about package activity." + statistics: PackageVersionStatistics + "The package version summary." + summary: String + "The version string." + version: String! +} + +"The connection type for PackageVersion." +type PackageVersionConnection { + "A list of edges." + edges: [PackageVersionEdge] + "A list of nodes." + nodes: [PackageVersion] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PackageVersionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PackageVersion +} + +"Represents a object that contains package version activity statistics such as downloads." +type PackageVersionStatistics { + "Number of times the package was downloaded since it was created." + downloadsTotalCount: Int! +} + +"Information about pagination in a connection." +type PageInfo { + "When paginating forwards, the cursor to continue." + endCursor: String + "When paginating forwards, are there more items?" + hasNextPage: Boolean! + "When paginating backwards, are there more items?" + hasPreviousPage: Boolean! + "When paginating backwards, the cursor to continue." + startCursor: String +} + +"Represents a 'parent_issue_added' event on a given issue." +type ParentIssueAddedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ParentIssueAddedEvent object" + id: ID! + "The parent issue added." + parent: Issue +} + +"Represents a 'parent_issue_removed' event on a given issue." +type ParentIssueRemovedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ParentIssueRemovedEvent object" + id: ID! + "The parent issue removed." + parent: Issue +} + +"A level of permission and source for a user's access to a repository." +type PermissionSource { + "The organization the repository belongs to." + organization: Organization! + "The level of access this source has granted to the user." + permission: DefaultRepositoryPermissionField! + "The name of the role this source has granted to the user." + roleName: String + "The source of this permission." + source: PermissionGranter! +} + +"Autogenerated return type of PinEnvironment." +type PinEnvironmentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The environment that was pinned" + environment: Environment + "The pinned environment if we pinned" + pinnedEnvironment: PinnedEnvironment +} + +"Autogenerated return type of PinIssue." +type PinIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue that was pinned" + issue: Issue +} + +"The connection type for PinnableItem." +type PinnableItemConnection { + "A list of edges." + edges: [PinnableItemEdge] + "A list of nodes." + nodes: [PinnableItem] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PinnableItemEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PinnableItem +} + +"A Pinned Discussion is a discussion pinned to a repository's index page." +type PinnedDiscussion implements Node & RepositoryNode { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The discussion that was pinned." + discussion: Discussion! + "Color stops of the chosen gradient" + gradientStopColors: [String!]! + "The Node ID of the PinnedDiscussion object" + id: ID! + "Background texture pattern" + pattern: PinnedDiscussionPattern! + "The actor that pinned this discussion." + pinnedBy: Actor! + "Preconfigured background gradient option" + preconfiguredGradient: PinnedDiscussionGradient + "The repository associated with this node." + repository: Repository! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for PinnedDiscussion." +type PinnedDiscussionConnection { + "A list of edges." + edges: [PinnedDiscussionEdge] + "A list of nodes." + nodes: [PinnedDiscussion] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PinnedDiscussionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PinnedDiscussion +} + +"Represents a pinned environment on a given repository" +type PinnedEnvironment implements Node { + "Identifies the date and time when the pinned environment was created" + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "Identifies the environment associated." + environment: Environment! + "The Node ID of the PinnedEnvironment object" + id: ID! + "Identifies the position of the pinned environment." + position: Int! + "The repository that this environment was pinned to." + repository: Repository! +} + +"The connection type for PinnedEnvironment." +type PinnedEnvironmentConnection { + "A list of edges." + edges: [PinnedEnvironmentEdge] + "A list of nodes." + nodes: [PinnedEnvironment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PinnedEnvironmentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PinnedEnvironment +} + +"Represents a 'pinned' event on a given issue or pull request." +type PinnedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the PinnedEvent object" + id: ID! + "Identifies the issue associated with the event." + issue: Issue! +} + +"A Pinned Issue is a issue pinned to a repository's index page." +type PinnedIssue implements Node { + "Identifies the primary key from the database." + databaseId: Int + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the PinnedIssue object" + id: ID! + "The issue that was pinned." + issue: Issue! + "The actor that pinned this issue." + pinnedBy: Actor! + "The repository that this issue was pinned to." + repository: Repository! +} + +"The connection type for PinnedIssue." +type PinnedIssueConnection { + "A list of edges." + edges: [PinnedIssueEdge] + "A list of nodes." + nodes: [PinnedIssue] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PinnedIssueEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PinnedIssue +} + +"Audit log entry for a private_repository_forking.disable event." +type PrivateRepositoryForkingDisableAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the PrivateRepositoryForkingDisableAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a private_repository_forking.enable event." +type PrivateRepositoryForkingEnableAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the PrivateRepositoryForkingEnableAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"A curatable list of repositories relating to a repository owner, which defaults to showing the most popular repositories they own." +type ProfileItemShowcase { + "Whether or not the owner has pinned any repositories or gists." + hasPinnedItems: Boolean! + "The repositories and gists in the showcase. If the profile owner has any pinned items, those will be returned. Otherwise, the profile owner's popular repositories will be returned." + items( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PinnableItemConnection! +} + +"Projects manage issues, pull requests and notes within a project owner." +type Project implements Closable & Node & Updatable { + "The project's description body." + body: String @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The projects description body rendered to HTML." + bodyHTML: HTML! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Indicates if the object is closed (definition of closed may depend on type)" + closed: Boolean! + "Identifies the date and time when the object was closed." + closedAt: DateTime + "List of columns in the project" + columns( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectColumnConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the date and time when the object was created." + createdAt: DateTime! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The actor who originally created the project." + creator: Actor @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The Node ID of the Project object" + id: ID! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The project's name." + name: String! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The project's number." + number: Int! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The project's owner. Currently limited to repositories, organizations, and users." + owner: ProjectOwner! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "List of pending cards in this project" + pendingCards( + "Returns the elements in the list that come after the specified cursor." + after: String, + "A list of archived states to filter the cards by" + archivedStates: [ProjectCardArchivedState] = [ARCHIVED, NOT_ARCHIVED], + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectCardConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Project progress details." + progress: ProjectProgress! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP path for this project" + resourcePath: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Whether the project is open or closed." + state: ProjectState! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP URL for this project" + url: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Indicates if the object can be closed by the viewer." + viewerCanClose: Boolean! + "Indicates if the object can be reopened by the viewer." + viewerCanReopen: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! +} + +"A card in a project." +type ProjectCard implements Node { + """ + + The project column this card is associated under. A card may only belong to one + project column at a time. The column field will be null if the card is created + in a pending state and has yet to be associated with a column. Once cards are + associated with a column, they will not become pending in the future. + """ + column: ProjectColumn @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The card content item" + content: ProjectCardItem @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the date and time when the object was created." + createdAt: DateTime! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The actor who created this card" + creator: Actor @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The Node ID of the ProjectCard object" + id: ID! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Whether the card is archived" + isArchived: Boolean! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The card note" + note: String @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The project that contains this card." + project: Project! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP path for this card" + resourcePath: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The state of ProjectCard" + state: ProjectCardState @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP URL for this card" + url: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"The connection type for ProjectCard." +type ProjectCardConnection { + "A list of edges." + edges: [ProjectCardEdge] + "A list of nodes." + nodes: [ProjectCard] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectCardEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectCard +} + +"A column inside a project." +type ProjectColumn implements Node { + "List of cards in the column" + cards( + "Returns the elements in the list that come after the specified cursor." + after: String, + "A list of archived states to filter the cards by" + archivedStates: [ProjectCardArchivedState] = [ARCHIVED, NOT_ARCHIVED], + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectCardConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the date and time when the object was created." + createdAt: DateTime! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The Node ID of the ProjectColumn object" + id: ID! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The project column's name." + name: String! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The project that contains this column." + project: Project! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The semantic purpose of the column" + purpose: ProjectColumnPurpose @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP path for this project column" + resourcePath: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP URL for this project column" + url: URI! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"The connection type for ProjectColumn." +type ProjectColumnConnection { + "A list of edges." + edges: [ProjectColumnEdge] + "A list of nodes." + nodes: [ProjectColumn] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectColumnEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectColumn +} + +"A list of projects associated with the owner." +type ProjectConnection { + "A list of edges." + edges: [ProjectEdge] + "A list of nodes." + nodes: [Project] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Project +} + +"Project progress stats." +type ProjectProgress { + "The number of done cards." + doneCount: Int! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The percentage of done cards." + donePercentage: Float! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Whether progress tracking is enabled and cards with purpose exist for this project" + enabled: Boolean! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The number of in-progress cards." + inProgressCount: Int! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The percentage of in-progress cards." + inProgressPercentage: Float! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The number of to do cards." + todoCount: Int! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The percentage of to do cards." + todoPercentage: Float! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"New projects that manage issues, pull requests and drafts using tables and boards." +type ProjectV2 implements Closable & Node & Updatable { + "Returns true if the project is closed." + closed: Boolean! + "Identifies the date and time when the object was closed." + closedAt: DateTime + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who originally created the project." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2025-04-01 UTC.") + "A field of the project" + field( + "The name of the field" + name: String! + ): ProjectV2FieldConfiguration + "List of fields and their constraints in the project" + fields( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for project v2 fields returned from the connection" + orderBy: ProjectV2FieldOrder = {field: POSITION, direction: ASC} + ): ProjectV2FieldConfigurationConnection! + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the ProjectV2 object" + id: ID! + "List of items in the project" + items( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for project v2 items returned from the connection" + orderBy: ProjectV2ItemOrder = {field: POSITION, direction: ASC} + ): ProjectV2ItemConnection! + "The project's number." + number: Int! + "The project's owner. Currently limited to organizations and users." + owner: ProjectV2Owner! + "Returns true if the project is public." + public: Boolean! + "The project's readme." + readme: String + "The repositories the project is linked to." + repositories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder = {field: CREATED_AT, direction: DESC} + ): RepositoryConnection! + "The HTTP path for this project" + resourcePath: URI! + "The project's short description." + shortDescription: String + "List of the status updates in the project." + statusUpdates( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: ProjectV2StatusOrder = {field: CREATED_AT, direction: DESC} + ): ProjectV2StatusUpdateConnection! + "The teams the project is linked to." + teams( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for teams returned from this connection." + orderBy: TeamOrder = {field: NAME, direction: ASC} + ): TeamConnection! + "Returns true if this project is a template." + template: Boolean! + "The project's name." + title: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this project" + url: URI! + "A view of the project" + view( + "The number of a view belonging to the project" + number: Int! + ): ProjectV2View + "Indicates if the object can be closed by the viewer." + viewerCanClose: Boolean! + "Indicates if the object can be reopened by the viewer." + viewerCanReopen: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "List of views in the project" + views( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for project v2 views returned from the connection" + orderBy: ProjectV2ViewOrder = {field: POSITION, direction: ASC} + ): ProjectV2ViewConnection! + "A workflow of the project" + workflow( + "The number of a workflow belonging to the project" + number: Int! + ): ProjectV2Workflow + "List of the workflows in the project" + workflows( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for project v2 workflows returned from the connection" + orderBy: ProjectV2WorkflowOrder = {field: NAME, direction: ASC} + ): ProjectV2WorkflowConnection! +} + +"The connection type for ProjectV2Actor." +type ProjectV2ActorConnection { + "A list of edges." + edges: [ProjectV2ActorEdge] + "A list of nodes." + nodes: [ProjectV2Actor] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2ActorEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2Actor +} + +"The connection type for ProjectV2." +type ProjectV2Connection { + "A list of edges." + edges: [ProjectV2Edge] + "A list of nodes." + nodes: [ProjectV2] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2Edge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2 +} + +"A field inside a project." +type ProjectV2Field implements Node & ProjectV2FieldCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The field's type." + dataType: ProjectV2FieldType! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the ProjectV2Field object" + id: ID! + "The project field's name." + name: String! + "The project that contains this field." + project: ProjectV2! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for ProjectV2FieldConfiguration." +type ProjectV2FieldConfigurationConnection { + "A list of edges." + edges: [ProjectV2FieldConfigurationEdge] + "A list of nodes." + nodes: [ProjectV2FieldConfiguration] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2FieldConfigurationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2FieldConfiguration +} + +"The connection type for ProjectV2Field." +type ProjectV2FieldConnection { + "A list of edges." + edges: [ProjectV2FieldEdge] + "A list of nodes." + nodes: [ProjectV2Field] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2FieldEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2Field +} + +"An item within a Project." +type ProjectV2Item implements Node { + "The content of the referenced draft issue, issue, or pull request" + content: ProjectV2ItemContent + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the item." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2025-04-01 UTC.") + "The field value of the first project field which matches the 'name' argument that is set on the item." + fieldValueByName( + "The name of the field to return the field value of" + name: String! + ): ProjectV2ItemFieldValue + "The field values that are set on the item." + fieldValues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for project v2 item field values returned from the connection" + orderBy: ProjectV2ItemFieldValueOrder = {field: POSITION, direction: ASC} + ): ProjectV2ItemFieldValueConnection! + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the ProjectV2Item object" + id: ID! + "Whether the item is archived." + isArchived: Boolean! + "The project that contains this item." + project: ProjectV2! + "The type of the item." + type: ProjectV2ItemType! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for ProjectV2Item." +type ProjectV2ItemConnection { + "A list of edges." + edges: [ProjectV2ItemEdge] + "A list of nodes." + nodes: [ProjectV2Item] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2ItemEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2Item +} + +"The value of a date field in a Project item." +type ProjectV2ItemFieldDateValue implements Node & ProjectV2ItemFieldValueCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the item." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int + "Date value for the field" + date: Date + "The project field that contains this value." + field: ProjectV2FieldConfiguration! + "The Node ID of the ProjectV2ItemFieldDateValue object" + id: ID! + "The project item that contains this value." + item: ProjectV2Item! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The value of an iteration field in a Project item." +type ProjectV2ItemFieldIterationValue implements Node & ProjectV2ItemFieldValueCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the item." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int + "The duration of the iteration in days." + duration: Int! + "The project field that contains this value." + field: ProjectV2FieldConfiguration! + "The Node ID of the ProjectV2ItemFieldIterationValue object" + id: ID! + "The project item that contains this value." + item: ProjectV2Item! + "The ID of the iteration." + iterationId: String! + "The start date of the iteration." + startDate: Date! + "The title of the iteration." + title: String! + "The title of the iteration, with HTML." + titleHTML: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The value of the labels field in a Project item." +type ProjectV2ItemFieldLabelValue { + "The field that contains this value." + field: ProjectV2FieldConfiguration! + "Labels value of a field" + labels( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): LabelConnection +} + +"The value of a milestone field in a Project item." +type ProjectV2ItemFieldMilestoneValue { + "The field that contains this value." + field: ProjectV2FieldConfiguration! + "Milestone value of a field" + milestone: Milestone +} + +"The value of a number field in a Project item." +type ProjectV2ItemFieldNumberValue implements Node & ProjectV2ItemFieldValueCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the item." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int + "The project field that contains this value." + field: ProjectV2FieldConfiguration! + "The Node ID of the ProjectV2ItemFieldNumberValue object" + id: ID! + "The project item that contains this value." + item: ProjectV2Item! + "Number as a float(8)" + number: Float + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The value of a pull request field in a Project item." +type ProjectV2ItemFieldPullRequestValue { + "The field that contains this value." + field: ProjectV2FieldConfiguration! + "The pull requests for this field" + pullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests." + orderBy: PullRequestOrder = {field: CREATED_AT, direction: ASC} + ): PullRequestConnection +} + +"The value of a repository field in a Project item." +type ProjectV2ItemFieldRepositoryValue { + "The field that contains this value." + field: ProjectV2FieldConfiguration! + "The repository for this field." + repository: Repository +} + +"The value of a reviewers field in a Project item." +type ProjectV2ItemFieldReviewerValue { + "The field that contains this value." + field: ProjectV2FieldConfiguration! + "The reviewers for this field." + reviewers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): RequestedReviewerConnection +} + +"The value of a single select field in a Project item." +type ProjectV2ItemFieldSingleSelectValue implements Node & ProjectV2ItemFieldValueCommon { + "The color applied to the selected single-select option." + color: ProjectV2SingleSelectFieldOptionColor! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the item." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int + "A plain-text description of the selected single-select option, such as what the option means." + description: String + "The description of the selected single-select option, including HTML tags." + descriptionHTML: String + "The project field that contains this value." + field: ProjectV2FieldConfiguration! + "The Node ID of the ProjectV2ItemFieldSingleSelectValue object" + id: ID! + "The project item that contains this value." + item: ProjectV2Item! + "The name of the selected single select option." + name: String + "The html name of the selected single select option." + nameHTML: String + "The id of the selected single select option." + optionId: String + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The value of a text field in a Project item." +type ProjectV2ItemFieldTextValue implements Node & ProjectV2ItemFieldValueCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the item." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int + "The project field that contains this value." + field: ProjectV2FieldConfiguration! + "The Node ID of the ProjectV2ItemFieldTextValue object" + id: ID! + "The project item that contains this value." + item: ProjectV2Item! + "Text value of a field" + text: String + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The value of a user field in a Project item." +type ProjectV2ItemFieldUserValue { + "The field that contains this value." + field: ProjectV2FieldConfiguration! + "The users for this field" + users( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection +} + +"The connection type for ProjectV2ItemFieldValue." +type ProjectV2ItemFieldValueConnection { + "A list of edges." + edges: [ProjectV2ItemFieldValueEdge] + "A list of nodes." + nodes: [ProjectV2ItemFieldValue] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2ItemFieldValueEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2ItemFieldValue +} + +"An iteration field inside a project." +type ProjectV2IterationField implements Node & ProjectV2FieldCommon { + "Iteration configuration settings" + configuration: ProjectV2IterationFieldConfiguration! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The field's type." + dataType: ProjectV2FieldType! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the ProjectV2IterationField object" + id: ID! + "The project field's name." + name: String! + "The project that contains this field." + project: ProjectV2! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"Iteration field configuration for a project." +type ProjectV2IterationFieldConfiguration { + "The iteration's completed iterations" + completedIterations: [ProjectV2IterationFieldIteration!]! + "The iteration's duration in days" + duration: Int! + "The iteration's iterations" + iterations: [ProjectV2IterationFieldIteration!]! + "The iteration's start day of the week" + startDay: Int! +} + +"Iteration field iteration settings for a project." +type ProjectV2IterationFieldIteration { + "The iteration's duration in days" + duration: Int! + "The iteration's ID." + id: String! + "The iteration's start date" + startDate: Date! + "The iteration's title." + title: String! + "The iteration's html title." + titleHTML: String! +} + +"A single select field inside a project." +type ProjectV2SingleSelectField implements Node & ProjectV2FieldCommon { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The field's type." + dataType: ProjectV2FieldType! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the ProjectV2SingleSelectField object" + id: ID! + "The project field's name." + name: String! + "Options for the single select field" + options( + "Filter returned options to only those matching these names, case insensitive." + names: [String!] + ): [ProjectV2SingleSelectFieldOption!]! + "The project that contains this field." + project: ProjectV2! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"Single select field option for a configuration for a project." +type ProjectV2SingleSelectFieldOption { + "The option's display color." + color: ProjectV2SingleSelectFieldOptionColor! + "The option's plain-text description." + description: String! + "The option's description, possibly containing HTML." + descriptionHTML: String! + "The option's ID." + id: String! + "The option's name." + name: String! + "The option's html name." + nameHTML: String! +} + +"Represents a sort by field and direction." +type ProjectV2SortBy { + "The direction of the sorting. Possible values are ASC and DESC." + direction: OrderDirection! + "The field by which items are sorted." + field: ProjectV2Field! +} + +"The connection type for ProjectV2SortBy." +type ProjectV2SortByConnection { + "A list of edges." + edges: [ProjectV2SortByEdge] + "A list of nodes." + nodes: [ProjectV2SortBy] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2SortByEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2SortBy +} + +"Represents a sort by field and direction." +type ProjectV2SortByField { + "The direction of the sorting. Possible values are ASC and DESC." + direction: OrderDirection! + "The field by which items are sorted." + field: ProjectV2FieldConfiguration! +} + +"The connection type for ProjectV2SortByField." +type ProjectV2SortByFieldConnection { + "A list of edges." + edges: [ProjectV2SortByFieldEdge] + "A list of nodes." + nodes: [ProjectV2SortByField] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2SortByFieldEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2SortByField +} + +"A status update within a project." +type ProjectV2StatusUpdate implements Node { + "The body of the status update." + body: String + "The body of the status update rendered to HTML." + bodyHTML: HTML + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created the status update." + creator: Actor + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2025-04-01 UTC.") + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the ProjectV2StatusUpdate object" + id: ID! + "The project that contains this status update." + project: ProjectV2! + "The start date of the status update." + startDate: Date + "The status of the status update." + status: ProjectV2StatusUpdateStatus + "The target date of the status update." + targetDate: Date + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for ProjectV2StatusUpdate." +type ProjectV2StatusUpdateConnection { + "A list of edges." + edges: [ProjectV2StatusUpdateEdge] + "A list of nodes." + nodes: [ProjectV2StatusUpdate] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2StatusUpdateEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2StatusUpdate +} + +"A view within a ProjectV2." +type ProjectV2View implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2025-04-01 UTC.") + "The view's visible fields." + fields( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the project v2 fields returned from the connection." + orderBy: ProjectV2FieldOrder = {field: POSITION, direction: ASC} + ): ProjectV2FieldConfigurationConnection + "The project view's filter." + filter: String + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The view's group-by field." + groupBy( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the project v2 fields returned from the connection." + orderBy: ProjectV2FieldOrder = {field: POSITION, direction: ASC} + ): ProjectV2FieldConnection @deprecated(reason: "The `ProjectV2View#order_by` API is deprecated in favour of the more capable `ProjectV2View#group_by_field` API. Check out the `ProjectV2View#group_by_fields` API as an example for the more capable alternative. Removal on 2023-04-01 UTC.") + "The view's group-by field." + groupByFields( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the project v2 fields returned from the connection." + orderBy: ProjectV2FieldOrder = {field: POSITION, direction: ASC} + ): ProjectV2FieldConfigurationConnection + "The Node ID of the ProjectV2View object" + id: ID! + "The project view's layout." + layout: ProjectV2ViewLayout! + "The project view's name." + name: String! + "The project view's number." + number: Int! + "The project that contains this view." + project: ProjectV2! + "The view's sort-by config." + sortBy( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2SortByConnection @deprecated(reason: "The `ProjectV2View#sort_by` API is deprecated in favour of the more capable `ProjectV2View#sort_by_fields` API. Check out the `ProjectV2View#sort_by_fields` API as an example for the more capable alternative. Removal on 2023-04-01 UTC.") + "The view's sort-by config." + sortByFields( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2SortByFieldConnection + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The view's vertical-group-by field." + verticalGroupBy( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the project v2 fields returned from the connection." + orderBy: ProjectV2FieldOrder = {field: POSITION, direction: ASC} + ): ProjectV2FieldConnection @deprecated(reason: "The `ProjectV2View#vertical_group_by` API is deprecated in favour of the more capable `ProjectV2View#vertical_group_by_fields` API. Check out the `ProjectV2View#vertical_group_by_fields` API as an example for the more capable alternative. Removal on 2023-04-01 UTC.") + "The view's vertical-group-by field." + verticalGroupByFields( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the project v2 fields returned from the connection." + orderBy: ProjectV2FieldOrder = {field: POSITION, direction: ASC} + ): ProjectV2FieldConfigurationConnection + "The view's visible fields." + visibleFields( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the project v2 fields returned from the connection." + orderBy: ProjectV2FieldOrder = {field: POSITION, direction: ASC} + ): ProjectV2FieldConnection @deprecated(reason: "The `ProjectV2View#visibleFields` API is deprecated in favour of the more capable `ProjectV2View#fields` API. Check out the `ProjectV2View#fields` API as an example for the more capable alternative. Removal on 2023-01-01 UTC.") +} + +"The connection type for ProjectV2View." +type ProjectV2ViewConnection { + "A list of edges." + edges: [ProjectV2ViewEdge] + "A list of nodes." + nodes: [ProjectV2View] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2ViewEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2View +} + +"A workflow inside a project." +type ProjectV2Workflow implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2025-04-01 UTC.") + "Whether the workflow is enabled." + enabled: Boolean! + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the ProjectV2Workflow object" + id: ID! + "The name of the workflow." + name: String! + "The number of the workflow." + number: Int! + "The project that contains this workflow." + project: ProjectV2! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for ProjectV2Workflow." +type ProjectV2WorkflowConnection { + "A list of edges." + edges: [ProjectV2WorkflowEdge] + "A list of nodes." + nodes: [ProjectV2Workflow] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ProjectV2WorkflowEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ProjectV2Workflow +} + +"A property that must match" +type PropertyTargetDefinition { + "The name of the property" + name: String! + "The values to match for" + propertyValues: [String!]! + "The source of the property. Choose 'custom' or 'system'. Defaults to 'custom' if not specified" + source: String +} + +"A user's public key." +type PublicKey implements Node { + "The last time this authorization was used to perform an action. Values will be null for keys not owned by the user." + accessedAt: DateTime + "Identifies the date and time when the key was created. Keys created before March 5th, 2014 have inaccurate values. Values will be null for keys not owned by the user." + createdAt: DateTime + "The fingerprint for this PublicKey." + fingerprint: String! + "The Node ID of the PublicKey object" + id: ID! + "Whether this PublicKey is read-only or not. Values will be null for keys not owned by the user." + isReadOnly: Boolean + "The public key string." + key: String! + "Identifies the date and time when the key was updated. Keys created before March 5th, 2014 may have inaccurate values. Values will be null for keys not owned by the user." + updatedAt: DateTime +} + +"The connection type for PublicKey." +type PublicKeyConnection { + "A list of edges." + edges: [PublicKeyEdge] + "A list of nodes." + nodes: [PublicKey] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PublicKeyEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PublicKey +} + +"Autogenerated return type of PublishSponsorsTier." +type PublishSponsorsTierPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The tier that was published." + sponsorsTier: SponsorsTier +} + +"A repository pull request." +type PullRequest implements Assignable & Closable & Comment & Labelable & Lockable & Node & ProjectV2Owner & Reactable & RepositoryNode & Subscribable & UniformResourceLocatable & Updatable & UpdatableComment { + "Reason that the conversation was locked." + activeLockReason: LockReason + "The number of additions in this pull request." + additions: Int! + "A list of actors assigned to this object." + assignedActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): AssigneeConnection! + "A list of Users assigned to this object." + assignees( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "Returns the auto-merge request object if one exists for this pull request." + autoMergeRequest: AutoMergeRequest + "Identifies the base Ref associated with the pull request." + baseRef: Ref + "Identifies the name of the base Ref associated with the pull request, even if the ref has been deleted." + baseRefName: String! + "Identifies the oid of the base ref associated with the pull request, even if the ref has been deleted." + baseRefOid: GitObjectID! + "The repository associated with this pull request's base Ref." + baseRepository: Repository + "The body as Markdown." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "Whether or not the pull request is rebaseable." + canBeRebased: Boolean! + "The number of changed files in this pull request." + changedFiles: Int! + "The HTTP path for the checks of this pull request." + checksResourcePath: URI! + "The HTTP URL for the checks of this pull request." + checksUrl: URI! + "`true` if the pull request is closed" + closed: Boolean! + "Identifies the date and time when the object was closed." + closedAt: DateTime + "List of issues that may be closed by this pull request" + closingIssuesReferences( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issues returned from the connection" + orderBy: IssueOrder, + "Return only manually linked Issues" + userLinkedOnly: Boolean = false + ): IssueConnection + "A list of comments associated with the pull request." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issue comments returned from the connection." + orderBy: IssueCommentOrder + ): IssueCommentConnection! + "A list of commits present in this pull request's head branch not present in the base branch." + commits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PullRequestCommitConnection! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2024-07-01 UTC.") + "The number of deletions in this pull request." + deletions: Int! + "The actor who edited this pull request's body." + editor: Actor + "Lists the files changed within this pull request." + files( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PullRequestChangedFileConnection + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "Identifies the head Ref associated with the pull request." + headRef: Ref + "Identifies the name of the head Ref associated with the pull request, even if the ref has been deleted." + headRefName: String! + "Identifies the oid of the head ref associated with the pull request, even if the ref has been deleted." + headRefOid: GitObjectID! + "The repository associated with this pull request's head Ref." + headRepository: Repository + "The owner of the repository associated with this pull request's head Ref." + headRepositoryOwner: RepositoryOwner + "The hovercard information for this issue" + hovercard( + "Whether or not to include notification contexts" + includeNotificationContexts: Boolean = true + ): Hovercard! + "The Node ID of the PullRequest object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "The head and base repositories are different." + isCrossRepository: Boolean! + "Identifies if the pull request is a draft." + isDraft: Boolean! + "Indicates whether the pull request is in a merge queue" + isInMergeQueue: Boolean! + "Indicates whether the pull request's base ref has a merge queue enabled." + isMergeQueueEnabled: Boolean! + "Is this pull request read by the viewer" + isReadByViewer: Boolean + "A list of labels associated with the object." + labels( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for labels returned from the connection." + orderBy: LabelOrder = {field: CREATED_AT, direction: ASC} + ): LabelConnection + "The moment the editor made the last edit" + lastEditedAt: DateTime + "A list of latest reviews per user associated with the pull request." + latestOpinionatedReviews( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Only return reviews from user who have write access to the repository" + writersOnly: Boolean = false + ): PullRequestReviewConnection + "A list of latest reviews per user associated with the pull request that are not also pending review." + latestReviews( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PullRequestReviewConnection + "`true` if the pull request is locked" + locked: Boolean! + "Indicates whether maintainers can modify the pull request." + maintainerCanModify: Boolean! + "The commit that was created when this pull request was merged." + mergeCommit: Commit + "The merge queue for the pull request's base branch" + mergeQueue: MergeQueue + "The merge queue entry of the pull request in the base branch's merge queue" + mergeQueueEntry: MergeQueueEntry + "Detailed information about the current pull request merge state status." + mergeStateStatus: MergeStateStatus! + "Whether or not the pull request can be merged based on the existence of merge conflicts." + mergeable: MergeableState! + "Whether or not the pull request was merged." + merged: Boolean! + "The date and time that the pull request was merged." + mergedAt: DateTime + "The actor who merged the pull request." + mergedBy: Actor + "Identifies the milestone associated with the pull request." + milestone: Milestone + "Identifies the pull request number." + number: Int! + "A list of Users that are participating in the Pull Request conversation." + participants( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "The permalink to the pull request." + permalink: URI! + "The commit that GitHub automatically generated to test if this pull request could be merged. This field will not return a value if the pull request is merged, or if the test merge commit is still being generated. See the `mergeable` field for more details on the mergeability of the pull request." + potentialMergeCommit: Commit + "List of project cards associated with this pull request." + projectCards( + "Returns the elements in the list that come after the specified cursor." + after: String, + "A list of archived states to filter the cards by" + archivedStates: [ProjectCardArchivedState] = [ARCHIVED, NOT_ARCHIVED], + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectCardConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "List of project items associated with this pull request." + projectItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Include archived items." + includeArchived: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2ItemConnection! + "Find a project by number." + projectV2( + "The project number." + number: Int! + ): ProjectV2 + "A list of projects under the owner." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter projects based on user role." + minPermissionLevel: ProjectV2PermissionLevel = READ, + "How to order the returned projects." + orderBy: ProjectV2Order = {field: NUMBER, direction: DESC}, + "A project to search for under the owner." + query: String + ): ProjectV2Connection! + "Identifies when the comment was published at." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The repository associated with this node." + repository: Repository! + "The HTTP path for this pull request." + resourcePath: URI! + "The HTTP path for reverting this pull request." + revertResourcePath: URI! + "The HTTP URL for reverting this pull request." + revertUrl: URI! + "The current status of this pull request with respect to code review." + reviewDecision: PullRequestReviewDecision + "A list of review requests associated with the pull request." + reviewRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ReviewRequestConnection + "The list of all review threads for this pull request." + reviewThreads( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PullRequestReviewThreadConnection! + "A list of reviews associated with the pull request." + reviews( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Filter by author of the review." + author: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "A list of states to filter the reviews." + states: [PullRequestReviewState!] + ): PullRequestReviewConnection + "Identifies the state of the pull request." + state: PullRequestState! + "Check and Status rollup information for the PR's head ref." + statusCheckRollup: StatusCheckRollup + "A list of suggested actors to assign to this object" + suggestedActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "If provided, searches users by login or profile name" + query: String + ): AssigneeConnection! + "A list of reviewer suggestions based on commit history and past review comments." + suggestedReviewers: [SuggestedReviewer]! + "A list of events, comments, commits, etc. associated with the pull request." + timeline( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows filtering timeline events by a `since` timestamp." + since: DateTime + ): PullRequestTimelineConnection! @deprecated(reason: "`timeline` will be removed Use PullRequest.timelineItems instead. Removal on 2020-10-01 UTC.") + "A list of events, comments, commits, etc. associated with the pull request." + timelineItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Filter timeline items by type." + itemTypes: [PullRequestTimelineItemsItemType!], + "Returns the last _n_ elements from the list." + last: Int, + "Filter timeline items by a `since` timestamp." + since: DateTime, + "Skips the first _n_ elements in the list." + skip: Int + ): PullRequestTimelineItemsConnection! + "Identifies the pull request title." + title: String! + "Identifies the pull request title rendered to HTML." + titleHTML: HTML! + "Returns a count of how many comments this pull request has received." + totalCommentsCount: Int + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this pull request." + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Whether or not the viewer can apply suggestion." + viewerCanApplySuggestion: Boolean! + "Indicates if the object can be closed by the viewer." + viewerCanClose: Boolean! + "Check if the viewer can restore the deleted head ref." + viewerCanDeleteHeadRef: Boolean! + "Whether or not the viewer can disable auto-merge" + viewerCanDisableAutoMerge: Boolean! + "Can the viewer edit files within this pull request." + viewerCanEditFiles: Boolean! + "Whether or not the viewer can enable auto-merge" + viewerCanEnableAutoMerge: Boolean! + "Indicates if the viewer can edit labels for this object." + viewerCanLabel: Boolean! + "Indicates whether the viewer can bypass branch protections and merge the pull request immediately" + viewerCanMergeAsAdmin: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Indicates if the object can be reopened by the viewer." + viewerCanReopen: Boolean! + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + """ + + Whether or not the viewer can update the head ref of this PR, by merging or rebasing the base ref. + If the head ref is up to date or unable to be updated by this user, this will return false. + """ + viewerCanUpdateBranch: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! + "The latest review given from the viewer." + viewerLatestReview: PullRequestReview + "The person who has requested the viewer for review on this pull request." + viewerLatestReviewRequest: ReviewRequest + "The merge body text for the viewer and method." + viewerMergeBodyText( + "The merge method for the message." + mergeType: PullRequestMergeMethod + ): String! + "The merge headline text for the viewer and method." + viewerMergeHeadlineText( + "The merge method for the message." + mergeType: PullRequestMergeMethod + ): String! + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState +} + +"A file changed in a pull request." +type PullRequestChangedFile { + "The number of additions to the file." + additions: Int! + "How the file was changed in this PullRequest" + changeType: PatchStatus! + "The number of deletions to the file." + deletions: Int! + "The path of the file." + path: String! + "The state of the file for the viewer." + viewerViewedState: FileViewedState! +} + +"The connection type for PullRequestChangedFile." +type PullRequestChangedFileConnection { + "A list of edges." + edges: [PullRequestChangedFileEdge] + "A list of nodes." + nodes: [PullRequestChangedFile] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PullRequestChangedFileEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequestChangedFile +} + +"Represents a Git commit part of a pull request." +type PullRequestCommit implements Node & UniformResourceLocatable { + "The Git commit object" + commit: Commit! + "The Node ID of the PullRequestCommit object" + id: ID! + "The pull request this commit belongs to" + pullRequest: PullRequest! + "The HTTP path for this pull request commit" + resourcePath: URI! + "The HTTP URL for this pull request commit" + url: URI! +} + +"Represents a commit comment thread part of a pull request." +type PullRequestCommitCommentThread implements Node & RepositoryNode { + "The comments that exist in this thread." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CommitCommentConnection! + "The commit the comments were made on." + commit: Commit! + "The Node ID of the PullRequestCommitCommentThread object" + id: ID! + "The file the comments were made on." + path: String + "The position in the diff for the commit that the comment was made on." + position: Int + "The pull request this commit comment thread belongs to" + pullRequest: PullRequest! + "The repository associated with this node." + repository: Repository! +} + +"The connection type for PullRequestCommit." +type PullRequestCommitConnection { + "A list of edges." + edges: [PullRequestCommitEdge] + "A list of nodes." + nodes: [PullRequestCommit] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PullRequestCommitEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequestCommit +} + +"The connection type for PullRequest." +type PullRequestConnection { + "A list of edges." + edges: [PullRequestEdge] + "A list of nodes." + nodes: [PullRequest] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"This aggregates pull requests opened by a user within one repository." +type PullRequestContributionsByRepository { + "The pull request contributions." + contributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for contributions returned from the connection." + orderBy: ContributionOrder = {direction: DESC} + ): CreatedPullRequestContributionConnection! + "The repository in which the pull requests were opened." + repository: Repository! +} + +"An edge in a connection." +type PullRequestEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequest +} + +"Require all commits be made to a non-target branch and submitted via a pull request before they can be merged." +type PullRequestParameters { + "Array of allowed merge methods. Allowed values include `merge`, `squash`, and `rebase`. At least one option must be enabled." + allowedMergeMethods: [PullRequestAllowedMergeMethods!] + "Request Copilot code review for new pull requests automatically if the author has access to Copilot code review." + automaticCopilotCodeReviewEnabled: Boolean! + "New, reviewable commits pushed will dismiss previous pull request review approvals." + dismissStaleReviewsOnPush: Boolean! + "Require an approving review in pull requests that modify files that have a designated code owner." + requireCodeOwnerReview: Boolean! + "Whether the most recent reviewable push must be approved by someone other than the person who pushed it." + requireLastPushApproval: Boolean! + "The number of approving reviews that are required before a pull request can be merged." + requiredApprovingReviewCount: Int! + "All conversations on code must be resolved before a pull request can be merged." + requiredReviewThreadResolution: Boolean! +} + +"A review object for a given pull request." +type PullRequestReview implements Comment & Deletable & Minimizable & Node & Reactable & RepositoryNode & Updatable & UpdatableComment { + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "Indicates whether the author of this review has push access to the repository." + authorCanPushToRepository: Boolean! + "Identifies the pull request review body." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body of this review rendered as plain text." + bodyText: String! + "A list of review comments for the current pull request review." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PullRequestReviewCommentConnection! + "Identifies the commit associated with this pull request review." + commit: Commit + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2024-07-01 UTC.") + "The actor who edited the comment." + editor: Actor + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the PullRequestReview object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Returns whether or not a comment has been minimized." + isMinimized: Boolean! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Returns why the comment was minimized. One of `abuse`, `off-topic`, `outdated`, `resolved`, `duplicate` and `spam`. Note that the case and formatting of these values differs from the inputs to the `MinimizeComment` mutation." + minimizedReason: String + "A list of teams that this review was made on behalf of." + onBehalfOf( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): TeamConnection! + "Identifies when the comment was published at." + publishedAt: DateTime + "Identifies the pull request associated with this pull request review." + pullRequest: PullRequest! + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The repository associated with this node." + repository: Repository! + "The HTTP path permalink for this PullRequestReview." + resourcePath: URI! + "Identifies the current state of the pull request review." + state: PullRequestReviewState! + "Identifies when the Pull Request Review was submitted" + submittedAt: DateTime + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL permalink for this PullRequestReview." + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Check if the current viewer can minimize this object." + viewerCanMinimize: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Check if the current viewer can unminimize this object." + viewerCanUnminimize: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! +} + +"A review comment associated with a given repository pull request." +type PullRequestReviewComment implements Comment & Deletable & Minimizable & Node & Reactable & RepositoryNode & Updatable & UpdatableComment { + "The actor who authored the comment." + author: Actor + "Author's association with the subject of the comment." + authorAssociation: CommentAuthorAssociation! + "The comment body of this review comment." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The comment body of this review comment rendered as plain text." + bodyText: String! + "Identifies the commit associated with the comment." + commit: Commit + "Identifies when the comment was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "`databaseId` will be removed because it does not support 64-bit signed integer identifiers. Use `fullDatabaseId` instead. Removal on 2024-07-01 UTC.") + "The diff hunk to which the comment applies." + diffHunk: String! + "Identifies when the comment was created in a draft state." + draftedAt: DateTime! + "The actor who edited the comment." + editor: Actor + "Identifies the primary key from the database as a BigInt." + fullDatabaseId: BigInt + "The Node ID of the PullRequestReviewComment object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Returns whether or not a comment has been minimized." + isMinimized: Boolean! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "The end line number on the file to which the comment applies" + line: Int + "Returns why the comment was minimized. One of `abuse`, `off-topic`, `outdated`, `resolved`, `duplicate` and `spam`. Note that the case and formatting of these values differs from the inputs to the `MinimizeComment` mutation." + minimizedReason: String + "Identifies the original commit associated with the comment." + originalCommit: Commit + "The end line number on the file to which the comment applied when it was first created" + originalLine: Int + "The original line index in the diff to which the comment applies." + originalPosition: Int! @deprecated(reason: "We are phasing out diff-relative positioning for PR comments Removal on 2023-10-01 UTC.") + "The start line number on the file to which the comment applied when it was first created" + originalStartLine: Int + "Identifies when the comment body is outdated" + outdated: Boolean! + "The path to which the comment applies." + path: String! + "The line index in the diff to which the comment applies." + position: Int @deprecated(reason: "We are phasing out diff-relative positioning for PR comments Use the `line` and `startLine` fields instead, which are file line numbers instead of diff line numbers Removal on 2023-10-01 UTC.") + "Identifies when the comment was published at." + publishedAt: DateTime + "The pull request associated with this review comment." + pullRequest: PullRequest! + "The pull request review associated with this review comment." + pullRequestReview: PullRequestReview + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The comment this is a reply to." + replyTo: PullRequestReviewComment + "The repository associated with this node." + repository: Repository! + "The HTTP path permalink for this review comment." + resourcePath: URI! + "The start line number on the file to which the comment applies" + startLine: Int + "Identifies the state of the comment." + state: PullRequestReviewCommentState! + "The level at which the comments in the corresponding thread are targeted, can be a diff line or a file" + subjectType: PullRequestReviewThreadSubjectType! + "Identifies when the comment was last updated." + updatedAt: DateTime! + "The HTTP URL permalink for this review comment." + url: URI! + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Check if the current viewer can minimize this object." + viewerCanMinimize: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Check if the current viewer can unminimize this object." + viewerCanUnminimize: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! +} + +"The connection type for PullRequestReviewComment." +type PullRequestReviewCommentConnection { + "A list of edges." + edges: [PullRequestReviewCommentEdge] + "A list of nodes." + nodes: [PullRequestReviewComment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PullRequestReviewCommentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequestReviewComment +} + +"The connection type for PullRequestReview." +type PullRequestReviewConnection { + "A list of edges." + edges: [PullRequestReviewEdge] + "A list of nodes." + nodes: [PullRequestReview] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"This aggregates pull request reviews made by a user within one repository." +type PullRequestReviewContributionsByRepository { + "The pull request review contributions." + contributions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for contributions returned from the connection." + orderBy: ContributionOrder = {direction: DESC} + ): CreatedPullRequestReviewContributionConnection! + "The repository in which the pull request reviews were made." + repository: Repository! +} + +"An edge in a connection." +type PullRequestReviewEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequestReview +} + +"A threaded list of comments for a given pull request." +type PullRequestReviewThread implements Node { + "A list of pull request comments associated with the thread." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Skips the first _n_ elements in the list." + skip: Int + ): PullRequestReviewCommentConnection! + "The side of the diff on which this thread was placed." + diffSide: DiffSide! + "The Node ID of the PullRequestReviewThread object" + id: ID! + "Whether or not the thread has been collapsed (resolved)" + isCollapsed: Boolean! + "Indicates whether this thread was outdated by newer changes." + isOutdated: Boolean! + "Whether this thread has been resolved" + isResolved: Boolean! + "The line in the file to which this thread refers" + line: Int + "The original line in the file to which this thread refers." + originalLine: Int + "The original start line in the file to which this thread refers (multi-line only)." + originalStartLine: Int + "Identifies the file path of this thread." + path: String! + "Identifies the pull request associated with this thread." + pullRequest: PullRequest! + "Identifies the repository associated with this thread." + repository: Repository! + "The user who resolved this thread" + resolvedBy: User + "The side of the diff that the first line of the thread starts on (multi-line only)" + startDiffSide: DiffSide + "The start line in the file to which this thread refers (multi-line only)" + startLine: Int + "The level at which the comments in the corresponding thread are targeted, can be a diff line or a file" + subjectType: PullRequestReviewThreadSubjectType! + "Indicates whether the current viewer can reply to this thread." + viewerCanReply: Boolean! + "Whether or not the viewer can resolve this thread" + viewerCanResolve: Boolean! + "Whether or not the viewer can unresolve this thread" + viewerCanUnresolve: Boolean! +} + +"Review comment threads for a pull request review." +type PullRequestReviewThreadConnection { + "A list of edges." + edges: [PullRequestReviewThreadEdge] + "A list of nodes." + nodes: [PullRequestReviewThread] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PullRequestReviewThreadEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequestReviewThread +} + +"Represents the latest point in the pull request timeline for which the viewer has seen the pull request's commits." +type PullRequestRevisionMarker { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The last commit the viewer has seen." + lastSeenCommit: Commit! + "The pull request to which the marker belongs." + pullRequest: PullRequest! +} + +"A repository pull request template." +type PullRequestTemplate { + "The body of the template" + body: String + "The filename of the template" + filename: String + "The repository the template belongs to" + repository: Repository! +} + +"A threaded list of comments for a given pull request." +type PullRequestThread implements Node { + "A list of pull request comments associated with the thread." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Skips the first _n_ elements in the list." + skip: Int + ): PullRequestReviewCommentConnection! + "The side of the diff on which this thread was placed." + diffSide: DiffSide! + "The Node ID of the PullRequestThread object" + id: ID! + "Whether or not the thread has been collapsed (resolved)" + isCollapsed: Boolean! + "Indicates whether this thread was outdated by newer changes." + isOutdated: Boolean! + "Whether this thread has been resolved" + isResolved: Boolean! + "The line in the file to which this thread refers" + line: Int + "Identifies the file path of this thread." + path: String! + "Identifies the pull request associated with this thread." + pullRequest: PullRequest! + "Identifies the repository associated with this thread." + repository: Repository! + "The user who resolved this thread" + resolvedBy: User + "The side of the diff that the first line of the thread starts on (multi-line only)" + startDiffSide: DiffSide + "The line of the first file diff in the thread." + startLine: Int + "The level at which the comments in the corresponding thread are targeted, can be a diff line or a file" + subjectType: PullRequestReviewThreadSubjectType! + "Indicates whether the current viewer can reply to this thread." + viewerCanReply: Boolean! + "Whether or not the viewer can resolve this thread" + viewerCanResolve: Boolean! + "Whether or not the viewer can unresolve this thread" + viewerCanUnresolve: Boolean! +} + +"The connection type for PullRequestTimelineItem." +type PullRequestTimelineConnection { + "A list of edges." + edges: [PullRequestTimelineItemEdge] + "A list of nodes." + nodes: [PullRequestTimelineItem] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PullRequestTimelineItemEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequestTimelineItem +} + +"The connection type for PullRequestTimelineItems." +type PullRequestTimelineItemsConnection { + "A list of edges." + edges: [PullRequestTimelineItemsEdge] + "Identifies the count of items after applying `before` and `after` filters." + filteredCount: Int! + "A list of nodes." + nodes: [PullRequestTimelineItems] + "Identifies the count of items after applying `before`/`after` filters and `first`/`last`/`skip` slicing." + pageCount: Int! + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "Identifies the date and time when the timeline was last updated." + updatedAt: DateTime! +} + +"An edge in a connection." +type PullRequestTimelineItemsEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PullRequestTimelineItems +} + +"A Git push." +type Push implements Node { + "The Node ID of the Push object" + id: ID! + "The SHA after the push" + nextSha: GitObjectID + "The permalink for this push." + permalink: URI! + "The SHA before the push" + previousSha: GitObjectID + "The actor who pushed" + pusher: Actor! + "The repository that was pushed to" + repository: Repository! +} + +"A team, user, or app who has the ability to push to a protected branch." +type PushAllowance implements Node { + "The actor that can push." + actor: PushAllowanceActor + "Identifies the branch protection rule associated with the allowed user, team, or app." + branchProtectionRule: BranchProtectionRule + "The Node ID of the PushAllowance object" + id: ID! +} + +"The connection type for PushAllowance." +type PushAllowanceConnection { + "A list of edges." + edges: [PushAllowanceEdge] + "A list of nodes." + nodes: [PushAllowance] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type PushAllowanceEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: PushAllowance +} + +"The query root of GitHub's GraphQL interface." +type Query implements Node { + "Look up a code of conduct by its key" + codeOfConduct( + "The code of conduct's key" + key: String! + ): CodeOfConduct + "Look up a code of conduct by its key" + codesOfConduct: [CodeOfConduct] + "Look up an enterprise by URL slug." + enterprise( + "The enterprise invitation token." + invitationToken: String, + "The enterprise URL slug." + slug: String! + ): Enterprise + "Look up a pending enterprise administrator invitation by invitee, enterprise and role." + enterpriseAdministratorInvitation( + "The slug of the enterprise the user was invited to join." + enterpriseSlug: String!, + "The role for the enterprise member invitation." + role: EnterpriseAdministratorRole!, + "The login of the user invited to join the enterprise." + userLogin: String! + ): EnterpriseAdministratorInvitation + "Look up a pending enterprise administrator invitation by invitation token." + enterpriseAdministratorInvitationByToken( + "The invitation token sent with the invitation email." + invitationToken: String! + ): EnterpriseAdministratorInvitation + "Look up a pending enterprise unaffiliated member invitation by invitee and enterprise." + enterpriseMemberInvitation( + "The slug of the enterprise the user was invited to join." + enterpriseSlug: String!, + "The login of the user invited to join the enterprise." + userLogin: String! + ): EnterpriseMemberInvitation + "Look up a pending enterprise unaffiliated member invitation by invitation token." + enterpriseMemberInvitationByToken( + "The invitation token sent with the invitation email." + invitationToken: String! + ): EnterpriseMemberInvitation + "ID of the object." + id: ID! + "Look up an open source license by its key" + license( + "The license's downcased SPDX ID" + key: String! + ): License + "Return a list of known open source licenses" + licenses: [License]! + "Get alphabetically sorted list of Marketplace categories" + marketplaceCategories( + "Exclude categories with no listings." + excludeEmpty: Boolean, + "Returns top level categories only, excluding any subcategories." + excludeSubcategories: Boolean, + "Return only the specified categories." + includeCategories: [String!] + ): [MarketplaceCategory!]! + "Look up a Marketplace category by its slug." + marketplaceCategory( + "The URL slug of the category." + slug: String!, + "Also check topic aliases for the category slug" + useTopicAliases: Boolean + ): MarketplaceCategory + "Look up a single Marketplace listing" + marketplaceListing( + "Select the listing that matches this slug. It's the short name of the listing used in its URL." + slug: String! + ): MarketplaceListing + "Look up Marketplace listings" + marketplaceListings( + "Select listings that can be administered by the specified user." + adminId: ID, + "Returns the elements in the list that come after the specified cursor." + after: String, + """ + + Select listings visible to the viewer even if they are not approved. If omitted or + false, only approved listings will be returned. + """ + allStates: Boolean, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Select only listings with the given category." + categorySlug: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Select listings for products owned by the specified organization." + organizationId: ID, + "Select only listings where the primary category matches the given category slug." + primaryCategoryOnly: Boolean = false, + "Select the listings with these slugs, if they are visible to the viewer." + slugs: [String], + "Also check topic aliases for the category slug" + useTopicAliases: Boolean, + """ + + Select listings to which user has admin access. If omitted, listings visible to the + viewer are returned. + """ + viewerCanAdmin: Boolean, + "Select only listings that offer a free trial." + withFreeTrialsOnly: Boolean = false + ): MarketplaceListingConnection! + "Return information about the GitHub instance" + meta: GitHubMetadata! + "Fetches an object given its ID." + node( + "ID of the object." + id: ID! + ): Node + "Lookup nodes by a list of IDs." + nodes( + "The list of node IDs." + ids: [ID!]! + ): [Node]! + "Lookup a organization by login." + organization( + "The organization's login." + login: String! + ): Organization + "The client's rate limit information." + rateLimit( + "If true, calculate the cost for the query without evaluating it" + dryRun: Boolean = false + ): RateLimit + "Workaround for re-exposing the root query object. (Refer to https://github.com/facebook/relay/issues/112 for more information.)" + relay: Query! + "Lookup a given repository by the owner and repository name." + repository( + "Follow repository renames. If disabled, a repository referenced by its old name will return an error." + followRenames: Boolean = true, + "The name of the repository" + name: String!, + "The login field of a user or organization" + owner: String! + ): Repository + "Lookup a repository owner (ie. either a User or an Organization) by login." + repositoryOwner( + "The username to lookup the owner by." + login: String! + ): RepositoryOwner + "Lookup resource by a URL." + resource( + "The URL." + url: URI! + ): UniformResourceLocatable + "Perform a search across resources, returning a maximum of 1,000 results." + search( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "The search string to look for. GitHub search syntax is supported. For more information, see \"[Searching on GitHub](https://docs.github.com/search-github/searching-on-github),\" \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax),\" and \"[Sorting search results](https://docs.github.com/search-github/getting-started-with-searching-on-github/sorting-search-results).\"" + query: String!, + "The types of search items to search within." + type: SearchType! + ): SearchResultItemConnection! + "GitHub Security Advisories" + securityAdvisories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "A list of classifications to filter advisories by." + classifications: [SecurityAdvisoryClassification!], + "The EPSS percentage to filter advisories by." + epssPercentage: Float, + "The EPSS percentile to filter advisories by." + epssPercentile: Float, + "Returns the first _n_ elements from the list." + first: Int, + "Filter advisories by identifier, e.g. GHSA or CVE." + identifier: SecurityAdvisoryIdentifierFilter, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the returned topics." + orderBy: SecurityAdvisoryOrder = {field: UPDATED_AT, direction: DESC}, + "Filter advisories to those published since a time in the past." + publishedSince: DateTime, + "Filter advisories to those updated since a time in the past." + updatedSince: DateTime + ): SecurityAdvisoryConnection! + "Fetch a Security Advisory by its GHSA ID" + securityAdvisory( + "GitHub Security Advisory ID." + ghsaId: String! + ): SecurityAdvisory + "Software Vulnerabilities documented by GitHub Security Advisories" + securityVulnerabilities( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "A list of advisory classifications to filter vulnerabilities by." + classifications: [SecurityAdvisoryClassification!], + "An ecosystem to filter vulnerabilities by." + ecosystem: SecurityAdvisoryEcosystem, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the returned topics." + orderBy: SecurityVulnerabilityOrder = {field: UPDATED_AT, direction: DESC}, + "A package name to filter vulnerabilities by." + package: String, + "A list of severities to filter vulnerabilities by." + severities: [SecurityAdvisorySeverity!] + ): SecurityVulnerabilityConnection! + "Users and organizations who can be sponsored via GitHub Sponsors." + sponsorables( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + """ + + Optional filter for which dependencies should be checked for sponsorable owners. Only sponsorable owners of dependencies in this ecosystem will be included. Used when onlyDependencies = true. + + **Upcoming Change on 2022-07-01 UTC** + **Description:** `dependencyEcosystem` will be removed. Use the ecosystem argument instead. + **Reason:** The type is switching from SecurityAdvisoryEcosystem to DependencyGraphEcosystem. + """ + dependencyEcosystem: SecurityAdvisoryEcosystem, + "Optional filter for which dependencies should be checked for sponsorable owners. Only sponsorable owners of dependencies in this ecosystem will be included. Used when onlyDependencies = true." + ecosystem: DependencyGraphEcosystem, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Whether only sponsorables who own the viewer's dependencies will be returned. Must be authenticated to use. Can check an organization instead for their dependencies owned by sponsorables by passing orgLoginForDependencies." + onlyDependencies: Boolean = false, + "Ordering options for users and organizations returned from the connection." + orderBy: SponsorableOrder = {field: LOGIN, direction: ASC}, + "Optional organization username for whose dependencies should be checked. Used when onlyDependencies = true. Omit to check your own dependencies. If you are not an administrator of the organization, only dependencies from its public repositories will be considered." + orgLoginForDependencies: String + ): SponsorableItemConnection! + "Look up a topic by name." + topic( + "The topic's name." + name: String! + ): Topic + "Lookup a user by login." + user( + "The user's login." + login: String! + ): User + "The currently authenticated user." + viewer: User! +} + +"Represents the client's rate limit." +type RateLimit { + "The point cost for the current query counting against the rate limit." + cost: Int! + "The maximum number of points the client is permitted to consume in a 60 minute window." + limit: Int! + "The maximum number of nodes this query may return" + nodeCount: Int! + "The number of points remaining in the current rate limit window." + remaining: Int! + "The time at which the current rate limit window resets in UTC epoch seconds." + resetAt: DateTime! + "The number of points used in the current rate limit window." + used: Int! +} + +"The connection type for User." +type ReactingUserConnection { + "A list of edges." + edges: [ReactingUserEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a user that's made a reaction." +type ReactingUserEdge { + "A cursor for use in pagination." + cursor: String! + node: User! + "The moment when the user made the reaction." + reactedAt: DateTime! +} + +"An emoji reaction to a particular piece of content." +type Reaction implements Node { + "Identifies the emoji reaction." + content: ReactionContent! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the Reaction object" + id: ID! + "The reactable piece of content" + reactable: Reactable! + "Identifies the user who created this reaction." + user: User +} + +"A list of reactions that have been left on the subject." +type ReactionConnection { + "A list of edges." + edges: [ReactionEdge] + "A list of nodes." + nodes: [Reaction] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "Whether or not the authenticated user has left a reaction on the subject." + viewerHasReacted: Boolean! +} + +"An edge in a connection." +type ReactionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Reaction +} + +"A group of emoji reactions to a particular piece of content." +type ReactionGroup { + "Identifies the emoji reaction." + content: ReactionContent! + "Identifies when the reaction was created." + createdAt: DateTime + "Reactors to the reaction subject with the emotion represented by this reaction group." + reactors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ReactorConnection! + "The subject that was reacted to." + subject: Reactable! + "Users who have reacted to the reaction subject with the emotion represented by this reaction group" + users( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ReactingUserConnection! @deprecated(reason: "Reactors can now be mannequins, bots, and organizations. Use the `reactors` field instead. Removal on 2021-10-01 UTC.") + "Whether or not the authenticated user has left a reaction on the subject." + viewerHasReacted: Boolean! +} + +"The connection type for Reactor." +type ReactorConnection { + "A list of edges." + edges: [ReactorEdge] + "A list of nodes." + nodes: [Reactor] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents an author of a reaction." +type ReactorEdge { + "A cursor for use in pagination." + cursor: String! + "The author of the reaction." + node: Reactor! + "The moment when the user made the reaction." + reactedAt: DateTime! +} + +"Represents a 'ready_for_review' event on a given pull request." +type ReadyForReviewEvent implements Node & UniformResourceLocatable { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ReadyForReviewEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! + "The HTTP path for this ready for review event." + resourcePath: URI! + "The HTTP URL for this ready for review event." + url: URI! +} + +"Represents a Git reference." +type Ref implements Node { + "A list of pull requests with this ref as the head ref." + associatedPullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "The base ref name to filter the pull requests by." + baseRefName: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "The head ref name to filter the pull requests by." + headRefName: String, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the pull requests by." + states: [PullRequestState!] + ): PullRequestConnection! + "Branch protection rules for this ref" + branchProtectionRule: BranchProtectionRule + "Compares the current ref as a base ref to another head ref, if the comparison can be made." + compare( + "The head ref to compare against." + headRef: String! + ): Comparison + "The Node ID of the Ref object" + id: ID! + "The ref name." + name: String! + "The ref's prefix, such as `refs/heads/` or `refs/tags/`." + prefix: String! + "Branch protection rules that are viewable by non-admins" + refUpdateRule: RefUpdateRule + "The repository the ref belongs to." + repository: Repository! + "A list of rules from active Repository and Organization rulesets that apply to this ref." + rules( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repository rules." + orderBy: RepositoryRuleOrder = {field: UPDATED_AT, direction: DESC} + ): RepositoryRuleConnection + "The object the ref points to. Returns null when object does not exist." + target: GitObject +} + +"The connection type for Ref." +type RefConnection { + "A list of edges." + edges: [RefEdge] + "A list of nodes." + nodes: [Ref] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RefEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Ref +} + +"Parameters to be used for the ref_name condition" +type RefNameConditionTarget { + "Array of ref names or patterns to exclude. The condition will not pass if any of these patterns match." + exclude: [String!]! + "Array of ref names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~DEFAULT_BRANCH` to include the default branch or `~ALL` to include all branches." + include: [String!]! +} + +"Branch protection rules that are enforced on the viewer." +type RefUpdateRule { + "Can this branch be deleted." + allowsDeletions: Boolean! + "Are force pushes allowed on this branch." + allowsForcePushes: Boolean! + "Can matching branches be created." + blocksCreations: Boolean! + "Identifies the protection rule pattern." + pattern: String! + "Number of approving reviews required to update matching branches." + requiredApprovingReviewCount: Int + "List of required status check contexts that must pass for commits to be accepted to matching branches." + requiredStatusCheckContexts: [String] + "Are reviews from code owners required to update matching branches." + requiresCodeOwnerReviews: Boolean! + "Are conversations required to be resolved before merging." + requiresConversationResolution: Boolean! + "Are merge commits prohibited from being pushed to this branch." + requiresLinearHistory: Boolean! + "Are commits required to be signed." + requiresSignatures: Boolean! + "Is the viewer allowed to dismiss reviews." + viewerAllowedToDismissReviews: Boolean! + "Can the viewer push to the branch" + viewerCanPush: Boolean! +} + +"Represents a 'referenced' event on a given `ReferencedSubject`." +type ReferencedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the commit associated with the 'referenced' event." + commit: Commit + "Identifies the repository associated with the 'referenced' event." + commitRepository: Repository! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ReferencedEvent object" + id: ID! + "Reference originated in a different repository." + isCrossRepository: Boolean! + "Checks if the commit message itself references the subject. Can be false in the case of a commit comment reference." + isDirectReference: Boolean! + "Object referenced by event." + subject: ReferencedSubject! +} + +"Autogenerated return type of RegenerateEnterpriseIdentityProviderRecoveryCodes." +type RegenerateEnterpriseIdentityProviderRecoveryCodesPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The identity provider for the enterprise." + identityProvider: EnterpriseIdentityProvider +} + +"Autogenerated return type of RegenerateVerifiableDomainToken." +type RegenerateVerifiableDomainTokenPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The verification token that was generated." + verificationToken: String +} + +"Autogenerated return type of RejectDeployments." +type RejectDeploymentsPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The affected deployments." + deployments: [Deployment!] +} + +"A release contains the content for a release." +type Release implements Node & Reactable & UniformResourceLocatable { + "The author of the release" + author: User + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The description of the release." + description: String + "The description of this release rendered to HTML." + descriptionHTML: HTML + "The Node ID of the Release object" + id: ID! + "Whether or not the release is immutable" + immutable: Boolean! + "Whether or not the release is a draft" + isDraft: Boolean! + "Whether or not the release is the latest releast" + isLatest: Boolean! + "Whether or not the release is a prerelease" + isPrerelease: Boolean! + "A list of users mentioned in the release description" + mentions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection + "The title of the release." + name: String + "Identifies the date and time when the release was created." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "List of releases assets which are dependent on this release." + releaseAssets( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "A name to filter the assets by." + name: String + ): ReleaseAssetConnection! + "The repository that the release belongs to." + repository: Repository! + "The HTTP path for this issue" + resourcePath: URI! + "A description of the release, rendered to HTML without any links in it." + shortDescriptionHTML( + "How many characters to return." + limit: Int = 200 + ): HTML + "The Git tag the release points to" + tag: Ref + "The tag commit for this release." + tagCommit: Commit + "The name of the release's Git tag" + tagName: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this issue" + url: URI! + "Can user react to this subject" + viewerCanReact: Boolean! +} + +"A release asset contains the content for a release asset." +type ReleaseAsset implements Node { + "The asset's content-type" + contentType: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The SHA256 digest of the asset" + digest: String + "The number of times this asset was downloaded" + downloadCount: Int! + "Identifies the URL where you can download the release asset via the browser." + downloadUrl: URI! + "The Node ID of the ReleaseAsset object" + id: ID! + "Identifies the title of the release asset." + name: String! + "Release that the asset is associated with" + release: Release + "The size (in bytes) of the asset" + size: Int! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The user that performed the upload" + uploadedBy: User! + "Identifies the URL of the release asset." + url: URI! +} + +"The connection type for ReleaseAsset." +type ReleaseAssetConnection { + "A list of edges." + edges: [ReleaseAssetEdge] + "A list of nodes." + nodes: [ReleaseAsset] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ReleaseAssetEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ReleaseAsset +} + +"The connection type for Release." +type ReleaseConnection { + "A list of edges." + edges: [ReleaseEdge] + "A list of nodes." + nodes: [Release] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ReleaseEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Release +} + +"Autogenerated return type of RemoveAssigneesFromAssignable." +type RemoveAssigneesFromAssignablePayload { + "The item that was unassigned." + assignable: Assignable + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of RemoveBlockedBy." +type RemoveBlockedByPayload { + "The previously blocking issue." + blockingIssue: Issue + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The previously blocked issue." + issue: Issue +} + +"Autogenerated return type of RemoveEnterpriseAdmin." +type RemoveEnterpriseAdminPayload { + "The user who was removed as an administrator." + admin: User + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated enterprise." + enterprise: Enterprise + "A message confirming the result of removing an administrator." + message: String + "The viewer performing the mutation." + viewer: User +} + +"Autogenerated return type of RemoveEnterpriseIdentityProvider." +type RemoveEnterpriseIdentityProviderPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The identity provider that was removed from the enterprise." + identityProvider: EnterpriseIdentityProvider +} + +"Autogenerated return type of RemoveEnterpriseMember." +type RemoveEnterpriseMemberPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated enterprise." + enterprise: Enterprise + "The user that was removed from the enterprise." + user: User + "The viewer performing the mutation." + viewer: User +} + +"Autogenerated return type of RemoveEnterpriseOrganization." +type RemoveEnterpriseOrganizationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated enterprise." + enterprise: Enterprise + "The organization that was removed from the enterprise." + organization: Organization + "The viewer performing the mutation." + viewer: User +} + +"Autogenerated return type of RemoveEnterpriseSupportEntitlement." +type RemoveEnterpriseSupportEntitlementPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A message confirming the result of removing the support entitlement." + message: String +} + +"Autogenerated return type of RemoveLabelsFromLabelable." +type RemoveLabelsFromLabelablePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Labelable the labels were removed from." + labelable: Labelable +} + +"Autogenerated return type of RemoveOutsideCollaborator." +type RemoveOutsideCollaboratorPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The user that was removed as an outside collaborator." + removedUser: User +} + +"Autogenerated return type of RemoveReaction." +type RemoveReactionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The reaction object." + reaction: Reaction + "The reaction groups for the subject." + reactionGroups: [ReactionGroup!] + "The reactable subject." + subject: Reactable +} + +"Autogenerated return type of RemoveStar." +type RemoveStarPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The starrable." + starrable: Starrable +} + +"Autogenerated return type of RemoveSubIssue." +type RemoveSubIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The parent of the sub-issue." + issue: Issue + "The sub-issue of the parent." + subIssue: Issue +} + +"Autogenerated return type of RemoveUpvote." +type RemoveUpvotePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The votable subject." + subject: Votable +} + +"Represents a 'removed_from_merge_queue' event on a given pull request." +type RemovedFromMergeQueueEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the before commit SHA for the 'removed_from_merge_queue' event." + beforeCommit: Commit + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The user who removed this Pull Request from the merge queue" + enqueuer: User + "The Node ID of the RemovedFromMergeQueueEvent object" + id: ID! + "The merge queue where this pull request was removed from." + mergeQueue: MergeQueue + "PullRequest referenced by event." + pullRequest: PullRequest + "The reason this pull request was removed from the queue." + reason: String +} + +"Represents a 'removed_from_project' event on a given issue or pull request." +type RemovedFromProjectEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The Node ID of the RemovedFromProjectEvent object" + id: ID! + "Project referenced by event." + project: Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Column name referenced by this project event." + projectColumnName: String! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"Represents a 'renamed' event on a given issue or pull request" +type RenamedTitleEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the current title of the issue or pull request." + currentTitle: String! + "The Node ID of the RenamedTitleEvent object" + id: ID! + "Identifies the previous title of the issue or pull request." + previousTitle: String! + "Subject that was renamed." + subject: RenamedTitleSubject! +} + +"Autogenerated return type of ReopenDiscussion." +type ReopenDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion that was reopened." + discussion: Discussion +} + +"Autogenerated return type of ReopenIssue." +type ReopenIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue that was opened." + issue: Issue +} + +"Autogenerated return type of ReopenPullRequest." +type ReopenPullRequestPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request that was reopened." + pullRequest: PullRequest +} + +"Represents a 'reopened' event on any `Closable`." +type ReopenedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Object that was reopened." + closable: Closable! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ReopenedEvent object" + id: ID! + "The reason the issue state was changed to open." + stateReason: IssueStateReason +} + +"Autogenerated return type of ReorderEnvironment." +type ReorderEnvironmentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The environment that was reordered" + environment: Environment +} + +"Autogenerated return type of ReplaceActorsForAssignable." +type ReplaceActorsForAssignablePayload { + "The item that was assigned." + assignable: Assignable + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Audit log entry for a repo.access event." +type RepoAccessAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoAccessAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The visibility of the repository" + visibility: RepoAccessAuditEntryVisibility @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.add_member event." +type RepoAddMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoAddMemberAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The visibility of the repository" + visibility: RepoAddMemberAuditEntryVisibility @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.add_topic event." +type RepoAddTopicAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData & TopicAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoAddTopicAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The name of the topic added to the repository" + topic: Topic + "The name of the topic added to the repository" + topicName: String + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.archived event." +type RepoArchivedAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoArchivedAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The visibility of the repository" + visibility: RepoArchivedAuditEntryVisibility @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.change_merge_setting event." +type RepoChangeMergeSettingAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoChangeMergeSettingAuditEntry object" + id: ID! + "Whether the change was to enable (true) or disable (false) the merge type" + isEnabled: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The merge method affected by the change" + mergeType: RepoChangeMergeSettingAuditEntryMergeType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.disable_anonymous_git_access event." +type RepoConfigDisableAnonymousGitAccessAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigDisableAnonymousGitAccessAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.disable_collaborators_only event." +type RepoConfigDisableCollaboratorsOnlyAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigDisableCollaboratorsOnlyAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.disable_contributors_only event." +type RepoConfigDisableContributorsOnlyAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigDisableContributorsOnlyAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.disable_sockpuppet_disallowed event." +type RepoConfigDisableSockpuppetDisallowedAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigDisableSockpuppetDisallowedAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.enable_anonymous_git_access event." +type RepoConfigEnableAnonymousGitAccessAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigEnableAnonymousGitAccessAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.enable_collaborators_only event." +type RepoConfigEnableCollaboratorsOnlyAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigEnableCollaboratorsOnlyAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.enable_contributors_only event." +type RepoConfigEnableContributorsOnlyAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigEnableContributorsOnlyAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.enable_sockpuppet_disallowed event." +type RepoConfigEnableSockpuppetDisallowedAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigEnableSockpuppetDisallowedAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.lock_anonymous_git_access event." +type RepoConfigLockAnonymousGitAccessAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigLockAnonymousGitAccessAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.config.unlock_anonymous_git_access event." +type RepoConfigUnlockAnonymousGitAccessAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoConfigUnlockAnonymousGitAccessAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.create event." +type RepoCreateAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the parent repository for this forked repository." + forkParentName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the root repository for this network." + forkSourceName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoCreateAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The visibility of the repository" + visibility: RepoCreateAuditEntryVisibility @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.destroy event." +type RepoDestroyAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoDestroyAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The visibility of the repository" + visibility: RepoDestroyAuditEntryVisibility @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.remove_member event." +type RepoRemoveMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoRemoveMemberAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The visibility of the repository" + visibility: RepoRemoveMemberAuditEntryVisibility @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repo.remove_topic event." +type RepoRemoveTopicAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData & TopicAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the RepoRemoveTopicAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The name of the topic added to the repository" + topic: Topic + "The name of the topic added to the repository" + topicName: String + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"A repository contains the content for a project." +type Repository implements Node & PackageOwner & ProjectOwner & ProjectV2Recent & RepositoryInfo & Starrable & Subscribable & UniformResourceLocatable { + "Whether or not a pull request head branch that is behind its base branch can always be updated even if it is not required to be up to date before merging." + allowUpdateBranch: Boolean! + "Identifies the date and time when the repository was archived." + archivedAt: DateTime + "A list of users that can be assigned to issues in this repository." + assignableUsers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filters users with query on user name and login." + query: String + ): UserConnection! + "Whether or not Auto-merge can be enabled on pull requests in this repository." + autoMergeAllowed: Boolean! + "A list of branch protection rules for this repository." + branchProtectionRules( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): BranchProtectionRuleConnection! + "Returns the code of conduct for this repository" + codeOfConduct: CodeOfConduct + "Information extracted from the repository's `CODEOWNERS` file." + codeowners( + "The ref name used to return the associated `CODEOWNERS` file." + refName: String + ): RepositoryCodeowners + "A list of collaborators associated with the repository." + collaborators( + "Collaborators affiliation level with a repository." + affiliation: CollaboratorAffiliation, + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "The login of one specific collaborator." + login: String, + "Filters users with query on user name and login" + query: String + ): RepositoryCollaboratorConnection + "A list of commit comments associated with the repository." + commitComments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CommitCommentConnection! + "Returns a list of contact links associated to the repository" + contactLinks: [RepositoryContactLink!] + "Returns the contributing guidelines for this repository." + contributingGuidelines: ContributingGuidelines + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The Ref associated with the repository's default branch." + defaultBranchRef: Ref + "Whether or not branches are automatically deleted when merged in this repository." + deleteBranchOnMerge: Boolean! + "A list of dependency manifests contained in the repository" + dependencyGraphManifests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Cursor to paginate dependencies" + dependenciesAfter: String, + "Number of dependencies to fetch" + dependenciesFirst: Int, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Flag to scope to only manifests with dependencies" + withDependencies: Boolean + ): DependencyGraphManifestConnection + "A list of deploy keys that are on this repository." + deployKeys( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DeployKeyConnection! + "Deployments associated with the repository" + deployments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Environments to list deployments for" + environments: [String!], + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for deployments returned from the connection." + orderBy: DeploymentOrder = {field: CREATED_AT, direction: ASC} + ): DeploymentConnection! + "The description of the repository." + description: String + "The description of the repository rendered to HTML." + descriptionHTML: HTML! + "Returns a single discussion from the current repository by number." + discussion( + "The number for the discussion to be returned." + number: Int! + ): Discussion + "A list of discussion categories that are available in the repository." + discussionCategories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filter by categories that are assignable by the viewer." + filterByAssignable: Boolean = false, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DiscussionCategoryConnection! + "A discussion category by slug." + discussionCategory( + "The slug of the discussion category to be returned." + slug: String! + ): DiscussionCategory + "A list of discussions that have been opened in the repository." + discussions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Only show answered or unanswered discussions" + answered: Boolean, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Only include discussions that belong to the category with this ID." + categoryId: ID, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for discussions returned from the connection." + orderBy: DiscussionOrder = {field: UPDATED_AT, direction: DESC}, + "A list of states to filter the discussions by." + states: [DiscussionState!] = [] + ): DiscussionConnection! + "The number of kilobytes this repository occupies on disk." + diskUsage: Int + "Returns a single active environment from the current repository by name." + environment( + "The name of the environment to be returned." + name: String! + ): Environment + "A list of environments that are in this repository." + environments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "The names of the environments to be returned." + names: [String!] = [], + "Ordering options for the environments" + orderBy: Environments = {field: NAME, direction: ASC}, + "Filter to control pinned environments return" + pinnedEnvironmentFilter: EnvironmentPinnedFilterField = ALL + ): EnvironmentConnection! + "Returns how many forks there are of this repository in the whole network." + forkCount: Int! + "Whether this repository allows forks." + forkingAllowed: Boolean! + "A list of direct forked repositories." + forks( + "Array of viewer's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the current viewer owns." + affiliations: [RepositoryAffiliation], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "If non-null, filters repositories according to whether they have issues enabled" + hasIssuesEnabled: Boolean, + "If non-null, filters repositories according to whether they have been locked" + isLocked: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder, + "Array of owner's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the organization or user being viewed owns." + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR], + "If non-null, filters repositories according to privacy. Internal repositories are considered private; consider using the visibility argument if only internal repositories are needed. Cannot be combined with the visibility argument." + privacy: RepositoryPrivacy, + "If non-null, filters repositories according to visibility. Cannot be combined with the privacy argument." + visibility: RepositoryVisibility + ): RepositoryConnection! + "The funding links for this repository" + fundingLinks: [FundingLink!]! + "Indicates if the repository has the Discussions feature enabled." + hasDiscussionsEnabled: Boolean! + "Indicates if the repository has issues feature enabled." + hasIssuesEnabled: Boolean! + "Indicates if the repository has the Projects feature enabled." + hasProjectsEnabled: Boolean! + "Indicates if the repository displays a Sponsor button for financial contributions." + hasSponsorshipsEnabled: Boolean! + "Whether vulnerability alerts are enabled for the repository." + hasVulnerabilityAlertsEnabled: Boolean! + "Indicates if the repository has wiki feature enabled." + hasWikiEnabled: Boolean! + "The repository's URL." + homepageUrl: URI + "The Node ID of the Repository object" + id: ID! + "The interaction ability settings for this repository." + interactionAbility: RepositoryInteractionAbility + "Indicates if the repository is unmaintained." + isArchived: Boolean! + "Returns true if blank issue creation is allowed" + isBlankIssuesEnabled: Boolean! + "Returns whether or not this repository disabled." + isDisabled: Boolean! + "Returns whether or not this repository is empty." + isEmpty: Boolean! + "Identifies if the repository is a fork." + isFork: Boolean! + "Indicates if a repository is either owned by an organization, or is a private fork of an organization repository." + isInOrganization: Boolean! + "Indicates if the repository has been locked or not." + isLocked: Boolean! + "Identifies if the repository is a mirror." + isMirror: Boolean! + "Identifies if the repository is private or internal." + isPrivate: Boolean! + "Returns true if this repository has a security policy" + isSecurityPolicyEnabled: Boolean + "Identifies if the repository is a template that can be used to generate new repositories." + isTemplate: Boolean! + "Is this repository a user configuration repository?" + isUserConfigurationRepository: Boolean! + "Returns a single issue from the current repository by number." + issue( + "The number for the issue to be returned." + number: Int! + ): Issue + "Returns a single issue-like object from the current repository by number." + issueOrPullRequest( + "The number for the issue to be returned." + number: Int! + ): IssueOrPullRequest + "Returns a list of issue templates associated to the repository" + issueTemplates: [IssueTemplate!] + "Returns a single issue type by name" + issueType( + "Issue type name." + name: String! + ): IssueType + "A list of the repository's issue types" + issueTypes( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issue types returned from the connection." + orderBy: IssueTypeOrder = {field: CREATED_AT, direction: ASC} + ): IssueTypeConnection + "A list of issues that have been opened in the repository." + issues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filtering options for issues returned from the connection." + filterBy: IssueFilters, + "Returns the first _n_ elements from the list." + first: Int, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issues returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the issues by." + states: [IssueState!] + ): IssueConnection! + "Returns a single label by name" + label( + "Label name" + name: String! + ): Label + "A list of labels associated with the repository." + labels( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for labels returned from the connection." + orderBy: LabelOrder = {field: CREATED_AT, direction: ASC}, + "If provided, searches labels by name and description." + query: String + ): LabelConnection + "A list containing a breakdown of the language composition of the repository." + languages( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: LanguageOrder + ): LanguageConnection + "Get the latest release for the repository if one exists." + latestRelease: Release + "The license associated with the repository" + licenseInfo: License + "The reason the repository has been locked." + lockReason: RepositoryLockReason + "A list of Users that can be mentioned in the context of the repository." + mentionableUsers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filters users with query on user name and login" + query: String + ): UserConnection! + "Whether or not PRs are merged with a merge commit on this repository." + mergeCommitAllowed: Boolean! + "How the default commit message will be generated when merging a pull request." + mergeCommitMessage: MergeCommitMessage! + "How the default commit title will be generated when merging a pull request." + mergeCommitTitle: MergeCommitTitle! + "The merge queue for a specified branch, otherwise the default branch if not provided." + mergeQueue( + "The name of the branch to get the merge queue for. Case sensitive." + branch: String + ): MergeQueue + "Returns a single milestone from the current repository by number." + milestone( + "The number for the milestone to be returned." + number: Int! + ): Milestone + "A list of milestones associated with the repository." + milestones( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for milestones." + orderBy: MilestoneOrder, + "Filters milestones with a query on the title" + query: String, + "Filter by the state of the milestones." + states: [MilestoneState!] + ): MilestoneConnection + "The repository's original mirror URL." + mirrorUrl: URI + "The name of the repository." + name: String! + "The repository's name with owner." + nameWithOwner: String! + "A Git object in the repository" + object( + "A Git revision expression suitable for rev-parse" + expression: String, + "The Git object ID" + oid: GitObjectID + ): GitObject + "The image used to represent this repository in Open Graph data." + openGraphImageUrl: URI! + "The User owner of the repository." + owner: RepositoryOwner! + "A list of packages under the owner." + packages( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Find packages by their names." + names: [String], + "Ordering of the returned packages." + orderBy: PackageOrder = {field: CREATED_AT, direction: DESC}, + "Filter registry package by type." + packageType: PackageType, + "Find packages in a repository by ID." + repositoryId: ID + ): PackageConnection! + "The repository parent, if this is a fork." + parent: Repository + "A list of discussions that have been pinned in this repository." + pinnedDiscussions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PinnedDiscussionConnection! + "A list of pinned environments for this repository." + pinnedEnvironments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the environments" + orderBy: PinnedEnvironmentOrder = {field: POSITION, direction: ASC} + ): PinnedEnvironmentConnection + "A list of pinned issues for this repository." + pinnedIssues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PinnedIssueConnection + "Returns information about the availability of certain features and limits based on the repository's billing plan." + planFeatures: RepositoryPlanFeatures! + "The primary language of the repository's code." + primaryLanguage: Language + "Find project by number." + project( + "The project number to find." + number: Int! + ): Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Finds and returns the Project according to the provided Project number." + projectV2( + "The Project number." + number: Int! + ): ProjectV2 + "A list of projects under the owner." + projects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for projects returned from the connection" + orderBy: ProjectOrder, + "Query to search projects by, currently only searching by name." + search: String, + "A list of states to filter the projects by." + states: [ProjectState!] + ): ProjectConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP path listing the repository's projects" + projectsResourcePath: URI! + "The HTTP URL listing the repository's projects" + projectsUrl: URI! + "List of projects linked to this repository." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter projects based on user role." + minPermissionLevel: ProjectV2PermissionLevel = READ, + "How to order the returned projects." + orderBy: ProjectV2Order = {field: NUMBER, direction: DESC}, + "A project to search for linked to the repo." + query: String + ): ProjectV2Connection! + "Returns a single pull request from the current repository by number." + pullRequest( + "The number for the pull request to be returned." + number: Int! + ): PullRequest + "Returns a list of pull request templates associated to the repository" + pullRequestTemplates: [PullRequestTemplate!] + "A list of pull requests that have been opened in the repository." + pullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "The base ref name to filter the pull requests by." + baseRefName: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "The head ref name to filter the pull requests by." + headRefName: String, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the pull requests by." + states: [PullRequestState!] + ): PullRequestConnection! + "Identifies the date and time when the repository was last pushed to." + pushedAt: DateTime + "Whether or not rebase-merging is enabled on this repository." + rebaseMergeAllowed: Boolean! + "Recent projects that this user has modified in the context of the owner." + recentProjects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2Connection! + "Fetch a given ref from the repository" + ref( + "The ref to retrieve. Fully qualified matches are checked in order (`refs/heads/master`) before falling back onto checks for short name matches (`master`)." + qualifiedName: String! + ): Ref + "Fetch a list of refs from the repository" + refs( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "DEPRECATED: use orderBy. The ordering direction." + direction: OrderDirection, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for refs returned from the connection." + orderBy: RefOrder, + "Filters refs with query on name" + query: String, + "A ref name prefix like `refs/heads/`, `refs/tags/`, etc." + refPrefix: String! + ): RefConnection + "Lookup a single release given various criteria." + release( + "The name of the Tag the Release was created from" + tagName: String! + ): Release + "List of releases which are dependent on this repository." + releases( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: ReleaseOrder + ): ReleaseConnection! + "A list of applied repository-topic associations for this repository." + repositoryTopics( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): RepositoryTopicConnection! + "The HTTP path for this repository" + resourcePath: URI! + "Returns a single ruleset from the current repository by ID." + ruleset( + "The ID of the ruleset to be returned." + databaseId: Int!, + "Include rulesets configured at higher levels that apply to this repository" + includeParents: Boolean = true + ): RepositoryRuleset + "A list of rulesets for this repository." + rulesets( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Return rulesets configured at higher levels that apply to this repository" + includeParents: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int, + "Return rulesets that apply to the specified target" + targets: [RepositoryRulesetTarget!] + ): RepositoryRulesetConnection + "The security policy URL." + securityPolicyUrl: URI + "A description of the repository, rendered to HTML without any links in it." + shortDescriptionHTML( + "How many characters to return." + limit: Int = 200 + ): HTML! + "Whether or not squash-merging is enabled on this repository." + squashMergeAllowed: Boolean! + "How the default commit message will be generated when squash merging a pull request." + squashMergeCommitMessage: SquashMergeCommitMessage! + "How the default commit title will be generated when squash merging a pull request." + squashMergeCommitTitle: SquashMergeCommitTitle! + "Whether a squash merge commit can use the pull request title as default." + squashPrTitleUsedAsDefault: Boolean! @deprecated(reason: "`squashPrTitleUsedAsDefault` will be removed. Use `Repository.squashMergeCommitTitle` instead. Removal on 2023-04-01 UTC.") + "The SSH URL to clone this repository" + sshUrl: GitSSHRemote! + """ + + Returns a count of how many stargazers there are on this object + """ + stargazerCount: Int! + "A list of users who have starred this starrable." + stargazers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: StarOrder + ): StargazerConnection! + "Returns a list of all submodules in this repository parsed from the .gitmodules file as of the default branch's HEAD commit." + submodules( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): SubmoduleConnection! + "A list of suggested actors that can be attributed to content in this repository." + suggestedActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "A list of capabilities to filter actors by." + capabilities: [RepositorySuggestedActorFilter!]!, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "A comma separated list of login names to filter actors by. Only the first 10 logins will be used." + loginNames: String, + "Search actors with query on user name and login." + query: String + ): ActorConnection! + "Temporary authentication token for cloning this repository." + tempCloneToken: String + "The repository from which this repository was generated, if any." + templateRepository: Repository + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this repository" + url: URI! + "Whether this repository has a custom image to use with Open Graph as opposed to being represented by the owner's avatar." + usesCustomOpenGraphImage: Boolean! + "Indicates whether the viewer has admin permissions on this repository." + viewerCanAdminister: Boolean! + "Can the current viewer create new projects on this owner." + viewerCanCreateProjects: Boolean! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Indicates whether the current user can see issue fields in this repository" + viewerCanSeeIssueFields: Boolean! + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Indicates whether the viewer can update the topics of this repository." + viewerCanUpdateTopics: Boolean! + "The last commit email for the viewer." + viewerDefaultCommitEmail: String + "The last used merge method by the viewer or the default for the repository." + viewerDefaultMergeMethod: PullRequestMergeMethod! + "Returns a boolean indicating whether the viewing user has starred this starrable." + viewerHasStarred: Boolean! + "The users permission level on the repository. Will return null if authenticated as an GitHub App." + viewerPermission: RepositoryPermission + "A list of emails this viewer can commit with." + viewerPossibleCommitEmails: [String!] + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState + "Indicates the repository's visibility level." + visibility: RepositoryVisibility! + "Returns a single vulnerability alert from the current repository by number." + vulnerabilityAlert( + "The number for the vulnerability alert to be returned." + number: Int! + ): RepositoryVulnerabilityAlert + "A list of vulnerability alerts that are on this repository." + vulnerabilityAlerts( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filter by the scope of the alert's dependency" + dependencyScopes: [RepositoryVulnerabilityAlertDependencyScope!], + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter by the state of the alert" + states: [RepositoryVulnerabilityAlertState!] + ): RepositoryVulnerabilityAlertConnection + "A list of users watching the repository." + watchers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserConnection! + "Whether contributors are required to sign off on web-based commits in this repository." + webCommitSignoffRequired: Boolean! +} + +"Information extracted from a repository's `CODEOWNERS` file." +type RepositoryCodeowners { + "Any problems that were encountered while parsing the `CODEOWNERS` file." + errors: [RepositoryCodeownersError!]! +} + +"An error in a `CODEOWNERS` file." +type RepositoryCodeownersError { + "The column number where the error occurs." + column: Int! + "A short string describing the type of error." + kind: String! + "The line number where the error occurs." + line: Int! + "A complete description of the error, combining information from other fields." + message: String! + "The path to the file when the error occurs." + path: String! + "The content of the line where the error occurs." + source: String! + "A suggestion of how to fix the error." + suggestion: String +} + +"The connection type for User." +type RepositoryCollaboratorConnection { + "A list of edges." + edges: [RepositoryCollaboratorEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a user who is a collaborator of a repository." +type RepositoryCollaboratorEdge { + "A cursor for use in pagination." + cursor: String! + node: User! + "The permission the user has on the repository." + permission: RepositoryPermission! + "A list of sources for the user's access to the repository." + permissionSources: [PermissionSource!] +} + +"A list of repositories owned by the subject." +type RepositoryConnection { + "A list of edges." + edges: [RepositoryEdge] + "A list of nodes." + nodes: [Repository] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "The total size in kilobytes of all repositories in the connection. Value will never be larger than max 32-bit signed integer." + totalDiskUsage: Int! +} + +"A repository contact link." +type RepositoryContactLink { + "The contact link purpose." + about: String! + "The contact link name." + name: String! + "The contact link URL." + url: URI! +} + +"An edge in a connection." +type RepositoryEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Repository +} + +"Parameters to be used for the repository_id condition" +type RepositoryIdConditionTarget { + "One of these repo IDs must match the repo." + repositoryIds: [ID!]! +} + +"Repository interaction limit that applies to this object." +type RepositoryInteractionAbility { + "The time the currently active limit expires." + expiresAt: DateTime + "The current limit that is enabled on this object." + limit: RepositoryInteractionLimit! + "The origin of the currently active interaction limit." + origin: RepositoryInteractionLimitOrigin! +} + +"An invitation for a user to be added to a repository." +type RepositoryInvitation implements Node { + "The email address that received the invitation." + email: String + "The Node ID of the RepositoryInvitation object" + id: ID! + "The user who received the invitation." + invitee: User + "The user who created the invitation." + inviter: User! + "The permalink for this repository invitation." + permalink: URI! + "The permission granted on this repository by this invitation." + permission: RepositoryPermission! + "The Repository the user is invited to." + repository: RepositoryInfo +} + +"A list of repository invitations." +type RepositoryInvitationConnection { + "A list of edges." + edges: [RepositoryInvitationEdge] + "A list of nodes." + nodes: [RepositoryInvitation] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RepositoryInvitationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RepositoryInvitation +} + +"A GitHub Enterprise Importer (GEI) repository migration." +type RepositoryMigration implements Migration & Node { + "The migration flag to continue on error." + continueOnError: Boolean! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: String + "The reason the migration failed." + failureReason: String + "The Node ID of the RepositoryMigration object" + id: ID! + "The URL for the migration log (expires 1 day after migration completes)." + migrationLogUrl: URI + "The migration source." + migrationSource: MigrationSource! + "The target repository name." + repositoryName: String! + "The migration source URL, for example `https://github.com` or `https://monalisa.ghe.com`." + sourceUrl: URI! + "The migration state." + state: MigrationState! + "The number of warnings encountered for this migration. To review the warnings, check the [Migration Log](https://docs.github.com/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer)." + warningsCount: Int! +} + +"A list of migrations." +type RepositoryMigrationConnection { + "A list of edges." + edges: [RepositoryMigrationEdge] + "A list of nodes." + nodes: [RepositoryMigration] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a repository migration." +type RepositoryMigrationEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RepositoryMigration +} + +"Parameters to be used for the repository_name condition" +type RepositoryNameConditionTarget { + "Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match." + exclude: [String!]! + "Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories." + include: [String!]! + "Target changes that match these patterns will be prevented except by those with bypass permissions." + protected: Boolean! +} + +"Information about the availability of features and limits for a repository based on its billing plan." +type RepositoryPlanFeatures { + "Whether reviews can be automatically requested and enforced with a CODEOWNERS file" + codeowners: Boolean! + "Whether pull requests can be created as or converted to draft" + draftPullRequests: Boolean! + "Maximum number of users that can be assigned to an issue or pull request" + maximumAssignees: Int! + "Maximum number of manually-requested reviews on a pull request" + maximumManualReviewRequests: Int! + "Whether teams can be requested to review pull requests" + teamReviewRequests: Boolean! +} + +"Parameters to be used for the repository_property condition" +type RepositoryPropertyConditionTarget { + "Array of repository properties that must not match." + exclude: [PropertyTargetDefinition!]! + "Array of repository properties that must match" + include: [PropertyTargetDefinition!]! +} + +"A repository rule." +type RepositoryRule implements Node { + "The Node ID of the RepositoryRule object" + id: ID! + "The parameters for this rule." + parameters: RuleParameters + "The repository ruleset associated with this rule configuration" + repositoryRuleset: RepositoryRuleset + "The type of rule." + type: RepositoryRuleType! +} + +"Set of conditions that determine if a ruleset will evaluate" +type RepositoryRuleConditions { + "Configuration for the ref_name condition" + refName: RefNameConditionTarget + "Configuration for the repository_id condition" + repositoryId: RepositoryIdConditionTarget + "Configuration for the repository_name condition" + repositoryName: RepositoryNameConditionTarget + "Configuration for the repository_property condition" + repositoryProperty: RepositoryPropertyConditionTarget +} + +"The connection type for RepositoryRule." +type RepositoryRuleConnection { + "A list of edges." + edges: [RepositoryRuleEdge] + "A list of nodes." + nodes: [RepositoryRule] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RepositoryRuleEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RepositoryRule +} + +"A repository ruleset." +type RepositoryRuleset implements Node { + "The actors that can bypass this ruleset" + bypassActors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): RepositoryRulesetBypassActorConnection + "The set of conditions that must evaluate to true for this ruleset to apply" + conditions: RepositoryRuleConditions! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The enforcement level of this ruleset" + enforcement: RuleEnforcement! + "The Node ID of the RepositoryRuleset object" + id: ID! + "Name of the ruleset." + name: String! + "List of rules." + rules( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "The type of rule." + type: RepositoryRuleType + ): RepositoryRuleConnection + "Source of ruleset." + source: RuleSource! + "Target of the ruleset." + target: RepositoryRulesetTarget + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"A team or app that has the ability to bypass a rules defined on a ruleset" +type RepositoryRulesetBypassActor implements Node { + "The actor that can bypass rules." + actor: BypassActor + "The mode for the bypass actor" + bypassMode: RepositoryRulesetBypassActorBypassMode + "This actor represents the ability for a deploy key to bypass" + deployKey: Boolean! + "This actor represents the ability for an enterprise owner to bypass" + enterpriseOwner: Boolean! + "The Node ID of the RepositoryRulesetBypassActor object" + id: ID! + "This actor represents the ability for an organization owner to bypass" + organizationAdmin: Boolean! + "If the actor is a repository role, the repository role's ID that can bypass" + repositoryRoleDatabaseId: Int + "If the actor is a repository role, the repository role's name that can bypass" + repositoryRoleName: String + "Identifies the ruleset associated with the allowed actor" + repositoryRuleset: RepositoryRuleset +} + +"The connection type for RepositoryRulesetBypassActor." +type RepositoryRulesetBypassActorConnection { + "A list of edges." + edges: [RepositoryRulesetBypassActorEdge] + "A list of nodes." + nodes: [RepositoryRulesetBypassActor] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RepositoryRulesetBypassActorEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RepositoryRulesetBypassActor +} + +"The connection type for RepositoryRuleset." +type RepositoryRulesetConnection { + "A list of edges." + edges: [RepositoryRulesetEdge] + "A list of nodes." + nodes: [RepositoryRuleset] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RepositoryRulesetEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RepositoryRuleset +} + +"A repository-topic connects a repository to a topic." +type RepositoryTopic implements Node & UniformResourceLocatable { + "The Node ID of the RepositoryTopic object" + id: ID! + "The HTTP path for this repository-topic." + resourcePath: URI! + "The topic." + topic: Topic! + "The HTTP URL for this repository-topic." + url: URI! +} + +"The connection type for RepositoryTopic." +type RepositoryTopicConnection { + "A list of edges." + edges: [RepositoryTopicEdge] + "A list of nodes." + nodes: [RepositoryTopic] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RepositoryTopicEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RepositoryTopic +} + +"Audit log entry for a repository_visibility_change.disable event." +type RepositoryVisibilityChangeDisableAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the RepositoryVisibilityChangeDisableAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a repository_visibility_change.enable event." +type RepositoryVisibilityChangeEnableAuditEntry implements AuditEntry & EnterpriseAuditEntryData & Node & OrganizationAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for this enterprise." + enterpriseResourcePath: URI + "The slug of the enterprise." + enterpriseSlug: String + "The HTTP URL for this enterprise." + enterpriseUrl: URI + "The Node ID of the RepositoryVisibilityChangeEnableAuditEntry object" + id: ID! + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"A Dependabot alert for a repository with a dependency affected by a security vulnerability." +type RepositoryVulnerabilityAlert implements Node & RepositoryNode { + "When was the alert auto-dismissed?" + autoDismissedAt: DateTime + "When was the alert created?" + createdAt: DateTime! + "The associated Dependabot update" + dependabotUpdate: DependabotUpdate + "The relationship of an alert's dependency." + dependencyRelationship: RepositoryVulnerabilityAlertDependencyRelationship + "The scope of an alert's dependency" + dependencyScope: RepositoryVulnerabilityAlertDependencyScope + "Comment explaining the reason the alert was dismissed" + dismissComment: String + "The reason the alert was dismissed" + dismissReason: String + "When was the alert dismissed?" + dismissedAt: DateTime + "The user who dismissed the alert" + dismisser: User + "When was the alert fixed?" + fixedAt: DateTime + "The Node ID of the RepositoryVulnerabilityAlert object" + id: ID! + "Identifies the alert number." + number: Int! + "The associated repository" + repository: Repository! + "The associated security advisory" + securityAdvisory: SecurityAdvisory + "The associated security vulnerability" + securityVulnerability: SecurityVulnerability + "Identifies the state of the alert." + state: RepositoryVulnerabilityAlertState! + "The vulnerable manifest filename" + vulnerableManifestFilename: String! + "The vulnerable manifest path" + vulnerableManifestPath: String! + "The vulnerable requirements" + vulnerableRequirements: String +} + +"The connection type for RepositoryVulnerabilityAlert." +type RepositoryVulnerabilityAlertConnection { + "A list of edges." + edges: [RepositoryVulnerabilityAlertEdge] + "A list of nodes." + nodes: [RepositoryVulnerabilityAlert] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RepositoryVulnerabilityAlertEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RepositoryVulnerabilityAlert +} + +"Autogenerated return type of ReprioritizeSubIssue." +type ReprioritizeSubIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The parent issue that the sub-issue was reprioritized in." + issue: Issue +} + +"Autogenerated return type of RequestReviews." +type RequestReviewsPayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request that is getting requests." + pullRequest: PullRequest + "The edge from the pull request to the requested reviewers." + requestedReviewersEdge: UserEdge +} + +"The connection type for RequestedReviewer." +type RequestedReviewerConnection { + "A list of edges." + edges: [RequestedReviewerEdge] + "A list of nodes." + nodes: [RequestedReviewer] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type RequestedReviewerEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: RequestedReviewer +} + +"Choose which environments must be successfully deployed to before refs can be pushed into a ref that matches this rule." +type RequiredDeploymentsParameters { + "The environments that must be successfully deployed to before branches can be merged." + requiredDeploymentEnvironments: [String!]! +} + +"Represents a required status check for a protected branch, but not any specific run of that check." +type RequiredStatusCheckDescription { + "The App that must provide this status in order for it to be accepted." + app: App + "The name of this status." + context: String! +} + +"Choose which status checks must pass before the ref is updated. When enabled, commits must first be pushed to another ref where the checks pass." +type RequiredStatusChecksParameters { + "Allow repositories and branches to be created if a check would otherwise prohibit it." + doNotEnforceOnCreate: Boolean! + "Status checks that are required." + requiredStatusChecks: [StatusCheckConfiguration!]! + "Whether pull requests targeting a matching branch must be tested with the latest code. This setting will not take effect unless at least one status check is enabled." + strictRequiredStatusChecksPolicy: Boolean! +} + +"Autogenerated return type of RerequestCheckSuite." +type RerequestCheckSuitePayload { + "The requested check suite." + checkSuite: CheckSuite + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of ResolveReviewThread." +type ResolveReviewThreadPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The thread to resolve." + thread: PullRequestReviewThread +} + +"Represents a private contribution a user made on GitHub." +type RestrictedContribution implements Contribution { + """ + + Whether this contribution is associated with a record you do not have access to. For + example, your own 'first issue' contribution may have been made on a repository you can no + longer access. + """ + isRestricted: Boolean! + "When this contribution was made." + occurredAt: DateTime! + "The HTTP path for this contribution." + resourcePath: URI! + "The HTTP URL for this contribution." + url: URI! + """ + + The user who made this contribution. + """ + user: User! +} + +"Autogenerated return type of RetireSponsorsTier." +type RetireSponsorsTierPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The tier that was retired." + sponsorsTier: SponsorsTier +} + +"Autogenerated return type of RevertPullRequest." +type RevertPullRequestPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The pull request that was reverted." + pullRequest: PullRequest + "The new pull request that reverts the input pull request." + revertPullRequest: PullRequest +} + +"A user, team, or app who has the ability to dismiss a review on a protected branch." +type ReviewDismissalAllowance implements Node { + "The actor that can dismiss." + actor: ReviewDismissalAllowanceActor + "Identifies the branch protection rule associated with the allowed user, team, or app." + branchProtectionRule: BranchProtectionRule + "The Node ID of the ReviewDismissalAllowance object" + id: ID! +} + +"The connection type for ReviewDismissalAllowance." +type ReviewDismissalAllowanceConnection { + "A list of edges." + edges: [ReviewDismissalAllowanceEdge] + "A list of nodes." + nodes: [ReviewDismissalAllowance] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ReviewDismissalAllowanceEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ReviewDismissalAllowance +} + +"Represents a 'review_dismissed' event on a given issue or pull request." +type ReviewDismissedEvent implements Node & UniformResourceLocatable { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "Identifies the optional message associated with the 'review_dismissed' event." + dismissalMessage: String + "Identifies the optional message associated with the event, rendered to HTML." + dismissalMessageHTML: String + "The Node ID of the ReviewDismissedEvent object" + id: ID! + "Identifies the previous state of the review with the 'review_dismissed' event." + previousReviewState: PullRequestReviewState! + "PullRequest referenced by event." + pullRequest: PullRequest! + "Identifies the commit which caused the review to become stale." + pullRequestCommit: PullRequestCommit + "The HTTP path for this review dismissed event." + resourcePath: URI! + "Identifies the review associated with the 'review_dismissed' event." + review: PullRequestReview + "The HTTP URL for this review dismissed event." + url: URI! +} + +"A request for a user to review a pull request." +type ReviewRequest implements Node { + "Whether this request was created for a code owner" + asCodeOwner: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the ReviewRequest object" + id: ID! + "Identifies the pull request associated with this review request." + pullRequest: PullRequest! + "The reviewer that is requested." + requestedReviewer: RequestedReviewer +} + +"The connection type for ReviewRequest." +type ReviewRequestConnection { + "A list of edges." + edges: [ReviewRequestEdge] + "A list of nodes." + nodes: [ReviewRequest] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type ReviewRequestEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: ReviewRequest +} + +"Represents an 'review_request_removed' event on a given pull request." +type ReviewRequestRemovedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ReviewRequestRemovedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! + "Identifies the reviewer whose review request was removed." + requestedReviewer: RequestedReviewer +} + +"Represents an 'review_requested' event on a given pull request." +type ReviewRequestedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the ReviewRequestedEvent object" + id: ID! + "PullRequest referenced by event." + pullRequest: PullRequest! + "Identifies the reviewer whose review was requested." + requestedReviewer: RequestedReviewer +} + +""" + +A hovercard context with a message describing the current code review state of the pull +request. +""" +type ReviewStatusHovercardContext implements HovercardContext { + "A string describing this context" + message: String! + "An octicon to accompany this context" + octicon: String! + "The current status of the pull request with respect to code review." + reviewDecision: PullRequestReviewDecision +} + +"Autogenerated return type of RevokeEnterpriseOrganizationsMigratorRole." +type RevokeEnterpriseOrganizationsMigratorRolePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The organizations that had the migrator role revoked for the given user." + organizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): OrganizationConnection +} + +"Autogenerated return type of RevokeMigratorRole." +type RevokeMigratorRolePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Did the operation succeed?" + success: Boolean +} + +"A Saved Reply is text a user can use to reply quickly." +type SavedReply implements Node { + "The body of the saved reply." + body: String! + "The saved reply body rendered to HTML." + bodyHTML: HTML! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the SavedReply object" + id: ID! + "The title of the saved reply." + title: String! + "The user that saved this reply." + user: Actor +} + +"The connection type for SavedReply." +type SavedReplyConnection { + "A list of edges." + edges: [SavedReplyEdge] + "A list of nodes." + nodes: [SavedReply] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SavedReplyEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SavedReply +} + +"A list of results that matched against a search query. Regardless of the number of matches, a maximum of 1,000 results will be available across all types, potentially split across many pages." +type SearchResultItemConnection { + "The total number of pieces of code that matched the search query. Regardless of the total number of matches, a maximum of 1,000 results will be available across all types." + codeCount: Int! + "The total number of discussions that matched the search query. Regardless of the total number of matches, a maximum of 1,000 results will be available across all types." + discussionCount: Int! + "A list of edges." + edges: [SearchResultItemEdge] + "The total number of issues that matched the search query. Regardless of the total number of matches, a maximum of 1,000 results will be available across all types." + issueCount: Int! + "A list of nodes." + nodes: [SearchResultItem] + "Information to aid in pagination." + pageInfo: PageInfo! + "The total number of repositories that matched the search query. Regardless of the total number of matches, a maximum of 1,000 results will be available across all types." + repositoryCount: Int! + "The total number of users that matched the search query. Regardless of the total number of matches, a maximum of 1,000 results will be available across all types." + userCount: Int! + "The total number of wiki pages that matched the search query. Regardless of the total number of matches, a maximum of 1,000 results will be available across all types." + wikiCount: Int! +} + +"An edge in a connection." +type SearchResultItemEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SearchResultItem + "Text matches on the result found." + textMatches: [TextMatch] +} + +"A GitHub Security Advisory" +type SecurityAdvisory implements Node { + "The classification of the advisory" + classification: SecurityAdvisoryClassification! + "The CVSS associated with this advisory" + cvss: CVSS! @deprecated(reason: "`cvss` will be removed. New `cvss_severities` field will now contain both `cvss_v3` and `cvss_v4` properties. Removal on 2025-10-01 UTC.") + "The CVSS associated with this advisory" + cvssSeverities: CvssSeverities! + "CWEs associated with this Advisory" + cwes( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CWEConnection! + "Identifies the primary key from the database." + databaseId: Int + "This is a long plaintext description of the advisory" + description: String! + "The Exploit Prediction Scoring System" + epss: EPSS + "The GitHub Security Advisory ID" + ghsaId: String! + "The Node ID of the SecurityAdvisory object" + id: ID! + "A list of identifiers for this advisory" + identifiers: [SecurityAdvisoryIdentifier!]! + "The permalink for the advisory's dependabot alerts page" + notificationsPermalink: URI + "The organization that originated the advisory" + origin: String! + "The permalink for the advisory" + permalink: URI + "When the advisory was published" + publishedAt: DateTime! + "A list of references for this advisory" + references: [SecurityAdvisoryReference!]! + "The severity of the advisory" + severity: SecurityAdvisorySeverity! + "A short plaintext summary of the advisory" + summary: String! + "When the advisory was last updated" + updatedAt: DateTime! + "Vulnerabilities associated with this Advisory" + vulnerabilities( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "A list of advisory classifications to filter vulnerabilities by." + classifications: [SecurityAdvisoryClassification!], + "An ecosystem to filter vulnerabilities by." + ecosystem: SecurityAdvisoryEcosystem, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the returned topics." + orderBy: SecurityVulnerabilityOrder = {field: UPDATED_AT, direction: DESC}, + "A package name to filter vulnerabilities by." + package: String, + "A list of severities to filter vulnerabilities by." + severities: [SecurityAdvisorySeverity!] + ): SecurityVulnerabilityConnection! + "When the advisory was withdrawn, if it has been withdrawn" + withdrawnAt: DateTime +} + +"The connection type for SecurityAdvisory." +type SecurityAdvisoryConnection { + "A list of edges." + edges: [SecurityAdvisoryEdge] + "A list of nodes." + nodes: [SecurityAdvisory] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SecurityAdvisoryEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SecurityAdvisory +} + +"A GitHub Security Advisory Identifier" +type SecurityAdvisoryIdentifier { + "The identifier type, e.g. GHSA, CVE" + type: String! + "The identifier" + value: String! +} + +"An individual package" +type SecurityAdvisoryPackage { + "The ecosystem the package belongs to, e.g. RUBYGEMS, NPM" + ecosystem: SecurityAdvisoryEcosystem! + "The package name" + name: String! +} + +"An individual package version" +type SecurityAdvisoryPackageVersion { + "The package name or version" + identifier: String! +} + +"A GitHub Security Advisory Reference" +type SecurityAdvisoryReference { + "A publicly accessible reference" + url: URI! +} + +"An individual vulnerability within an Advisory" +type SecurityVulnerability { + "The Advisory associated with this Vulnerability" + advisory: SecurityAdvisory! + "The first version containing a fix for the vulnerability" + firstPatchedVersion: SecurityAdvisoryPackageVersion + "A description of the vulnerable package" + package: SecurityAdvisoryPackage! + "The severity of the vulnerability within this package" + severity: SecurityAdvisorySeverity! + "When the vulnerability was last updated" + updatedAt: DateTime! + """ + + A string that describes the vulnerable package versions. + This string follows a basic syntax with a few forms. + + `= 0.2.0` denotes a single vulnerable version. + + `<= 1.0.8` denotes a version range up to and including the specified version + + `< 0.1.11` denotes a version range up to, but excluding, the specified version + + `>= 4.3.0, < 4.3.5` denotes a version range with a known minimum and maximum version. + + `>= 0.0.1` denotes a version range with a known minimum, but no known maximum + """ + vulnerableVersionRange: String! +} + +"The connection type for SecurityVulnerability." +type SecurityVulnerabilityConnection { + "A list of edges." + edges: [SecurityVulnerabilityEdge] + "A list of nodes." + nodes: [SecurityVulnerability] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SecurityVulnerabilityEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SecurityVulnerability +} + +"Autogenerated return type of SetEnterpriseIdentityProvider." +type SetEnterpriseIdentityProviderPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The identity provider for the enterprise." + identityProvider: EnterpriseIdentityProvider +} + +"Autogenerated return type of SetOrganizationInteractionLimit." +type SetOrganizationInteractionLimitPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The organization that the interaction limit was set for." + organization: Organization +} + +"Autogenerated return type of SetRepositoryInteractionLimit." +type SetRepositoryInteractionLimitPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository that the interaction limit was set for." + repository: Repository +} + +"Autogenerated return type of SetUserInteractionLimit." +type SetUserInteractionLimitPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The user that the interaction limit was set for." + user: User +} + +"Represents an S/MIME signature on a Commit or Tag." +type SmimeSignature implements GitSignature { + "Email used to sign this object." + email: String! + "True if the signature is valid and verified by GitHub." + isValid: Boolean! + "Payload for GPG signing object. Raw ODB object without the signature header." + payload: String! + "ASCII-armored signature header from object." + signature: String! + "GitHub user corresponding to the email signing this commit." + signer: User + "The state of this signature. `VALID` if signature is valid and verified by GitHub, otherwise represents reason why signature is considered invalid." + state: GitSignatureState! + "The date the signature was verified, if valid" + verifiedAt: DateTime + "True if the signature was made with GitHub's signing key." + wasSignedByGitHub: Boolean! +} + +"Social media profile associated with a user." +type SocialAccount { + "Name of the social media account as it appears on the profile." + displayName: String! + "Software or company that hosts the social media account." + provider: SocialAccountProvider! + "URL of the social media account." + url: URI! +} + +"The connection type for SocialAccount." +type SocialAccountConnection { + "A list of edges." + edges: [SocialAccountEdge] + "A list of nodes." + nodes: [SocialAccount] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SocialAccountEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SocialAccount +} + +"A GitHub account and the total amount in USD they've paid for sponsorships to a particular maintainer. Does not include payments made via Patreon." +type SponsorAndLifetimeValue { + "The amount in cents." + amountInCents: Int! + "The amount in USD, formatted as a string." + formattedAmount: String! + "The sponsor's GitHub account." + sponsor: Sponsorable! + "The maintainer's GitHub account." + sponsorable: Sponsorable! +} + +"The connection type for SponsorAndLifetimeValue." +type SponsorAndLifetimeValueConnection { + "A list of edges." + edges: [SponsorAndLifetimeValueEdge] + "A list of nodes." + nodes: [SponsorAndLifetimeValue] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SponsorAndLifetimeValueEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SponsorAndLifetimeValue +} + +"A list of users and organizations sponsoring someone via GitHub Sponsors." +type SponsorConnection { + "A list of edges." + edges: [SponsorEdge] + "A list of nodes." + nodes: [Sponsor] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a user or organization who is sponsoring someone in GitHub Sponsors." +type SponsorEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Sponsor +} + +"The connection type for SponsorableItem." +type SponsorableItemConnection { + "A list of edges." + edges: [SponsorableItemEdge] + "A list of nodes." + nodes: [SponsorableItem] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SponsorableItemEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SponsorableItem +} + +"An event related to sponsorship activity." +type SponsorsActivity implements Node { + "What action this activity indicates took place." + action: SponsorsActivityAction! + "The sponsor's current privacy level." + currentPrivacyLevel: SponsorshipPrivacy + "The Node ID of the SponsorsActivity object" + id: ID! + "The platform that was used to pay for the sponsorship." + paymentSource: SponsorshipPaymentSource + "The tier that the sponsorship used to use, for tier change events." + previousSponsorsTier: SponsorsTier + "The user or organization who triggered this activity and was/is sponsoring the sponsorable." + sponsor: Sponsor + "The user or organization that is being sponsored, the maintainer." + sponsorable: Sponsorable! + "The associated sponsorship tier." + sponsorsTier: SponsorsTier + "The timestamp of this event." + timestamp: DateTime + "Was this sponsorship made alongside other sponsorships at the same time from the same sponsor?" + viaBulkSponsorship: Boolean! +} + +"The connection type for SponsorsActivity." +type SponsorsActivityConnection { + "A list of edges." + edges: [SponsorsActivityEdge] + "A list of nodes." + nodes: [SponsorsActivity] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SponsorsActivityEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SponsorsActivity +} + +"A goal associated with a GitHub Sponsors listing, representing a target the sponsored maintainer would like to attain." +type SponsorsGoal { + "A description of the goal from the maintainer." + description: String + "What the objective of this goal is." + kind: SponsorsGoalKind! + "The percentage representing how complete this goal is, between 0-100." + percentComplete: Int! + "What the goal amount is. Represents an amount in USD for monthly sponsorship amount goals. Represents a count of unique sponsors for total sponsors count goals." + targetValue: Int! + "A brief summary of the kind and target value of this goal." + title: String! +} + +"A GitHub Sponsors listing." +type SponsorsListing implements Node { + "The current goal the maintainer is trying to reach with GitHub Sponsors, if any." + activeGoal: SponsorsGoal + "The Stripe Connect account currently in use for payouts for this Sponsors listing, if any. Will only return a value when queried by the maintainer themselves, or by an admin of the sponsorable organization." + activeStripeConnectAccount: StripeConnectAccount + "The name of the country or region with the maintainer's bank account or fiscal host. Will only return a value when queried by the maintainer themselves, or by an admin of the sponsorable organization." + billingCountryOrRegion: String + "The email address used by GitHub to contact the sponsorable about their GitHub Sponsors profile. Will only return a value when queried by the maintainer themselves, or by an admin of the sponsorable organization." + contactEmailAddress: String + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The HTTP path for the Sponsors dashboard for this Sponsors listing." + dashboardResourcePath: URI! + "The HTTP URL for the Sponsors dashboard for this Sponsors listing." + dashboardUrl: URI! + "The records featured on the GitHub Sponsors profile." + featuredItems( + "The types of featured items to return." + featureableTypes: [SponsorsListingFeaturedItemFeatureableType!] = [REPOSITORY, USER] + ): [SponsorsListingFeaturedItem!]! + "The fiscal host used for payments, if any. Will only return a value when queried by the maintainer themselves, or by an admin of the sponsorable organization." + fiscalHost: Organization + "The full description of the listing." + fullDescription: String! + "The full description of the listing rendered to HTML." + fullDescriptionHTML: HTML! + "The Node ID of the SponsorsListing object" + id: ID! + "Whether this listing is publicly visible." + isPublic: Boolean! + "The listing's full name." + name: String! + "A future date on which this listing is eligible to receive a payout." + nextPayoutDate: Date + "The name of the country or region where the maintainer resides. Will only return a value when queried by the maintainer themselves, or by an admin of the sponsorable organization." + residenceCountryOrRegion: String + "The HTTP path for this Sponsors listing." + resourcePath: URI! + "The short description of the listing." + shortDescription: String! + "The short name of the listing." + slug: String! + "The entity this listing represents who can be sponsored on GitHub Sponsors." + sponsorable: Sponsorable! + "The tiers for this GitHub Sponsors profile." + tiers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether to include tiers that aren't published. Only admins of the Sponsors listing can see draft tiers. Only admins of the Sponsors listing and viewers who are currently sponsoring on a retired tier can see those retired tiers. Defaults to including only published tiers, which are visible to anyone who can see the GitHub Sponsors profile." + includeUnpublished: Boolean = false, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for Sponsors tiers returned from the connection." + orderBy: SponsorsTierOrder = {field: MONTHLY_PRICE_IN_CENTS, direction: ASC} + ): SponsorsTierConnection + "The HTTP URL for this Sponsors listing." + url: URI! +} + +"A record that is promoted on a GitHub Sponsors profile." +type SponsorsListingFeaturedItem implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Will either be a description from the sponsorable maintainer about why they featured this item, or the item's description itself, such as a user's bio from their GitHub profile page." + description: String + "The record that is featured on the GitHub Sponsors profile." + featureable: SponsorsListingFeatureableItem! + "The Node ID of the SponsorsListingFeaturedItem object" + id: ID! + "The position of this featured item on the GitHub Sponsors profile with a lower position indicating higher precedence. Starts at 1." + position: Int! + "The GitHub Sponsors profile that features this record." + sponsorsListing: SponsorsListing! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"A GitHub Sponsors tier associated with a GitHub Sponsors listing." +type SponsorsTier implements Node { + "SponsorsTier information only visible to users that can administer the associated Sponsors listing." + adminInfo: SponsorsTierAdminInfo + "Get a different tier for this tier's maintainer that is at the same frequency as this tier but with an equal or lesser cost. Returns the published tier with the monthly price closest to this tier's without going over." + closestLesserValueTier: SponsorsTier + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The description of the tier." + description: String! + "The tier description rendered to HTML" + descriptionHTML: HTML! + "The Node ID of the SponsorsTier object" + id: ID! + "Whether this tier was chosen at checkout time by the sponsor rather than defined ahead of time by the maintainer who manages the Sponsors listing." + isCustomAmount: Boolean! + "Whether this tier is only for use with one-time sponsorships." + isOneTime: Boolean! + "How much this tier costs per month in cents." + monthlyPriceInCents: Int! + "How much this tier costs per month in USD." + monthlyPriceInDollars: Int! + "The name of the tier." + name: String! + "The sponsors listing that this tier belongs to." + sponsorsListing: SponsorsListing! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"SponsorsTier information only visible to users that can administer the associated Sponsors listing." +type SponsorsTierAdminInfo { + "Indicates whether this tier is still a work in progress by the sponsorable and not yet published to the associated GitHub Sponsors profile. Draft tiers cannot be used for new sponsorships and will not be in use on existing sponsorships. Draft tiers cannot be seen by anyone but the admins of the GitHub Sponsors profile." + isDraft: Boolean! + "Indicates whether this tier is published to the associated GitHub Sponsors profile. Published tiers are visible to anyone who can see the GitHub Sponsors profile, and are available for use in sponsorships if the GitHub Sponsors profile is publicly visible." + isPublished: Boolean! + "Indicates whether this tier has been retired from the associated GitHub Sponsors profile. Retired tiers are no longer shown on the GitHub Sponsors profile and cannot be chosen for new sponsorships. Existing sponsorships may still use retired tiers if the sponsor selected the tier before it was retired." + isRetired: Boolean! + "The sponsorships using this tier." + sponsorships( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether or not to return private sponsorships using this tier. Defaults to only returning public sponsorships on this tier." + includePrivate: Boolean = false, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsorships returned from this connection. If left blank, the sponsorships will be ordered based on relevancy to the viewer." + orderBy: SponsorshipOrder + ): SponsorshipConnection! +} + +"The connection type for SponsorsTier." +type SponsorsTierConnection { + "A list of edges." + edges: [SponsorsTierEdge] + "A list of nodes." + nodes: [SponsorsTier] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SponsorsTierEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SponsorsTier +} + +"A sponsorship relationship between a sponsor and a maintainer" +type Sponsorship implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the Sponsorship object" + id: ID! + "Whether the sponsorship is active. False implies the sponsor is a past sponsor of the maintainer, while true implies they are a current sponsor." + isActive: Boolean! + "Whether this sponsorship represents a one-time payment versus a recurring sponsorship." + isOneTimePayment: Boolean! + "Whether the sponsor has chosen to receive sponsorship update emails sent from the sponsorable. Only returns a non-null value when the viewer has permission to know this." + isSponsorOptedIntoEmail: Boolean + "The entity that is being sponsored" + maintainer: User! @deprecated(reason: "`Sponsorship.maintainer` will be removed. Use `Sponsorship.sponsorable` instead. Removal on 2020-04-01 UTC.") + "The platform that was most recently used to pay for the sponsorship." + paymentSource: SponsorshipPaymentSource + "The privacy level for this sponsorship." + privacyLevel: SponsorshipPrivacy! + "The user that is sponsoring. Returns null if the sponsorship is private or if sponsor is not a user." + sponsor: User @deprecated(reason: "`Sponsorship.sponsor` will be removed. Use `Sponsorship.sponsorEntity` instead. Removal on 2020-10-01 UTC.") + "The user or organization that is sponsoring, if you have permission to view them." + sponsorEntity: Sponsor + "The entity that is being sponsored" + sponsorable: Sponsorable! + "The associated sponsorship tier" + tier: SponsorsTier + "Identifies the date and time when the current tier was chosen for this sponsorship." + tierSelectedAt: DateTime +} + +"A list of sponsorships either from the subject or received by the subject." +type SponsorshipConnection { + "A list of edges." + edges: [SponsorshipEdge] + "A list of nodes." + nodes: [Sponsorship] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! + "The total amount in cents of all recurring sponsorships in the connection whose amount you can view. Does not include one-time sponsorships." + totalRecurringMonthlyPriceInCents: Int! + "The total amount in USD of all recurring sponsorships in the connection whose amount you can view. Does not include one-time sponsorships." + totalRecurringMonthlyPriceInDollars: Int! +} + +"An edge in a connection." +type SponsorshipEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Sponsorship +} + +"An update sent to sponsors of a user or organization on GitHub Sponsors." +type SponsorshipNewsletter implements Node { + "The author of the newsletter." + author: User + "The contents of the newsletter, the message the sponsorable wanted to give." + body: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the SponsorshipNewsletter object" + id: ID! + "Indicates if the newsletter has been made available to sponsors." + isPublished: Boolean! + "The user or organization this newsletter is from." + sponsorable: Sponsorable! + "The subject of the newsletter, what it's about." + subject: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"The connection type for SponsorshipNewsletter." +type SponsorshipNewsletterConnection { + "A list of edges." + edges: [SponsorshipNewsletterEdge] + "A list of nodes." + nodes: [SponsorshipNewsletter] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SponsorshipNewsletterEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: SponsorshipNewsletter +} + +"Represents an SSH signature on a Commit or Tag." +type SshSignature implements GitSignature { + "Email used to sign this object." + email: String! + "True if the signature is valid and verified by GitHub." + isValid: Boolean! + "Hex-encoded fingerprint of the key that signed this object." + keyFingerprint: String + "Payload for GPG signing object. Raw ODB object without the signature header." + payload: String! + "ASCII-armored signature header from object." + signature: String! + "GitHub user corresponding to the email signing this commit." + signer: User + "The state of this signature. `VALID` if signature is valid and verified by GitHub, otherwise represents reason why signature is considered invalid." + state: GitSignatureState! + "The date the signature was verified, if valid" + verifiedAt: DateTime + "True if the signature was made with GitHub's signing key." + wasSignedByGitHub: Boolean! +} + +"The connection type for User." +type StargazerConnection { + "A list of edges." + edges: [StargazerEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a user that's starred a repository." +type StargazerEdge { + "A cursor for use in pagination." + cursor: String! + node: User! + "Identifies when the item was starred." + starredAt: DateTime! +} + +"The connection type for Repository." +type StarredRepositoryConnection { + "A list of edges." + edges: [StarredRepositoryEdge] + "Is the list of stars for this user truncated? This is true for users that have many stars." + isOverLimit: Boolean! + "A list of nodes." + nodes: [Repository] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a starred repository." +type StarredRepositoryEdge { + "A cursor for use in pagination." + cursor: String! + node: Repository! + "Identifies when the item was starred." + starredAt: DateTime! +} + +"Autogenerated return type of StartOrganizationMigration." +type StartOrganizationMigrationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new organization migration." + orgMigration: OrganizationMigration +} + +"Autogenerated return type of StartRepositoryMigration." +type StartRepositoryMigrationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new repository migration." + repositoryMigration: RepositoryMigration +} + +"Represents a commit status." +type Status implements Node { + "A list of status contexts and check runs for this commit." + combinedContexts( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): StatusCheckRollupContextConnection! + "The commit this status is attached to." + commit: Commit + "Looks up an individual status context by context name." + context( + "The context name." + name: String! + ): StatusContext + "The individual status contexts for this commit." + contexts: [StatusContext!]! + "The Node ID of the Status object" + id: ID! + "The combined commit status." + state: StatusState! +} + +"Required status check" +type StatusCheckConfiguration { + "The status check context name that must be present on the commit." + context: String! + "The optional integration ID that this status check must originate from." + integrationId: Int +} + +"Represents the rollup for both the check runs and status for a commit." +type StatusCheckRollup implements Node { + "The commit the status and check runs are attached to." + commit: Commit + "A list of status contexts and check runs for this commit." + contexts( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): StatusCheckRollupContextConnection! + "The Node ID of the StatusCheckRollup object" + id: ID! + "The combined status for the commit." + state: StatusState! +} + +"The connection type for StatusCheckRollupContext." +type StatusCheckRollupContextConnection { + "The number of check runs in this rollup." + checkRunCount: Int! + "Counts of check runs by state." + checkRunCountsByState: [CheckRunStateCount!] + "A list of edges." + edges: [StatusCheckRollupContextEdge] + "A list of nodes." + nodes: [StatusCheckRollupContext] + "Information to aid in pagination." + pageInfo: PageInfo! + "The number of status contexts in this rollup." + statusContextCount: Int! + "Counts of status contexts by state." + statusContextCountsByState: [StatusContextStateCount!] + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type StatusCheckRollupContextEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: StatusCheckRollupContext +} + +"Represents an individual commit status context" +type StatusContext implements Node & RequirableByPullRequest { + "The avatar of the OAuth application or the user that created the status" + avatarUrl( + "The size of the resulting square image." + size: Int = 40 + ): URI + "This commit this status context is attached to." + commit: Commit + "The name of this status context." + context: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The actor who created this status context." + creator: Actor + "The description for this status context." + description: String + "The Node ID of the StatusContext object" + id: ID! + "Whether this is required to pass before merging for a specific pull request." + isRequired( + "The id of the pull request this is required for" + pullRequestId: ID, + "The number of the pull request this is required for" + pullRequestNumber: Int + ): Boolean! + "The state of this status context." + state: StatusState! + "The URL for this status context." + targetUrl: URI +} + +"Represents a count of the state of a status context." +type StatusContextStateCount { + "The number of statuses with this state." + count: Int! + "The state of a status context." + state: StatusState! +} + +"A Stripe Connect account for receiving sponsorship funds from GitHub Sponsors." +type StripeConnectAccount { + "The account number used to identify this Stripe Connect account." + accountId: String! + "The name of the country or region of an external account, such as a bank account, tied to the Stripe Connect account. Will only return a value when queried by the maintainer of the associated GitHub Sponsors profile themselves, or by an admin of the sponsorable organization." + billingCountryOrRegion: String + "The name of the country or region of the Stripe Connect account. Will only return a value when queried by the maintainer of the associated GitHub Sponsors profile themselves, or by an admin of the sponsorable organization." + countryOrRegion: String + "Whether this Stripe Connect account is currently in use for the associated GitHub Sponsors profile." + isActive: Boolean! + "The GitHub Sponsors profile associated with this Stripe Connect account." + sponsorsListing: SponsorsListing! + "The URL to access this Stripe Connect account on Stripe's website." + stripeDashboardUrl: URI! +} + +"Represents a 'sub_issue_added' event on a given issue." +type SubIssueAddedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the SubIssueAddedEvent object" + id: ID! + "The sub-issue added." + subIssue: Issue +} + +"Represents a 'sub_issue_removed' event on a given issue." +type SubIssueRemovedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the SubIssueRemovedEvent object" + id: ID! + "The sub-issue removed." + subIssue: Issue +} + +"Summary of the state of an issue's sub-issues" +type SubIssuesSummary { + "Count of completed sub-issues" + completed: Int! + "Percent of sub-issues which are completed" + percentCompleted: Int! + "Count of total number of sub-issues" + total: Int! +} + +"Autogenerated return type of SubmitPullRequestReview." +type SubmitPullRequestReviewPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The submitted pull request review." + pullRequestReview: PullRequestReview +} + +"A pointer to a repository at a specific revision embedded inside another repository." +type Submodule { + "The branch of the upstream submodule for tracking updates" + branch: String + "The git URL of the submodule repository" + gitUrl: URI! + "The name of the submodule in .gitmodules" + name: String! + "The name of the submodule in .gitmodules (Base64-encoded)" + nameRaw: Base64String! + "The path in the superproject that this submodule is located in" + path: String! + "The path in the superproject that this submodule is located in (Base64-encoded)" + pathRaw: Base64String! + "The commit revision of the subproject repository being tracked by the submodule" + subprojectCommitOid: GitObjectID +} + +"The connection type for Submodule." +type SubmoduleConnection { + "A list of edges." + edges: [SubmoduleEdge] + "A list of nodes." + nodes: [Submodule] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type SubmoduleEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Submodule +} + +"Represents a 'subscribed' event on a given `Subscribable`." +type SubscribedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the SubscribedEvent object" + id: ID! + "Object referenced by event." + subscribable: Subscribable! +} + +"A suggestion to review a pull request based on a user's commit history and review comments." +type SuggestedReviewer { + "Is this suggestion based on past commits?" + isAuthor: Boolean! + "Is this suggestion based on past review comments?" + isCommenter: Boolean! + "Identifies the user suggested to review the pull request." + reviewer: User! +} + +"Represents a Git tag." +type Tag implements GitObject & Node { + "An abbreviated version of the Git object ID" + abbreviatedOid: String! + "The HTTP path for this Git object" + commitResourcePath: URI! + "The HTTP URL for this Git object" + commitUrl: URI! + "The Node ID of the Tag object" + id: ID! + "The Git tag message." + message: String + "The Git tag name." + name: String! + "The Git object ID" + oid: GitObjectID! + "The Repository the Git object belongs to" + repository: Repository! + "Details about the tag author." + tagger: GitActor + "The Git object the tag points to." + target: GitObject! +} + +"Parameters to be used for the tag_name_pattern rule" +type TagNamePatternParameters { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean! + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"A team of users in an organization." +type Team implements MemberStatusable & Node & Subscribable { + "A list of teams that are ancestors of this team." + ancestors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): TeamConnection! + "A URL pointing to the team's avatar." + avatarUrl( + "The size in pixels of the resulting square image." + size: Int = 400 + ): URI + "List of child teams belonging to this team" + childTeams( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether to list immediate child teams or all descendant child teams." + immediateOnly: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: TeamOrder, + "User logins to filter by" + userLogins: [String!] + ): TeamConnection! + "The slug corresponding to the organization and team." + combinedSlug: String! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The description of the team." + description: String + "Find a team discussion by its number." + discussion( + "The sequence number of the discussion to find." + number: Int! + ): TeamDiscussion + "A list of team discussions." + discussions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "If provided, filters discussions according to whether or not they are pinned." + isPinned: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: TeamDiscussionOrder + ): TeamDiscussionConnection! + "The HTTP path for team discussions" + discussionsResourcePath: URI! + "The HTTP URL for team discussions" + discussionsUrl: URI! + "The HTTP path for editing this team" + editTeamResourcePath: URI! + "The HTTP URL for editing this team" + editTeamUrl: URI! + "The Node ID of the Team object" + id: ID! + "A list of pending invitations for users to this team" + invitations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): OrganizationInvitationConnection + "Get the status messages members of this entity have set that are either public or visible only to the organization." + memberStatuses( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for user statuses returned from the connection." + orderBy: UserStatusOrder = {field: UPDATED_AT, direction: DESC} + ): UserStatusConnection! + "A list of users who are members of this team." + members( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter by membership type" + membership: TeamMembershipType = ALL, + "Order for the connection." + orderBy: TeamMemberOrder, + "The search string to look for." + query: String, + "Filter by team member role" + role: TeamMemberRole + ): TeamMemberConnection! + "The HTTP path for the team' members" + membersResourcePath: URI! + "The HTTP URL for the team' members" + membersUrl: URI! + "The name of the team." + name: String! + "The HTTP path creating a new team" + newTeamResourcePath: URI! + "The HTTP URL creating a new team" + newTeamUrl: URI! + "The notification setting that the team has set." + notificationSetting: TeamNotificationSetting! + "The organization that owns this team." + organization: Organization! + "The parent team of the team." + parentTeam: Team + "The level of privacy the team has." + privacy: TeamPrivacy! + "Finds and returns the project according to the provided project number." + projectV2( + "The Project number." + number: Int! + ): ProjectV2 + "List of projects this team has collaborator access to." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filtering options for projects returned from this connection" + filterBy: ProjectV2Filters = {}, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter projects based on user role." + minPermissionLevel: ProjectV2PermissionLevel = READ, + "How to order the returned projects." + orderBy: ProjectV2Order = {field: NUMBER, direction: DESC}, + "The query to search projects by." + query: String = "" + ): ProjectV2Connection! + "A list of repositories this team has access to." + repositories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for the connection." + orderBy: TeamRepositoryOrder, + "The search string to look for. Repositories will be returned where the name contains your search string." + query: String + ): TeamRepositoryConnection! + "The HTTP path for this team's repositories" + repositoriesResourcePath: URI! + "The HTTP URL for this team's repositories" + repositoriesUrl: URI! + "The HTTP path for this team" + resourcePath: URI! + "What algorithm is used for review assignment for this team" + reviewRequestDelegationAlgorithm: TeamReviewAssignmentAlgorithm + "True if review assignment is enabled for this team" + reviewRequestDelegationEnabled: Boolean! + "How many team members are required for review assignment for this team" + reviewRequestDelegationMemberCount: Int + "When assigning team members via delegation, whether the entire team should be notified as well." + reviewRequestDelegationNotifyTeam: Boolean! + "The slug corresponding to the team." + slug: String! + "The HTTP path for this team's teams" + teamsResourcePath: URI! + "The HTTP URL for this team's teams" + teamsUrl: URI! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this team" + url: URI! + "Team is adminable by the viewer." + viewerCanAdminister: Boolean! + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState +} + +"Audit log entry for a team.add_member event." +type TeamAddMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & TeamAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the TeamAddMemberAuditEntry object" + id: ID! + "Whether the team was mapped to an LDAP Group." + isLdapMapped: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The team associated with the action" + team: Team + "The name of the team" + teamName: String + "The HTTP path for this team" + teamResourcePath: URI + "The HTTP URL for this team" + teamUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a team.add_repository event." +type TeamAddRepositoryAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData & TeamAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the TeamAddRepositoryAuditEntry object" + id: ID! + "Whether the team was mapped to an LDAP Group." + isLdapMapped: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The team associated with the action" + team: Team + "The name of the team" + teamName: String + "The HTTP path for this team" + teamResourcePath: URI + "The HTTP URL for this team" + teamUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a team.change_parent_team event." +type TeamChangeParentTeamAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & TeamAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the TeamChangeParentTeamAuditEntry object" + id: ID! + "Whether the team was mapped to an LDAP Group." + isLdapMapped: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The new parent team." + parentTeam: Team @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the new parent team" + parentTeamName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the former parent team" + parentTeamNameWas: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the parent team" + parentTeamResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the parent team" + parentTeamUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The former parent team." + parentTeamWas: Team @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the previous parent team" + parentTeamWasResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the previous parent team" + parentTeamWasUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The team associated with the action" + team: Team + "The name of the team" + teamName: String + "The HTTP path for this team" + teamResourcePath: URI + "The HTTP URL for this team" + teamUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"The connection type for Team." +type TeamConnection { + "A list of edges." + edges: [TeamEdge] + "A list of nodes." + nodes: [Team] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"A team discussion." +type TeamDiscussion implements Comment & Deletable & Node & Reactable & Subscribable & UniformResourceLocatable & Updatable & UpdatableComment { + "The actor who authored the comment." + author: Actor + "Author's association with the discussion's team." + authorAssociation: CommentAuthorAssociation! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The body as Markdown." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "Identifies the discussion body hash." + bodyVersion: String! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "A list of comments on this discussion." + comments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "When provided, filters the connection such that results begin with the comment with this number." + fromComment: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: TeamDiscussionCommentOrder + ): TeamDiscussionCommentConnection! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The HTTP path for discussion comments" + commentsResourcePath: URI! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The HTTP URL for discussion comments" + commentsUrl: URI! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The actor who edited the comment." + editor: Actor + "The Node ID of the TeamDiscussion object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "Whether or not the discussion is pinned." + isPinned: Boolean! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Whether or not the discussion is only visible to team members and organization owners." + isPrivate: Boolean! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Identifies the discussion within its team." + number: Int! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Identifies when the comment was published at." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The HTTP path for this discussion" + resourcePath: URI! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The team that defines the context of this discussion." + team: Team! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The title of the discussion" + title: String! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this discussion" + url: URI! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Whether or not the current viewer can pin this discussion." + viewerCanPin: Boolean! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Can user react to this subject" + viewerCanReact: Boolean! + "Check if the viewer is able to change their subscription status for the repository." + viewerCanSubscribe: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! + "Identifies if the viewer is watching, not watching, or ignoring the subscribable entity." + viewerSubscription: SubscriptionState +} + +"A comment on a team discussion." +type TeamDiscussionComment implements Comment & Deletable & Node & Reactable & UniformResourceLocatable & Updatable & UpdatableComment { + "The actor who authored the comment." + author: Actor + "Author's association with the comment's team." + authorAssociation: CommentAuthorAssociation! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The body as Markdown." + body: String! + "The body rendered to HTML." + bodyHTML: HTML! + "The body rendered to text." + bodyText: String! + "The current version of the body content." + bodyVersion: String! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Check if this comment was created via an email reply." + createdViaEmail: Boolean! + "Identifies the primary key from the database." + databaseId: Int + "The discussion this comment is about." + discussion: TeamDiscussion! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "The actor who edited the comment." + editor: Actor + "The Node ID of the TeamDiscussionComment object" + id: ID! + "Check if this comment was edited and includes an edit with the creation data" + includesCreatedEdit: Boolean! + "The moment the editor made the last edit" + lastEditedAt: DateTime + "Identifies the comment number." + number: Int! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Identifies when the comment was published at." + publishedAt: DateTime + "A list of reactions grouped by content left on the subject." + reactionGroups: [ReactionGroup!] + "A list of Reactions left on the Issue." + reactions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Allows filtering Reactions by emoji." + content: ReactionContent, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Allows specifying the order in which reactions are returned." + orderBy: ReactionOrder + ): ReactionConnection! + "The HTTP path for this comment" + resourcePath: URI! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this comment" + url: URI! @deprecated(reason: "The Team Discussions feature is deprecated in favor of Organization Discussions. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. Removal on 2024-07-01 UTC.") + "A list of edits to this content." + userContentEdits( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserContentEditConnection + "Check if the current viewer can delete this object." + viewerCanDelete: Boolean! + "Can user react to this subject" + viewerCanReact: Boolean! + "Check if the current viewer can update this object." + viewerCanUpdate: Boolean! + "Reasons why the current viewer can not update this comment." + viewerCannotUpdateReasons: [CommentCannotUpdateReason!]! + "Did the viewer author this comment." + viewerDidAuthor: Boolean! +} + +"The connection type for TeamDiscussionComment." +type TeamDiscussionCommentConnection { + "A list of edges." + edges: [TeamDiscussionCommentEdge] + "A list of nodes." + nodes: [TeamDiscussionComment] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type TeamDiscussionCommentEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: TeamDiscussionComment +} + +"The connection type for TeamDiscussion." +type TeamDiscussionConnection { + "A list of edges." + edges: [TeamDiscussionEdge] + "A list of nodes." + nodes: [TeamDiscussion] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type TeamDiscussionEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: TeamDiscussion +} + +"An edge in a connection." +type TeamEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: Team +} + +"The connection type for User." +type TeamMemberConnection { + "A list of edges." + edges: [TeamMemberEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a user who is a member of a team." +type TeamMemberEdge { + "A cursor for use in pagination." + cursor: String! + "The HTTP path to the organization's member access page." + memberAccessResourcePath: URI! + "The HTTP URL to the organization's member access page." + memberAccessUrl: URI! + node: User! + "The role the member has on the team." + role: TeamMemberRole! +} + +"Audit log entry for a team.remove_member event." +type TeamRemoveMemberAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & TeamAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the TeamRemoveMemberAuditEntry object" + id: ID! + "Whether the team was mapped to an LDAP Group." + isLdapMapped: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The team associated with the action" + team: Team + "The name of the team" + teamName: String + "The HTTP path for this team" + teamResourcePath: URI + "The HTTP URL for this team" + teamUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"Audit log entry for a team.remove_repository event." +type TeamRemoveRepositoryAuditEntry implements AuditEntry & Node & OrganizationAuditEntryData & RepositoryAuditEntryData & TeamAuditEntryData { + "The action name" + action: String! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The user who initiated the action" + actor: AuditEntryActor @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The IP address of the actor" + actorIp: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "A readable representation of the actor's location" + actorLocation: ActorLocation @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The username of the user who initiated the action" + actorLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the actor." + actorResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the actor." + actorUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The time the action was initiated" + createdAt: PreciseDateTime! @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Node ID of the TeamRemoveRepositoryAuditEntry object" + id: ID! + "Whether the team was mapped to an LDAP Group." + isLdapMapped: Boolean @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The corresponding operation type for the action" + operationType: OperationType @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The Organization associated with the Audit Entry." + organization: Organization @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The name of the Organization." + organizationName: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the organization" + organizationResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the organization" + organizationUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The repository associated with the action" + repository: Repository + "The name of the repository" + repositoryName: String + "The HTTP path for the repository" + repositoryResourcePath: URI + "The HTTP URL for the repository" + repositoryUrl: URI + "The team associated with the action" + team: Team + "The name of the team" + teamName: String + "The HTTP path for this team" + teamResourcePath: URI + "The HTTP URL for this team" + teamUrl: URI + "The user affected by the action" + user: User @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "For actions involving two users, the actor is the initiator and the user is the affected user." + userLogin: String @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP path for the user." + userResourcePath: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") + "The HTTP URL for the user." + userUrl: URI @deprecated(reason: "The GraphQL audit-log is deprecated. Please use the REST API instead. Removal on 2026-04-01 UTC.") +} + +"The connection type for Repository." +type TeamRepositoryConnection { + "A list of edges." + edges: [TeamRepositoryEdge] + "A list of nodes." + nodes: [Repository] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"Represents a team repository." +type TeamRepositoryEdge { + "A cursor for use in pagination." + cursor: String! + node: Repository! + "The permission level the team has on the repository" + permission: RepositoryPermission! +} + +"A text match within a search result." +type TextMatch { + "The specific text fragment within the property matched on." + fragment: String! + "Highlights within the matched fragment." + highlights: [TextMatchHighlight!]! + "The property matched on." + property: String! +} + +"Represents a single highlight in a search result match." +type TextMatchHighlight { + "The indice in the fragment where the matched text begins." + beginIndice: Int! + "The indice in the fragment where the matched text ends." + endIndice: Int! + "The text matched." + text: String! +} + +"A topic aggregates entities that are related to a subject." +type Topic implements Node & Starrable { + "The Node ID of the Topic object" + id: ID! + "The topic's name." + name: String! + """ + + A list of related topics, including aliases of this topic, sorted with the most relevant + first. Returns up to 10 Topics. + """ + relatedTopics( + "How many topics to return." + first: Int = 3 + ): [Topic!]! + "A list of repositories." + repositories( + "Array of viewer's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the current viewer owns." + affiliations: [RepositoryAffiliation], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "If non-null, filters repositories according to whether they have issues enabled" + hasIssuesEnabled: Boolean, + "If non-null, filters repositories according to whether they have been locked" + isLocked: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder, + "Array of owner's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the organization or user being viewed owns." + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR], + "If non-null, filters repositories according to privacy. Internal repositories are considered private; consider using the visibility argument if only internal repositories are needed. Cannot be combined with the visibility argument." + privacy: RepositoryPrivacy, + "If true, only repositories whose owner can be sponsored via GitHub Sponsors will be returned." + sponsorableOnly: Boolean = false, + "If non-null, filters repositories according to visibility. Cannot be combined with the privacy argument." + visibility: RepositoryVisibility + ): RepositoryConnection! + """ + + Returns a count of how many stargazers there are on this object + """ + stargazerCount: Int! + "A list of users who have starred this starrable." + stargazers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: StarOrder + ): StargazerConnection! + "Returns a boolean indicating whether the viewing user has starred this starrable." + viewerHasStarred: Boolean! +} + +"Autogenerated return type of TransferEnterpriseOrganization." +type TransferEnterpriseOrganizationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The organization for which a transfer was initiated." + organization: Organization +} + +"Autogenerated return type of TransferIssue." +type TransferIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue that was transferred" + issue: Issue +} + +"Represents a 'transferred' event on a given issue or pull request." +type TransferredEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The repository this came from" + fromRepository: Repository + "The Node ID of the TransferredEvent object" + id: ID! + "Identifies the issue associated with the event." + issue: Issue! +} + +"Represents a Git tree." +type Tree implements GitObject & Node { + "An abbreviated version of the Git object ID" + abbreviatedOid: String! + "The HTTP path for this Git object" + commitResourcePath: URI! + "The HTTP URL for this Git object" + commitUrl: URI! + "A list of tree entries." + entries: [TreeEntry!] + "The Node ID of the Tree object" + id: ID! + "The Git object ID" + oid: GitObjectID! + "The Repository the Git object belongs to" + repository: Repository! +} + +"Represents a Git tree entry." +type TreeEntry { + "The extension of the file" + extension: String + "Whether or not this tree entry is generated" + isGenerated: Boolean! + "The programming language this file is written in." + language: Language + "Number of lines in the file." + lineCount: Int + "Entry file mode." + mode: Int! + "Entry file name." + name: String! + "Entry file name. (Base64-encoded)" + nameRaw: Base64String! + "Entry file object." + object: GitObject + "Entry file Git object ID." + oid: GitObjectID! + "The full path of the file." + path: String + "The full path of the file. (Base64-encoded)" + pathRaw: Base64String + "The Repository the tree entry belongs to" + repository: Repository! + "Entry byte size" + size: Int! + "If the TreeEntry is for a directory occupied by a submodule project, this returns the corresponding submodule" + submodule: Submodule + "Entry file type." + type: String! +} + +"Autogenerated return type of UnarchiveProjectV2Item." +type UnarchiveProjectV2ItemPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item unarchived from the project." + item: ProjectV2Item +} + +"Autogenerated return type of UnarchiveRepository." +type UnarchiveRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository that was unarchived." + repository: Repository +} + +"Represents an 'unassigned' event on any assignable object." +type UnassignedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the assignable associated with the event." + assignable: Assignable! + "Identifies the user or mannequin that was unassigned." + assignee: Assignee + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the UnassignedEvent object" + id: ID! + "Identifies the subject (user) who was unassigned." + user: User @deprecated(reason: "Assignees can now be mannequins. Use the `assignee` field instead. Removal on 2020-01-01 UTC.") +} + +"Autogenerated return type of UnfollowOrganization." +type UnfollowOrganizationPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The organization that was unfollowed." + organization: Organization +} + +"Autogenerated return type of UnfollowUser." +type UnfollowUserPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The user that was unfollowed." + user: User +} + +"Represents an unknown signature on a Commit or Tag." +type UnknownSignature implements GitSignature { + "Email used to sign this object." + email: String! + "True if the signature is valid and verified by GitHub." + isValid: Boolean! + "Payload for GPG signing object. Raw ODB object without the signature header." + payload: String! + "ASCII-armored signature header from object." + signature: String! + "GitHub user corresponding to the email signing this commit." + signer: User + "The state of this signature. `VALID` if signature is valid and verified by GitHub, otherwise represents reason why signature is considered invalid." + state: GitSignatureState! + "The date the signature was verified, if valid" + verifiedAt: DateTime + "True if the signature was made with GitHub's signing key." + wasSignedByGitHub: Boolean! +} + +"Represents an 'unlabeled' event on a given issue or pull request." +type UnlabeledEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the UnlabeledEvent object" + id: ID! + "Identifies the label associated with the 'unlabeled' event." + label: Label! + "Identifies the `Labelable` associated with the event." + labelable: Labelable! +} + +"Autogenerated return type of UnlinkProjectV2FromRepository." +type UnlinkProjectV2FromRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository the project is no longer linked to." + repository: Repository +} + +"Autogenerated return type of UnlinkProjectV2FromTeam." +type UnlinkProjectV2FromTeamPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The team the project is unlinked from" + team: Team +} + +"Autogenerated return type of UnlinkRepositoryFromProject." +type UnlinkRepositoryFromProjectPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The linked Project." + project: Project + "The linked Repository." + repository: Repository +} + +"Autogenerated return type of UnlockLockable." +type UnlockLockablePayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item that was unlocked." + unlockedRecord: Lockable +} + +"Represents an 'unlocked' event on a given issue or pull request." +type UnlockedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the UnlockedEvent object" + id: ID! + "Object that was unlocked." + lockable: Lockable! +} + +"Autogenerated return type of UnmarkDiscussionCommentAsAnswer." +type UnmarkDiscussionCommentAsAnswerPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion that includes the comment." + discussion: Discussion +} + +"Autogenerated return type of UnmarkFileAsViewed." +type UnmarkFileAsViewedPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated pull request." + pullRequest: PullRequest +} + +"Autogenerated return type of UnmarkIssueAsDuplicate." +type UnmarkIssueAsDuplicatePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue or pull request that was marked as a duplicate." + duplicate: IssueOrPullRequest +} + +"Autogenerated return type of UnmarkProjectV2AsTemplate." +type UnmarkProjectV2AsTemplatePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The project." + projectV2: ProjectV2 +} + +"Represents an 'unmarked_as_duplicate' event on a given issue or pull request." +type UnmarkedAsDuplicateEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "The authoritative issue or pull request which has been duplicated by another." + canonical: IssueOrPullRequest + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The issue or pull request which has been marked as a duplicate of another." + duplicate: IssueOrPullRequest + "The Node ID of the UnmarkedAsDuplicateEvent object" + id: ID! + "Canonical and duplicate belong to different repositories." + isCrossRepository: Boolean! +} + +"Autogenerated return type of UnminimizeComment." +type UnminimizeCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The comment that was unminimized." + unminimizedComment: Minimizable +} + +"Autogenerated return type of UnpinIssue." +type UnpinIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the pinned issue that was unpinned" + id: ID + "The issue that was unpinned" + issue: Issue +} + +"Represents an 'unpinned' event on a given issue or pull request." +type UnpinnedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the UnpinnedEvent object" + id: ID! + "Identifies the issue associated with the event." + issue: Issue! +} + +"Autogenerated return type of UnresolveReviewThread." +type UnresolveReviewThreadPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The thread to resolve." + thread: PullRequestReviewThread +} + +"Represents an 'unsubscribed' event on a given `Subscribable`." +type UnsubscribedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the UnsubscribedEvent object" + id: ID! + "Object referenced by event." + subscribable: Subscribable! +} + +"Autogenerated return type of UpdateBranchProtectionRule." +type UpdateBranchProtectionRulePayload { + "The newly created BranchProtectionRule." + branchProtectionRule: BranchProtectionRule + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of UpdateCheckRun." +type UpdateCheckRunPayload { + "The updated check run." + checkRun: CheckRun + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of UpdateCheckSuitePreferences." +type UpdateCheckSuitePreferencesPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated repository." + repository: Repository +} + +"Autogenerated return type of UpdateDiscussionComment." +type UpdateDiscussionCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The modified discussion comment." + comment: DiscussionComment +} + +"Autogenerated return type of UpdateDiscussion." +type UpdateDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The modified discussion." + discussion: Discussion +} + +"Autogenerated return type of UpdateEnterpriseAdministratorRole." +type UpdateEnterpriseAdministratorRolePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A message confirming the result of changing the administrator's role." + message: String +} + +"Autogenerated return type of UpdateEnterpriseAllowPrivateRepositoryForkingSetting." +type UpdateEnterpriseAllowPrivateRepositoryForkingSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated allow private repository forking setting." + enterprise: Enterprise + "A message confirming the result of updating the allow private repository forking setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseDefaultRepositoryPermissionSetting." +type UpdateEnterpriseDefaultRepositoryPermissionSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated base repository permission setting." + enterprise: Enterprise + "A message confirming the result of updating the base repository permission setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseDeployKeySetting." +type UpdateEnterpriseDeployKeySettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated deploy key setting." + enterprise: Enterprise + "A message confirming the result of updating the deploy key setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanChangeRepositoryVisibilitySetting." +type UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can change repository visibility setting." + enterprise: Enterprise + "A message confirming the result of updating the members can change repository visibility setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanCreateRepositoriesSetting." +type UpdateEnterpriseMembersCanCreateRepositoriesSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can create repositories setting." + enterprise: Enterprise + "A message confirming the result of updating the members can create repositories setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanDeleteIssuesSetting." +type UpdateEnterpriseMembersCanDeleteIssuesSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can delete issues setting." + enterprise: Enterprise + "A message confirming the result of updating the members can delete issues setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanDeleteRepositoriesSetting." +type UpdateEnterpriseMembersCanDeleteRepositoriesSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can delete repositories setting." + enterprise: Enterprise + "A message confirming the result of updating the members can delete repositories setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanInviteCollaboratorsSetting." +type UpdateEnterpriseMembersCanInviteCollaboratorsSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can invite collaborators setting." + enterprise: Enterprise + "A message confirming the result of updating the members can invite collaborators setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanMakePurchasesSetting." +type UpdateEnterpriseMembersCanMakePurchasesSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can make purchases setting." + enterprise: Enterprise + "A message confirming the result of updating the members can make purchases setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanUpdateProtectedBranchesSetting." +type UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can update protected branches setting." + enterprise: Enterprise + "A message confirming the result of updating the members can update protected branches setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseMembersCanViewDependencyInsightsSetting." +type UpdateEnterpriseMembersCanViewDependencyInsightsSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated members can view dependency insights setting." + enterprise: Enterprise + "A message confirming the result of updating the members can view dependency insights setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseOrganizationProjectsSetting." +type UpdateEnterpriseOrganizationProjectsSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated organization projects setting." + enterprise: Enterprise + "A message confirming the result of updating the organization projects setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseOwnerOrganizationRole." +type UpdateEnterpriseOwnerOrganizationRolePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A message confirming the result of changing the owner's organization role." + message: String +} + +"Autogenerated return type of UpdateEnterpriseProfile." +type UpdateEnterpriseProfilePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated enterprise." + enterprise: Enterprise +} + +"Autogenerated return type of UpdateEnterpriseRepositoryProjectsSetting." +type UpdateEnterpriseRepositoryProjectsSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated repository projects setting." + enterprise: Enterprise + "A message confirming the result of updating the repository projects setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseTeamDiscussionsSetting." +type UpdateEnterpriseTeamDiscussionsSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated team discussions setting." + enterprise: Enterprise + "A message confirming the result of updating the team discussions setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseTwoFactorAuthenticationDisallowedMethodsSetting." +type UpdateEnterpriseTwoFactorAuthenticationDisallowedMethodsSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated two-factor authentication disallowed methods setting." + enterprise: Enterprise + "A message confirming the result of updating the two-factor authentication disallowed methods setting." + message: String +} + +"Autogenerated return type of UpdateEnterpriseTwoFactorAuthenticationRequiredSetting." +type UpdateEnterpriseTwoFactorAuthenticationRequiredSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The enterprise with the updated two factor authentication required setting." + enterprise: Enterprise + "A message confirming the result of updating the two factor authentication required setting." + message: String +} + +"Autogenerated return type of UpdateEnvironment." +type UpdateEnvironmentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated environment." + environment: Environment +} + +"Autogenerated return type of UpdateIpAllowListEnabledSetting." +type UpdateIpAllowListEnabledSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The IP allow list owner on which the setting was updated." + owner: IpAllowListOwner +} + +"Autogenerated return type of UpdateIpAllowListEntry." +type UpdateIpAllowListEntryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The IP allow list entry that was updated." + ipAllowListEntry: IpAllowListEntry +} + +"Autogenerated return type of UpdateIpAllowListForInstalledAppsEnabledSetting." +type UpdateIpAllowListForInstalledAppsEnabledSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The IP allow list owner on which the setting was updated." + owner: IpAllowListOwner +} + +"Autogenerated return type of UpdateIssueComment." +type UpdateIssueCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated comment." + issueComment: IssueComment +} + +"Autogenerated return type of UpdateIssueIssueType." +type UpdateIssueIssueTypePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated issue" + issue: Issue +} + +"Autogenerated return type of UpdateIssue." +type UpdateIssuePayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The issue." + issue: Issue +} + +"Autogenerated return type of UpdateIssueType." +type UpdateIssueTypePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated issue type" + issueType: IssueType +} + +"Autogenerated return type of UpdateLabel." +type UpdateLabelPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated label." + label: Label +} + +"Autogenerated return type of UpdateNotificationRestrictionSetting." +type UpdateNotificationRestrictionSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The owner on which the setting was updated." + owner: VerifiableDomainOwner +} + +"Autogenerated return type of UpdateOrganizationAllowPrivateRepositoryForkingSetting." +type UpdateOrganizationAllowPrivateRepositoryForkingSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A message confirming the result of updating the allow private repository forking setting." + message: String + "The organization with the updated allow private repository forking setting." + organization: Organization +} + +"Autogenerated return type of UpdateOrganizationWebCommitSignoffSetting." +type UpdateOrganizationWebCommitSignoffSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A message confirming the result of updating the web commit signoff setting." + message: String + "The organization with the updated web commit signoff setting." + organization: Organization +} + +"Only allow users with bypass permission to update matching refs." +type UpdateParameters { + "Branch can pull changes from its upstream repository" + updateAllowsFetchAndMerge: Boolean! +} + +"Autogenerated return type of UpdatePatreonSponsorability." +type UpdatePatreonSponsorabilityPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The GitHub Sponsors profile." + sponsorsListing: SponsorsListing +} + +"Autogenerated return type of UpdateProjectCard." +type UpdateProjectCardPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated ProjectCard." + projectCard: ProjectCard +} + +"Autogenerated return type of UpdateProjectColumn." +type UpdateProjectColumnPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated project column." + projectColumn: ProjectColumn +} + +"Autogenerated return type of UpdateProject." +type UpdateProjectPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated project." + project: Project +} + +"Autogenerated return type of UpdateProjectV2Collaborators." +type UpdateProjectV2CollaboratorsPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The collaborators granted a role" + collaborators( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2ActorConnection +} + +"Autogenerated return type of UpdateProjectV2DraftIssue." +type UpdateProjectV2DraftIssuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The draft issue updated in the project." + draftIssue: DraftIssue +} + +"Autogenerated return type of UpdateProjectV2Field." +type UpdateProjectV2FieldPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated field." + projectV2Field: ProjectV2FieldConfiguration +} + +"Autogenerated return type of UpdateProjectV2ItemFieldValue." +type UpdateProjectV2ItemFieldValuePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated item." + projectV2Item: ProjectV2Item +} + +"Autogenerated return type of UpdateProjectV2ItemPosition." +type UpdateProjectV2ItemPositionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The items in the new order" + items( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2ItemConnection +} + +"Autogenerated return type of UpdateProjectV2." +type UpdateProjectV2Payload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated Project." + projectV2: ProjectV2 +} + +"Autogenerated return type of UpdateProjectV2StatusUpdate." +type UpdateProjectV2StatusUpdatePayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The status update updated in the project." + statusUpdate: ProjectV2StatusUpdate +} + +"Autogenerated return type of UpdatePullRequestBranch." +type UpdatePullRequestBranchPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated pull request." + pullRequest: PullRequest +} + +"Autogenerated return type of UpdatePullRequest." +type UpdatePullRequestPayload { + "Identifies the actor who performed the event." + actor: Actor + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated pull request." + pullRequest: PullRequest +} + +"Autogenerated return type of UpdatePullRequestReviewComment." +type UpdatePullRequestReviewCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated comment." + pullRequestReviewComment: PullRequestReviewComment +} + +"Autogenerated return type of UpdatePullRequestReview." +type UpdatePullRequestReviewPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated pull request review." + pullRequestReview: PullRequestReview +} + +"Autogenerated return type of UpdateRef." +type UpdateRefPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated Ref." + ref: Ref +} + +"Autogenerated return type of UpdateRefs." +type UpdateRefsPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated return type of UpdateRepository." +type UpdateRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated repository." + repository: Repository +} + +"Autogenerated return type of UpdateRepositoryRuleset." +type UpdateRepositoryRulesetPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The newly created Ruleset." + ruleset: RepositoryRuleset +} + +"Autogenerated return type of UpdateRepositoryWebCommitSignoffSetting." +type UpdateRepositoryWebCommitSignoffSettingPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A message confirming the result of updating the web commit signoff setting." + message: String + "The updated repository." + repository: Repository +} + +"Autogenerated return type of UpdateSponsorshipPreferences." +type UpdateSponsorshipPreferencesPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The sponsorship that was updated." + sponsorship: Sponsorship +} + +"Autogenerated return type of UpdateSubscription." +type UpdateSubscriptionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The input subscribable entity." + subscribable: Subscribable +} + +"Autogenerated return type of UpdateTeamDiscussionComment." +type UpdateTeamDiscussionCommentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated comment." + teamDiscussionComment: TeamDiscussionComment +} + +"Autogenerated return type of UpdateTeamDiscussion." +type UpdateTeamDiscussionPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The updated discussion." + teamDiscussion: TeamDiscussion +} + +"Autogenerated return type of UpdateTeamReviewAssignment." +type UpdateTeamReviewAssignmentPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The team that was modified" + team: Team +} + +"Autogenerated return type of UpdateTeamsRepository." +type UpdateTeamsRepositoryPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The repository that was updated." + repository: Repository + "The teams granted permission on the repository." + teams: [Team!] +} + +"Autogenerated return type of UpdateTopics." +type UpdateTopicsPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Names of the provided topics that are not valid." + invalidTopicNames: [String!] + "The updated repository." + repository: Repository +} + +"Autogenerated return type of UpdateUserList." +type UpdateUserListPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The list that was just updated" + list: UserList +} + +"Autogenerated return type of UpdateUserListsForItem." +type UpdateUserListsForItemPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item that was added" + item: UserListItems + "The lists to which this item belongs" + lists: [UserList!] + "The user who owns the lists" + user: User +} + +"A user is an individual's account on GitHub that owns repositories and can make new content." +type User implements Actor & Node & PackageOwner & ProfileOwner & ProjectOwner & ProjectV2Owner & ProjectV2Recent & RepositoryDiscussionAuthor & RepositoryDiscussionCommentAuthor & RepositoryOwner & Sponsorable & UniformResourceLocatable { + "Determine if this repository owner has any items that can be pinned to their profile." + anyPinnableItems( + "Filter to only a particular kind of pinnable item." + type: PinnableItemType + ): Boolean! + "A URL pointing to the user's public avatar." + avatarUrl( + "The size of the resulting square image." + size: Int + ): URI! + "The user's public profile bio." + bio: String + "The user's public profile bio as HTML." + bioHTML: HTML! + "Could this user receive email notifications, if the organization had notification restrictions enabled?" + canReceiveOrganizationEmailsWhenNotificationsRestricted( + "The login of the organization to check." + login: String! + ): Boolean! + "A list of commit comments made by this user." + commitComments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): CommitCommentConnection! + "The user's public profile company." + company: String + "The user's public profile company as HTML." + companyHTML: HTML! + "The collection of contributions this user has made to different repositories." + contributionsCollection( + "Only contributions made at this time or later will be counted. If omitted, defaults to a year ago." + from: DateTime, + "The ID of the organization used to filter contributions." + organizationID: ID, + "Only contributions made before and up to (including) this time will be counted. If omitted, defaults to the current time or one year from the provided from argument." + to: DateTime + ): ContributionsCollection! + "The user's Copilot endpoint information" + copilotEndpoints: CopilotEndpoints + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The user's publicly visible profile email." + email: String! + "A list of enterprises that the user belongs to." + enterprises( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter enterprises returned based on the user's membership type." + membershipType: EnterpriseMembershipType = ALL, + "Ordering options for the User's enterprises." + orderBy: EnterpriseOrder = {field: NAME, direction: ASC} + ): EnterpriseConnection + "The estimated next GitHub Sponsors payout for this user/organization in cents (USD)." + estimatedNextSponsorsPayoutInCents: Int! + "A list of users the given user is followed by." + followers( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): FollowerConnection! + "A list of users the given user is following." + following( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): FollowingConnection! + "Find gist by repo name." + gist( + "The gist name to find." + name: String! + ): Gist + "A list of gist comments made by this user." + gistComments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): GistCommentConnection! + "A list of the Gists the user has created." + gists( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for gists returned from the connection" + orderBy: GistOrder, + "Filters Gists according to privacy." + privacy: GistPrivacy + ): GistConnection! + "True if this user/organization has a GitHub Sponsors listing." + hasSponsorsListing: Boolean! + "The hovercard information for this user in a given context" + hovercard( + "The ID of the subject to get the hovercard in the context of" + primarySubjectId: ID + ): Hovercard! + "The Node ID of the User object" + id: ID! + "The interaction ability settings for this user." + interactionAbility: RepositoryInteractionAbility + "Whether or not this user is a participant in the GitHub Security Bug Bounty." + isBountyHunter: Boolean! + "Whether or not this user is a participant in the GitHub Campus Experts Program." + isCampusExpert: Boolean! + "Whether or not this user is a GitHub Developer Program member." + isDeveloperProgramMember: Boolean! + "Whether or not this user is a GitHub employee." + isEmployee: Boolean! + "Whether or not this user is following the viewer. Inverse of viewerIsFollowing" + isFollowingViewer: Boolean! + "Whether or not this user is a member of the GitHub Stars Program." + isGitHubStar: Boolean! + "Whether or not the user has marked themselves as for hire." + isHireable: Boolean! + "Whether or not this user is a site administrator." + isSiteAdmin: Boolean! + "Whether the given account is sponsoring this user/organization." + isSponsoredBy( + "The target account's login." + accountLogin: String! + ): Boolean! + "True if the viewer is sponsored by this user/organization." + isSponsoringViewer: Boolean! + "Whether or not this user is the viewing user." + isViewer: Boolean! + "A list of issue comments made by this user." + issueComments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issue comments returned from the connection." + orderBy: IssueCommentOrder + ): IssueCommentConnection! + "A list of issues associated with this user." + issues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Filtering options for issues returned from the connection." + filterBy: IssueFilters, + "Returns the first _n_ elements from the list." + first: Int, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for issues returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the issues by." + states: [IssueState!] + ): IssueConnection! + "Showcases a selection of repositories and gists that the profile owner has either curated or that have been selected automatically based on popularity." + itemShowcase: ProfileItemShowcase! + "Calculate how much each sponsor has ever paid total to this maintainer via GitHub Sponsors. Does not include sponsorships paid via Patreon." + lifetimeReceivedSponsorshipValues( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for results returned from the connection." + orderBy: SponsorAndLifetimeValueOrder = {field: SPONSOR_LOGIN, direction: ASC} + ): SponsorAndLifetimeValueConnection! + "A user-curated list of repositories" + lists( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserListConnection! + "The user's public profile location." + location: String + "The username used to login." + login: String! + "The estimated monthly GitHub Sponsors income for this user/organization in cents (USD)." + monthlyEstimatedSponsorsIncomeInCents: Int! + "The user's public profile name." + name: String + "Find an organization by its login that the user belongs to." + organization( + "The login of the organization to find." + login: String! + ): Organization + "Verified email addresses that match verified domains for a specified organization the user is a member of." + organizationVerifiedDomainEmails( + "The login of the organization to match verified domains from." + login: String! + ): [String!]! + "A list of organizations the user belongs to." + organizations( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the User's organizations." + orderBy: OrganizationOrder + ): OrganizationConnection! + "A list of packages under the owner." + packages( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Find packages by their names." + names: [String], + "Ordering of the returned packages." + orderBy: PackageOrder = {field: CREATED_AT, direction: DESC}, + "Filter registry package by type." + packageType: PackageType, + "Find packages in a repository by ID." + repositoryId: ID + ): PackageConnection! + "A list of repositories and gists this profile owner can pin to their profile." + pinnableItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter the types of pinnable items that are returned." + types: [PinnableItemType!] + ): PinnableItemConnection! + "A list of repositories and gists this profile owner has pinned to their profile" + pinnedItems( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter the types of pinned items that are returned." + types: [PinnableItemType!] + ): PinnableItemConnection! + "Returns how many more items this profile owner can pin to their profile." + pinnedItemsRemaining: Int! + "Find project by number." + project( + "The project number to find." + number: Int! + ): Project @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Find a project by number." + projectV2( + "The project number." + number: Int! + ): ProjectV2 + "A list of projects under the owner." + projects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for projects returned from the connection" + orderBy: ProjectOrder, + "Query to search projects by, currently only searching by name." + search: String, + "A list of states to filter the projects by." + states: [ProjectState!] + ): ProjectConnection! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "The HTTP path listing user's projects" + projectsResourcePath: URI! + "The HTTP URL listing user's projects" + projectsUrl: URI! + "A list of projects under the owner." + projectsV2( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter projects based on user role." + minPermissionLevel: ProjectV2PermissionLevel = READ, + "How to order the returned projects." + orderBy: ProjectV2Order = {field: NUMBER, direction: DESC}, + "A project to search for under the owner." + query: String + ): ProjectV2Connection! + "The user's profile pronouns" + pronouns: String + "A list of public keys associated with this user." + publicKeys( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): PublicKeyConnection! + "A list of pull requests associated with this user." + pullRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "The base ref name to filter the pull requests by." + baseRefName: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "The head ref name to filter the pull requests by." + headRefName: String, + "A list of label names to filter the pull requests by." + labels: [String!], + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for pull requests returned from the connection." + orderBy: IssueOrder, + "A list of states to filter the pull requests by." + states: [PullRequestState!] + ): PullRequestConnection! + "Recent projects that this user has modified in the context of the owner." + recentProjects( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): ProjectV2Connection! + "A list of repositories that the user owns." + repositories( + "Array of viewer's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the current viewer owns." + affiliations: [RepositoryAffiliation], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "If non-null, filters repositories according to whether they have issues enabled" + hasIssuesEnabled: Boolean, + "If non-null, filters repositories according to whether they are archived and not maintained" + isArchived: Boolean, + "If non-null, filters repositories according to whether they are forks of another repository" + isFork: Boolean, + "If non-null, filters repositories according to whether they have been locked" + isLocked: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder, + "Array of owner's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the organization or user being viewed owns." + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR], + "If non-null, filters repositories according to privacy. Internal repositories are considered private; consider using the visibility argument if only internal repositories are needed. Cannot be combined with the visibility argument." + privacy: RepositoryPrivacy, + "If non-null, filters repositories according to visibility. Cannot be combined with the privacy argument." + visibility: RepositoryVisibility + ): RepositoryConnection! + "A list of repositories that the user recently contributed to." + repositoriesContributedTo( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "If non-null, include only the specified types of contributions. The GitHub.com UI uses [COMMIT, ISSUE, PULL_REQUEST, REPOSITORY]" + contributionTypes: [RepositoryContributionType], + "Returns the first _n_ elements from the list." + first: Int, + "If non-null, filters repositories according to whether they have issues enabled" + hasIssues: Boolean, + "If true, include user repositories" + includeUserRepositories: Boolean, + "If non-null, filters repositories according to whether they have been locked" + isLocked: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder, + "If non-null, filters repositories according to privacy" + privacy: RepositoryPrivacy + ): RepositoryConnection! + "Find Repository." + repository( + "Follow repository renames. If disabled, a repository referenced by its old name will return an error." + followRenames: Boolean = true, + "Name of Repository to find." + name: String! + ): Repository + "Discussion comments this user has authored." + repositoryDiscussionComments( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter discussion comments to only those that were marked as the answer" + onlyAnswers: Boolean = false, + "Filter discussion comments to only those in a specific repository." + repositoryId: ID + ): DiscussionCommentConnection! + "Discussions this user has started." + repositoryDiscussions( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Filter discussions to only those that have been answered or not. Defaults to including both answered and unanswered discussions." + answered: Boolean, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for discussions returned from the connection." + orderBy: DiscussionOrder = {field: CREATED_AT, direction: DESC}, + "Filter discussions to only those in a specific repository." + repositoryId: ID, + "A list of states to filter the discussions by." + states: [DiscussionState!] = [] + ): DiscussionConnection! + "The HTTP path for this user" + resourcePath: URI! + "Replies this user has saved" + savedReplies( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "The field to order saved replies by." + orderBy: SavedReplyOrder = {field: UPDATED_AT, direction: DESC} + ): SavedReplyConnection + "The user's social media accounts, ordered as they appear on the user's profile." + socialAccounts( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): SocialAccountConnection! + "List of users and organizations this entity is sponsoring." + sponsoring( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the users and organizations returned from the connection." + orderBy: SponsorOrder = {field: RELEVANCE, direction: DESC} + ): SponsorConnection! + "List of sponsors for this user or organization." + sponsors( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsors returned from the connection." + orderBy: SponsorOrder = {field: RELEVANCE, direction: DESC}, + "If given, will filter for sponsors at the given tier. Will only return sponsors whose tier the viewer is permitted to see." + tierId: ID + ): SponsorConnection! + "Events involving this sponsorable, such as new sponsorships." + sponsorsActivities( + "Filter activities to only the specified actions." + actions: [SponsorsActivityAction!] = [], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether to include those events where this sponsorable acted as the sponsor. Defaults to only including events where this sponsorable was the recipient of a sponsorship." + includeAsSponsor: Boolean = false, + "Whether or not to include private activities in the result set. Defaults to including public and private activities." + includePrivate: Boolean = true, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for activity returned from the connection." + orderBy: SponsorsActivityOrder = {field: TIMESTAMP, direction: DESC}, + "Filter activities returned to only those that occurred in the most recent specified time period. Set to ALL to avoid filtering by when the activity occurred. Will be ignored if `since` or `until` is given." + period: SponsorsActivityPeriod = MONTH, + "Filter activities to those that occurred on or after this time." + since: DateTime, + "Filter activities to those that occurred before this time." + until: DateTime + ): SponsorsActivityConnection! + "The GitHub Sponsors listing for this user or organization." + sponsorsListing: SponsorsListing + "The sponsorship from the viewer to this user/organization; that is, the sponsorship where you're the sponsor." + sponsorshipForViewerAsSponsor( + "Whether to return the sponsorship only if it's still active. Pass false to get the viewer's sponsorship back even if it has been cancelled." + activeOnly: Boolean = true + ): Sponsorship + "The sponsorship from this user/organization to the viewer; that is, the sponsorship you're receiving." + sponsorshipForViewerAsSponsorable( + "Whether to return the sponsorship only if it's still active. Pass false to get the sponsorship back even if it has been cancelled." + activeOnly: Boolean = true + ): Sponsorship + "List of sponsorship updates sent from this sponsorable to sponsors." + sponsorshipNewsletters( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsorship updates returned from the connection." + orderBy: SponsorshipNewsletterOrder = {field: CREATED_AT, direction: DESC} + ): SponsorshipNewsletterConnection! + "The sponsorships where this user or organization is the maintainer receiving the funds." + sponsorshipsAsMaintainer( + "Whether to include only sponsorships that are active right now, versus all sponsorships this maintainer has ever received." + activeOnly: Boolean = true, + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Whether or not to include private sponsorships in the result set" + includePrivate: Boolean = false, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for sponsorships returned from this connection. If left blank, the sponsorships will be ordered based on relevancy to the viewer." + orderBy: SponsorshipOrder + ): SponsorshipConnection! + "The sponsorships where this user or organization is the funder." + sponsorshipsAsSponsor( + "Whether to include only sponsorships that are active right now, versus all sponsorships this sponsor has ever made." + activeOnly: Boolean = true, + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Filter sponsorships returned to those for the specified maintainers. That is, the recipient of the sponsorship is a user or organization with one of the given logins." + maintainerLogins: [String!], + "Ordering options for sponsorships returned from this connection. If left blank, the sponsorships will be ordered based on relevancy to the viewer." + orderBy: SponsorshipOrder + ): SponsorshipConnection! + "Repositories the user has starred." + starredRepositories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Order for connection" + orderBy: StarOrder, + "Filters starred repositories to only return repositories owned by the viewer." + ownedByViewer: Boolean + ): StarredRepositoryConnection! + "The user's description of what they're currently doing." + status: UserStatus + "Suggested names for user lists" + suggestedListNames: [UserListSuggestion!]! + """ + + Repositories the user has contributed to, ordered by contribution rank, plus repositories the user has created + """ + topRepositories( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder!, + "How far back in time to fetch contributed repositories" + since: DateTime + ): RepositoryConnection! + "The amount in United States cents (e.g., 500 = $5.00 USD) that this entity has spent on GitHub to fund sponsorships. Only returns a value when viewed by the user themselves or by a user who can manage sponsorships for the requested organization." + totalSponsorshipAmountAsSponsorInCents( + "Filter payments to those that occurred on or after this time." + since: DateTime, + "Filter payments to those made to the users or organizations with the specified usernames." + sponsorableLogins: [String!] = [], + "Filter payments to those that occurred before this time." + until: DateTime + ): Int + "The user's Twitter username." + twitterUsername: String + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this user" + url: URI! + "Whether the request returns publicly visible information or privately visible information about the user" + userViewType: UserViewType! + "Can the viewer pin repositories and gists to the profile?" + viewerCanChangePinnedItems: Boolean! + "Can the current viewer create new projects on this owner." + viewerCanCreateProjects: Boolean! @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "Whether or not the viewer is able to follow the user." + viewerCanFollow: Boolean! + "Whether or not the viewer is able to sponsor this user/organization." + viewerCanSponsor: Boolean! + "Whether or not this user is followed by the viewer. Inverse of isFollowingViewer." + viewerIsFollowing: Boolean! + "True if the viewer is sponsoring this user/organization." + viewerIsSponsoring: Boolean! + "A list of repositories the given user is watching." + watching( + "Affiliation options for repositories returned from the connection. If none specified, the results will include repositories for which the current viewer is an owner or collaborator, or member." + affiliations: [RepositoryAffiliation], + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "If non-null, filters repositories according to whether they have issues enabled" + hasIssuesEnabled: Boolean, + "If non-null, filters repositories according to whether they have been locked" + isLocked: Boolean, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for repositories returned from the connection" + orderBy: RepositoryOrder, + "Array of owner's affiliation options for repositories returned from the connection. For example, OWNER will include only repositories that the organization or user being viewed owns." + ownerAffiliations: [RepositoryAffiliation] = [OWNER, COLLABORATOR], + "If non-null, filters repositories according to privacy. Internal repositories are considered private; consider using the visibility argument if only internal repositories are needed. Cannot be combined with the visibility argument." + privacy: RepositoryPrivacy, + "If non-null, filters repositories according to visibility. Cannot be combined with the privacy argument." + visibility: RepositoryVisibility + ): RepositoryConnection! + "A URL pointing to the user's public website/blog." + websiteUrl: URI +} + +"Represents a 'user_blocked' event on a given user." +type UserBlockedEvent implements Node { + "Identifies the actor who performed the event." + actor: Actor + "Number of days that the user was blocked for." + blockDuration: UserBlockDuration! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The Node ID of the UserBlockedEvent object" + id: ID! + "The user who was blocked." + subject: User +} + +"A list of users." +type UserConnection { + "A list of edges." + edges: [UserEdge] + "A list of nodes." + nodes: [User] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edit on user content" +type UserContentEdit implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the date and time when the object was deleted." + deletedAt: DateTime + "The actor who deleted this content" + deletedBy: Actor + "A summary of the changes for this edit" + diff: String + "When this content was edited" + editedAt: DateTime! + "The actor who edited this content" + editor: Actor + "The Node ID of the UserContentEdit object" + id: ID! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! +} + +"A list of edits to content." +type UserContentEditConnection { + "A list of edges." + edges: [UserContentEditEdge] + "A list of nodes." + nodes: [UserContentEdit] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type UserContentEditEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: UserContentEdit +} + +"Represents a user." +type UserEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: User +} + +"Email attributes from External Identity" +type UserEmailMetadata { + "Boolean to identify primary emails" + primary: Boolean + "Type of email" + type: String + "Email id" + value: String! +} + +"A user-curated list of repositories" +type UserList implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "The description of this list" + description: String + "The Node ID of the UserList object" + id: ID! + "Whether or not this list is private" + isPrivate: Boolean! + "The items associated with this list" + items( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): UserListItemsConnection! + "The date and time at which this list was created or last had items added to it" + lastAddedAt: DateTime! + "The name of this list" + name: String! + "The slug of this list" + slug: String! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The user to which this list belongs" + user: User! +} + +"The connection type for UserList." +type UserListConnection { + "A list of edges." + edges: [UserListEdge] + "A list of nodes." + nodes: [UserList] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type UserListEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: UserList +} + +"The connection type for UserListItems." +type UserListItemsConnection { + "A list of edges." + edges: [UserListItemsEdge] + "A list of nodes." + nodes: [UserListItems] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type UserListItemsEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: UserListItems +} + +"Represents a suggested user list." +type UserListSuggestion { + "The ID of the suggested user list" + id: ID + "The name of the suggested user list" + name: String +} + +"A repository owned by an Enterprise Managed user." +type UserNamespaceRepository implements Node { + "The Node ID of the UserNamespaceRepository object" + id: ID! + "The name of the repository." + name: String! + "The repository's name with owner." + nameWithOwner: String! + "The user owner of the repository." + owner: RepositoryOwner! +} + +"A list of repositories owned by users in an enterprise with Enterprise Managed Users." +type UserNamespaceRepositoryConnection { + "A list of edges." + edges: [UserNamespaceRepositoryEdge] + "A list of nodes." + nodes: [UserNamespaceRepository] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type UserNamespaceRepositoryEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: UserNamespaceRepository +} + +"The user's description of what they're currently doing." +type UserStatus implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "An emoji summarizing the user's status." + emoji: String + "The status emoji as HTML." + emojiHTML: HTML + "If set, the status will not be shown after this date." + expiresAt: DateTime + "The Node ID of the UserStatus object" + id: ID! + "Whether this status indicates the user is not fully available on GitHub." + indicatesLimitedAvailability: Boolean! + "A brief message describing what the user is doing." + message: String + "The organization whose members can see this status. If null, this status is publicly visible." + organization: Organization + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The user who has this status." + user: User! +} + +"The connection type for UserStatus." +type UserStatusConnection { + "A list of edges." + edges: [UserStatusEdge] + "A list of nodes." + nodes: [UserStatus] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type UserStatusEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: UserStatus +} + +"A domain that can be verified or approved for an organization or an enterprise." +type VerifiableDomain implements Node { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The DNS host name that should be used for verification." + dnsHostName: URI + "The unicode encoded domain." + domain: URI! + "Whether a TXT record for verification with the expected host name was found." + hasFoundHostName: Boolean! + "Whether a TXT record for verification with the expected verification token was found." + hasFoundVerificationToken: Boolean! + "The Node ID of the VerifiableDomain object" + id: ID! + "Whether or not the domain is approved." + isApproved: Boolean! + "Whether this domain is required to exist for an organization or enterprise policy to be enforced." + isRequiredForPolicyEnforcement: Boolean! + "Whether or not the domain is verified." + isVerified: Boolean! + "The owner of the domain." + owner: VerifiableDomainOwner! + "The punycode encoded domain." + punycodeEncodedDomain: URI! + "The time that the current verification token will expire." + tokenExpirationTime: DateTime + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The current verification token for the domain." + verificationToken: String +} + +"The connection type for VerifiableDomain." +type VerifiableDomainConnection { + "A list of edges." + edges: [VerifiableDomainEdge] + "A list of nodes." + nodes: [VerifiableDomain] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type VerifiableDomainEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: VerifiableDomain +} + +"Autogenerated return type of VerifyVerifiableDomain." +type VerifyVerifiableDomainPayload { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The verifiable domain that was verified." + domain: VerifiableDomain +} + +"A hovercard context with a message describing how the viewer is related." +type ViewerHovercardContext implements HovercardContext { + "A string describing this context" + message: String! + "An octicon to accompany this context" + octicon: String! + "Identifies the user who is related to this context." + viewer: User! +} + +"A workflow contains meta information about an Actions workflow file." +type Workflow implements Node & UniformResourceLocatable { + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The Node ID of the Workflow object" + id: ID! + "The name of the workflow." + name: String! + "The HTTP path for this workflow" + resourcePath: URI! + "The runs of the workflow." + runs( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int, + "Ordering options for the connection" + orderBy: WorkflowRunOrder = {field: CREATED_AT, direction: DESC} + ): WorkflowRunConnection! + "The state of the workflow." + state: WorkflowState! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this workflow" + url: URI! +} + +"A workflow that must run for this rule to pass" +type WorkflowFileReference { + "The path to the workflow file" + path: String! + "The ref (branch or tag) of the workflow file to use" + ref: String + "The ID of the repository where the workflow is defined" + repositoryId: Int! + "The commit SHA of the workflow file to use" + sha: String +} + +"A workflow run." +type WorkflowRun implements Node & UniformResourceLocatable { + "The check suite this workflow run belongs to." + checkSuite: CheckSuite! + "Identifies the date and time when the object was created." + createdAt: DateTime! + "Identifies the primary key from the database." + databaseId: Int + "The log of deployment reviews" + deploymentReviews( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DeploymentReviewConnection! + "The event that triggered the workflow run" + event: String! + "The workflow file" + file: WorkflowRunFile + "The Node ID of the WorkflowRun object" + id: ID! + "The pending deployment requests of all check runs in this workflow run" + pendingDeploymentRequests( + "Returns the elements in the list that come after the specified cursor." + after: String, + "Returns the elements in the list that come before the specified cursor." + before: String, + "Returns the first _n_ elements from the list." + first: Int, + "Returns the last _n_ elements from the list." + last: Int + ): DeploymentRequestConnection! + "The HTTP path for this workflow run" + resourcePath: URI! + "A number that uniquely identifies this workflow run in its parent workflow." + runNumber: Int! + "Identifies the date and time when the object was last updated." + updatedAt: DateTime! + "The HTTP URL for this workflow run" + url: URI! + "The workflow executed in this workflow run." + workflow: Workflow! +} + +"The connection type for WorkflowRun." +type WorkflowRunConnection { + "A list of edges." + edges: [WorkflowRunEdge] + "A list of nodes." + nodes: [WorkflowRun] + "Information to aid in pagination." + pageInfo: PageInfo! + "Identifies the total count of items in the connection." + totalCount: Int! +} + +"An edge in a connection." +type WorkflowRunEdge { + "A cursor for use in pagination." + cursor: String! + "The item at the end of the edge." + node: WorkflowRun +} + +"An executed workflow file for a workflow run." +type WorkflowRunFile implements Node & UniformResourceLocatable { + "The Node ID of the WorkflowRunFile object" + id: ID! + "The path of the workflow file relative to its repository." + path: String! + "The direct link to the file in the repository which stores the workflow file." + repositoryFileUrl: URI! + "The repository name and owner which stores the workflow file." + repositoryName: URI! + "The HTTP path for this workflow run file" + resourcePath: URI! + "The parent workflow run execution for this file." + run: WorkflowRun! + "The HTTP URL for this workflow run file" + url: URI! + "If the viewer has permissions to push to the repository which stores the workflow." + viewerCanPushRepository: Boolean! + "If the viewer has permissions to read the repository which stores the workflow." + viewerCanReadRepository: Boolean! +} + +"Require all changes made to a targeted branch to pass the specified workflows before they can be merged." +type WorkflowsParameters { + "Allow repositories and branches to be created if a check would otherwise prohibit it." + doNotEnforceOnCreate: Boolean! + "Workflows that must pass for this rule to pass." + workflows: [WorkflowFileReference!]! +} + +"The actor's type." +enum ActorType { + "Indicates a team actor." + TEAM + "Indicates a user actor." + USER +} + +"Properties by which Audit Log connections can be ordered." +enum AuditLogOrderField { + "Order audit log entries by timestamp" + CREATED_AT +} + +"Represents an annotation's information level." +enum CheckAnnotationLevel { + "An annotation indicating an inescapable error." + FAILURE + "An annotation indicating some information." + NOTICE + "An annotation indicating an ignorable error." + WARNING +} + +"The possible states for a check suite or run conclusion." +enum CheckConclusionState { + "The check suite or run requires action." + ACTION_REQUIRED + "The check suite or run has been cancelled." + CANCELLED + "The check suite or run has failed." + FAILURE + "The check suite or run was neutral." + NEUTRAL + "The check suite or run was skipped." + SKIPPED + "The check suite or run was marked stale by GitHub. Only GitHub can use this conclusion." + STALE + "The check suite or run has failed at startup." + STARTUP_FAILURE + "The check suite or run has succeeded." + SUCCESS + "The check suite or run has timed out." + TIMED_OUT +} + +"The possible states of a check run in a status rollup." +enum CheckRunState { + "The check run requires action." + ACTION_REQUIRED + "The check run has been cancelled." + CANCELLED + "The check run has been completed." + COMPLETED + "The check run has failed." + FAILURE + "The check run is in progress." + IN_PROGRESS + "The check run was neutral." + NEUTRAL + "The check run is in pending state." + PENDING + "The check run has been queued." + QUEUED + "The check run was skipped." + SKIPPED + "The check run was marked stale by GitHub. Only GitHub can use this conclusion." + STALE + "The check run has failed at startup." + STARTUP_FAILURE + "The check run has succeeded." + SUCCESS + "The check run has timed out." + TIMED_OUT + "The check run is in waiting state." + WAITING +} + +"The possible types of check runs." +enum CheckRunType { + "Every check run available." + ALL + "The latest check run." + LATEST +} + +"The possible states for a check suite or run status." +enum CheckStatusState { + "The check suite or run has been completed." + COMPLETED + "The check suite or run is in progress." + IN_PROGRESS + "The check suite or run is in pending state." + PENDING + "The check suite or run has been queued." + QUEUED + "The check suite or run has been requested." + REQUESTED + "The check suite or run is in waiting state." + WAITING +} + +"Collaborators affiliation level with a subject." +enum CollaboratorAffiliation { + "All collaborators the authenticated user can see." + ALL + "All collaborators with permissions to an organization-owned subject, regardless of organization membership status." + DIRECT + "All outside collaborators of an organization-owned subject." + OUTSIDE +} + +"A comment author association with repository." +enum CommentAuthorAssociation { + "Author has been invited to collaborate on the repository." + COLLABORATOR + "Author has previously committed to the repository." + CONTRIBUTOR + "Author has not previously committed to GitHub." + FIRST_TIMER + "Author has not previously committed to the repository." + FIRST_TIME_CONTRIBUTOR + "Author is a placeholder for an unclaimed user." + MANNEQUIN + "Author is a member of the organization that owns the repository." + MEMBER + "Author has no association with the repository." + NONE + "Author is the owner of the repository." + OWNER +} + +"The possible errors that will prevent a user from updating a comment." +enum CommentCannotUpdateReason { + "Unable to create comment because repository is archived." + ARCHIVED + "You cannot update this comment" + DENIED + "You must be the author or have write access to this repository to update this comment." + INSUFFICIENT_ACCESS + "Unable to create comment because issue is locked." + LOCKED + "You must be logged in to update this comment." + LOGIN_REQUIRED + "Repository is under maintenance." + MAINTENANCE + "At least one email address must be verified to update this comment." + VERIFIED_EMAIL_REQUIRED +} + +"Properties by which commit contribution connections can be ordered." +enum CommitContributionOrderField { + "Order commit contributions by how many commits they represent." + COMMIT_COUNT + "Order commit contributions by when they were made." + OCCURRED_AT +} + +"The status of a git comparison between two refs." +enum ComparisonStatus { + "The head ref is ahead of the base ref." + AHEAD + "The head ref is behind the base ref." + BEHIND + "The head ref is both ahead and behind of the base ref, indicating git history has diverged." + DIVERGED + "The head ref and base ref are identical." + IDENTICAL +} + +"Varying levels of contributions from none to many." +enum ContributionLevel { + "Lowest 25% of days of contributions." + FIRST_QUARTILE + "Highest 25% of days of contributions. More contributions than the third quartile." + FOURTH_QUARTILE + "No contributions occurred." + NONE + "Second lowest 25% of days of contributions. More contributions than the first quartile." + SECOND_QUARTILE + "Second highest 25% of days of contributions. More contributions than second quartile, less than the fourth quartile." + THIRD_QUARTILE +} + +"The possible base permissions for repositories." +enum DefaultRepositoryPermissionField { + "Can read, write, and administrate repos by default" + ADMIN + "No access" + NONE + "Can read repos by default" + READ + "Can read and write repos by default" + WRITE +} + +"The possible ecosystems of a dependency graph package." +enum DependencyGraphEcosystem { + "GitHub Actions" + ACTIONS + "PHP packages hosted at packagist.org" + COMPOSER + "Go modules" + GO + "Java artifacts hosted at the Maven central repository" + MAVEN + "JavaScript packages hosted at npmjs.com" + NPM + ".NET packages hosted at the NuGet Gallery" + NUGET + "Python packages hosted at PyPI.org" + PIP + "Dart packages hosted at pub.dev" + PUB + "Ruby gems hosted at RubyGems.org" + RUBYGEMS + "Rust crates" + RUST + "Swift packages" + SWIFT +} + +"Properties by which deployment connections can be ordered." +enum DeploymentOrderField { + "Order collection by creation time" + CREATED_AT +} + +"The possible protection rule types." +enum DeploymentProtectionRuleType { + "Branch policy" + BRANCH_POLICY + "Required reviewers" + REQUIRED_REVIEWERS + "Wait timer" + WAIT_TIMER +} + +"The possible states for a deployment review." +enum DeploymentReviewState { + "The deployment was approved." + APPROVED + "The deployment was rejected." + REJECTED +} + +"The possible states in which a deployment can be." +enum DeploymentState { + "The pending deployment was not updated after 30 minutes." + ABANDONED + "The deployment is currently active." + ACTIVE + "An inactive transient deployment." + DESTROYED + "The deployment experienced an error." + ERROR + "The deployment has failed." + FAILURE + "The deployment is inactive." + INACTIVE + "The deployment is in progress." + IN_PROGRESS + "The deployment is pending." + PENDING + "The deployment has queued" + QUEUED + "The deployment was successful." + SUCCESS + "The deployment is waiting." + WAITING +} + +"The possible states for a deployment status." +enum DeploymentStatusState { + "The deployment experienced an error." + ERROR + "The deployment has failed." + FAILURE + "The deployment is inactive." + INACTIVE + "The deployment is in progress." + IN_PROGRESS + "The deployment is pending." + PENDING + "The deployment is queued" + QUEUED + "The deployment was successful." + SUCCESS + "The deployment is waiting." + WAITING +} + +"The possible sides of a diff." +enum DiffSide { + "The left side of the diff." + LEFT + "The right side of the diff." + RIGHT +} + +"The possible reasons for closing a discussion." +enum DiscussionCloseReason { + "The discussion is a duplicate of another" + DUPLICATE + "The discussion is no longer relevant" + OUTDATED + "The discussion has been resolved" + RESOLVED +} + +"Properties by which discussion connections can be ordered." +enum DiscussionOrderField { + "Order discussions by creation time." + CREATED_AT + "Order discussions by most recent modification time." + UPDATED_AT +} + +"Properties by which discussion poll option connections can be ordered." +enum DiscussionPollOptionOrderField { + "Order poll options by the order that the poll author specified when creating the poll." + AUTHORED_ORDER + "Order poll options by the number of votes it has." + VOTE_COUNT +} + +"The possible states of a discussion." +enum DiscussionState { + "A discussion that has been closed" + CLOSED + "A discussion that is open" + OPEN +} + +"The possible state reasons of a discussion." +enum DiscussionStateReason { + "The discussion is a duplicate of another" + DUPLICATE + "The discussion is no longer relevant" + OUTDATED + "The discussion was reopened" + REOPENED + "The discussion has been resolved" + RESOLVED +} + +"The possible reasons that a Dependabot alert was dismissed." +enum DismissReason { + "A fix has already been started" + FIX_STARTED + "This alert is inaccurate or incorrect" + INACCURATE + "Vulnerable code is not actually used" + NOT_USED + "No bandwidth to fix this" + NO_BANDWIDTH + "Risk is tolerable to this project" + TOLERABLE_RISK +} + +"Properties by which enterprise administrator invitation connections can be ordered." +enum EnterpriseAdministratorInvitationOrderField { + "Order enterprise administrator member invitations by creation time" + CREATED_AT +} + +"The possible administrator roles in an enterprise account." +enum EnterpriseAdministratorRole { + "Represents a billing manager of the enterprise account." + BILLING_MANAGER + "Represents an owner of the enterprise account." + OWNER + "Unaffiliated member of the enterprise account without an admin role." + UNAFFILIATED +} + +"The possible values for the enterprise allow private repository forking policy value." +enum EnterpriseAllowPrivateRepositoryForkingPolicyValue { + "Members can fork a repository to an organization within this enterprise." + ENTERPRISE_ORGANIZATIONS + "Members can fork a repository to their enterprise-managed user account or an organization inside this enterprise." + ENTERPRISE_ORGANIZATIONS_USER_ACCOUNTS + "Members can fork a repository to their user account or an organization, either inside or outside of this enterprise." + EVERYWHERE + "Members can fork a repository only within the same organization (intra-org)." + SAME_ORGANIZATION + "Members can fork a repository to their user account or within the same organization." + SAME_ORGANIZATION_USER_ACCOUNTS + "Members can fork a repository to their user account." + USER_ACCOUNTS +} + +"The possible values for the enterprise base repository permission setting." +enum EnterpriseDefaultRepositoryPermissionSettingValue { + "Organization members will be able to clone, pull, push, and add new collaborators to all organization repositories." + ADMIN + "Organization members will only be able to clone and pull public repositories." + NONE + "Organizations in the enterprise choose base repository permissions for their members." + NO_POLICY + "Organization members will be able to clone and pull all organization repositories." + READ + "Organization members will be able to clone, pull, and push all organization repositories." + WRITE +} + +"The possible values for an enabled/no policy enterprise setting." +enum EnterpriseDisallowedMethodsSettingValue { + "The setting prevents insecure 2FA methods from being used by members of the enterprise." + INSECURE + "There is no policy set for preventing insecure 2FA methods from being used by members of the enterprise." + NO_POLICY +} + +"The possible values for an enabled/disabled enterprise setting." +enum EnterpriseEnabledDisabledSettingValue { + "The setting is disabled for organizations in the enterprise." + DISABLED + "The setting is enabled for organizations in the enterprise." + ENABLED + "There is no policy set for organizations in the enterprise." + NO_POLICY +} + +"The possible values for an enabled/no policy enterprise setting." +enum EnterpriseEnabledSettingValue { + "The setting is enabled for organizations in the enterprise." + ENABLED + "There is no policy set for organizations in the enterprise." + NO_POLICY +} + +"Properties by which enterprise member invitation connections can be ordered." +enum EnterpriseMemberInvitationOrderField { + "Order enterprise member invitations by creation time" + CREATED_AT +} + +"Properties by which enterprise member connections can be ordered." +enum EnterpriseMemberOrderField { + "Order enterprise members by creation time" + CREATED_AT + "Order enterprise members by login" + LOGIN +} + +"The possible values for the enterprise members can create repositories setting." +enum EnterpriseMembersCanCreateRepositoriesSettingValue { + "Members will be able to create public and private repositories." + ALL + "Members will not be able to create public or private repositories." + DISABLED + "Organization owners choose whether to allow members to create repositories." + NO_POLICY + "Members will be able to create only private repositories." + PRIVATE + "Members will be able to create only public repositories." + PUBLIC +} + +"The possible values for the members can make purchases setting." +enum EnterpriseMembersCanMakePurchasesSettingValue { + "The setting is disabled for organizations in the enterprise." + DISABLED + "The setting is enabled for organizations in the enterprise." + ENABLED +} + +"The possible values we have for filtering Platform::Objects::User#enterprises." +enum EnterpriseMembershipType { + "Returns all enterprises in which the user is an admin." + ADMIN + "Returns all enterprises in which the user is a member, admin, or billing manager." + ALL + "Returns all enterprises in which the user is a billing manager." + BILLING_MANAGER + "Returns all enterprises in which the user is a member of an org that is owned by the enterprise." + ORG_MEMBERSHIP +} + +"Properties by which enterprise connections can be ordered." +enum EnterpriseOrderField { + "Order enterprises by name" + NAME +} + +"Properties by which Enterprise Server installation connections can be ordered." +enum EnterpriseServerInstallationOrderField { + "Order Enterprise Server installations by creation time" + CREATED_AT + "Order Enterprise Server installations by customer name" + CUSTOMER_NAME + "Order Enterprise Server installations by host name" + HOST_NAME +} + +"Properties by which Enterprise Server user account email connections can be ordered." +enum EnterpriseServerUserAccountEmailOrderField { + "Order emails by email" + EMAIL +} + +"Properties by which Enterprise Server user account connections can be ordered." +enum EnterpriseServerUserAccountOrderField { + "Order user accounts by login" + LOGIN + "Order user accounts by creation time on the Enterprise Server installation" + REMOTE_CREATED_AT +} + +"Properties by which Enterprise Server user accounts upload connections can be ordered." +enum EnterpriseServerUserAccountsUploadOrderField { + "Order user accounts uploads by creation time" + CREATED_AT +} + +"Synchronization state of the Enterprise Server user accounts upload" +enum EnterpriseServerUserAccountsUploadSyncState { + "The synchronization of the upload failed." + FAILURE + "The synchronization of the upload is pending." + PENDING + "The synchronization of the upload succeeded." + SUCCESS +} + +"The possible roles for enterprise membership." +enum EnterpriseUserAccountMembershipRole { + "The user is a member of an organization in the enterprise." + MEMBER + "The user is an owner of an organization in the enterprise." + OWNER + "The user is not an owner of the enterprise, and not a member or owner of any organizations in the enterprise; only for EMU-enabled enterprises." + UNAFFILIATED +} + +"The possible GitHub Enterprise deployments where this user can exist." +enum EnterpriseUserDeployment { + "The user is part of a GitHub Enterprise Cloud deployment." + CLOUD + "The user is part of a GitHub Enterprise Server deployment." + SERVER +} + +"Properties by which environments connections can be ordered" +enum EnvironmentOrderField { + "Order environments by name." + NAME +} + +"Properties by which environments connections can be ordered" +enum EnvironmentPinnedFilterField { + "All environments will be returned." + ALL + "Environments exclude pinned will be returned" + NONE + "Only pinned environment will be returned" + ONLY +} + +"The possible viewed states of a file ." +enum FileViewedState { + "The file has new changes since last viewed." + DISMISSED + "The file has not been marked as viewed." + UNVIEWED + "The file has been marked as viewed." + VIEWED +} + +"The possible funding platforms for repository funding links." +enum FundingPlatform { + "Buy Me a Coffee funding platform." + BUY_ME_A_COFFEE + "Community Bridge funding platform." + COMMUNITY_BRIDGE + "Custom funding platform." + CUSTOM + "GitHub funding platform." + GITHUB + "IssueHunt funding platform." + ISSUEHUNT + "Ko-fi funding platform." + KO_FI + "LFX Crowdfunding funding platform." + LFX_CROWDFUNDING + "Liberapay funding platform." + LIBERAPAY + "Open Collective funding platform." + OPEN_COLLECTIVE + "Patreon funding platform." + PATREON + "Polar funding platform." + POLAR + "thanks.dev funding platform." + THANKS_DEV + "Tidelift funding platform." + TIDELIFT +} + +"Properties by which gist connections can be ordered." +enum GistOrderField { + "Order gists by creation time" + CREATED_AT + "Order gists by push time" + PUSHED_AT + "Order gists by update time" + UPDATED_AT +} + +"The privacy of a Gist" +enum GistPrivacy { + "Gists that are public and secret" + ALL + "Public" + PUBLIC + "Secret" + SECRET +} + +"The state of a Git signature." +enum GitSignatureState { + "The signing certificate or its chain could not be verified" + BAD_CERT + "Invalid email used for signing" + BAD_EMAIL + "Signing key expired" + EXPIRED_KEY + "Internal error - the GPG verification service misbehaved" + GPGVERIFY_ERROR + "Internal error - the GPG verification service is unavailable at the moment" + GPGVERIFY_UNAVAILABLE + "Invalid signature" + INVALID + "Malformed signature" + MALFORMED_SIG + "The usage flags for the key that signed this don't allow signing" + NOT_SIGNING_KEY + "Email used for signing not known to GitHub" + NO_USER + "Valid signature, though certificate revocation check failed" + OCSP_ERROR + "Valid signature, pending certificate revocation checking" + OCSP_PENDING + "One or more certificates in chain has been revoked" + OCSP_REVOKED + "Key used for signing not known to GitHub" + UNKNOWN_KEY + "Unknown signature type" + UNKNOWN_SIG_TYPE + "Unsigned" + UNSIGNED + "Email used for signing unverified on GitHub" + UNVERIFIED_EMAIL + "Valid signature and verified by GitHub" + VALID +} + +"The possible states in which authentication can be configured with an identity provider." +enum IdentityProviderConfigurationState { + "Authentication with an identity provider is configured but not enforced." + CONFIGURED + "Authentication with an identity provider is configured and enforced." + ENFORCED + "Authentication with an identity provider is not configured." + UNCONFIGURED +} + +"The possible values for the IP allow list enabled setting." +enum IpAllowListEnabledSettingValue { + "The setting is disabled for the owner." + DISABLED + "The setting is enabled for the owner." + ENABLED +} + +"Properties by which IP allow list entry connections can be ordered." +enum IpAllowListEntryOrderField { + "Order IP allow list entries by the allow list value." + ALLOW_LIST_VALUE + "Order IP allow list entries by creation time." + CREATED_AT +} + +"The possible values for the IP allow list configuration for installed GitHub Apps setting." +enum IpAllowListForInstalledAppsEnabledSettingValue { + "The setting is disabled for the owner." + DISABLED + "The setting is enabled for the owner." + ENABLED +} + +"The possible state reasons of a closed issue." +enum IssueClosedStateReason { + "An issue that has been closed as completed" + COMPLETED + "An issue that has been closed as a duplicate" + DUPLICATE + "An issue that has been closed as not planned" + NOT_PLANNED +} + +"Properties by which issue comment connections can be ordered." +enum IssueCommentOrderField { + "Order issue comments by update time" + UPDATED_AT +} + +"Properties by which issue dependencies can be ordered." +enum IssueDependencyOrderField { + "Order issue dependencies by the creation time of the dependent issue" + CREATED_AT + "Order issue dependencies by time of when the dependency relationship was added" + DEPENDENCY_ADDED_AT +} + +"Properties by which issue connections can be ordered." +enum IssueOrderField { + "Order issues by comment count" + COMMENTS + "Order issues by creation time" + CREATED_AT + "Order issues by update time" + UPDATED_AT +} + +"The possible states of an issue." +enum IssueState { + "An issue that has been closed" + CLOSED + "An issue that is still open" + OPEN +} + +"The possible state reasons of an issue." +enum IssueStateReason { + "An issue that has been closed as completed" + COMPLETED + "An issue that has been closed as a duplicate." + DUPLICATE + "An issue that has been closed as not planned" + NOT_PLANNED + "An issue that has been reopened" + REOPENED +} + +"The possible item types found in a timeline." +enum IssueTimelineItemsItemType { + "Represents a 'added_to_project' event on a given issue or pull request." + ADDED_TO_PROJECT_EVENT + "Represents an 'assigned' event on any assignable object." + ASSIGNED_EVENT + "Represents a 'blocked_by_added' event on a given issue." + BLOCKED_BY_ADDED_EVENT + "Represents a 'blocked_by_removed' event on a given issue." + BLOCKED_BY_REMOVED_EVENT + "Represents a 'blocking_added' event on a given issue." + BLOCKING_ADDED_EVENT + "Represents a 'blocking_removed' event on a given issue." + BLOCKING_REMOVED_EVENT + "Represents a 'closed' event on any `Closable`." + CLOSED_EVENT + "Represents a 'comment_deleted' event on a given issue or pull request." + COMMENT_DELETED_EVENT + "Represents a 'connected' event on a given issue or pull request." + CONNECTED_EVENT + "Represents a 'converted_note_to_issue' event on a given issue or pull request." + CONVERTED_NOTE_TO_ISSUE_EVENT + "Represents a 'converted_to_discussion' event on a given issue." + CONVERTED_TO_DISCUSSION_EVENT + "Represents a mention made by one issue or pull request to another." + CROSS_REFERENCED_EVENT + "Represents a 'demilestoned' event on a given issue or pull request." + DEMILESTONED_EVENT + "Represents a 'disconnected' event on a given issue or pull request." + DISCONNECTED_EVENT + "Represents a comment on an Issue." + ISSUE_COMMENT + "Represents a 'issue_type_added' event on a given issue." + ISSUE_TYPE_ADDED_EVENT + "Represents a 'issue_type_changed' event on a given issue." + ISSUE_TYPE_CHANGED_EVENT + "Represents a 'issue_type_removed' event on a given issue." + ISSUE_TYPE_REMOVED_EVENT + "Represents a 'labeled' event on a given issue or pull request." + LABELED_EVENT + "Represents a 'locked' event on a given issue or pull request." + LOCKED_EVENT + "Represents a 'marked_as_duplicate' event on a given issue or pull request." + MARKED_AS_DUPLICATE_EVENT + "Represents a 'mentioned' event on a given issue or pull request." + MENTIONED_EVENT + "Represents a 'milestoned' event on a given issue or pull request." + MILESTONED_EVENT + "Represents a 'moved_columns_in_project' event on a given issue or pull request." + MOVED_COLUMNS_IN_PROJECT_EVENT + "Represents a 'parent_issue_added' event on a given issue." + PARENT_ISSUE_ADDED_EVENT + "Represents a 'parent_issue_removed' event on a given issue." + PARENT_ISSUE_REMOVED_EVENT + "Represents a 'pinned' event on a given issue or pull request." + PINNED_EVENT + "Represents a 'referenced' event on a given `ReferencedSubject`." + REFERENCED_EVENT + "Represents a 'removed_from_project' event on a given issue or pull request." + REMOVED_FROM_PROJECT_EVENT + "Represents a 'renamed' event on a given issue or pull request" + RENAMED_TITLE_EVENT + "Represents a 'reopened' event on any `Closable`." + REOPENED_EVENT + "Represents a 'subscribed' event on a given `Subscribable`." + SUBSCRIBED_EVENT + "Represents a 'sub_issue_added' event on a given issue." + SUB_ISSUE_ADDED_EVENT + "Represents a 'sub_issue_removed' event on a given issue." + SUB_ISSUE_REMOVED_EVENT + "Represents a 'transferred' event on a given issue or pull request." + TRANSFERRED_EVENT + "Represents an 'unassigned' event on any assignable object." + UNASSIGNED_EVENT + "Represents an 'unlabeled' event on a given issue or pull request." + UNLABELED_EVENT + "Represents an 'unlocked' event on a given issue or pull request." + UNLOCKED_EVENT + "Represents an 'unmarked_as_duplicate' event on a given issue or pull request." + UNMARKED_AS_DUPLICATE_EVENT + "Represents an 'unpinned' event on a given issue or pull request." + UNPINNED_EVENT + "Represents an 'unsubscribed' event on a given `Subscribable`." + UNSUBSCRIBED_EVENT + "Represents a 'user_blocked' event on a given user." + USER_BLOCKED_EVENT +} + +"The possible color for an issue type" +enum IssueTypeColor { + "blue" + BLUE + "gray" + GRAY + "green" + GREEN + "orange" + ORANGE + "pink" + PINK + "purple" + PURPLE + "red" + RED + "yellow" + YELLOW +} + +"Properties by which issue type connections can be ordered." +enum IssueTypeOrderField { + "Order issue types by creation time" + CREATED_AT + "Order issue types by name" + NAME +} + +"Properties by which label connections can be ordered." +enum LabelOrderField { + "Order labels by creation time" + CREATED_AT + "Order labels by issue count" + ISSUE_COUNT + "Order labels by name " + NAME +} + +"Properties by which language connections can be ordered." +enum LanguageOrderField { + "Order languages by the size of all files containing the language" + SIZE +} + +"The possible reasons that an issue or pull request was locked." +enum LockReason { + "The issue or pull request was locked because the conversation was off-topic." + OFF_TOPIC + "The issue or pull request was locked because the conversation was resolved." + RESOLVED + "The issue or pull request was locked because the conversation was spam." + SPAM + "The issue or pull request was locked because the conversation was too heated." + TOO_HEATED +} + +"Properties by which mannequins can be ordered." +enum MannequinOrderField { + "Order mannequins why when they were created." + CREATED_AT + "Order mannequins alphabetically by their source login." + LOGIN +} + +"The possible default commit messages for merges." +enum MergeCommitMessage { + "Default to a blank commit message." + BLANK + "Default to the pull request's body." + PR_BODY + "Default to the pull request's title." + PR_TITLE +} + +"The possible default commit titles for merges." +enum MergeCommitTitle { + "Default to the classic title for a merge message (e.g., Merge pull request #123 from branch-name)." + MERGE_MESSAGE + "Default to the pull request's title." + PR_TITLE +} + +"The possible states for a merge queue entry." +enum MergeQueueEntryState { + "The entry is currently waiting for checks to pass." + AWAITING_CHECKS + "The entry is currently locked." + LOCKED + "The entry is currently mergeable." + MERGEABLE + "The entry is currently queued." + QUEUED + "The entry is currently unmergeable." + UNMERGEABLE +} + +"When set to ALLGREEN, the merge commit created by merge queue for each PR in the group must pass all required checks to merge. When set to HEADGREEN, only the commit at the head of the merge group, i.e. the commit containing changes from all of the PRs in the group, must pass its required checks to merge." +enum MergeQueueGroupingStrategy { + "The merge commit created by merge queue for each PR in the group must pass all required checks to merge" + ALLGREEN + "Only the commit at the head of the merge group must pass its required checks to merge." + HEADGREEN +} + +"Method to use when merging changes from queued pull requests." +enum MergeQueueMergeMethod { + "Merge commit" + MERGE + "Rebase and merge" + REBASE + "Squash and merge" + SQUASH +} + +"The possible merging strategies for a merge queue." +enum MergeQueueMergingStrategy { + "Entries only allowed to merge if they are passing." + ALLGREEN + "Failing Entires are allowed to merge if they are with a passing entry." + HEADGREEN +} + +"Detailed status information about a pull request merge." +enum MergeStateStatus { + "The head ref is out of date." + BEHIND + "The merge is blocked." + BLOCKED + "Mergeable and passing commit status." + CLEAN + "The merge commit cannot be cleanly created." + DIRTY + "The merge is blocked due to the pull request being a draft." + DRAFT @deprecated(reason: "DRAFT state will be removed from this enum and `isDraft` should be used instead Use PullRequest.isDraft instead. Removal on 2021-01-01 UTC.") + "Mergeable with passing commit status and pre-receive hooks." + HAS_HOOKS + "The state cannot currently be determined." + UNKNOWN + "Mergeable with non-passing commit status." + UNSTABLE +} + +"Whether or not a PullRequest can be merged." +enum MergeableState { + "The pull request cannot be merged due to merge conflicts." + CONFLICTING + "The pull request can be merged." + MERGEABLE + "The mergeability of the pull request is still being calculated." + UNKNOWN +} + +"Represents the different GitHub Enterprise Importer (GEI) migration sources." +enum MigrationSourceType { + "An Azure DevOps migration source." + AZURE_DEVOPS + "A Bitbucket Server migration source." + BITBUCKET_SERVER + "A GitHub Migration API source." + GITHUB_ARCHIVE +} + +"The GitHub Enterprise Importer (GEI) migration state." +enum MigrationState { + "The migration has failed." + FAILED + "The migration has invalid credentials." + FAILED_VALIDATION + "The migration is in progress." + IN_PROGRESS + "The migration has not started." + NOT_STARTED + "The migration needs to have its credentials validated." + PENDING_VALIDATION + "The migration has been queued." + QUEUED + "The migration has succeeded." + SUCCEEDED +} + +"Properties by which milestone connections can be ordered." +enum MilestoneOrderField { + "Order milestones by when they were created." + CREATED_AT + "Order milestones by when they are due." + DUE_DATE + "Order milestones by their number." + NUMBER + "Order milestones by when they were last updated." + UPDATED_AT +} + +"The possible states of a milestone." +enum MilestoneState { + "A milestone that has been closed." + CLOSED + "A milestone that is still open." + OPEN +} + +"The possible values for the notification restriction setting." +enum NotificationRestrictionSettingValue { + "The setting is disabled for the owner." + DISABLED + "The setting is enabled for the owner." + ENABLED +} + +"The OIDC identity provider type" +enum OIDCProviderType { + "Azure Active Directory" + AAD +} + +"The state of an OAuth application when it was created." +enum OauthApplicationCreateAuditEntryState { + "The OAuth application was active and allowed to have OAuth Accesses." + ACTIVE + "The OAuth application was in the process of being deleted." + PENDING_DELETION + "The OAuth application was suspended from generating OAuth Accesses due to abuse or security concerns." + SUSPENDED +} + +"The corresponding operation type for the action" +enum OperationType { + "An existing resource was accessed" + ACCESS + "A resource performed an authentication event" + AUTHENTICATION + "A new resource was created" + CREATE + "An existing resource was modified" + MODIFY + "An existing resource was removed" + REMOVE + "An existing resource was restored" + RESTORE + "An existing resource was transferred between multiple resources" + TRANSFER +} + +"Possible directions in which to order a list of items when provided an `orderBy` argument." +enum OrderDirection { + "Specifies an ascending order for a given `orderBy` argument." + ASC + "Specifies a descending order for a given `orderBy` argument." + DESC +} + +"The permissions available to members on an Organization." +enum OrgAddMemberAuditEntryPermission { + "Can read, clone, push, and add collaborators to repositories." + ADMIN + "Can read and clone repositories." + READ +} + +"The billing plans available for organizations." +enum OrgCreateAuditEntryBillingPlan { + "Team Plan" + BUSINESS + "Enterprise Cloud Plan" + BUSINESS_PLUS + "Free Plan" + FREE + "Tiered Per Seat Plan" + TIERED_PER_SEAT + "Legacy Unlimited Plan" + UNLIMITED +} + +"Properties by which enterprise owners can be ordered." +enum OrgEnterpriseOwnerOrderField { + "Order enterprise owners by login." + LOGIN +} + +"The reason a billing manager was removed from an Organization." +enum OrgRemoveBillingManagerAuditEntryReason { + "SAML external identity missing" + SAML_EXTERNAL_IDENTITY_MISSING + "SAML SSO enforcement requires an external identity" + SAML_SSO_ENFORCEMENT_REQUIRES_EXTERNAL_IDENTITY + "The organization required 2FA of its billing managers and this user did not have 2FA enabled." + TWO_FACTOR_REQUIREMENT_NON_COMPLIANCE +} + +"The type of membership a user has with an Organization." +enum OrgRemoveMemberAuditEntryMembershipType { + "Organization owners have full access and can change several settings, including the names of repositories that belong to the Organization and Owners team membership. In addition, organization owners can delete the organization and all of its repositories." + ADMIN + "A billing manager is a user who manages the billing settings for the Organization, such as updating payment information." + BILLING_MANAGER + "A direct member is a user that is a member of the Organization." + DIRECT_MEMBER + "An outside collaborator is a person who isn't explicitly a member of the Organization, but who has Read, Write, or Admin permissions to one or more repositories in the organization." + OUTSIDE_COLLABORATOR + "A suspended member." + SUSPENDED + "An unaffiliated collaborator is a person who is not a member of the Organization and does not have access to any repositories in the Organization." + UNAFFILIATED +} + +"The reason a member was removed from an Organization." +enum OrgRemoveMemberAuditEntryReason { + "SAML external identity missing" + SAML_EXTERNAL_IDENTITY_MISSING + "SAML SSO enforcement requires an external identity" + SAML_SSO_ENFORCEMENT_REQUIRES_EXTERNAL_IDENTITY + "User was removed from organization during account recovery" + TWO_FACTOR_ACCOUNT_RECOVERY + "The organization required 2FA of its billing managers and this user did not have 2FA enabled." + TWO_FACTOR_REQUIREMENT_NON_COMPLIANCE + "User account has been deleted" + USER_ACCOUNT_DELETED +} + +"The type of membership a user has with an Organization." +enum OrgRemoveOutsideCollaboratorAuditEntryMembershipType { + "A billing manager is a user who manages the billing settings for the Organization, such as updating payment information." + BILLING_MANAGER + "An outside collaborator is a person who isn't explicitly a member of the Organization, but who has Read, Write, or Admin permissions to one or more repositories in the organization." + OUTSIDE_COLLABORATOR + "An unaffiliated collaborator is a person who is not a member of the Organization and does not have access to any repositories in the organization." + UNAFFILIATED +} + +"The reason an outside collaborator was removed from an Organization." +enum OrgRemoveOutsideCollaboratorAuditEntryReason { + "SAML external identity missing" + SAML_EXTERNAL_IDENTITY_MISSING + "The organization required 2FA of its billing managers and this user did not have 2FA enabled." + TWO_FACTOR_REQUIREMENT_NON_COMPLIANCE +} + +"The default permission a repository can have in an Organization." +enum OrgUpdateDefaultRepositoryPermissionAuditEntryPermission { + "Can read, clone, push, and add collaborators to repositories." + ADMIN + "No default permission value." + NONE + "Can read and clone repositories." + READ + "Can read, clone and push to repositories." + WRITE +} + +"The permissions available to members on an Organization." +enum OrgUpdateMemberAuditEntryPermission { + "Can read, clone, push, and add collaborators to repositories." + ADMIN + "Can read and clone repositories." + READ +} + +"The permissions available for repository creation on an Organization." +enum OrgUpdateMemberRepositoryCreationPermissionAuditEntryVisibility { + "All organization members are restricted from creating any repositories." + ALL + "All organization members are restricted from creating internal repositories." + INTERNAL + "All organization members are allowed to create any repositories." + NONE + "All organization members are restricted from creating private repositories." + PRIVATE + "All organization members are restricted from creating private or internal repositories." + PRIVATE_INTERNAL + "All organization members are restricted from creating public repositories." + PUBLIC + "All organization members are restricted from creating public or internal repositories." + PUBLIC_INTERNAL + "All organization members are restricted from creating public or private repositories." + PUBLIC_PRIVATE +} + +"The possible organization invitation roles." +enum OrganizationInvitationRole { + "The user is invited to be an admin of the organization." + ADMIN + "The user is invited to be a billing manager of the organization." + BILLING_MANAGER + "The user is invited to be a direct member of the organization." + DIRECT_MEMBER + "The user's previous role will be reinstated." + REINSTATE +} + +"The possible organization invitation sources." +enum OrganizationInvitationSource { + "The invitation was created from the web interface or from API" + MEMBER + "The invitation was created from SCIM" + SCIM + "The invitation was sent before this feature was added" + UNKNOWN +} + +"The possible organization invitation types." +enum OrganizationInvitationType { + "The invitation was to an email address." + EMAIL + "The invitation was to an existing user." + USER +} + +"The possible roles within an organization for its members." +enum OrganizationMemberRole { + "The user is an administrator of the organization." + ADMIN + "The user is a member of the organization." + MEMBER +} + +"The possible values for the members can create repositories setting on an organization." +enum OrganizationMembersCanCreateRepositoriesSettingValue { + "Members will be able to create public and private repositories." + ALL + "Members will not be able to create public or private repositories." + DISABLED + "Members will be able to create only internal repositories." + INTERNAL + "Members will be able to create only private repositories." + PRIVATE +} + +"The Octoshift Organization migration state." +enum OrganizationMigrationState { + "The Octoshift migration has failed." + FAILED + "The Octoshift migration has invalid credentials." + FAILED_VALIDATION + "The Octoshift migration is in progress." + IN_PROGRESS + "The Octoshift migration has not started." + NOT_STARTED + "The Octoshift migration needs to have its credentials validated." + PENDING_VALIDATION + "The Octoshift migration is performing post repository migrations." + POST_REPO_MIGRATION + "The Octoshift migration is performing pre repository migrations." + PRE_REPO_MIGRATION + "The Octoshift migration has been queued." + QUEUED + "The Octoshift org migration is performing repository migrations." + REPO_MIGRATION + "The Octoshift migration has succeeded." + SUCCEEDED +} + +"Properties by which organization connections can be ordered." +enum OrganizationOrderField { + "Order organizations by creation time" + CREATED_AT + "Order organizations by login" + LOGIN +} + +"Properties by which package file connections can be ordered." +enum PackageFileOrderField { + "Order package files by creation time" + CREATED_AT +} + +"Properties by which package connections can be ordered." +enum PackageOrderField { + "Order packages by creation time" + CREATED_AT +} + +"The possible types of a package." +enum PackageType { + "A debian package." + DEBIAN + "A docker image." + DOCKER @deprecated(reason: "DOCKER will be removed from this enum as this type will be migrated to only be used by the Packages REST API. Removal on 2021-06-21 UTC.") + "A maven package." + MAVEN @deprecated(reason: "MAVEN will be removed from this enum as this type will be migrated to only be used by the Packages REST API. Removal on 2023-02-10 UTC.") + "An npm package." + NPM @deprecated(reason: "NPM will be removed from this enum as this type will be migrated to only be used by the Packages REST API. Removal on 2022-11-21 UTC.") + "A nuget package." + NUGET @deprecated(reason: "NUGET will be removed from this enum as this type will be migrated to only be used by the Packages REST API. Removal on 2022-11-21 UTC.") + "A python package." + PYPI + "A rubygems package." + RUBYGEMS @deprecated(reason: "RUBYGEMS will be removed from this enum as this type will be migrated to only be used by the Packages REST API. Removal on 2022-12-28 UTC.") +} + +"Properties by which package version connections can be ordered." +enum PackageVersionOrderField { + "Order package versions by creation time" + CREATED_AT +} + +"The possible types of patch statuses." +enum PatchStatus { + "The file was added. Git status 'A'." + ADDED + "The file's type was changed. Git status 'T'." + CHANGED + "The file was copied. Git status 'C'." + COPIED + "The file was deleted. Git status 'D'." + DELETED + "The file's contents were changed. Git status 'M'." + MODIFIED + "The file was renamed. Git status 'R'." + RENAMED +} + +"Represents items that can be pinned to a profile page or dashboard." +enum PinnableItemType { + "A gist." + GIST + "An issue." + ISSUE + "An organization." + ORGANIZATION + "A project." + PROJECT + "A pull request." + PULL_REQUEST + "A repository." + REPOSITORY + "A team." + TEAM + "A user." + USER +} + +"Preconfigured gradients that may be used to style discussions pinned within a repository." +enum PinnedDiscussionGradient { + "A gradient of blue to mint" + BLUE_MINT + "A gradient of blue to purple" + BLUE_PURPLE + "A gradient of pink to blue" + PINK_BLUE + "A gradient of purple to coral" + PURPLE_CORAL + "A gradient of red to orange" + RED_ORANGE +} + +"Preconfigured background patterns that may be used to style discussions pinned within a repository." +enum PinnedDiscussionPattern { + "An upward-facing chevron pattern" + CHEVRON_UP + "A hollow dot pattern" + DOT + "A solid dot pattern" + DOT_FILL + "A heart pattern" + HEART_FILL + "A plus sign pattern" + PLUS + "A lightning bolt pattern" + ZAP +} + +"Properties by which pinned environments connections can be ordered" +enum PinnedEnvironmentOrderField { + "Order pinned environments by position" + POSITION +} + +"The possible archived states of a project card." +enum ProjectCardArchivedState { + "A project card that is archived" + ARCHIVED @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") + "A project card that is not archived" + NOT_ARCHIVED @deprecated(reason: "Projects (classic) is being deprecated in favor of the new Projects experience, see: https://github.blog/changelog/2024-05-23-sunset-notice-projects-classic/. Removal on 2025-04-01 UTC.") +} + +"Various content states of a ProjectCard" +enum ProjectCardState { + "The card has content only." + CONTENT_ONLY + "The card has a note only." + NOTE_ONLY + "The card is redacted." + REDACTED +} + +"The semantic purpose of the column - todo, in progress, or done." +enum ProjectColumnPurpose { + "The column contains cards which are complete" + DONE + "The column contains cards which are currently being worked on" + IN_PROGRESS + "The column contains cards still to be worked on" + TODO +} + +"Properties by which project connections can be ordered." +enum ProjectOrderField { + "Order projects by creation time" + CREATED_AT + "Order projects by name" + NAME + "Order projects by update time" + UPDATED_AT +} + +"State of the project; either 'open' or 'closed'" +enum ProjectState { + "The project is closed." + CLOSED + "The project is open." + OPEN +} + +"GitHub-provided templates for Projects" +enum ProjectTemplate { + "Create a board with v2 triggers to automatically move cards across To do, In progress and Done columns." + AUTOMATED_KANBAN_V2 + "Create a board with triggers to automatically move cards across columns with review automation." + AUTOMATED_REVIEWS_KANBAN + "Create a board with columns for To do, In progress and Done." + BASIC_KANBAN + "Create a board to triage and prioritize bugs with To do, priority, and Done columns." + BUG_TRIAGE +} + +"The type of a project field." +enum ProjectV2CustomFieldType { + "Date" + DATE + "Iteration" + ITERATION + "Number" + NUMBER + "Single Select" + SINGLE_SELECT + "Text" + TEXT +} + +"Properties by which project v2 field connections can be ordered." +enum ProjectV2FieldOrderField { + "Order project v2 fields by creation time" + CREATED_AT + "Order project v2 fields by name" + NAME + "Order project v2 fields by position" + POSITION +} + +"The type of a project field." +enum ProjectV2FieldType { + "Assignees" + ASSIGNEES + "Date" + DATE + "Issue type" + ISSUE_TYPE + "Iteration" + ITERATION + "Labels" + LABELS + "Linked Pull Requests" + LINKED_PULL_REQUESTS + "Milestone" + MILESTONE + "Number" + NUMBER + "Parent issue" + PARENT_ISSUE + "Repository" + REPOSITORY + "Reviewers" + REVIEWERS + "Single Select" + SINGLE_SELECT + "Sub-issues progress" + SUB_ISSUES_PROGRESS + "Text" + TEXT + "Title" + TITLE + "Tracked by" + TRACKED_BY + "Tracks" + TRACKS +} + +"Properties by which project v2 item field value connections can be ordered." +enum ProjectV2ItemFieldValueOrderField { + "Order project v2 item field values by the their position in the project" + POSITION +} + +"Properties by which project v2 item connections can be ordered." +enum ProjectV2ItemOrderField { + "Order project v2 items by the their position in the project" + POSITION +} + +"The type of a project item." +enum ProjectV2ItemType { + "Draft Issue" + DRAFT_ISSUE + "Issue" + ISSUE + "Pull Request" + PULL_REQUEST + "Redacted Item" + REDACTED +} + +"Properties by which projects can be ordered." +enum ProjectV2OrderField { + "The project's date and time of creation" + CREATED_AT + "The project's number" + NUMBER + "The project's title" + TITLE + "The project's date and time of update" + UPDATED_AT +} + +"The possible roles of a collaborator on a project." +enum ProjectV2PermissionLevel { + "The collaborator can view, edit, and maange the settings of the project" + ADMIN + "The collaborator can view the project" + READ + "The collaborator can view and edit the project" + WRITE +} + +"The possible roles of a collaborator on a project." +enum ProjectV2Roles { + "The collaborator can view, edit, and maange the settings of the project" + ADMIN + "The collaborator has no direct access to the project" + NONE + "The collaborator can view the project" + READER + "The collaborator can view and edit the project" + WRITER +} + +"The display color of a single-select field option." +enum ProjectV2SingleSelectFieldOptionColor { + "BLUE" + BLUE + "GRAY" + GRAY + "GREEN" + GREEN + "ORANGE" + ORANGE + "PINK" + PINK + "PURPLE" + PURPLE + "RED" + RED + "YELLOW" + YELLOW +} + +"The possible states of a project v2." +enum ProjectV2State { + "A project v2 that has been closed" + CLOSED + "A project v2 that is still open" + OPEN +} + +"Properties by which project v2 status updates can be ordered." +enum ProjectV2StatusUpdateOrderField { + "Allows chronological ordering of project v2 status updates." + CREATED_AT +} + +"The possible statuses of a project v2." +enum ProjectV2StatusUpdateStatus { + "A project v2 that is at risk and encountering some challenges." + AT_RISK + "A project v2 that is complete." + COMPLETE + "A project v2 that is inactive." + INACTIVE + "A project v2 that is off track and needs attention." + OFF_TRACK + "A project v2 that is on track with no risks." + ON_TRACK +} + +"The layout of a project v2 view." +enum ProjectV2ViewLayout { + "Board layout" + BOARD_LAYOUT + "Roadmap layout" + ROADMAP_LAYOUT + "Table layout" + TABLE_LAYOUT +} + +"Properties by which project v2 view connections can be ordered." +enum ProjectV2ViewOrderField { + "Order project v2 views by creation time" + CREATED_AT + "Order project v2 views by name" + NAME + "Order project v2 views by position" + POSITION +} + +"Properties by which project workflows can be ordered." +enum ProjectV2WorkflowsOrderField { + "The date and time of the workflow creation" + CREATED_AT + "The name of the workflow" + NAME + "The number of the workflow" + NUMBER + "The date and time of the workflow update" + UPDATED_AT +} + +"Array of allowed merge methods. Allowed values include `merge`, `squash`, and `rebase`. At least one option must be enabled." +enum PullRequestAllowedMergeMethods { + "Add all commits from the head branch to the base branch with a merge commit." + MERGE + "Add all commits from the head branch onto the base branch individually." + REBASE + "Combine all commits from the head branch into a single commit in the base branch." + SQUASH +} + +"The possible methods for updating a pull request's head branch with the base branch." +enum PullRequestBranchUpdateMethod { + "Update branch via merge" + MERGE + "Update branch via rebase" + REBASE +} + +"Represents available types of methods to use when merging a pull request." +enum PullRequestMergeMethod { + "Add all commits from the head branch to the base branch with a merge commit." + MERGE + "Add all commits from the head branch onto the base branch individually." + REBASE + "Combine all commits from the head branch into a single commit in the base branch." + SQUASH +} + +"Properties by which pull_requests connections can be ordered." +enum PullRequestOrderField { + "Order pull_requests by creation time" + CREATED_AT + "Order pull_requests by update time" + UPDATED_AT +} + +"The possible states of a pull request review comment." +enum PullRequestReviewCommentState { + "A comment that is part of a pending review" + PENDING + "A comment that is part of a submitted review" + SUBMITTED +} + +"The review status of a pull request." +enum PullRequestReviewDecision { + "The pull request has received an approving review." + APPROVED + "Changes have been requested on the pull request." + CHANGES_REQUESTED + "A review is required before the pull request can be merged." + REVIEW_REQUIRED +} + +"The possible events to perform on a pull request review." +enum PullRequestReviewEvent { + "Submit feedback and approve merging these changes." + APPROVE + "Submit general feedback without explicit approval." + COMMENT + "Dismiss review so it now longer effects merging." + DISMISS + "Submit feedback that must be addressed before merging." + REQUEST_CHANGES +} + +"The possible states of a pull request review." +enum PullRequestReviewState { + "A review allowing the pull request to merge." + APPROVED + "A review blocking the pull request from merging." + CHANGES_REQUESTED + "An informational review." + COMMENTED + "A review that has been dismissed." + DISMISSED + "A review that has not yet been submitted." + PENDING +} + +"The possible subject types of a pull request review comment." +enum PullRequestReviewThreadSubjectType { + "A comment that has been made against the file of a pull request" + FILE + "A comment that has been made against the line of a pull request" + LINE +} + +"The possible states of a pull request." +enum PullRequestState { + "A pull request that has been closed without being merged." + CLOSED + "A pull request that has been closed by being merged." + MERGED + "A pull request that is still open." + OPEN +} + +"The possible item types found in a timeline." +enum PullRequestTimelineItemsItemType { + "Represents an 'added_to_merge_queue' event on a given pull request." + ADDED_TO_MERGE_QUEUE_EVENT + "Represents a 'added_to_project' event on a given issue or pull request." + ADDED_TO_PROJECT_EVENT + "Represents an 'assigned' event on any assignable object." + ASSIGNED_EVENT + "Represents a 'automatic_base_change_failed' event on a given pull request." + AUTOMATIC_BASE_CHANGE_FAILED_EVENT + "Represents a 'automatic_base_change_succeeded' event on a given pull request." + AUTOMATIC_BASE_CHANGE_SUCCEEDED_EVENT + "Represents a 'auto_merge_disabled' event on a given pull request." + AUTO_MERGE_DISABLED_EVENT + "Represents a 'auto_merge_enabled' event on a given pull request." + AUTO_MERGE_ENABLED_EVENT + "Represents a 'auto_rebase_enabled' event on a given pull request." + AUTO_REBASE_ENABLED_EVENT + "Represents a 'auto_squash_enabled' event on a given pull request." + AUTO_SQUASH_ENABLED_EVENT + "Represents a 'base_ref_changed' event on a given issue or pull request." + BASE_REF_CHANGED_EVENT + "Represents a 'base_ref_deleted' event on a given pull request." + BASE_REF_DELETED_EVENT + "Represents a 'base_ref_force_pushed' event on a given pull request." + BASE_REF_FORCE_PUSHED_EVENT + "Represents a 'blocked_by_added' event on a given issue." + BLOCKED_BY_ADDED_EVENT + "Represents a 'blocked_by_removed' event on a given issue." + BLOCKED_BY_REMOVED_EVENT + "Represents a 'blocking_added' event on a given issue." + BLOCKING_ADDED_EVENT + "Represents a 'blocking_removed' event on a given issue." + BLOCKING_REMOVED_EVENT + "Represents a 'closed' event on any `Closable`." + CLOSED_EVENT + "Represents a 'comment_deleted' event on a given issue or pull request." + COMMENT_DELETED_EVENT + "Represents a 'connected' event on a given issue or pull request." + CONNECTED_EVENT + "Represents a 'converted_note_to_issue' event on a given issue or pull request." + CONVERTED_NOTE_TO_ISSUE_EVENT + "Represents a 'converted_to_discussion' event on a given issue." + CONVERTED_TO_DISCUSSION_EVENT + "Represents a 'convert_to_draft' event on a given pull request." + CONVERT_TO_DRAFT_EVENT + "Represents a mention made by one issue or pull request to another." + CROSS_REFERENCED_EVENT + "Represents a 'demilestoned' event on a given issue or pull request." + DEMILESTONED_EVENT + "Represents a 'deployed' event on a given pull request." + DEPLOYED_EVENT + "Represents a 'deployment_environment_changed' event on a given pull request." + DEPLOYMENT_ENVIRONMENT_CHANGED_EVENT + "Represents a 'disconnected' event on a given issue or pull request." + DISCONNECTED_EVENT + "Represents a 'head_ref_deleted' event on a given pull request." + HEAD_REF_DELETED_EVENT + "Represents a 'head_ref_force_pushed' event on a given pull request." + HEAD_REF_FORCE_PUSHED_EVENT + "Represents a 'head_ref_restored' event on a given pull request." + HEAD_REF_RESTORED_EVENT + "Represents a comment on an Issue." + ISSUE_COMMENT + "Represents a 'issue_type_added' event on a given issue." + ISSUE_TYPE_ADDED_EVENT + "Represents a 'issue_type_changed' event on a given issue." + ISSUE_TYPE_CHANGED_EVENT + "Represents a 'issue_type_removed' event on a given issue." + ISSUE_TYPE_REMOVED_EVENT + "Represents a 'labeled' event on a given issue or pull request." + LABELED_EVENT + "Represents a 'locked' event on a given issue or pull request." + LOCKED_EVENT + "Represents a 'marked_as_duplicate' event on a given issue or pull request." + MARKED_AS_DUPLICATE_EVENT + "Represents a 'mentioned' event on a given issue or pull request." + MENTIONED_EVENT + "Represents a 'merged' event on a given pull request." + MERGED_EVENT + "Represents a 'milestoned' event on a given issue or pull request." + MILESTONED_EVENT + "Represents a 'moved_columns_in_project' event on a given issue or pull request." + MOVED_COLUMNS_IN_PROJECT_EVENT + "Represents a 'parent_issue_added' event on a given issue." + PARENT_ISSUE_ADDED_EVENT + "Represents a 'parent_issue_removed' event on a given issue." + PARENT_ISSUE_REMOVED_EVENT + "Represents a 'pinned' event on a given issue or pull request." + PINNED_EVENT + "Represents a Git commit part of a pull request." + PULL_REQUEST_COMMIT + "Represents a commit comment thread part of a pull request." + PULL_REQUEST_COMMIT_COMMENT_THREAD + "A review object for a given pull request." + PULL_REQUEST_REVIEW + "A threaded list of comments for a given pull request." + PULL_REQUEST_REVIEW_THREAD + "Represents the latest point in the pull request timeline for which the viewer has seen the pull request's commits." + PULL_REQUEST_REVISION_MARKER + "Represents a 'ready_for_review' event on a given pull request." + READY_FOR_REVIEW_EVENT + "Represents a 'referenced' event on a given `ReferencedSubject`." + REFERENCED_EVENT + "Represents a 'removed_from_merge_queue' event on a given pull request." + REMOVED_FROM_MERGE_QUEUE_EVENT + "Represents a 'removed_from_project' event on a given issue or pull request." + REMOVED_FROM_PROJECT_EVENT + "Represents a 'renamed' event on a given issue or pull request" + RENAMED_TITLE_EVENT + "Represents a 'reopened' event on any `Closable`." + REOPENED_EVENT + "Represents a 'review_dismissed' event on a given issue or pull request." + REVIEW_DISMISSED_EVENT + "Represents an 'review_requested' event on a given pull request." + REVIEW_REQUESTED_EVENT + "Represents an 'review_request_removed' event on a given pull request." + REVIEW_REQUEST_REMOVED_EVENT + "Represents a 'subscribed' event on a given `Subscribable`." + SUBSCRIBED_EVENT + "Represents a 'sub_issue_added' event on a given issue." + SUB_ISSUE_ADDED_EVENT + "Represents a 'sub_issue_removed' event on a given issue." + SUB_ISSUE_REMOVED_EVENT + "Represents a 'transferred' event on a given issue or pull request." + TRANSFERRED_EVENT + "Represents an 'unassigned' event on any assignable object." + UNASSIGNED_EVENT + "Represents an 'unlabeled' event on a given issue or pull request." + UNLABELED_EVENT + "Represents an 'unlocked' event on a given issue or pull request." + UNLOCKED_EVENT + "Represents an 'unmarked_as_duplicate' event on a given issue or pull request." + UNMARKED_AS_DUPLICATE_EVENT + "Represents an 'unpinned' event on a given issue or pull request." + UNPINNED_EVENT + "Represents an 'unsubscribed' event on a given `Subscribable`." + UNSUBSCRIBED_EVENT + "Represents a 'user_blocked' event on a given user." + USER_BLOCKED_EVENT +} + +"The possible target states when updating a pull request." +enum PullRequestUpdateState { + "A pull request that has been closed without being merged." + CLOSED + "A pull request that is still open." + OPEN +} + +"Emojis that can be attached to Issues, Pull Requests and Comments." +enum ReactionContent { + "Represents the `:confused:` emoji." + CONFUSED + "Represents the `:eyes:` emoji." + EYES + "Represents the `:heart:` emoji." + HEART + "Represents the `:hooray:` emoji." + HOORAY + "Represents the `:laugh:` emoji." + LAUGH + "Represents the `:rocket:` emoji." + ROCKET + "Represents the `:-1:` emoji." + THUMBS_DOWN + "Represents the `:+1:` emoji." + THUMBS_UP +} + +"A list of fields that reactions can be ordered by." +enum ReactionOrderField { + "Allows ordering a list of reactions by when they were created." + CREATED_AT +} + +"Properties by which ref connections can be ordered." +enum RefOrderField { + "Order refs by their alphanumeric name" + ALPHABETICAL + "Order refs by underlying commit date if the ref prefix is refs/tags/" + TAG_COMMIT_DATE +} + +"Properties by which release connections can be ordered." +enum ReleaseOrderField { + "Order releases by creation time" + CREATED_AT + "Order releases alphabetically by name" + NAME +} + +"The privacy of a repository" +enum RepoAccessAuditEntryVisibility { + "The repository is visible only to users in the same enterprise." + INTERNAL + "The repository is visible only to those with explicit access." + PRIVATE + "The repository is visible to everyone." + PUBLIC +} + +"The privacy of a repository" +enum RepoAddMemberAuditEntryVisibility { + "The repository is visible only to users in the same enterprise." + INTERNAL + "The repository is visible only to those with explicit access." + PRIVATE + "The repository is visible to everyone." + PUBLIC +} + +"The privacy of a repository" +enum RepoArchivedAuditEntryVisibility { + "The repository is visible only to users in the same enterprise." + INTERNAL + "The repository is visible only to those with explicit access." + PRIVATE + "The repository is visible to everyone." + PUBLIC +} + +"The merge options available for pull requests to this repository." +enum RepoChangeMergeSettingAuditEntryMergeType { + "The pull request is added to the base branch in a merge commit." + MERGE + "Commits from the pull request are added onto the base branch individually without a merge commit." + REBASE + "The pull request's commits are squashed into a single commit before they are merged to the base branch." + SQUASH +} + +"The privacy of a repository" +enum RepoCreateAuditEntryVisibility { + "The repository is visible only to users in the same enterprise." + INTERNAL + "The repository is visible only to those with explicit access." + PRIVATE + "The repository is visible to everyone." + PUBLIC +} + +"The privacy of a repository" +enum RepoDestroyAuditEntryVisibility { + "The repository is visible only to users in the same enterprise." + INTERNAL + "The repository is visible only to those with explicit access." + PRIVATE + "The repository is visible to everyone." + PUBLIC +} + +"The privacy of a repository" +enum RepoRemoveMemberAuditEntryVisibility { + "The repository is visible only to users in the same enterprise." + INTERNAL + "The repository is visible only to those with explicit access." + PRIVATE + "The repository is visible to everyone." + PUBLIC +} + +"The reasons a piece of content can be reported or minimized." +enum ReportedContentClassifiers { + "An abusive or harassing piece of content" + ABUSE + "A duplicated piece of content" + DUPLICATE + "An irrelevant piece of content" + OFF_TOPIC + "An outdated piece of content" + OUTDATED + "The content has been resolved" + RESOLVED + "A spammy piece of content" + SPAM +} + +"The affiliation of a user to a repository" +enum RepositoryAffiliation { + "Repositories that the user has been added to as a collaborator." + COLLABORATOR + "Repositories that the user has access to through being a member of an organization. This includes every repository on every team that the user is on." + ORGANIZATION_MEMBER + "Repositories that are owned by the authenticated user." + OWNER +} + +"The reason a repository is listed as 'contributed'." +enum RepositoryContributionType { + "Created a commit" + COMMIT + "Created an issue" + ISSUE + "Created a pull request" + PULL_REQUEST + "Reviewed a pull request" + PULL_REQUEST_REVIEW + "Created the repository" + REPOSITORY +} + +"A repository interaction limit." +enum RepositoryInteractionLimit { + "Users that are not collaborators will not be able to interact with the repository." + COLLABORATORS_ONLY + "Users that have not previously committed to a repository’s default branch will be unable to interact with the repository." + CONTRIBUTORS_ONLY + "Users that have recently created their account will be unable to interact with the repository." + EXISTING_USERS + "No interaction limits are enabled." + NO_LIMIT +} + +"The length for a repository interaction limit to be enabled for." +enum RepositoryInteractionLimitExpiry { + "The interaction limit will expire after 1 day." + ONE_DAY + "The interaction limit will expire after 1 month." + ONE_MONTH + "The interaction limit will expire after 1 week." + ONE_WEEK + "The interaction limit will expire after 6 months." + SIX_MONTHS + "The interaction limit will expire after 3 days." + THREE_DAYS +} + +"Indicates where an interaction limit is configured." +enum RepositoryInteractionLimitOrigin { + "A limit that is configured at the organization level." + ORGANIZATION + "A limit that is configured at the repository level." + REPOSITORY + "A limit that is configured at the user-wide level." + USER +} + +"Properties by which repository invitation connections can be ordered." +enum RepositoryInvitationOrderField { + "Order repository invitations by creation time" + CREATED_AT +} + +"The possible reasons a given repository could be in a locked state." +enum RepositoryLockReason { + "The repository is locked due to a billing related reason." + BILLING + "The repository is locked due to a migration." + MIGRATING + "The repository is locked due to a move." + MOVING + "The repository is locked due to a rename." + RENAME + "The repository is locked due to a trade controls related reason." + TRADE_RESTRICTION + "The repository is locked due to an ownership transfer." + TRANSFERRING_OWNERSHIP +} + +"Possible directions in which to order a list of repository migrations when provided an `orderBy` argument." +enum RepositoryMigrationOrderDirection { + "Specifies an ascending order for a given `orderBy` argument." + ASC + "Specifies a descending order for a given `orderBy` argument." + DESC +} + +"Properties by which repository migrations can be ordered." +enum RepositoryMigrationOrderField { + "Order mannequins why when they were created." + CREATED_AT +} + +"Properties by which repository connections can be ordered." +enum RepositoryOrderField { + "Order repositories by creation time" + CREATED_AT + "Order repositories by name" + NAME + "Order repositories by push time" + PUSHED_AT + "Order repositories by number of stargazers" + STARGAZERS + "Order repositories by update time" + UPDATED_AT +} + +"The access level to a repository" +enum RepositoryPermission { + "Can read, clone, and push to this repository. Can also manage issues, pull requests, and repository settings, including adding collaborators" + ADMIN + "Can read, clone, and push to this repository. They can also manage issues, pull requests, and some repository settings" + MAINTAIN + "Can read and clone this repository. Can also open and comment on issues and pull requests" + READ + "Can read and clone this repository. Can also manage issues and pull requests" + TRIAGE + "Can read, clone, and push to this repository. Can also manage issues and pull requests" + WRITE +} + +"The privacy of a repository" +enum RepositoryPrivacy { + "Private" + PRIVATE + "Public" + PUBLIC +} + +"Properties by which repository rule connections can be ordered." +enum RepositoryRuleOrderField { + "Order repository rules by created time" + CREATED_AT + "Order repository rules by type" + TYPE + "Order repository rules by updated time" + UPDATED_AT +} + +"The rule types supported in rulesets" +enum RepositoryRuleType { + "Authorization" + AUTHORIZATION + "Branch name pattern" + BRANCH_NAME_PATTERN + "Choose which tools must provide code scanning results before the reference is updated. When configured, code scanning must be enabled and have results for both the commit and the reference being updated." + CODE_SCANNING + "Committer email pattern" + COMMITTER_EMAIL_PATTERN + "Commit author email pattern" + COMMIT_AUTHOR_EMAIL_PATTERN + "Commit message pattern" + COMMIT_MESSAGE_PATTERN + "Request Copilot code review for new pull requests automatically if the author has access to Copilot code review." + COPILOT_CODE_REVIEW + "Only allow users with bypass permission to create matching refs." + CREATION + "Only allow users with bypass permissions to delete matching refs." + DELETION + "Prevent commits that include files with specified file extensions from being pushed to the commit graph." + FILE_EXTENSION_RESTRICTION + "Prevent commits that include changes in specified file and folder paths from being pushed to the commit graph. This includes absolute paths that contain file names." + FILE_PATH_RESTRICTION + "Branch is read-only. Users cannot push to the branch." + LOCK_BRANCH + "Prevent commits that include file paths that exceed the specified character limit from being pushed to the commit graph." + MAX_FILE_PATH_LENGTH + "Prevent commits with individual files that exceed the specified limit from being pushed to the commit graph." + MAX_FILE_SIZE + "Max ref updates" + MAX_REF_UPDATES + "Merges must be performed via a merge queue." + MERGE_QUEUE + "Merge queue locked ref" + MERGE_QUEUE_LOCKED_REF + "Prevent users with push access from force pushing to refs." + NON_FAST_FORWARD + "Require all commits be made to a non-target branch and submitted via a pull request before they can be merged." + PULL_REQUEST + "Choose which environments must be successfully deployed to before refs can be pushed into a ref that matches this rule." + REQUIRED_DEPLOYMENTS + "Prevent merge commits from being pushed to matching refs." + REQUIRED_LINEAR_HISTORY + "When enabled, all conversations on code must be resolved before a pull request can be merged into a branch that matches this rule." + REQUIRED_REVIEW_THREAD_RESOLUTION + "Commits pushed to matching refs must have verified signatures." + REQUIRED_SIGNATURES + "Choose which status checks must pass before the ref is updated. When enabled, commits must first be pushed to another ref where the checks pass." + REQUIRED_STATUS_CHECKS + "Require all commits be made to a non-target branch and submitted via a pull request and required workflow checks to pass before they can be merged." + REQUIRED_WORKFLOW_STATUS_CHECKS + "Secret scanning" + SECRET_SCANNING + "Tag" + TAG + "Tag name pattern" + TAG_NAME_PATTERN + "Only allow users with bypass permission to update matching refs." + UPDATE + "Require all changes made to a targeted branch to pass the specified workflows before they can be merged." + WORKFLOWS + "Workflow files cannot be modified." + WORKFLOW_UPDATES +} + +"The bypass mode for a specific actor on a ruleset." +enum RepositoryRulesetBypassActorBypassMode { + "The actor can always bypass rules" + ALWAYS + "The actor is exempt from rules without generating a pass / fail result" + EXEMPT + "The actor can only bypass rules via a pull request" + PULL_REQUEST +} + +"The targets supported for rulesets." +enum RepositoryRulesetTarget { + "Branch" + BRANCH + "Push" + PUSH + "repository" + REPOSITORY + "Tag" + TAG +} + +"The possible filters for suggested actors in a repository" +enum RepositorySuggestedActorFilter { + "Actors that can be assigned to issues and pull requests" + CAN_BE_ASSIGNED + "Actors that can be the author of issues and pull requests" + CAN_BE_AUTHOR +} + +"The repository's visibility level." +enum RepositoryVisibility { + "The repository is visible only to users in the same enterprise." + INTERNAL + "The repository is visible only to those with explicit access." + PRIVATE + "The repository is visible to everyone." + PUBLIC +} + +"The possible relationships of an alert's dependency." +enum RepositoryVulnerabilityAlertDependencyRelationship { + "A direct dependency of your project" + DIRECT + "A transitive dependency of your project" + TRANSITIVE + "The relationship is unknown" + UNKNOWN +} + +"The possible scopes of an alert's dependency." +enum RepositoryVulnerabilityAlertDependencyScope { + "A dependency that is only used in development" + DEVELOPMENT + "A dependency that is leveraged during application runtime" + RUNTIME +} + +"The possible states of an alert" +enum RepositoryVulnerabilityAlertState { + "An alert that has been automatically closed by Dependabot." + AUTO_DISMISSED + "An alert that has been manually closed by a user." + DISMISSED + "An alert that has been resolved by a code change." + FIXED + "An alert that is still open." + OPEN +} + +"The possible states that can be requested when creating a check run." +enum RequestableCheckStatusState { + "The check suite or run has been completed." + COMPLETED + "The check suite or run is in progress." + IN_PROGRESS + "The check suite or run is in pending state." + PENDING + "The check suite or run has been queued." + QUEUED + "The check suite or run is in waiting state." + WAITING +} + +"Possible roles a user may have in relation to an organization." +enum RoleInOrganization { + "A user who is a direct member of the organization." + DIRECT_MEMBER + "A user with full administrative access to the organization." + OWNER + "A user who is unaffiliated with the organization." + UNAFFILIATED +} + +"The level of enforcement for a rule or ruleset." +enum RuleEnforcement { + "Rules will be enforced" + ACTIVE + "Do not evaluate or enforce rules" + DISABLED + "Allow admins to test rules before enforcing them. Admins can view insights on the Rule Insights page (`evaluate` is only available with GitHub Enterprise)." + EVALUATE +} + +"The possible digest algorithms used to sign SAML requests for an identity provider." +enum SamlDigestAlgorithm { + "SHA1" + SHA1 + "SHA256" + SHA256 + "SHA384" + SHA384 + "SHA512" + SHA512 +} + +"The possible signature algorithms used to sign SAML requests for a Identity Provider." +enum SamlSignatureAlgorithm { + "RSA-SHA1" + RSA_SHA1 + "RSA-SHA256" + RSA_SHA256 + "RSA-SHA384" + RSA_SHA384 + "RSA-SHA512" + RSA_SHA512 +} + +"Properties by which saved reply connections can be ordered." +enum SavedReplyOrderField { + "Order saved reply by when they were updated." + UPDATED_AT +} + +"Represents the individual results of a search." +enum SearchType { + "Returns matching discussions in repositories." + DISCUSSION + "Returns results matching issues in repositories." + ISSUE + "Returns results matching issues in repositories." + ISSUE_ADVANCED @deprecated(reason: "Search for issues and pull requests will be overridden by advanced search on November 4, 2025. You can read more about this change on https://github.blog/changelog/2025-03-06-github-issues-projects-api-support-for-issues-advanced-search-and-more/. Removal on 2025-11-04 UTC.") + "Returns results matching repositories." + REPOSITORY + "Returns results matching users and organizations on GitHub." + USER +} + +"Classification of the advisory." +enum SecurityAdvisoryClassification { + "Classification of general advisories." + GENERAL + "Classification of malware advisories." + MALWARE +} + +"The possible ecosystems of a security vulnerability's package." +enum SecurityAdvisoryEcosystem { + "GitHub Actions" + ACTIONS + "PHP packages hosted at packagist.org" + COMPOSER + "Erlang/Elixir packages hosted at hex.pm" + ERLANG + "Go modules" + GO + "Java artifacts hosted at the Maven central repository" + MAVEN + "JavaScript packages hosted at npmjs.com" + NPM + ".NET packages hosted at the NuGet Gallery" + NUGET + "Python packages hosted at PyPI.org" + PIP + "Dart packages hosted at pub.dev" + PUB + "Ruby gems hosted at RubyGems.org" + RUBYGEMS + "Rust crates" + RUST + "Swift packages" + SWIFT +} + +"Identifier formats available for advisories." +enum SecurityAdvisoryIdentifierType { + "Common Vulnerabilities and Exposures Identifier." + CVE + "GitHub Security Advisory ID." + GHSA +} + +"Properties by which security advisory connections can be ordered." +enum SecurityAdvisoryOrderField { + "Order advisories by EPSS percentage" + EPSS_PERCENTAGE + "Order advisories by EPSS percentile" + EPSS_PERCENTILE + "Order advisories by publication time" + PUBLISHED_AT + "Order advisories by update time" + UPDATED_AT +} + +"Severity of the vulnerability." +enum SecurityAdvisorySeverity { + "Critical." + CRITICAL + "High." + HIGH + "Low." + LOW + "Moderate." + MODERATE +} + +"Properties by which security vulnerability connections can be ordered." +enum SecurityVulnerabilityOrderField { + "Order vulnerability by update time" + UPDATED_AT +} + +"Software or company that hosts social media accounts." +enum SocialAccountProvider { + "Decentralized microblogging social platform." + BLUESKY + "Social media and networking website." + FACEBOOK + "Catch-all for social media providers that do not yet have specific handling." + GENERIC + "Fork of Mastodon with a greater focus on local posting." + HOMETOWN + "Social media website with a focus on photo and video sharing." + INSTAGRAM + "Professional networking website." + LINKEDIN + "Open-source federated microblogging service." + MASTODON + "JavaScript package registry." + NPM + "Social news aggregation and discussion website." + REDDIT + "Live-streaming service." + TWITCH + "Microblogging website." + TWITTER + "Online video platform." + YOUTUBE +} + +"Properties by which sponsor and lifetime value connections can be ordered." +enum SponsorAndLifetimeValueOrderField { + "Order results by how much money the sponsor has paid in total." + LIFETIME_VALUE + "Order results by the sponsor's login (username)." + SPONSOR_LOGIN + "Order results by the sponsor's relevance to the viewer." + SPONSOR_RELEVANCE +} + +"Properties by which sponsor connections can be ordered." +enum SponsorOrderField { + "Order sponsorable entities by login (username)." + LOGIN + "Order sponsors by their relevance to the viewer." + RELEVANCE +} + +"Properties by which sponsorable connections can be ordered." +enum SponsorableOrderField { + "Order sponsorable entities by login (username)." + LOGIN +} + +"The possible actions that GitHub Sponsors activities can represent." +enum SponsorsActivityAction { + "The activity was cancelling a sponsorship." + CANCELLED_SPONSORSHIP + "The activity was starting a sponsorship." + NEW_SPONSORSHIP + "The activity was scheduling a downgrade or cancellation." + PENDING_CHANGE + "The activity was funds being refunded to the sponsor or GitHub." + REFUND + "The activity was disabling matching for a previously matched sponsorship." + SPONSOR_MATCH_DISABLED + "The activity was changing the sponsorship tier, either directly by the sponsor or by a scheduled/pending change." + TIER_CHANGE +} + +"Properties by which GitHub Sponsors activity connections can be ordered." +enum SponsorsActivityOrderField { + "Order activities by when they happened." + TIMESTAMP +} + +"The possible time periods for which Sponsors activities can be requested." +enum SponsorsActivityPeriod { + "Don't restrict the activity to any date range, include all activity." + ALL + "The previous calendar day." + DAY + "The previous thirty days." + MONTH + "The previous seven days." + WEEK +} + +"Represents countries or regions for billing and residence for a GitHub Sponsors profile." +enum SponsorsCountryOrRegionCode { + "Andorra" + AD + "United Arab Emirates" + AE + "Afghanistan" + AF + "Antigua and Barbuda" + AG + "Anguilla" + AI + "Albania" + AL + "Armenia" + AM + "Angola" + AO + "Antarctica" + AQ + "Argentina" + AR + "American Samoa" + AS + "Austria" + AT + "Australia" + AU + "Aruba" + AW + "Åland" + AX + "Azerbaijan" + AZ + "Bosnia and Herzegovina" + BA + "Barbados" + BB + "Bangladesh" + BD + "Belgium" + BE + "Burkina Faso" + BF + "Bulgaria" + BG + "Bahrain" + BH + "Burundi" + BI + "Benin" + BJ + "Saint Barthélemy" + BL + "Bermuda" + BM + "Brunei Darussalam" + BN + "Bolivia" + BO + "Bonaire, Sint Eustatius and Saba" + BQ + "Brazil" + BR + "Bahamas" + BS + "Bhutan" + BT + "Bouvet Island" + BV + "Botswana" + BW + "Belarus" + BY + "Belize" + BZ + "Canada" + CA + "Cocos (Keeling) Islands" + CC + "Congo (Kinshasa)" + CD + "Central African Republic" + CF + "Congo (Brazzaville)" + CG + "Switzerland" + CH + "Côte d'Ivoire" + CI + "Cook Islands" + CK + "Chile" + CL + "Cameroon" + CM + "China" + CN + "Colombia" + CO + "Costa Rica" + CR + "Cape Verde" + CV + "Curaçao" + CW + "Christmas Island" + CX + "Cyprus" + CY + "Czech Republic" + CZ + "Germany" + DE + "Djibouti" + DJ + "Denmark" + DK + "Dominica" + DM + "Dominican Republic" + DO + "Algeria" + DZ + "Ecuador" + EC + "Estonia" + EE + "Egypt" + EG + "Western Sahara" + EH + "Eritrea" + ER + "Spain" + ES + "Ethiopia" + ET + "Finland" + FI + "Fiji" + FJ + "Falkland Islands" + FK + "Micronesia" + FM + "Faroe Islands" + FO + "France" + FR + "Gabon" + GA + "United Kingdom" + GB + "Grenada" + GD + "Georgia" + GE + "French Guiana" + GF + "Guernsey" + GG + "Ghana" + GH + "Gibraltar" + GI + "Greenland" + GL + "Gambia" + GM + "Guinea" + GN + "Guadeloupe" + GP + "Equatorial Guinea" + GQ + "Greece" + GR + "South Georgia and South Sandwich Islands" + GS + "Guatemala" + GT + "Guam" + GU + "Guinea-Bissau" + GW + "Guyana" + GY + "Hong Kong" + HK + "Heard and McDonald Islands" + HM + "Honduras" + HN + "Croatia" + HR + "Haiti" + HT + "Hungary" + HU + "Indonesia" + ID + "Ireland" + IE + "Israel" + IL + "Isle of Man" + IM + "India" + IN + "British Indian Ocean Territory" + IO + "Iraq" + IQ + "Iran" + IR + "Iceland" + IS + "Italy" + IT + "Jersey" + JE + "Jamaica" + JM + "Jordan" + JO + "Japan" + JP + "Kenya" + KE + "Kyrgyzstan" + KG + "Cambodia" + KH + "Kiribati" + KI + "Comoros" + KM + "Saint Kitts and Nevis" + KN + "Korea, South" + KR + "Kuwait" + KW + "Cayman Islands" + KY + "Kazakhstan" + KZ + "Laos" + LA + "Lebanon" + LB + "Saint Lucia" + LC + "Liechtenstein" + LI + "Sri Lanka" + LK + "Liberia" + LR + "Lesotho" + LS + "Lithuania" + LT + "Luxembourg" + LU + "Latvia" + LV + "Libya" + LY + "Morocco" + MA + "Monaco" + MC + "Moldova" + MD + "Montenegro" + ME + "Saint Martin (French part)" + MF + "Madagascar" + MG + "Marshall Islands" + MH + "Macedonia" + MK + "Mali" + ML + "Myanmar" + MM + "Mongolia" + MN + "Macau" + MO + "Northern Mariana Islands" + MP + "Martinique" + MQ + "Mauritania" + MR + "Montserrat" + MS + "Malta" + MT + "Mauritius" + MU + "Maldives" + MV + "Malawi" + MW + "Mexico" + MX + "Malaysia" + MY + "Mozambique" + MZ + "Namibia" + NA + "New Caledonia" + NC + "Niger" + NE + "Norfolk Island" + NF + "Nigeria" + NG + "Nicaragua" + NI + "Netherlands" + NL + "Norway" + NO + "Nepal" + NP + "Nauru" + NR + "Niue" + NU + "New Zealand" + NZ + "Oman" + OM + "Panama" + PA + "Peru" + PE + "French Polynesia" + PF + "Papua New Guinea" + PG + "Philippines" + PH + "Pakistan" + PK + "Poland" + PL + "Saint Pierre and Miquelon" + PM + "Pitcairn" + PN + "Puerto Rico" + PR + "Palestine" + PS + "Portugal" + PT + "Palau" + PW + "Paraguay" + PY + "Qatar" + QA + "Reunion" + RE + "Romania" + RO + "Serbia" + RS + "Russian Federation" + RU + "Rwanda" + RW + "Saudi Arabia" + SA + "Solomon Islands" + SB + "Seychelles" + SC + "Sudan" + SD + "Sweden" + SE + "Singapore" + SG + "Saint Helena" + SH + "Slovenia" + SI + "Svalbard and Jan Mayen Islands" + SJ + "Slovakia" + SK + "Sierra Leone" + SL + "San Marino" + SM + "Senegal" + SN + "Somalia" + SO + "Suriname" + SR + "South Sudan" + SS + "Sao Tome and Principe" + ST + "El Salvador" + SV + "Sint Maarten (Dutch part)" + SX + "Syria" + SY + "Swaziland" + SZ + "Turks and Caicos Islands" + TC + "Chad" + TD + "French Southern Lands" + TF + "Togo" + TG + "Thailand" + TH + "Tajikistan" + TJ + "Tokelau" + TK + "Timor-Leste" + TL + "Turkmenistan" + TM + "Tunisia" + TN + "Tonga" + TO + "Türkiye" + TR + "Trinidad and Tobago" + TT + "Tuvalu" + TV + "Taiwan" + TW + "Tanzania" + TZ + "Ukraine" + UA + "Uganda" + UG + "United States Minor Outlying Islands" + UM + "United States of America" + US + "Uruguay" + UY + "Uzbekistan" + UZ + "Vatican City" + VA + "Saint Vincent and the Grenadines" + VC + "Venezuela" + VE + "Virgin Islands, British" + VG + "Virgin Islands, U.S." + VI + "Vietnam" + VN + "Vanuatu" + VU + "Wallis and Futuna Islands" + WF + "Samoa" + WS + "Yemen" + YE + "Mayotte" + YT + "South Africa" + ZA + "Zambia" + ZM + "Zimbabwe" + ZW +} + +"The different kinds of goals a GitHub Sponsors member can have." +enum SponsorsGoalKind { + "The goal is about getting a certain amount in USD from sponsorships each month." + MONTHLY_SPONSORSHIP_AMOUNT + "The goal is about reaching a certain number of sponsors." + TOTAL_SPONSORS_COUNT +} + +"The different kinds of records that can be featured on a GitHub Sponsors profile page." +enum SponsorsListingFeaturedItemFeatureableType { + "A repository owned by the user or organization with the GitHub Sponsors profile." + REPOSITORY + "A user who belongs to the organization with the GitHub Sponsors profile." + USER +} + +"Properties by which Sponsors tiers connections can be ordered." +enum SponsorsTierOrderField { + "Order tiers by creation time." + CREATED_AT + "Order tiers by their monthly price in cents" + MONTHLY_PRICE_IN_CENTS +} + +"Properties by which sponsorship update connections can be ordered." +enum SponsorshipNewsletterOrderField { + "Order sponsorship newsletters by when they were created." + CREATED_AT +} + +"Properties by which sponsorship connections can be ordered." +enum SponsorshipOrderField { + "Order sponsorship by creation time." + CREATED_AT +} + +"How payment was made for funding a GitHub Sponsors sponsorship." +enum SponsorshipPaymentSource { + "Payment was made through GitHub." + GITHUB + "Payment was made through Patreon." + PATREON +} + +"The privacy of a sponsorship" +enum SponsorshipPrivacy { + "Private" + PRIVATE + "Public" + PUBLIC +} + +"The possible default commit messages for squash merges." +enum SquashMergeCommitMessage { + "Default to a blank commit message." + BLANK + "Default to the branch's commit messages." + COMMIT_MESSAGES + "Default to the pull request's body." + PR_BODY +} + +"The possible default commit titles for squash merges." +enum SquashMergeCommitTitle { + "Default to the commit's title (if only one commit) or the pull request's title (when more than one commit)." + COMMIT_OR_PR_TITLE + "Default to the pull request's title." + PR_TITLE +} + +"Properties by which star connections can be ordered." +enum StarOrderField { + "Allows ordering a list of stars by when they were created." + STARRED_AT +} + +"The possible commit status states." +enum StatusState { + "Status is errored." + ERROR + "Status is expected." + EXPECTED + "Status is failing." + FAILURE + "Status is pending." + PENDING + "Status is successful." + SUCCESS +} + +"The possible states of a subscription." +enum SubscriptionState { + "The User is never notified." + IGNORED + "The User is notified of all conversations." + SUBSCRIBED + "The User is only notified when participating or @mentioned." + UNSUBSCRIBED +} + +"Properties by which team discussion comment connections can be ordered." +enum TeamDiscussionCommentOrderField { + "Allows sequential ordering of team discussion comments (which is equivalent to chronological ordering)." + NUMBER +} + +"Properties by which team discussion connections can be ordered." +enum TeamDiscussionOrderField { + "Allows chronological ordering of team discussions." + CREATED_AT +} + +"Properties by which team member connections can be ordered." +enum TeamMemberOrderField { + "Order team members by creation time" + CREATED_AT + "Order team members by login" + LOGIN +} + +"The possible team member roles; either 'maintainer' or 'member'." +enum TeamMemberRole { + "A team maintainer has permission to add and remove team members." + MAINTAINER + "A team member has no administrative permissions on the team." + MEMBER +} + +"Defines which types of team members are included in the returned list. Can be one of IMMEDIATE, CHILD_TEAM or ALL." +enum TeamMembershipType { + "Includes immediate and child team members for the team." + ALL + "Includes only child team members for the team." + CHILD_TEAM + "Includes only immediate members of the team." + IMMEDIATE +} + +"The possible team notification values." +enum TeamNotificationSetting { + "No one will receive notifications." + NOTIFICATIONS_DISABLED + "Everyone will receive notifications when the team is @mentioned." + NOTIFICATIONS_ENABLED +} + +"Properties by which team connections can be ordered." +enum TeamOrderField { + "Allows ordering a list of teams by name." + NAME +} + +"The possible team privacy values." +enum TeamPrivacy { + "A secret team can only be seen by its members." + SECRET + "A visible team can be seen and @mentioned by every member of the organization." + VISIBLE +} + +"Properties by which team repository connections can be ordered." +enum TeamRepositoryOrderField { + "Order repositories by creation time" + CREATED_AT + "Order repositories by name" + NAME + "Order repositories by permission" + PERMISSION + "Order repositories by push time" + PUSHED_AT + "Order repositories by number of stargazers" + STARGAZERS + "Order repositories by update time" + UPDATED_AT +} + +"The possible team review assignment algorithms" +enum TeamReviewAssignmentAlgorithm { + "Balance review load across the entire team" + LOAD_BALANCE + "Alternate reviews between each team member" + ROUND_ROBIN +} + +"The role of a user on a team." +enum TeamRole { + "User has admin rights on the team." + ADMIN + "User is a member of the team." + MEMBER +} + +"The possible states of a thread subscription form action" +enum ThreadSubscriptionFormAction { + "The User cannot subscribe or unsubscribe to the thread" + NONE + "The User can subscribe to the thread" + SUBSCRIBE + "The User can unsubscribe to the thread" + UNSUBSCRIBE +} + +"The possible states of a subscription." +enum ThreadSubscriptionState { + "The subscription status is currently disabled." + DISABLED + "The User is never notified because they are ignoring the list" + IGNORING_LIST + "The User is never notified because they are ignoring the thread" + IGNORING_THREAD + "The User is not recieving notifications from this thread" + NONE + "The User is notified becuase they are watching the list" + SUBSCRIBED_TO_LIST + "The User is notified because they are subscribed to the thread" + SUBSCRIBED_TO_THREAD + "The User is notified because they chose custom settings for this thread." + SUBSCRIBED_TO_THREAD_EVENTS + "The User is notified because they chose custom settings for this thread." + SUBSCRIBED_TO_THREAD_TYPE + "The subscription status is currently unavailable." + UNAVAILABLE +} + +"Reason that the suggested topic is declined." +enum TopicSuggestionDeclineReason { + "The suggested topic is not relevant to the repository." + NOT_RELEVANT @deprecated(reason: "Suggested topics are no longer supported Removal on 2024-04-01 UTC.") + "The viewer does not like the suggested topic." + PERSONAL_PREFERENCE @deprecated(reason: "Suggested topics are no longer supported Removal on 2024-04-01 UTC.") + "The suggested topic is too general for the repository." + TOO_GENERAL @deprecated(reason: "Suggested topics are no longer supported Removal on 2024-04-01 UTC.") + "The suggested topic is too specific for the repository (e.g. #ruby-on-rails-version-4-2-1)." + TOO_SPECIFIC @deprecated(reason: "Suggested topics are no longer supported Removal on 2024-04-01 UTC.") +} + +"The possible states of a tracked issue." +enum TrackedIssueStates { + "The tracked issue is closed" + CLOSED + "The tracked issue is open" + OPEN +} + +"Filters by whether or not 2FA is enabled and if the method configured is considered secure or insecure." +enum TwoFactorCredentialSecurityType { + "No method of two-factor authentication." + DISABLED + "Has an insecure method of two-factor authentication. GitHub currently defines this as SMS two-factor authentication." + INSECURE + "Has only secure methods of two-factor authentication." + SECURE +} + +"The possible durations that a user can be blocked for." +enum UserBlockDuration { + "The user was blocked for 1 day" + ONE_DAY + "The user was blocked for 30 days" + ONE_MONTH + "The user was blocked for 7 days" + ONE_WEEK + "The user was blocked permanently" + PERMANENT + "The user was blocked for 3 days" + THREE_DAYS +} + +"Properties by which user status connections can be ordered." +enum UserStatusOrderField { + "Order user statuses by when they were updated." + UPDATED_AT +} + +"Whether a user being viewed contains public or private information." +enum UserViewType { + "A user containing information only visible to the authenticated user." + PRIVATE + "A user that is publicly visible." + PUBLIC +} + +"Properties by which verifiable domain connections can be ordered." +enum VerifiableDomainOrderField { + "Order verifiable domains by their creation date." + CREATED_AT + "Order verifiable domains by the domain name." + DOMAIN +} + +"Properties by which workflow run connections can be ordered." +enum WorkflowRunOrderField { + "Order workflow runs by most recently created" + CREATED_AT +} + +"The possible states for a workflow." +enum WorkflowState { + "The workflow is active." + ACTIVE + "The workflow was deleted from the git repository." + DELETED + "The workflow was disabled by default on a fork." + DISABLED_FORK + "The workflow was disabled for inactivity in the repository." + DISABLED_INACTIVITY + "The workflow was disabled manually." + DISABLED_MANUALLY +} + +"A (potentially binary) string encoded using base64." +scalar Base64String + +"Represents non-fractional signed whole numeric values. Since the value may exceed the size of a 32-bit integer, it's encoded as a string." +scalar BigInt + +"An ISO-8601 encoded date string." +scalar Date + +"An ISO-8601 encoded UTC date string." +scalar DateTime + +"A Git object ID." +scalar GitObjectID + +"A fully qualified reference name (e.g. `refs/heads/master`)." +scalar GitRefname + +"Git SSH string" +scalar GitSSHRemote + +"An ISO-8601 encoded date string. Unlike the DateTime type, GitTimestamp is not converted in UTC." +scalar GitTimestamp + +"A string containing HTML code." +scalar HTML + +"An ISO-8601 encoded UTC date string with millisecond precision." +scalar PreciseDateTime + +"An RFC 3986, RFC 3987, and RFC 6570 (level 4) compliant URI string." +scalar URI + +"A valid x509 certificate string" +scalar X509Certificate + +"Autogenerated input type of AbortQueuedMigrations" +input AbortQueuedMigrationsInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the organization that is running the migrations." + ownerId: ID! +} + +"Autogenerated input type of AbortRepositoryMigration" +input AbortRepositoryMigrationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the migration to be aborted." + migrationId: ID! +} + +"Autogenerated input type of AcceptEnterpriseAdministratorInvitation" +input AcceptEnterpriseAdministratorInvitationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the invitation being accepted" + invitationId: ID! +} + +"Autogenerated input type of AcceptEnterpriseMemberInvitation" +input AcceptEnterpriseMemberInvitationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the invitation being accepted" + invitationId: ID! +} + +"Autogenerated input type of AcceptTopicSuggestion" +input AcceptTopicSuggestionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + """ + + The name of the suggested topic. + + **Upcoming Change on 2024-04-01 UTC** + **Description:** `name` will be removed. + **Reason:** Suggested topics are no longer supported + """ + name: String + """ + + The Node ID of the repository. + + **Upcoming Change on 2024-04-01 UTC** + **Description:** `repositoryId` will be removed. + **Reason:** Suggested topics are no longer supported + """ + repositoryId: ID +} + +"Autogenerated input type of AccessUserNamespaceRepository" +input AccessUserNamespaceRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise owning the user namespace repository." + enterpriseId: ID! + "The ID of the user namespace repository to access." + repositoryId: ID! +} + +"Autogenerated input type of AddAssigneesToAssignable" +input AddAssigneesToAssignableInput { + "The id of the assignable object to add assignees to." + assignableId: ID! + "The id of users to add as assignees." + assigneeIds: [ID!]! + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated input type of AddBlockedBy" +input AddBlockedByInput { + "The ID of the issue that blocks the given issue." + blockingIssueId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the issue to be blocked." + issueId: ID! +} + +"Autogenerated input type of AddComment" +input AddCommentInput { + "The contents of the comment." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the subject to modify." + subjectId: ID! +} + +"Autogenerated input type of AddDiscussionComment" +input AddDiscussionCommentInput { + "The contents of the comment." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion to comment on." + discussionId: ID! + "The Node ID of the discussion comment within this discussion to reply to." + replyToId: ID +} + +"Autogenerated input type of AddDiscussionPollVote" +input AddDiscussionPollVoteInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion poll option to vote for." + pollOptionId: ID! +} + +"Autogenerated input type of AddEnterpriseOrganizationMember" +input AddEnterpriseOrganizationMemberInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise which owns the organization." + enterpriseId: ID! + "The ID of the organization the users will be added to." + organizationId: ID! + "The role to assign the users in the organization" + role: OrganizationMemberRole + "The IDs of the enterprise members to add." + userIds: [ID!]! +} + +"Autogenerated input type of AddEnterpriseSupportEntitlement" +input AddEnterpriseSupportEntitlementInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Enterprise which the admin belongs to." + enterpriseId: ID! + "The login of a member who will receive the support entitlement." + login: String! +} + +"Autogenerated input type of AddLabelsToLabelable" +input AddLabelsToLabelableInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ids of the labels to add." + labelIds: [ID!]! + "The id of the labelable object to add labels to." + labelableId: ID! +} + +"Autogenerated input type of AddProjectCard" +input AddProjectCardInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The content of the card. Must be a member of the ProjectCardItem union" + contentId: ID + "The note on the card." + note: String + "The Node ID of the ProjectColumn." + projectColumnId: ID! +} + +"Autogenerated input type of AddProjectColumn" +input AddProjectColumnInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of the column." + name: String! + "The Node ID of the project." + projectId: ID! +} + +"Autogenerated input type of AddProjectV2DraftIssue" +input AddProjectV2DraftIssueInput { + "The IDs of the assignees of the draft issue." + assigneeIds: [ID!] + "The body of the draft issue." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Project to add the draft issue to." + projectId: ID! + "The title of the draft issue. A project item can also be created by providing the URL of an Issue or Pull Request if you have access." + title: String! +} + +"Autogenerated input type of AddProjectV2ItemById" +input AddProjectV2ItemByIdInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the Issue or Pull Request to add." + contentId: ID! + "The ID of the Project to add the item to." + projectId: ID! +} + +"Autogenerated input type of AddPullRequestReviewComment" +input AddPullRequestReviewCommentInput { + """ + + The text of the comment. This field is required + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `body` will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead + **Reason:** We are deprecating the addPullRequestReviewComment mutation + """ + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + """ + + The SHA of the commit to comment on. + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `commitOID` will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead + **Reason:** We are deprecating the addPullRequestReviewComment mutation + """ + commitOID: GitObjectID + """ + + The comment id to reply to. + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `inReplyTo` will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead + **Reason:** We are deprecating the addPullRequestReviewComment mutation + """ + inReplyTo: ID + """ + + The relative path of the file to comment on. + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `path` will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead + **Reason:** We are deprecating the addPullRequestReviewComment mutation + """ + path: String + """ + + The line index in the diff to comment on. + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `position` will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead + **Reason:** We are deprecating the addPullRequestReviewComment mutation + """ + position: Int + """ + + The node ID of the pull request reviewing + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `pullRequestId` will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead + **Reason:** We are deprecating the addPullRequestReviewComment mutation + """ + pullRequestId: ID + """ + + The Node ID of the review to modify. + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `pullRequestReviewId` will be removed. use addPullRequestReviewThread or addPullRequestReviewThreadReply instead + **Reason:** We are deprecating the addPullRequestReviewComment mutation + """ + pullRequestReviewId: ID +} + +"Autogenerated input type of AddPullRequestReview" +input AddPullRequestReviewInput { + "The contents of the review body comment." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + """ + + The review line comments. + + **Upcoming Change on 2023-10-01 UTC** + **Description:** `comments` will be removed. use the `threads` argument instead + **Reason:** We are deprecating comment fields that use diff-relative positioning + """ + comments: [DraftPullRequestReviewComment] + "The commit OID the review pertains to." + commitOID: GitObjectID + "The event to perform on the pull request review." + event: PullRequestReviewEvent + "The Node ID of the pull request to modify." + pullRequestId: ID! + "The review line comment threads." + threads: [DraftPullRequestReviewThread] +} + +"Autogenerated input type of AddPullRequestReviewThread" +input AddPullRequestReviewThreadInput { + "Body of the thread's first comment." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The line of the blob to which the thread refers, required for line-level threads. The end of the line range for multi-line comments." + line: Int + "Path to the file being commented on." + path: String + "The node ID of the pull request reviewing" + pullRequestId: ID + "The Node ID of the review to modify." + pullRequestReviewId: ID + "The side of the diff on which the line resides. For multi-line comments, this is the side for the end of the line range." + side: DiffSide = RIGHT + "The first line of the range to which the comment refers." + startLine: Int + "The side of the diff on which the start line resides." + startSide: DiffSide = RIGHT + "The level at which the comments in the corresponding thread are targeted, can be a diff line or a file" + subjectType: PullRequestReviewThreadSubjectType = LINE +} + +"Autogenerated input type of AddPullRequestReviewThreadReply" +input AddPullRequestReviewThreadReplyInput { + "The text of the reply." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the pending review to which the reply will belong." + pullRequestReviewId: ID + "The Node ID of the thread to which this reply is being written." + pullRequestReviewThreadId: ID! +} + +"Autogenerated input type of AddReaction" +input AddReactionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of the emoji to react with." + content: ReactionContent! + "The Node ID of the subject to modify." + subjectId: ID! +} + +"Autogenerated input type of AddStar" +input AddStarInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Starrable ID to star." + starrableId: ID! +} + +"Autogenerated input type of AddSubIssue" +input AddSubIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the issue." + issueId: ID! + "Option to replace parent issue if one already exists" + replaceParent: Boolean + "The id of the sub-issue." + subIssueId: ID + "The url of the sub-issue." + subIssueUrl: String +} + +"Autogenerated input type of AddUpvote" +input AddUpvoteInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion or comment to upvote." + subjectId: ID! +} + +"Autogenerated input type of AddVerifiableDomain" +input AddVerifiableDomainInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The URL of the domain" + domain: URI! + "The ID of the owner to add the domain to" + ownerId: ID! +} + +"Autogenerated input type of ApproveDeployments" +input ApproveDeploymentsInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Optional comment for approving deployments" + comment: String = "" + "The ids of environments to reject deployments" + environmentIds: [ID!]! + "The node ID of the workflow run containing the pending deployments." + workflowRunId: ID! +} + +"Autogenerated input type of ApproveVerifiableDomain" +input ApproveVerifiableDomainInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the verifiable domain to approve." + id: ID! +} + +"Autogenerated input type of ArchiveProjectV2Item" +input ArchiveProjectV2ItemInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the ProjectV2Item to archive." + itemId: ID! + "The ID of the Project to archive the item from." + projectId: ID! +} + +"Autogenerated input type of ArchiveRepository" +input ArchiveRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the repository to mark as archived." + repositoryId: ID! +} + +"Ordering options for Audit Log connections." +input AuditLogOrder { + "The ordering direction." + direction: OrderDirection + "The field to order Audit Logs by." + field: AuditLogOrderField +} + +"Parameters to be used for the branch_name_pattern rule" +input BranchNamePatternParametersInput { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"Information about a sponsorship to make for a user or organization with a GitHub Sponsors profile, as part of sponsoring many users or organizations at once." +input BulkSponsorship { + "The amount to pay to the sponsorable in US dollars. Valid values: 1-12000." + amount: Int! + "The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given." + sponsorableId: ID + "The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given." + sponsorableLogin: String +} + +"Autogenerated input type of CancelEnterpriseAdminInvitation" +input CancelEnterpriseAdminInvitationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the pending enterprise administrator invitation." + invitationId: ID! +} + +"Autogenerated input type of CancelEnterpriseMemberInvitation" +input CancelEnterpriseMemberInvitationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the pending enterprise member invitation." + invitationId: ID! +} + +"Autogenerated input type of CancelSponsorship" +input CancelSponsorshipInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given." + sponsorId: ID + "The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given." + sponsorLogin: String + "The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given." + sponsorableId: ID + "The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given." + sponsorableLogin: String +} + +"Autogenerated input type of ChangeUserStatus" +input ChangeUserStatusInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The emoji to represent your status. Can either be a native Unicode emoji or an emoji name with colons, e.g., :grinning:." + emoji: String + "If set, the user status will not be shown after this date." + expiresAt: DateTime + "Whether this status should indicate you are not fully available on GitHub, e.g., you are away." + limitedAvailability: Boolean = false + "A short description of your current status." + message: String + "The ID of the organization whose members will be allowed to see the status. If omitted, the status will be publicly visible." + organizationId: ID +} + +"Information from a check run analysis to specific lines of code." +input CheckAnnotationData { + "Represents an annotation's information level" + annotationLevel: CheckAnnotationLevel! + "The location of the annotation" + location: CheckAnnotationRange! + "A short description of the feedback for these lines of code." + message: String! + "The path of the file to add an annotation to." + path: String! + "Details about this annotation." + rawDetails: String + "The title that represents the annotation." + title: String +} + +"Information from a check run analysis to specific lines of code." +input CheckAnnotationRange { + "The ending column of the range." + endColumn: Int + "The ending line of the range." + endLine: Int! + "The starting column of the range." + startColumn: Int + "The starting line of the range." + startLine: Int! +} + +"Possible further actions the integrator can perform." +input CheckRunAction { + "A short explanation of what this action would do." + description: String! + "A reference for the action on the integrator's system. " + identifier: String! + "The text to be displayed on a button in the web UI." + label: String! +} + +"The filters that are available when fetching check runs." +input CheckRunFilter { + "Filters the check runs created by this application ID." + appId: Int + "Filters the check runs by this name." + checkName: String + "Filters the check runs by this type." + checkType: CheckRunType + "Filters the check runs by these conclusions." + conclusions: [CheckConclusionState!] + "Filters the check runs by this status. Superceded by statuses." + status: CheckStatusState + "Filters the check runs by this status. Overrides status." + statuses: [CheckStatusState!] +} + +"Descriptive details about the check run." +input CheckRunOutput { + "The annotations that are made as part of the check run." + annotations: [CheckAnnotationData!] + "Images attached to the check run output displayed in the GitHub pull request UI." + images: [CheckRunOutputImage!] + "The summary of the check run (supports Commonmark)." + summary: String! + "The details of the check run (supports Commonmark)." + text: String + "A title to provide for this check run." + title: String! +} + +"Images attached to the check run output displayed in the GitHub pull request UI." +input CheckRunOutputImage { + "The alternative text for the image." + alt: String! + "A short image description." + caption: String + "The full URL of the image." + imageUrl: URI! +} + +"The auto-trigger preferences that are available for check suites." +input CheckSuiteAutoTriggerPreference { + "The node ID of the application that owns the check suite." + appId: ID! + "Set to `true` to enable automatic creation of CheckSuite events upon pushes to the repository." + setting: Boolean! +} + +"The filters that are available when fetching check suites." +input CheckSuiteFilter { + "Filters the check suites created by this application ID." + appId: Int + "Filters the check suites by this name." + checkName: String +} + +"Autogenerated input type of ClearLabelsFromLabelable" +input ClearLabelsFromLabelableInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the labelable object to clear the labels from." + labelableId: ID! +} + +"Autogenerated input type of ClearProjectV2ItemFieldValue" +input ClearProjectV2ItemFieldValueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the field to be cleared." + fieldId: ID! + "The ID of the item to be cleared." + itemId: ID! + "The ID of the Project." + projectId: ID! +} + +"Autogenerated input type of CloneProject" +input CloneProjectInput { + "The description of the project." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether or not to clone the source project's workflows." + includeWorkflows: Boolean! + "The name of the project." + name: String! + "The visibility of the project, defaults to false (private)." + public: Boolean + "The source project to clone." + sourceId: ID! + "The owner ID to create the project under." + targetOwnerId: ID! +} + +"Autogenerated input type of CloneTemplateRepository" +input CloneTemplateRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A short description of the new repository." + description: String + "Whether to copy all branches from the template to the new repository. Defaults to copying only the default branch of the template." + includeAllBranches: Boolean = false + "The name of the new repository." + name: String! + "The ID of the owner for the new repository." + ownerId: ID! + "The Node ID of the template repository." + repositoryId: ID! + "Indicates the repository's visibility level." + visibility: RepositoryVisibility! +} + +"Autogenerated input type of CloseDiscussion" +input CloseDiscussionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the discussion to be closed." + discussionId: ID! + "The reason why the discussion is being closed." + reason: DiscussionCloseReason = RESOLVED +} + +"Autogenerated input type of CloseIssue" +input CloseIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the issue that this is a duplicate of." + duplicateIssueId: ID + "ID of the issue to be closed." + issueId: ID! + "The reason the issue is to be closed." + stateReason: IssueClosedStateReason +} + +"Autogenerated input type of ClosePullRequest" +input ClosePullRequestInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the pull request to be closed." + pullRequestId: ID! +} + +"Choose which tools must provide code scanning results before the reference is updated. When configured, code scanning must be enabled and have results for both the commit and the reference being updated." +input CodeScanningParametersInput { + "Tools that must provide code scanning results for this rule to pass." + codeScanningTools: [CodeScanningToolInput!]! +} + +"A tool that must provide code scanning results for this rule to pass." +input CodeScanningToolInput { + "The severity level at which code scanning results that raise alerts block a reference update. For more information on alert severity levels, see \"[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels).\"" + alertsThreshold: String! + "The severity level at which code scanning results that raise security alerts block a reference update. For more information on security severity levels, see \"[About code scanning alerts](${externalDocsUrl}/code-security/code-scanning/managing-code-scanning-alerts/about-code-scanning-alerts#about-alert-severity-and-security-severity-levels).\"" + securityAlertsThreshold: String! + "The name of a code scanning tool" + tool: String! +} + +"Specifies an author for filtering Git commits." +input CommitAuthor { + "Email addresses to filter by. Commits authored by any of the specified email addresses will be returned." + emails: [String!] + "ID of a User to filter by. If non-null, only commits authored by this user will be returned. This field takes precedence over emails." + id: ID +} + +"Parameters to be used for the commit_author_email_pattern rule" +input CommitAuthorEmailPatternParametersInput { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"Ordering options for commit contribution connections." +input CommitContributionOrder { + "The ordering direction." + direction: OrderDirection! + "The field by which to order commit contributions." + field: CommitContributionOrderField! +} + +"A message to include with a new commit" +input CommitMessage { + "The body of the message." + body: String + "The headline of the message." + headline: String! +} + +"Parameters to be used for the commit_message_pattern rule" +input CommitMessagePatternParametersInput { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +""" + +A git ref for a commit to be appended to. + +The ref must be a branch, i.e. its fully qualified name must start +with `refs/heads/` (although the input is not required to be fully +qualified). + +The Ref may be specified by its global node ID or by the +`repositoryNameWithOwner` and `branchName`. + +### Examples + +Specify a branch using a global node ID: + +{ "id": "MDM6UmVmMTpyZWZzL2hlYWRzL21haW4=" } + +Specify a branch using `repositoryNameWithOwner` and `branchName`: + +{ +"repositoryNameWithOwner": "github/graphql-client", +"branchName": "main" +} +""" +input CommittableBranch { + "The unqualified name of the branch to append the commit to." + branchName: String + "The Node ID of the Ref to be updated." + id: ID + "The nameWithOwner of the repository to commit to." + repositoryNameWithOwner: String +} + +"Parameters to be used for the committer_email_pattern rule" +input CommitterEmailPatternParametersInput { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"Ordering options for contribution connections." +input ContributionOrder { + "The ordering direction." + direction: OrderDirection! +} + +"Autogenerated input type of ConvertProjectCardNoteToIssue" +input ConvertProjectCardNoteToIssueInput { + "The body of the newly created issue." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ProjectCard ID to convert." + projectCardId: ID! + "The ID of the repository to create the issue in." + repositoryId: ID! + "The title of the newly created issue. Defaults to the card's note text." + title: String +} + +"Autogenerated input type of ConvertProjectV2DraftIssueItemToIssue" +input ConvertProjectV2DraftIssueItemToIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the draft issue ProjectV2Item to convert." + itemId: ID! + "The ID of the repository to create the issue in." + repositoryId: ID! +} + +"Autogenerated input type of ConvertPullRequestToDraft" +input ConvertPullRequestToDraftInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the pull request to convert to draft" + pullRequestId: ID! +} + +"Request Copilot code review for new pull requests automatically if the author has access to Copilot code review." +input CopilotCodeReviewParametersInput { + "Copilot automatically reviews draft pull requests before they are marked as ready for review." + reviewDraftPullRequests: Boolean + "Copilot automatically reviews each new push to the pull request." + reviewOnPush: Boolean +} + +"Autogenerated input type of CopyProjectV2" +input CopyProjectV2Input { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Include draft issues in the new project" + includeDraftIssues: Boolean = false + "The owner ID of the new project." + ownerId: ID! + "The ID of the source Project to copy." + projectId: ID! + "The title of the project." + title: String! +} + +"Autogenerated input type of CreateAttributionInvitation" +input CreateAttributionInvitationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the owner scoping the reattributable data." + ownerId: ID! + "The Node ID of the account owning the data to reattribute." + sourceId: ID! + "The Node ID of the account which may claim the data." + targetId: ID! +} + +"Autogenerated input type of CreateBranchProtectionRule" +input CreateBranchProtectionRuleInput { + "Can this branch be deleted." + allowsDeletions: Boolean + "Are force pushes allowed on this branch." + allowsForcePushes: Boolean + "Is branch creation a protected operation." + blocksCreations: Boolean + "A list of User, Team, or App IDs allowed to bypass force push targeting matching branches." + bypassForcePushActorIds: [ID!] + "A list of User, Team, or App IDs allowed to bypass pull requests targeting matching branches." + bypassPullRequestActorIds: [ID!] + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Will new commits pushed to matching branches dismiss pull request review approvals." + dismissesStaleReviews: Boolean + "Can admins override branch protection." + isAdminEnforced: Boolean + "Whether users can pull changes from upstream when the branch is locked. Set to `true` to allow fork syncing. Set to `false` to prevent fork syncing." + lockAllowsFetchAndMerge: Boolean + "Whether to set the branch as read-only. If this is true, users will not be able to push to the branch." + lockBranch: Boolean + "The glob-like pattern used to determine matching branches." + pattern: String! + "A list of User, Team, or App IDs allowed to push to matching branches." + pushActorIds: [ID!] + "The global relay id of the repository in which a new branch protection rule should be created in." + repositoryId: ID! + "Whether the most recent push must be approved by someone other than the person who pushed it" + requireLastPushApproval: Boolean + "Number of approving reviews required to update matching branches." + requiredApprovingReviewCount: Int + "The list of required deployment environments" + requiredDeploymentEnvironments: [String!] + "List of required status check contexts that must pass for commits to be accepted to matching branches." + requiredStatusCheckContexts: [String!] + "The list of required status checks" + requiredStatusChecks: [RequiredStatusCheckInput!] + "Are approving reviews required to update matching branches." + requiresApprovingReviews: Boolean + "Are reviews from code owners required to update matching branches." + requiresCodeOwnerReviews: Boolean + "Are commits required to be signed." + requiresCommitSignatures: Boolean + "Are conversations required to be resolved before merging." + requiresConversationResolution: Boolean + "Are successful deployments required before merging." + requiresDeployments: Boolean + "Are merge commits prohibited from being pushed to this branch." + requiresLinearHistory: Boolean + "Are status checks required to update matching branches." + requiresStatusChecks: Boolean + "Are branches required to be up to date before merging." + requiresStrictStatusChecks: Boolean + "Is pushing to matching branches restricted." + restrictsPushes: Boolean + "Is dismissal of pull request reviews restricted." + restrictsReviewDismissals: Boolean + "A list of User, Team, or App IDs allowed to dismiss reviews on pull requests targeting matching branches." + reviewDismissalActorIds: [ID!] +} + +"Autogenerated input type of CreateCheckRun" +input CreateCheckRunInput { + "Possible further actions the integrator can perform, which a user may trigger." + actions: [CheckRunAction!] + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The time that the check run finished." + completedAt: DateTime + "The final conclusion of the check." + conclusion: CheckConclusionState + "The URL of the integrator's site that has the full details of the check." + detailsUrl: URI + "A reference for the run on the integrator's system." + externalId: String + "The SHA of the head commit." + headSha: GitObjectID! + "The name of the check." + name: String! + "Descriptive details about the run." + output: CheckRunOutput + "The node ID of the repository." + repositoryId: ID! + "The time that the check run began." + startedAt: DateTime + "The current status." + status: RequestableCheckStatusState +} + +"Autogenerated input type of CreateCheckSuite" +input CreateCheckSuiteInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The SHA of the head commit." + headSha: GitObjectID! + "The Node ID of the repository." + repositoryId: ID! +} + +"Autogenerated input type of CreateCommitOnBranch" +input CreateCommitOnBranchInput { + "The Ref to be updated. Must be a branch." + branch: CommittableBranch! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The git commit oid expected at the head of the branch prior to the commit" + expectedHeadOid: GitObjectID! + "A description of changes to files in this commit." + fileChanges: FileChanges + "The commit message the be included with the commit." + message: CommitMessage! +} + +"Autogenerated input type of CreateDeployment" +input CreateDeploymentInput { + "Attempt to automatically merge the default branch into the requested ref, defaults to true." + autoMerge: Boolean = true + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Short description of the deployment." + description: String = "" + "Name for the target deployment environment." + environment: String = "production" + "JSON payload with extra information about the deployment." + payload: String = "{}" + "The node ID of the ref to be deployed." + refId: ID! + "The node ID of the repository." + repositoryId: ID! + "The status contexts to verify against commit status checks. To bypass required contexts, pass an empty array. Defaults to all unique contexts." + requiredContexts: [String!] + "Specifies a task to execute." + task: String = "deploy" +} + +"Autogenerated input type of CreateDeploymentStatus" +input CreateDeploymentStatusInput { + "Adds a new inactive status to all non-transient, non-production environment deployments with the same repository and environment name as the created status's deployment." + autoInactive: Boolean = true + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The node ID of the deployment." + deploymentId: ID! + "A short description of the status. Maximum length of 140 characters." + description: String = "" + "If provided, updates the environment of the deploy. Otherwise, does not modify the environment." + environment: String + "Sets the URL for accessing your environment." + environmentUrl: String = "" + "The log URL to associate with this status. This URL should contain output to keep the user updated while the task is running or serve as historical information for what happened in the deployment." + logUrl: String = "" + "The state of the deployment." + state: DeploymentStatusState! +} + +"Autogenerated input type of CreateDiscussion" +input CreateDiscussionInput { + "The body of the discussion." + body: String! + "The id of the discussion category to associate with this discussion." + categoryId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the repository on which to create the discussion." + repositoryId: ID! + "The title of the discussion." + title: String! +} + +"Autogenerated input type of CreateEnterpriseOrganization" +input CreateEnterpriseOrganizationInput { + "The logins for the administrators of the new organization." + adminLogins: [String!]! + "The email used for sending billing receipts." + billingEmail: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise owning the new organization." + enterpriseId: ID! + "The login of the new organization." + login: String! + "The profile name of the new organization." + profileName: String! +} + +"Autogenerated input type of CreateEnvironment" +input CreateEnvironmentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of the environment." + name: String! + "The node ID of the repository." + repositoryId: ID! +} + +"Autogenerated input type of CreateIpAllowListEntry" +input CreateIpAllowListEntryInput { + "An IP address or range of addresses in CIDR notation." + allowListValue: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether the IP allow list entry is active when an IP allow list is enabled." + isActive: Boolean! + "An optional name for the IP allow list entry." + name: String + "The ID of the owner for which to create the new IP allow list entry." + ownerId: ID! +} + +"Autogenerated input type of CreateIssue" +input CreateIssueInput { + "The Node ID of assignees for this issue." + assigneeIds: [ID!] + "The body for the issue description." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of an issue template in the repository, assigns labels and assignees from the template to the issue" + issueTemplate: String + "The Node ID of the issue type for this issue" + issueTypeId: ID + "An array of Node IDs of labels for this issue." + labelIds: [ID!] + "The Node ID of the milestone for this issue." + milestoneId: ID + "The Node ID of the parent issue to add this new issue to" + parentIssueId: ID + "An array of Node IDs for projects associated with this issue." + projectIds: [ID!] + "The Node ID of the repository." + repositoryId: ID! + "The title for the issue." + title: String! +} + +"Autogenerated input type of CreateIssueType" +input CreateIssueTypeInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Color for the issue type" + color: IssueTypeColor + "Description of the new issue type" + description: String + "Whether or not the issue type is enabled on the org level" + isEnabled: Boolean! + "Name of the new issue type" + name: String! + "The ID for the organization on which the issue type is created" + ownerId: ID! +} + +"Autogenerated input type of CreateLabel" +input CreateLabelInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A 6 character hex code, without the leading #, identifying the color of the label." + color: String! + "A brief description of the label, such as its purpose." + description: String + "The name of the label." + name: String! + "The Node ID of the repository." + repositoryId: ID! +} + +"Autogenerated input type of CreateLinkedBranch" +input CreateLinkedBranchInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the issue to link to." + issueId: ID! + "The name of the new branch. Defaults to issue number and title." + name: String + "The commit SHA to base the new branch on." + oid: GitObjectID! + "ID of the repository to create the branch in. Defaults to the issue repository." + repositoryId: ID +} + +"Autogenerated input type of CreateMigrationSource" +input CreateMigrationSourceInput { + "The migration source access token." + accessToken: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The GitHub personal access token of the user importing to the target repository." + githubPat: String + "The migration source name." + name: String! + "The ID of the organization that will own the migration source." + ownerId: ID! + "The migration source type." + type: MigrationSourceType! + "The migration source URL, for example `https://github.com` or `https://monalisa.ghe.com`." + url: String +} + +"Autogenerated input type of CreateProject" +input CreateProjectInput { + "The description of project." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of project." + name: String! + "The owner ID to create the project under." + ownerId: ID! + "A list of repository IDs to create as linked repositories for the project" + repositoryIds: [ID!] + "The name of the GitHub-provided template." + template: ProjectTemplate +} + +"Autogenerated input type of CreateProjectV2Field" +input CreateProjectV2FieldInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The data type of the field." + dataType: ProjectV2CustomFieldType! + "Configuration for an iteration field." + iterationConfiguration: ProjectV2IterationFieldConfigurationInput + "The name of the field." + name: String! + "The ID of the Project to create the field in." + projectId: ID! + "Options for a single select field. At least one value is required if data_type is SINGLE_SELECT" + singleSelectOptions: [ProjectV2SingleSelectFieldOptionInput!] +} + +"Autogenerated input type of CreateProjectV2" +input CreateProjectV2Input { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The owner ID to create the project under." + ownerId: ID! + "The repository to link the project to." + repositoryId: ID + "The team to link the project to. The team will be granted read permissions." + teamId: ID + "The title of the project." + title: String! +} + +"Autogenerated input type of CreateProjectV2StatusUpdate" +input CreateProjectV2StatusUpdateInput { + "The body of the status update." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Project to create the status update in." + projectId: ID! + "The start date of the status update." + startDate: Date + "The status of the status update." + status: ProjectV2StatusUpdateStatus + "The target date of the status update." + targetDate: Date +} + +"Autogenerated input type of CreatePullRequest" +input CreatePullRequestInput { + """ + + The name of the branch you want your changes pulled into. This should be an existing branch + on the current repository. You cannot update the base branch on a pull request to point + to another repository. + """ + baseRefName: String! + "The contents of the pull request." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Indicates whether this pull request should be a draft." + draft: Boolean = false + """ + + The name of the branch where your changes are implemented. For cross-repository pull requests + in the same network, namespace `head_ref_name` with a user like this: `username:branch`. + """ + headRefName: String! + "The Node ID of the head repository." + headRepositoryId: ID + "Indicates whether maintainers can modify the pull request." + maintainerCanModify: Boolean = true + "The Node ID of the repository." + repositoryId: ID! + "The title of the pull request." + title: String! +} + +"Autogenerated input type of CreateRef" +input CreateRefInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The fully qualified name of the new Ref (ie: `refs/heads/my_new_branch`)." + name: String! + "The GitObjectID that the new Ref shall target. Must point to a commit." + oid: GitObjectID! + "The Node ID of the Repository to create the Ref in." + repositoryId: ID! +} + +"Autogenerated input type of CreateRepository" +input CreateRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A short description of the new repository." + description: String + "Indicates if the repository should have the issues feature enabled." + hasIssuesEnabled: Boolean = true + "Indicates if the repository should have the wiki feature enabled." + hasWikiEnabled: Boolean = false + "The URL for a web page about this repository." + homepageUrl: URI + "The name of the new repository." + name: String! + "The ID of the owner for the new repository." + ownerId: ID + "When an organization is specified as the owner, this ID identifies the team that should be granted access to the new repository." + teamId: ID + "Whether this repository should be marked as a template such that anyone who can access it can create new repositories with the same files and directory structure." + template: Boolean = false + "Indicates the repository's visibility level." + visibility: RepositoryVisibility! +} + +"Autogenerated input type of CreateRepositoryRuleset" +input CreateRepositoryRulesetInput { + "A list of actors that are allowed to bypass rules in this ruleset." + bypassActors: [RepositoryRulesetBypassActorInput!] + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The set of conditions for this ruleset" + conditions: RepositoryRuleConditionsInput! + "The enforcement level for this ruleset" + enforcement: RuleEnforcement! + "The name of the ruleset." + name: String! + "The list of rules for this ruleset" + rules: [RepositoryRuleInput!] + "The global relay id of the source in which a new ruleset should be created in." + sourceId: ID! + "The target of the ruleset." + target: RepositoryRulesetTarget +} + +"Autogenerated input type of CreateSponsorsListing" +input CreateSponsorsListingInput { + "The country or region where the sponsorable's bank account is located. Required if fiscalHostLogin is not specified, ignored when fiscalHostLogin is specified." + billingCountryOrRegionCode: SponsorsCountryOrRegionCode + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The email address we should use to contact you about the GitHub Sponsors profile being created. This will not be shared publicly. Must be a verified email address already on your GitHub account. Only relevant when the sponsorable is yourself. Defaults to your primary email address on file if omitted." + contactEmail: String + "The username of the supported fiscal host's GitHub organization, if you want to receive sponsorship payouts through a fiscal host rather than directly to a bank account. For example, 'Open-Source-Collective' for Open Source Collective or 'numfocus' for numFOCUS. Case insensitive. See https://docs.github.com/sponsors/receiving-sponsorships-through-github-sponsors/using-a-fiscal-host-to-receive-github-sponsors-payouts for more information." + fiscalHostLogin: String + "The URL for your profile page on the fiscal host's website, e.g., https://opencollective.com/babel or https://numfocus.org/project/bokeh. Required if fiscalHostLogin is specified." + fiscallyHostedProjectProfileUrl: String + "Provide an introduction to serve as the main focus that appears on your GitHub Sponsors profile. It's a great opportunity to help potential sponsors learn more about you, your work, and why their sponsorship is important to you. GitHub-flavored Markdown is supported." + fullDescription: String + "The country or region where the sponsorable resides. This is for tax purposes. Required if the sponsorable is yourself, ignored when sponsorableLogin specifies an organization." + residenceCountryOrRegionCode: SponsorsCountryOrRegionCode + "The username of the organization to create a GitHub Sponsors profile for, if desired. Defaults to creating a GitHub Sponsors profile for the authenticated user if omitted." + sponsorableLogin: String +} + +"Autogenerated input type of CreateSponsorsTier" +input CreateSponsorsTierInput { + "The value of the new tier in US dollars. Valid values: 1-12000." + amount: Int! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A description of what this tier is, what perks sponsors might receive, what a sponsorship at this tier means for you, etc." + description: String! + "Whether sponsorships using this tier should happen monthly/yearly or just once." + isRecurring: Boolean = true + "Whether to make the tier available immediately for sponsors to choose. Defaults to creating a draft tier that will not be publicly visible." + publish: Boolean = false + "Optional ID of the private repository that sponsors at this tier should gain read-only access to. Must be owned by an organization." + repositoryId: ID + "Optional name of the private repository that sponsors at this tier should gain read-only access to. Must be owned by an organization. Necessary if repositoryOwnerLogin is given. Will be ignored if repositoryId is given." + repositoryName: String + "Optional login of the organization owner of the private repository that sponsors at this tier should gain read-only access to. Necessary if repositoryName is given. Will be ignored if repositoryId is given." + repositoryOwnerLogin: String + "The ID of the user or organization who owns the GitHub Sponsors profile. Defaults to the current user if omitted and sponsorableLogin is not given." + sponsorableId: ID + "The username of the user or organization who owns the GitHub Sponsors profile. Defaults to the current user if omitted and sponsorableId is not given." + sponsorableLogin: String + "Optional message new sponsors at this tier will receive." + welcomeMessage: String +} + +"Autogenerated input type of CreateSponsorship" +input CreateSponsorshipInput { + "The amount to pay to the sponsorable in US dollars. Required if a tierId is not specified. Valid values: 1-12000." + amount: Int + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether the sponsorship should happen monthly/yearly or just this one time. Required if a tierId is not specified." + isRecurring: Boolean + "Specify whether others should be able to see that the sponsor is sponsoring the sponsorable. Public visibility still does not reveal which tier is used." + privacyLevel: SponsorshipPrivacy = PUBLIC + "Whether the sponsor should receive email updates from the sponsorable." + receiveEmails: Boolean = true + "The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given." + sponsorId: ID + "The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given." + sponsorLogin: String + "The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given." + sponsorableId: ID + "The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given." + sponsorableLogin: String + "The ID of one of sponsorable's existing tiers to sponsor at. Required if amount is not specified." + tierId: ID +} + +"Autogenerated input type of CreateSponsorships" +input CreateSponsorshipsInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Specify whether others should be able to see that the sponsor is sponsoring the sponsorables. Public visibility still does not reveal the dollar value of the sponsorship." + privacyLevel: SponsorshipPrivacy = PUBLIC + "Whether the sponsor should receive email updates from the sponsorables." + receiveEmails: Boolean = false + "Whether the sponsorships created should continue each billing cycle for the sponsor (monthly or annually), versus lasting only a single month. Defaults to one-time sponsorships." + recurring: Boolean = false + "The username of the user or organization who is acting as the sponsor, paying for the sponsorships." + sponsorLogin: String! + "The list of maintainers to sponsor and for how much apiece." + sponsorships: [BulkSponsorship!]! +} + +"Autogenerated input type of CreateTeamDiscussionComment" +input CreateTeamDiscussionCommentInput { + """ + + The content of the comment. This field is required. + + **Upcoming Change on 2024-07-01 UTC** + **Description:** `body` will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. + **Reason:** The Team Discussions feature is deprecated in favor of Organization Discussions. + """ + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + """ + + The ID of the discussion to which the comment belongs. This field is required. + + **Upcoming Change on 2024-07-01 UTC** + **Description:** `discussionId` will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. + **Reason:** The Team Discussions feature is deprecated in favor of Organization Discussions. + """ + discussionId: ID +} + +"Autogenerated input type of CreateTeamDiscussion" +input CreateTeamDiscussionInput { + """ + + The content of the discussion. This field is required. + + **Upcoming Change on 2024-07-01 UTC** + **Description:** `body` will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. + **Reason:** The Team Discussions feature is deprecated in favor of Organization Discussions. + """ + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + """ + + If true, restricts the visibility of this discussion to team members and organization owners. If false or not specified, allows any organization member to view this discussion. + + **Upcoming Change on 2024-07-01 UTC** + **Description:** `private` will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. + **Reason:** The Team Discussions feature is deprecated in favor of Organization Discussions. + """ + private: Boolean + """ + + The ID of the team to which the discussion belongs. This field is required. + + **Upcoming Change on 2024-07-01 UTC** + **Description:** `teamId` will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. + **Reason:** The Team Discussions feature is deprecated in favor of Organization Discussions. + """ + teamId: ID + """ + + The title of the discussion. This field is required. + + **Upcoming Change on 2024-07-01 UTC** + **Description:** `title` will be removed. Follow the guide at https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/ to find a suitable replacement. + **Reason:** The Team Discussions feature is deprecated in favor of Organization Discussions. + """ + title: String +} + +"Autogenerated input type of CreateUserList" +input CreateUserListInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A description of the list" + description: String + "Whether or not the list is private" + isPrivate: Boolean = false + "The name of the new list" + name: String! +} + +"Autogenerated input type of DeclineTopicSuggestion" +input DeclineTopicSuggestionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + """ + + The name of the suggested topic. + + **Upcoming Change on 2024-04-01 UTC** + **Description:** `name` will be removed. + **Reason:** Suggested topics are no longer supported + """ + name: String + """ + + The reason why the suggested topic is declined. + + **Upcoming Change on 2024-04-01 UTC** + **Description:** `reason` will be removed. + **Reason:** Suggested topics are no longer supported + """ + reason: TopicSuggestionDeclineReason + """ + + The Node ID of the repository. + + **Upcoming Change on 2024-04-01 UTC** + **Description:** `repositoryId` will be removed. + **Reason:** Suggested topics are no longer supported + """ + repositoryId: ID +} + +"Autogenerated input type of DeleteBranchProtectionRule" +input DeleteBranchProtectionRuleInput { + "The global relay id of the branch protection rule to be deleted." + branchProtectionRuleId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated input type of DeleteDeployment" +input DeleteDeploymentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the deployment to be deleted." + id: ID! +} + +"Autogenerated input type of DeleteDiscussionComment" +input DeleteDiscussionCommentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node id of the discussion comment to delete." + id: ID! +} + +"Autogenerated input type of DeleteDiscussion" +input DeleteDiscussionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the discussion to delete." + id: ID! +} + +"Autogenerated input type of DeleteEnvironment" +input DeleteEnvironmentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the environment to be deleted." + id: ID! +} + +"Autogenerated input type of DeleteIpAllowListEntry" +input DeleteIpAllowListEntryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the IP allow list entry to delete." + ipAllowListEntryId: ID! +} + +"Autogenerated input type of DeleteIssueComment" +input DeleteIssueCommentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the comment to delete." + id: ID! +} + +"Autogenerated input type of DeleteIssue" +input DeleteIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the issue to delete." + issueId: ID! +} + +"Autogenerated input type of DeleteIssueType" +input DeleteIssueTypeInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the issue type to delete" + issueTypeId: ID! +} + +"Autogenerated input type of DeleteLabel" +input DeleteLabelInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the label to be deleted." + id: ID! +} + +"Autogenerated input type of DeleteLinkedBranch" +input DeleteLinkedBranchInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the linked branch" + linkedBranchId: ID! +} + +"Autogenerated input type of DeletePackageVersion" +input DeletePackageVersionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the package version to be deleted." + packageVersionId: ID! +} + +"Autogenerated input type of DeleteProjectCard" +input DeleteProjectCardInput { + "The id of the card to delete." + cardId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated input type of DeleteProjectColumn" +input DeleteProjectColumnInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the column to delete." + columnId: ID! +} + +"Autogenerated input type of DeleteProject" +input DeleteProjectInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Project ID to update." + projectId: ID! +} + +"Autogenerated input type of DeleteProjectV2Field" +input DeleteProjectV2FieldInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the field to delete." + fieldId: ID! +} + +"Autogenerated input type of DeleteProjectV2" +input DeleteProjectV2Input { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Project to delete." + projectId: ID! +} + +"Autogenerated input type of DeleteProjectV2Item" +input DeleteProjectV2ItemInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the item to be removed." + itemId: ID! + "The ID of the Project from which the item should be removed." + projectId: ID! +} + +"Autogenerated input type of DeleteProjectV2StatusUpdate" +input DeleteProjectV2StatusUpdateInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the status update to be removed." + statusUpdateId: ID! +} + +"Autogenerated input type of DeleteProjectV2Workflow" +input DeleteProjectV2WorkflowInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the workflow to be removed." + workflowId: ID! +} + +"Autogenerated input type of DeletePullRequestReviewComment" +input DeletePullRequestReviewCommentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the comment to delete." + id: ID! +} + +"Autogenerated input type of DeletePullRequestReview" +input DeletePullRequestReviewInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the pull request review to delete." + pullRequestReviewId: ID! +} + +"Autogenerated input type of DeleteRef" +input DeleteRefInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the Ref to be deleted." + refId: ID! +} + +"Autogenerated input type of DeleteRepositoryRuleset" +input DeleteRepositoryRulesetInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The global relay id of the repository ruleset to be deleted." + repositoryRulesetId: ID! +} + +"Autogenerated input type of DeleteTeamDiscussionComment" +input DeleteTeamDiscussionCommentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the comment to delete." + id: ID! +} + +"Autogenerated input type of DeleteTeamDiscussion" +input DeleteTeamDiscussionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The discussion ID to delete." + id: ID! +} + +"Autogenerated input type of DeleteUserList" +input DeleteUserListInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the list to delete." + listId: ID! +} + +"Autogenerated input type of DeleteVerifiableDomain" +input DeleteVerifiableDomainInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the verifiable domain to delete." + id: ID! +} + +"Ordering options for deployment connections" +input DeploymentOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order deployments by." + field: DeploymentOrderField! +} + +"Autogenerated input type of DequeuePullRequest" +input DequeuePullRequestInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the pull request to be dequeued." + id: ID! +} + +"Autogenerated input type of DisablePullRequestAutoMerge" +input DisablePullRequestAutoMergeInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the pull request to disable auto merge on." + pullRequestId: ID! +} + +"Ways in which lists of discussions can be ordered upon return." +input DiscussionOrder { + "The direction in which to order discussions by the specified field." + direction: OrderDirection! + "The field by which to order discussions." + field: DiscussionOrderField! +} + +"Ordering options for discussion poll option connections." +input DiscussionPollOptionOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order poll options by." + field: DiscussionPollOptionOrderField! +} + +"Autogenerated input type of DismissPullRequestReview" +input DismissPullRequestReviewInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The contents of the pull request review dismissal message." + message: String! + "The Node ID of the pull request review to modify." + pullRequestReviewId: ID! +} + +"Autogenerated input type of DismissRepositoryVulnerabilityAlert" +input DismissRepositoryVulnerabilityAlertInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The reason the Dependabot alert is being dismissed." + dismissReason: DismissReason! + "The Dependabot alert ID to dismiss." + repositoryVulnerabilityAlertId: ID! +} + +"Specifies a review comment to be left with a Pull Request Review." +input DraftPullRequestReviewComment { + "Body of the comment to leave." + body: String! + "Path to the file being commented on." + path: String! + "Position in the file to leave a comment on." + position: Int! +} + +"Specifies a review comment thread to be left with a Pull Request Review." +input DraftPullRequestReviewThread { + "Body of the comment to leave." + body: String! + "The line of the blob to which the thread refers. The end of the line range for multi-line comments. Required if not using positioning." + line: Int + "Path to the file being commented on. Required if not using positioning." + path: String + "The side of the diff on which the line resides. For multi-line comments, this is the side for the end of the line range." + side: DiffSide = RIGHT + "The first line of the range to which the comment refers." + startLine: Int + "The side of the diff on which the start line resides." + startSide: DiffSide = RIGHT +} + +"Autogenerated input type of EnablePullRequestAutoMerge" +input EnablePullRequestAutoMergeInput { + "The email address to associate with this merge." + authorEmail: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Commit body to use for the commit when the PR is mergable; if omitted, a default message will be used. NOTE: when merging with a merge queue any input value for commit message is ignored." + commitBody: String + "Commit headline to use for the commit when the PR is mergable; if omitted, a default message will be used. NOTE: when merging with a merge queue any input value for commit headline is ignored." + commitHeadline: String + "The expected head OID of the pull request." + expectedHeadOid: GitObjectID + "The merge method to use. If omitted, defaults to `MERGE`. NOTE: when merging with a merge queue any input value for merge method is ignored." + mergeMethod: PullRequestMergeMethod = MERGE + "ID of the pull request to enable auto-merge on." + pullRequestId: ID! +} + +"Autogenerated input type of EnqueuePullRequest" +input EnqueuePullRequestInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The expected head OID of the pull request." + expectedHeadOid: GitObjectID + "Add the pull request to the front of the queue." + jump: Boolean + "The ID of the pull request to enqueue." + pullRequestId: ID! +} + +"Ordering options for enterprise administrator invitation connections" +input EnterpriseAdministratorInvitationOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order enterprise administrator invitations by." + field: EnterpriseAdministratorInvitationOrderField! +} + +"Ordering options for enterprise administrator invitation connections" +input EnterpriseMemberInvitationOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order enterprise member invitations by." + field: EnterpriseMemberInvitationOrderField! +} + +"Ordering options for enterprise member connections." +input EnterpriseMemberOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order enterprise members by." + field: EnterpriseMemberOrderField! +} + +"Ordering options for enterprises." +input EnterpriseOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order enterprises by." + field: EnterpriseOrderField! +} + +"Ordering options for Enterprise Server installation connections." +input EnterpriseServerInstallationOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order Enterprise Server installations by." + field: EnterpriseServerInstallationOrderField! +} + +"Ordering options for Enterprise Server user account email connections." +input EnterpriseServerUserAccountEmailOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order emails by." + field: EnterpriseServerUserAccountEmailOrderField! +} + +"Ordering options for Enterprise Server user account connections." +input EnterpriseServerUserAccountOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order user accounts by." + field: EnterpriseServerUserAccountOrderField! +} + +"Ordering options for Enterprise Server user accounts upload connections." +input EnterpriseServerUserAccountsUploadOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order user accounts uploads by." + field: EnterpriseServerUserAccountsUploadOrderField! +} + +"Ordering options for environments" +input Environments { + "The direction in which to order environments by the specified field." + direction: OrderDirection! + "The field to order environments by." + field: EnvironmentOrderField! +} + +"A command to add a file at the given path with the given contents as part of a commit. Any existing file at that that path will be replaced." +input FileAddition { + "The base64 encoded contents of the file" + contents: Base64String! + "The path in the repository where the file will be located" + path: String! +} + +""" + +A description of a set of changes to a file tree to be made as part of +a git commit, modeled as zero or more file `additions` and zero or more +file `deletions`. + +Both fields are optional; omitting both will produce a commit with no +file changes. + +`deletions` and `additions` describe changes to files identified +by their path in the git tree using unix-style path separators, i.e. +`/`. The root of a git tree is an empty string, so paths are not +slash-prefixed. + +`path` values must be unique across all `additions` and `deletions` +provided. Any duplication will result in a validation error. + +### Encoding + +File contents must be provided in full for each `FileAddition`. + +The `contents` of a `FileAddition` must be encoded using RFC 4648 +compliant base64, i.e. correct padding is required and no characters +outside the standard alphabet may be used. Invalid base64 +encoding will be rejected with a validation error. + +The encoded contents may be binary. + +For text files, no assumptions are made about the character encoding of +the file contents (after base64 decoding). No charset transcoding or +line-ending normalization will be performed; it is the client's +responsibility to manage the character encoding of files they provide. +However, for maximum compatibility we recommend using UTF-8 encoding +and ensuring that all files in a repository use a consistent +line-ending convention (`\n` or `\r\n`), and that all files end +with a newline. + +### Modeling file changes + +Each of the the five types of conceptual changes that can be made in a +git commit can be described using the `FileChanges` type as follows: + +1. New file addition: create file `hello world\n` at path `docs/README.txt`: + +{ +"additions" [ +{ +"path": "docs/README.txt", +"contents": base64encode("hello world\n") +} +] +} + +2. Existing file modification: change existing `docs/README.txt` to have new +content `new content here\n`: + +{ +"additions" [ +{ +"path": "docs/README.txt", +"contents": base64encode("new content here\n") +} +] +} + +3. Existing file deletion: remove existing file `docs/README.txt`. +Note that the path is required to exist -- specifying a +path that does not exist on the given branch will abort the +commit and return an error. + +{ +"deletions" [ +{ +"path": "docs/README.txt" +} +] +} + + +4. File rename with no changes: rename `docs/README.txt` with +previous content `hello world\n` to the same content at +`newdocs/README.txt`: + +{ +"deletions" [ +{ +"path": "docs/README.txt", +} +], +"additions" [ +{ +"path": "newdocs/README.txt", +"contents": base64encode("hello world\n") +} +] +} + + +5. File rename with changes: rename `docs/README.txt` with +previous content `hello world\n` to a file at path +`newdocs/README.txt` with content `new contents\n`: + +{ +"deletions" [ +{ +"path": "docs/README.txt", +} +], +"additions" [ +{ +"path": "newdocs/README.txt", +"contents": base64encode("new contents\n") +} +] +} +""" +input FileChanges { + "File to add or change." + additions: [FileAddition!] = [] + "Files to delete." + deletions: [FileDeletion!] = [] +} + +"A command to delete the file at the given path as part of a commit." +input FileDeletion { + "The path to delete" + path: String! +} + +"Prevent commits that include files with specified file extensions from being pushed to the commit graph." +input FileExtensionRestrictionParametersInput { + "The file extensions that are restricted from being pushed to the commit graph." + restrictedFileExtensions: [String!]! +} + +"Prevent commits that include changes in specified file and folder paths from being pushed to the commit graph. This includes absolute paths that contain file names." +input FilePathRestrictionParametersInput { + "The file paths that are restricted from being pushed to the commit graph." + restrictedFilePaths: [String!]! +} + +"Autogenerated input type of FollowOrganization" +input FollowOrganizationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the organization to follow." + organizationId: ID! +} + +"Autogenerated input type of FollowUser" +input FollowUserInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the user to follow." + userId: ID! +} + +"Ordering options for gist connections" +input GistOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order repositories by." + field: GistOrderField! +} + +"Autogenerated input type of GrantEnterpriseOrganizationsMigratorRole" +input GrantEnterpriseOrganizationsMigratorRoleInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise to which all organizations managed by it will be granted the migrator role." + enterpriseId: ID! + "The login of the user to grant the migrator role" + login: String! +} + +"Autogenerated input type of GrantMigratorRole" +input GrantMigratorRoleInput { + "The user login or Team slug to grant the migrator role." + actor: String! + "Specifies the type of the actor, can be either USER or TEAM." + actorType: ActorType! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the organization that the user/team belongs to." + organizationId: ID! +} + +"Autogenerated input type of ImportProject" +input ImportProjectInput { + "The description of Project." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A list of columns containing issues and pull requests." + columnImports: [ProjectColumnImport!]! + "The name of Project." + name: String! + "The name of the Organization or User to create the Project under." + ownerName: String! + "Whether the Project is public or not." + public: Boolean = false +} + +"Autogenerated input type of InviteEnterpriseAdmin" +input InviteEnterpriseAdminInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The email of the person to invite as an administrator." + email: String + "The ID of the enterprise to which you want to invite an administrator." + enterpriseId: ID! + "The login of a user to invite as an administrator." + invitee: String + "The role of the administrator." + role: EnterpriseAdministratorRole +} + +"Autogenerated input type of InviteEnterpriseMember" +input InviteEnterpriseMemberInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The email of the person to invite as an unaffiliated member." + email: String + "The ID of the enterprise to which you want to invite an unaffiliated member." + enterpriseId: ID! + "The login of a user to invite as an unaffiliated member." + invitee: String +} + +"Ordering options for IP allow list entry connections." +input IpAllowListEntryOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order IP allow list entries by." + field: IpAllowListEntryOrderField! +} + +"Ways in which lists of issue comments can be ordered upon return." +input IssueCommentOrder { + "The direction in which to order issue comments by the specified field." + direction: OrderDirection! + "The field in which to order issue comments by." + field: IssueCommentOrderField! +} + +"Ordering options issue dependencies" +input IssueDependencyOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order issue dependencies by." + field: IssueDependencyOrderField! +} + +"Ways in which to filter lists of issues." +input IssueFilters { + "List issues assigned to given name. Pass in `null` for issues with no assigned user, and `*` for issues assigned to any user." + assignee: String + "List issues created by given name." + createdBy: String + "List issues where the list of label names exist on the issue." + labels: [String!] + "List issues where the given name is mentioned in the issue." + mentioned: String + "List issues by given milestone argument. If an string representation of an integer is passed, it should refer to a milestone by its database ID. Pass in `null` for issues with no milestone, and `*` for issues that are assigned to any milestone." + milestone: String + "List issues by given milestone argument. If an string representation of an integer is passed, it should refer to a milestone by its number field. Pass in `null` for issues with no milestone, and `*` for issues that are assigned to any milestone." + milestoneNumber: String + "List issues that have been updated at or after the given date." + since: DateTime + "List issues filtered by the list of states given." + states: [IssueState!] + "List issues filtered by the type given, only supported by searches on repositories." + type: String + "List issues subscribed to by viewer." + viewerSubscribed: Boolean = false +} + +"Ways in which lists of issues can be ordered upon return." +input IssueOrder { + "The direction in which to order issues by the specified field." + direction: OrderDirection! + "The field in which to order issues by." + field: IssueOrderField! +} + +"Ordering options for issue types connections" +input IssueTypeOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order issue types by." + field: IssueTypeOrderField! +} + +"Ways in which lists of labels can be ordered upon return." +input LabelOrder { + "The direction in which to order labels by the specified field." + direction: OrderDirection! + "The field in which to order labels by." + field: LabelOrderField! +} + +"Ordering options for language connections." +input LanguageOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order languages by." + field: LanguageOrderField! +} + +"Autogenerated input type of LinkProjectV2ToRepository" +input LinkProjectV2ToRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the project to link to the repository." + projectId: ID! + "The ID of the repository to link to the project." + repositoryId: ID! +} + +"Autogenerated input type of LinkProjectV2ToTeam" +input LinkProjectV2ToTeamInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the project to link to the team." + projectId: ID! + "The ID of the team to link to the project." + teamId: ID! +} + +"Autogenerated input type of LinkRepositoryToProject" +input LinkRepositoryToProjectInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Project to link to a Repository" + projectId: ID! + "The ID of the Repository to link to a Project." + repositoryId: ID! +} + +"Autogenerated input type of LockLockable" +input LockLockableInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A reason for why the item will be locked." + lockReason: LockReason + "ID of the item to be locked." + lockableId: ID! +} + +"Ordering options for mannequins." +input MannequinOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order mannequins by." + field: MannequinOrderField! +} + +"Autogenerated input type of MarkDiscussionCommentAsAnswer" +input MarkDiscussionCommentAsAnswerInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion comment to mark as an answer." + id: ID! +} + +"Autogenerated input type of MarkFileAsViewed" +input MarkFileAsViewedInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The path of the file to mark as viewed" + path: String! + "The Node ID of the pull request." + pullRequestId: ID! +} + +"Autogenerated input type of MarkProjectV2AsTemplate" +input MarkProjectV2AsTemplateInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Project to mark as a template." + projectId: ID! +} + +"Autogenerated input type of MarkPullRequestReadyForReview" +input MarkPullRequestReadyForReviewInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the pull request to be marked as ready for review." + pullRequestId: ID! +} + +"Prevent commits that include file paths that exceed the specified character limit from being pushed to the commit graph." +input MaxFilePathLengthParametersInput { + "The maximum amount of characters allowed in file paths." + maxFilePathLength: Int! +} + +"Prevent commits with individual files that exceed the specified limit from being pushed to the commit graph." +input MaxFileSizeParametersInput { + "The maximum file size allowed in megabytes. This limit does not apply to Git Large File Storage (Git LFS)." + maxFileSize: Int! +} + +"Autogenerated input type of MergeBranch" +input MergeBranchInput { + "The email address to associate with this commit." + authorEmail: String + "The name of the base branch that the provided head will be merged into." + base: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Message to use for the merge commit. If omitted, a default will be used." + commitMessage: String + "The head to merge into the base branch. This can be a branch name or a commit GitObjectID." + head: String! + "The Node ID of the Repository containing the base branch that will be modified." + repositoryId: ID! +} + +"Autogenerated input type of MergePullRequest" +input MergePullRequestInput { + "The email address to associate with this merge." + authorEmail: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Commit body to use for the merge commit; if omitted, a default message will be used" + commitBody: String + "Commit headline to use for the merge commit; if omitted, a default message will be used." + commitHeadline: String + "OID that the pull request head ref must match to allow merge; if omitted, no check is performed." + expectedHeadOid: GitObjectID + "The merge method to use. If omitted, defaults to 'MERGE'" + mergeMethod: PullRequestMergeMethod = MERGE + "ID of the pull request to be merged." + pullRequestId: ID! +} + +"Merges must be performed via a merge queue." +input MergeQueueParametersInput { + "Maximum time for a required status check to report a conclusion. After this much time has elapsed, checks that have not reported a conclusion will be assumed to have failed" + checkResponseTimeoutMinutes: Int! + "When set to ALLGREEN, the merge commit created by merge queue for each PR in the group must pass all required checks to merge. When set to HEADGREEN, only the commit at the head of the merge group, i.e. the commit containing changes from all of the PRs in the group, must pass its required checks to merge." + groupingStrategy: MergeQueueGroupingStrategy! + "Limit the number of queued pull requests requesting checks and workflow runs at the same time." + maxEntriesToBuild: Int! + "The maximum number of PRs that will be merged together in a group." + maxEntriesToMerge: Int! + "Method to use when merging changes from queued pull requests." + mergeMethod: MergeQueueMergeMethod! + "The minimum number of PRs that will be merged together in a group." + minEntriesToMerge: Int! + "The time merge queue should wait after the first PR is added to the queue for the minimum group size to be met. After this time has elapsed, the minimum group size will be ignored and a smaller group will be merged." + minEntriesToMergeWaitMinutes: Int! +} + +"Ordering options for milestone connections." +input MilestoneOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order milestones by." + field: MilestoneOrderField! +} + +"Autogenerated input type of MinimizeComment" +input MinimizeCommentInput { + "The classification of comment" + classifier: ReportedContentClassifiers! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the subject to modify." + subjectId: ID! +} + +"Autogenerated input type of MoveProjectCard" +input MoveProjectCardInput { + "Place the new card after the card with this id. Pass null to place it at the top." + afterCardId: ID + "The id of the card to move." + cardId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the column to move it into." + columnId: ID! +} + +"Autogenerated input type of MoveProjectColumn" +input MoveProjectColumnInput { + "Place the new column after the column with this id. Pass null to place it at the front." + afterColumnId: ID + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the column to move." + columnId: ID! +} + +"Ordering options for an organization's enterprise owner connections." +input OrgEnterpriseOwnerOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order enterprise owners by." + field: OrgEnterpriseOwnerOrderField! +} + +"Ordering options for organization connections." +input OrganizationOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order organizations by." + field: OrganizationOrderField! +} + +"Ways in which lists of package files can be ordered upon return." +input PackageFileOrder { + "The direction in which to order package files by the specified field." + direction: OrderDirection + "The field in which to order package files by." + field: PackageFileOrderField +} + +"Ways in which lists of packages can be ordered upon return." +input PackageOrder { + "The direction in which to order packages by the specified field." + direction: OrderDirection + "The field in which to order packages by." + field: PackageOrderField +} + +"Ways in which lists of package versions can be ordered upon return." +input PackageVersionOrder { + "The direction in which to order package versions by the specified field." + direction: OrderDirection + "The field in which to order package versions by." + field: PackageVersionOrderField +} + +"Autogenerated input type of PinEnvironment" +input PinEnvironmentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the environment to modify" + environmentId: ID! + "The desired state of the environment. If true, environment will be pinned. If false, it will be unpinned." + pinned: Boolean! +} + +"Autogenerated input type of PinIssue" +input PinIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the issue to be pinned" + issueId: ID! +} + +"Ordering options for pinned environments" +input PinnedEnvironmentOrder { + "The direction in which to order pinned environments by the specified field." + direction: OrderDirection! + "The field to order pinned environments by." + field: PinnedEnvironmentOrderField! +} + +"An issue or PR and its owning repository to be used in a project card." +input ProjectCardImport { + "The issue or pull request number." + number: Int! + "Repository name with owner (owner/repository)." + repository: String! +} + +"A project column and a list of its issues and PRs." +input ProjectColumnImport { + "The name of the column." + columnName: String! + "A list of issues and pull requests in the column." + issues: [ProjectCardImport!] + "The position of the column, starting from 0." + position: Int! +} + +"Ways in which lists of projects can be ordered upon return." +input ProjectOrder { + "The direction in which to order projects by the specified field." + direction: OrderDirection! + "The field in which to order projects by." + field: ProjectOrderField! +} + +"A collaborator to update on a project. Only one of the userId or teamId should be provided." +input ProjectV2Collaborator { + "The role to grant the collaborator" + role: ProjectV2Roles! + "The ID of the team as a collaborator." + teamId: ID + "The ID of the user as a collaborator." + userId: ID +} + +"Ordering options for project v2 field connections" +input ProjectV2FieldOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order the project v2 fields by." + field: ProjectV2FieldOrderField! +} + +"The values that can be used to update a field of an item inside a Project. Only 1 value can be updated at a time." +input ProjectV2FieldValue { + "The ISO 8601 date to set on the field." + date: Date + "The id of the iteration to set on the field." + iterationId: String + "The number to set on the field." + number: Float + "The id of the single select option to set on the field." + singleSelectOptionId: String + "The text to set on the field." + text: String +} + +"Ways in which to filter lists of projects." +input ProjectV2Filters { + "List project v2 filtered by the state given." + state: ProjectV2State +} + +"Ordering options for project v2 item field value connections" +input ProjectV2ItemFieldValueOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order the project v2 item field values by." + field: ProjectV2ItemFieldValueOrderField! +} + +"Ordering options for project v2 item connections" +input ProjectV2ItemOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order the project v2 items by." + field: ProjectV2ItemOrderField! +} + +"Represents an iteration" +input ProjectV2Iteration { + "The duration of the iteration, in days." + duration: Int! + "The start date for the iteration." + startDate: Date! + "The title for the iteration." + title: String! +} + +"Represents an iteration field configuration." +input ProjectV2IterationFieldConfigurationInput { + "The duration of each iteration, in days." + duration: Int! + "Zero or more iterations for the field." + iterations: [ProjectV2Iteration!]! + "The start date for the first iteration." + startDate: Date! +} + +"Ways in which lists of projects can be ordered upon return." +input ProjectV2Order { + "The direction in which to order projects by the specified field." + direction: OrderDirection! + "The field in which to order projects by." + field: ProjectV2OrderField! +} + +"Represents a single select field option" +input ProjectV2SingleSelectFieldOptionInput { + "The display color of the option" + color: ProjectV2SingleSelectFieldOptionColor! + "The description text of the option" + description: String! + "The name of the option" + name: String! +} + +"Ways in which project v2 status updates can be ordered." +input ProjectV2StatusOrder { + "The direction in which to order nodes." + direction: OrderDirection! + "The field by which to order nodes." + field: ProjectV2StatusUpdateOrderField! +} + +"Ordering options for project v2 view connections" +input ProjectV2ViewOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order the project v2 views by." + field: ProjectV2ViewOrderField! +} + +"Ordering options for project v2 workflows connections" +input ProjectV2WorkflowOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order the project v2 workflows by." + field: ProjectV2WorkflowsOrderField! +} + +"A property that must match" +input PropertyTargetDefinitionInput { + "The name of the property" + name: String! + "The values to match for" + propertyValues: [String!]! + "The source of the property. Choose 'custom' or 'system'. Defaults to 'custom' if not specified" + source: String +} + +"Autogenerated input type of PublishSponsorsTier" +input PublishSponsorsTierInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the draft tier to publish." + tierId: ID! +} + +"Ways in which lists of issues can be ordered upon return." +input PullRequestOrder { + "The direction in which to order pull requests by the specified field." + direction: OrderDirection! + "The field in which to order pull requests by." + field: PullRequestOrderField! +} + +"Require all commits be made to a non-target branch and submitted via a pull request before they can be merged." +input PullRequestParametersInput { + "Array of allowed merge methods. Allowed values include `merge`, `squash`, and `rebase`. At least one option must be enabled." + allowedMergeMethods: [PullRequestAllowedMergeMethods!] + "Request Copilot code review for new pull requests automatically if the author has access to Copilot code review." + automaticCopilotCodeReviewEnabled: Boolean + "New, reviewable commits pushed will dismiss previous pull request review approvals." + dismissStaleReviewsOnPush: Boolean! + "Require an approving review in pull requests that modify files that have a designated code owner." + requireCodeOwnerReview: Boolean! + "Whether the most recent reviewable push must be approved by someone other than the person who pushed it." + requireLastPushApproval: Boolean! + "The number of approving reviews that are required before a pull request can be merged." + requiredApprovingReviewCount: Int! + "All conversations on code must be resolved before a pull request can be merged." + requiredReviewThreadResolution: Boolean! +} + +"Ways in which lists of reactions can be ordered upon return." +input ReactionOrder { + "The direction in which to order reactions by the specified field." + direction: OrderDirection! + "The field in which to order reactions by." + field: ReactionOrderField! +} + +"Parameters to be used for the ref_name condition" +input RefNameConditionTargetInput { + "Array of ref names or patterns to exclude. The condition will not pass if any of these patterns match." + exclude: [String!]! + "Array of ref names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~DEFAULT_BRANCH` to include the default branch or `~ALL` to include all branches." + include: [String!]! +} + +"Ways in which lists of git refs can be ordered upon return." +input RefOrder { + "The direction in which to order refs by the specified field." + direction: OrderDirection! + "The field in which to order refs by." + field: RefOrderField! +} + +"A ref update" +input RefUpdate { + "The value this ref should be updated to." + afterOid: GitObjectID! + "The value this ref needs to point to before the update." + beforeOid: GitObjectID + "Force a non fast-forward update." + force: Boolean = false + "The fully qualified name of the ref to be update. For example `refs/heads/branch-name`" + name: GitRefname! +} + +"Autogenerated input type of RegenerateEnterpriseIdentityProviderRecoveryCodes" +input RegenerateEnterpriseIdentityProviderRecoveryCodesInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set an identity provider." + enterpriseId: ID! +} + +"Autogenerated input type of RegenerateVerifiableDomainToken" +input RegenerateVerifiableDomainTokenInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the verifiable domain to regenerate the verification token of." + id: ID! +} + +"Autogenerated input type of RejectDeployments" +input RejectDeploymentsInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Optional comment for rejecting deployments" + comment: String = "" + "The ids of environments to reject deployments" + environmentIds: [ID!]! + "The node ID of the workflow run containing the pending deployments." + workflowRunId: ID! +} + +"Ways in which lists of releases can be ordered upon return." +input ReleaseOrder { + "The direction in which to order releases by the specified field." + direction: OrderDirection! + "The field in which to order releases by." + field: ReleaseOrderField! +} + +"Autogenerated input type of RemoveAssigneesFromAssignable" +input RemoveAssigneesFromAssignableInput { + "The id of the assignable object to remove assignees from." + assignableId: ID! + "The id of users to remove as assignees." + assigneeIds: [ID!]! + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Autogenerated input type of RemoveBlockedBy" +input RemoveBlockedByInput { + "The ID of the blocking issue." + blockingIssueId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the blocked issue." + issueId: ID! +} + +"Autogenerated input type of RemoveEnterpriseAdmin" +input RemoveEnterpriseAdminInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Enterprise ID from which to remove the administrator." + enterpriseId: ID! + "The login of the user to remove as an administrator." + login: String! +} + +"Autogenerated input type of RemoveEnterpriseIdentityProvider" +input RemoveEnterpriseIdentityProviderInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise from which to remove the identity provider." + enterpriseId: ID! +} + +"Autogenerated input type of RemoveEnterpriseMember" +input RemoveEnterpriseMemberInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise from which the user should be removed." + enterpriseId: ID! + "The ID of the user to remove from the enterprise." + userId: ID! +} + +"Autogenerated input type of RemoveEnterpriseOrganization" +input RemoveEnterpriseOrganizationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise from which the organization should be removed." + enterpriseId: ID! + "The ID of the organization to remove from the enterprise." + organizationId: ID! +} + +"Autogenerated input type of RemoveEnterpriseSupportEntitlement" +input RemoveEnterpriseSupportEntitlementInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Enterprise which the admin belongs to." + enterpriseId: ID! + "The login of a member who will lose the support entitlement." + login: String! +} + +"Autogenerated input type of RemoveLabelsFromLabelable" +input RemoveLabelsFromLabelableInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ids of labels to remove." + labelIds: [ID!]! + "The id of the Labelable to remove labels from." + labelableId: ID! +} + +"Autogenerated input type of RemoveOutsideCollaborator" +input RemoveOutsideCollaboratorInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the organization to remove the outside collaborator from." + organizationId: ID! + "The ID of the outside collaborator to remove." + userId: ID! +} + +"Autogenerated input type of RemoveReaction" +input RemoveReactionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of the emoji reaction to remove." + content: ReactionContent! + "The Node ID of the subject to modify." + subjectId: ID! +} + +"Autogenerated input type of RemoveStar" +input RemoveStarInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Starrable ID to unstar." + starrableId: ID! +} + +"Autogenerated input type of RemoveSubIssue" +input RemoveSubIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the issue." + issueId: ID! + "The id of the sub-issue." + subIssueId: ID! +} + +"Autogenerated input type of RemoveUpvote" +input RemoveUpvoteInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion or comment to remove upvote." + subjectId: ID! +} + +"Autogenerated input type of ReopenDiscussion" +input ReopenDiscussionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the discussion to be reopened." + discussionId: ID! +} + +"Autogenerated input type of ReopenIssue" +input ReopenIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the issue to be opened." + issueId: ID! +} + +"Autogenerated input type of ReopenPullRequest" +input ReopenPullRequestInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the pull request to be reopened." + pullRequestId: ID! +} + +"Autogenerated input type of ReorderEnvironment" +input ReorderEnvironmentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the environment to modify" + environmentId: ID! + "The desired position of the environment" + position: Int! +} + +"Autogenerated input type of ReplaceActorsForAssignable" +input ReplaceActorsForAssignableInput { + "The ids of the actors to replace the existing assignees." + actorIds: [ID!]! + "The id of the assignable object to replace the assignees for." + assignableId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String +} + +"Parameters to be used for the repository_id condition" +input RepositoryIdConditionTargetInput { + "One of these repo IDs must match the repo." + repositoryIds: [ID!]! +} + +"Ordering options for repository invitation connections." +input RepositoryInvitationOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order repository invitations by." + field: RepositoryInvitationOrderField! +} + +"Ordering options for repository migrations." +input RepositoryMigrationOrder { + "The ordering direction." + direction: RepositoryMigrationOrderDirection! + "The field to order repository migrations by." + field: RepositoryMigrationOrderField! +} + +"Parameters to be used for the repository_name condition" +input RepositoryNameConditionTargetInput { + "Array of repository names or patterns to exclude. The condition will not pass if any of these patterns match." + exclude: [String!]! + "Array of repository names or patterns to include. One of these patterns must match for the condition to pass. Also accepts `~ALL` to include all repositories." + include: [String!]! + "Target changes that match these patterns will be prevented except by those with bypass permissions." + protected: Boolean +} + +"Ordering options for repository connections" +input RepositoryOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order repositories by." + field: RepositoryOrderField! +} + +"Parameters to be used for the repository_property condition" +input RepositoryPropertyConditionTargetInput { + "Array of repository properties that must not match." + exclude: [PropertyTargetDefinitionInput!]! + "Array of repository properties that must match" + include: [PropertyTargetDefinitionInput!]! +} + +"Specifies the conditions required for a ruleset to evaluate" +input RepositoryRuleConditionsInput { + "Configuration for the ref_name condition" + refName: RefNameConditionTargetInput + "Configuration for the repository_id condition" + repositoryId: RepositoryIdConditionTargetInput + "Configuration for the repository_name condition" + repositoryName: RepositoryNameConditionTargetInput + "Configuration for the repository_property condition" + repositoryProperty: RepositoryPropertyConditionTargetInput +} + +"Specifies the attributes for a new or updated rule." +input RepositoryRuleInput { + "Optional ID of this rule when updating" + id: ID + "The parameters for the rule." + parameters: RuleParametersInput + "The type of rule to create." + type: RepositoryRuleType! +} + +"Ordering options for repository rules." +input RepositoryRuleOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order repository rules by." + field: RepositoryRuleOrderField! +} + +"Specifies the attributes for a new or updated ruleset bypass actor. Only one of `actor_id`, `repository_role_database_id`, `organization_admin`, or `deploy_key` should be specified." +input RepositoryRulesetBypassActorInput { + "For Team and Integration bypasses, the Team or Integration ID" + actorId: ID + "The bypass mode for this actor." + bypassMode: RepositoryRulesetBypassActorBypassMode! + "For deploy key bypasses, true. Can only use ALWAYS as the bypass mode" + deployKey: Boolean + "For enterprise owner bypasses, true" + enterpriseOwner: Boolean + "For organization owner bypasses, true" + organizationAdmin: Boolean + "For role bypasses, the role database ID" + repositoryRoleDatabaseId: Int +} + +"Autogenerated input type of ReprioritizeSubIssue" +input ReprioritizeSubIssueInput { + "The id of the sub-issue to be prioritized after (either positional argument after OR before should be specified)." + afterId: ID + "The id of the sub-issue to be prioritized before (either positional argument after OR before should be specified)." + beforeId: ID + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The id of the parent issue." + issueId: ID! + "The id of the sub-issue to reprioritize." + subIssueId: ID! +} + +"Autogenerated input type of RequestReviews" +input RequestReviewsInput { + "The Node IDs of the bot to request." + botIds: [ID!] + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the pull request to modify." + pullRequestId: ID! + "The Node IDs of the team to request." + teamIds: [ID!] + "Add users to the set rather than replace." + union: Boolean = false + "The Node IDs of the user to request." + userIds: [ID!] +} + +"Choose which environments must be successfully deployed to before refs can be pushed into a ref that matches this rule." +input RequiredDeploymentsParametersInput { + "The environments that must be successfully deployed to before branches can be merged." + requiredDeploymentEnvironments: [String!]! +} + +"Specifies the attributes for a new or updated required status check." +input RequiredStatusCheckInput { + "The ID of the App that must set the status in order for it to be accepted. Omit this value to use whichever app has recently been setting this status, or use \"any\" to allow any app to set the status." + appId: ID + "Status check context that must pass for commits to be accepted to the matching branch." + context: String! +} + +"Choose which status checks must pass before the ref is updated. When enabled, commits must first be pushed to another ref where the checks pass." +input RequiredStatusChecksParametersInput { + "Allow repositories and branches to be created if a check would otherwise prohibit it." + doNotEnforceOnCreate: Boolean + "Status checks that are required." + requiredStatusChecks: [StatusCheckConfigurationInput!]! + "Whether pull requests targeting a matching branch must be tested with the latest code. This setting will not take effect unless at least one status check is enabled." + strictRequiredStatusChecksPolicy: Boolean! +} + +"Autogenerated input type of RerequestCheckSuite" +input RerequestCheckSuiteInput { + "The Node ID of the check suite." + checkSuiteId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the repository." + repositoryId: ID! +} + +"Autogenerated input type of ResolveReviewThread" +input ResolveReviewThreadInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the thread to resolve" + threadId: ID! +} + +"Autogenerated input type of RetireSponsorsTier" +input RetireSponsorsTierInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the published tier to retire." + tierId: ID! +} + +"Autogenerated input type of RevertPullRequest" +input RevertPullRequestInput { + "The description of the revert pull request." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Indicates whether the revert pull request should be a draft." + draft: Boolean = false + "The ID of the pull request to revert." + pullRequestId: ID! + "The title of the revert pull request." + title: String +} + +"Autogenerated input type of RevokeEnterpriseOrganizationsMigratorRole" +input RevokeEnterpriseOrganizationsMigratorRoleInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise to which all organizations managed by it will be granted the migrator role." + enterpriseId: ID! + "The login of the user to revoke the migrator role" + login: String! +} + +"Autogenerated input type of RevokeMigratorRole" +input RevokeMigratorRoleInput { + "The user login or Team slug to revoke the migrator role from." + actor: String! + "Specifies the type of the actor, can be either USER or TEAM." + actorType: ActorType! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the organization that the user/team belongs to." + organizationId: ID! +} + +"Specifies the parameters for a `RepositoryRule` object. Only one of the fields should be specified." +input RuleParametersInput { + "Parameters used for the `branch_name_pattern` rule type" + branchNamePattern: BranchNamePatternParametersInput + "Parameters used for the `code_scanning` rule type" + codeScanning: CodeScanningParametersInput + "Parameters used for the `commit_author_email_pattern` rule type" + commitAuthorEmailPattern: CommitAuthorEmailPatternParametersInput + "Parameters used for the `commit_message_pattern` rule type" + commitMessagePattern: CommitMessagePatternParametersInput + "Parameters used for the `committer_email_pattern` rule type" + committerEmailPattern: CommitterEmailPatternParametersInput + "Parameters used for the `copilot_code_review` rule type" + copilotCodeReview: CopilotCodeReviewParametersInput + "Parameters used for the `file_extension_restriction` rule type" + fileExtensionRestriction: FileExtensionRestrictionParametersInput + "Parameters used for the `file_path_restriction` rule type" + filePathRestriction: FilePathRestrictionParametersInput + "Parameters used for the `max_file_path_length` rule type" + maxFilePathLength: MaxFilePathLengthParametersInput + "Parameters used for the `max_file_size` rule type" + maxFileSize: MaxFileSizeParametersInput + "Parameters used for the `merge_queue` rule type" + mergeQueue: MergeQueueParametersInput + "Parameters used for the `pull_request` rule type" + pullRequest: PullRequestParametersInput + "Parameters used for the `required_deployments` rule type" + requiredDeployments: RequiredDeploymentsParametersInput + "Parameters used for the `required_status_checks` rule type" + requiredStatusChecks: RequiredStatusChecksParametersInput + "Parameters used for the `tag_name_pattern` rule type" + tagNamePattern: TagNamePatternParametersInput + "Parameters used for the `update` rule type" + update: UpdateParametersInput + "Parameters used for the `workflows` rule type" + workflows: WorkflowsParametersInput +} + +"Ordering options for saved reply connections." +input SavedReplyOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order saved replies by." + field: SavedReplyOrderField! +} + +"An advisory identifier to filter results on." +input SecurityAdvisoryIdentifierFilter { + "The identifier type." + type: SecurityAdvisoryIdentifierType! + "The identifier string. Supports exact or partial matching." + value: String! +} + +"Ordering options for security advisory connections" +input SecurityAdvisoryOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order security advisories by." + field: SecurityAdvisoryOrderField! +} + +"Ordering options for security vulnerability connections" +input SecurityVulnerabilityOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order security vulnerabilities by." + field: SecurityVulnerabilityOrderField! +} + +"Autogenerated input type of SetEnterpriseIdentityProvider" +input SetEnterpriseIdentityProviderInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The digest algorithm used to sign SAML requests for the identity provider." + digestMethod: SamlDigestAlgorithm! + "The ID of the enterprise on which to set an identity provider." + enterpriseId: ID! + "The x509 certificate used by the identity provider to sign assertions and responses." + idpCertificate: String! + "The Issuer Entity ID for the SAML identity provider" + issuer: String + "The signature algorithm used to sign SAML requests for the identity provider." + signatureMethod: SamlSignatureAlgorithm! + "The URL endpoint for the identity provider's SAML SSO." + ssoUrl: URI! +} + +"Autogenerated input type of SetOrganizationInteractionLimit" +input SetOrganizationInteractionLimitInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "When this limit should expire." + expiry: RepositoryInteractionLimitExpiry + "The limit to set." + limit: RepositoryInteractionLimit! + "The ID of the organization to set a limit for." + organizationId: ID! +} + +"Autogenerated input type of SetRepositoryInteractionLimit" +input SetRepositoryInteractionLimitInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "When this limit should expire." + expiry: RepositoryInteractionLimitExpiry + "The limit to set." + limit: RepositoryInteractionLimit! + "The ID of the repository to set a limit for." + repositoryId: ID! +} + +"Autogenerated input type of SetUserInteractionLimit" +input SetUserInteractionLimitInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "When this limit should expire." + expiry: RepositoryInteractionLimitExpiry + "The limit to set." + limit: RepositoryInteractionLimit! + "The ID of the user to set a limit for." + userId: ID! +} + +"Ordering options for connections to get sponsor entities and associated USD amounts for GitHub Sponsors." +input SponsorAndLifetimeValueOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order results by." + field: SponsorAndLifetimeValueOrderField! +} + +"Ordering options for connections to get sponsor entities for GitHub Sponsors." +input SponsorOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order sponsor entities by." + field: SponsorOrderField! +} + +"Ordering options for connections to get sponsorable entities for GitHub Sponsors." +input SponsorableOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order sponsorable entities by." + field: SponsorableOrderField! +} + +"Ordering options for GitHub Sponsors activity connections." +input SponsorsActivityOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order activity by." + field: SponsorsActivityOrderField! +} + +"Ordering options for Sponsors tiers connections." +input SponsorsTierOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order tiers by." + field: SponsorsTierOrderField! +} + +"Ordering options for sponsorship newsletter connections." +input SponsorshipNewsletterOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order sponsorship newsletters by." + field: SponsorshipNewsletterOrderField! +} + +"Ordering options for sponsorship connections." +input SponsorshipOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order sponsorship by." + field: SponsorshipOrderField! +} + +"Ways in which star connections can be ordered." +input StarOrder { + "The direction in which to order nodes." + direction: OrderDirection! + "The field in which to order nodes by." + field: StarOrderField! +} + +"Autogenerated input type of StartOrganizationMigration" +input StartOrganizationMigrationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The migration source access token." + sourceAccessToken: String! + "The URL of the organization to migrate." + sourceOrgUrl: URI! + "The ID of the enterprise the target organization belongs to." + targetEnterpriseId: ID! + "The name of the target organization." + targetOrgName: String! +} + +"Autogenerated input type of StartRepositoryMigration" +input StartRepositoryMigrationInput { + "The migration source access token." + accessToken: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether to continue the migration on error. Defaults to `true`." + continueOnError: Boolean + "The signed URL to access the user-uploaded git archive." + gitArchiveUrl: String + "The GitHub personal access token of the user importing to the target repository." + githubPat: String + "Whether to lock the source repository." + lockSource: Boolean + "The signed URL to access the user-uploaded metadata archive." + metadataArchiveUrl: String + "The ID of the organization that will own the imported repository." + ownerId: ID! + "The name of the imported repository." + repositoryName: String! + "Whether to skip migrating releases for the repository." + skipReleases: Boolean + "The ID of the migration source." + sourceId: ID! + "The URL of the source repository." + sourceRepositoryUrl: URI! + "The visibility of the imported repository." + targetRepoVisibility: String +} + +"Required status check" +input StatusCheckConfigurationInput { + "The status check context name that must be present on the commit." + context: String! + "The optional integration ID that this status check must originate from." + integrationId: Int +} + +"Autogenerated input type of SubmitPullRequestReview" +input SubmitPullRequestReviewInput { + "The text field to set on the Pull Request Review." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The event to send to the Pull Request Review." + event: PullRequestReviewEvent! + "The Pull Request ID to submit any pending reviews." + pullRequestId: ID + "The Pull Request Review ID to submit." + pullRequestReviewId: ID +} + +"Parameters to be used for the tag_name_pattern rule" +input TagNamePatternParametersInput { + "How this rule will appear to users." + name: String + "If true, the rule will fail if the pattern matches." + negate: Boolean + "The operator to use for matching." + operator: String! + "The pattern to match with." + pattern: String! +} + +"Ways in which team discussion comment connections can be ordered." +input TeamDiscussionCommentOrder { + "The direction in which to order nodes." + direction: OrderDirection! + "The field by which to order nodes." + field: TeamDiscussionCommentOrderField! +} + +"Ways in which team discussion connections can be ordered." +input TeamDiscussionOrder { + "The direction in which to order nodes." + direction: OrderDirection! + "The field by which to order nodes." + field: TeamDiscussionOrderField! +} + +"Ordering options for team member connections" +input TeamMemberOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order team members by." + field: TeamMemberOrderField! +} + +"Ways in which team connections can be ordered." +input TeamOrder { + "The direction in which to order nodes." + direction: OrderDirection! + "The field in which to order nodes by." + field: TeamOrderField! +} + +"Ordering options for team repository connections" +input TeamRepositoryOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order repositories by." + field: TeamRepositoryOrderField! +} + +"Autogenerated input type of TransferEnterpriseOrganization" +input TransferEnterpriseOrganizationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise where the organization should be transferred." + destinationEnterpriseId: ID! + "The ID of the organization to transfer." + organizationId: ID! +} + +"Autogenerated input type of TransferIssue" +input TransferIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether to create labels if they don't exist in the target repository (matched by name)" + createLabelsIfMissing: Boolean = false + "The Node ID of the issue to be transferred" + issueId: ID! + "The Node ID of the repository the issue should be transferred to" + repositoryId: ID! +} + +"Autogenerated input type of UnarchiveProjectV2Item" +input UnarchiveProjectV2ItemInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the ProjectV2Item to unarchive." + itemId: ID! + "The ID of the Project to archive the item from." + projectId: ID! +} + +"Autogenerated input type of UnarchiveRepository" +input UnarchiveRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the repository to unarchive." + repositoryId: ID! +} + +"Autogenerated input type of UnfollowOrganization" +input UnfollowOrganizationInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the organization to unfollow." + organizationId: ID! +} + +"Autogenerated input type of UnfollowUser" +input UnfollowUserInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the user to unfollow." + userId: ID! +} + +"Autogenerated input type of UnlinkProjectV2FromRepository" +input UnlinkProjectV2FromRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the project to unlink from the repository." + projectId: ID! + "The ID of the repository to unlink from the project." + repositoryId: ID! +} + +"Autogenerated input type of UnlinkProjectV2FromTeam" +input UnlinkProjectV2FromTeamInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the project to unlink from the team." + projectId: ID! + "The ID of the team to unlink from the project." + teamId: ID! +} + +"Autogenerated input type of UnlinkRepositoryFromProject" +input UnlinkRepositoryFromProjectInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Project linked to the Repository." + projectId: ID! + "The ID of the Repository linked to the Project." + repositoryId: ID! +} + +"Autogenerated input type of UnlockLockable" +input UnlockLockableInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the item to be unlocked." + lockableId: ID! +} + +"Autogenerated input type of UnmarkDiscussionCommentAsAnswer" +input UnmarkDiscussionCommentAsAnswerInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion comment to unmark as an answer." + id: ID! +} + +"Autogenerated input type of UnmarkFileAsViewed" +input UnmarkFileAsViewedInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The path of the file to mark as unviewed" + path: String! + "The Node ID of the pull request." + pullRequestId: ID! +} + +"Autogenerated input type of UnmarkIssueAsDuplicate" +input UnmarkIssueAsDuplicateInput { + "ID of the issue or pull request currently considered canonical/authoritative/original." + canonicalId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "ID of the issue or pull request currently marked as a duplicate." + duplicateId: ID! +} + +"Autogenerated input type of UnmarkProjectV2AsTemplate" +input UnmarkProjectV2AsTemplateInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Project to unmark as a template." + projectId: ID! +} + +"Autogenerated input type of UnminimizeComment" +input UnminimizeCommentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the subject to modify." + subjectId: ID! +} + +"Autogenerated input type of UnpinIssue" +input UnpinIssueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the issue to be unpinned" + issueId: ID! +} + +"Autogenerated input type of UnresolveReviewThread" +input UnresolveReviewThreadInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the thread to unresolve" + threadId: ID! +} + +"Autogenerated input type of UpdateBranchProtectionRule" +input UpdateBranchProtectionRuleInput { + "Can this branch be deleted." + allowsDeletions: Boolean + "Are force pushes allowed on this branch." + allowsForcePushes: Boolean + "Is branch creation a protected operation." + blocksCreations: Boolean + "The global relay id of the branch protection rule to be updated." + branchProtectionRuleId: ID! + "A list of User, Team, or App IDs allowed to bypass force push targeting matching branches." + bypassForcePushActorIds: [ID!] + "A list of User, Team, or App IDs allowed to bypass pull requests targeting matching branches." + bypassPullRequestActorIds: [ID!] + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Will new commits pushed to matching branches dismiss pull request review approvals." + dismissesStaleReviews: Boolean + "Can admins override branch protection." + isAdminEnforced: Boolean + "Whether users can pull changes from upstream when the branch is locked. Set to `true` to allow fork syncing. Set to `false` to prevent fork syncing." + lockAllowsFetchAndMerge: Boolean + "Whether to set the branch as read-only. If this is true, users will not be able to push to the branch." + lockBranch: Boolean + "The glob-like pattern used to determine matching branches." + pattern: String + "A list of User, Team, or App IDs allowed to push to matching branches." + pushActorIds: [ID!] + "Whether the most recent push must be approved by someone other than the person who pushed it" + requireLastPushApproval: Boolean + "Number of approving reviews required to update matching branches." + requiredApprovingReviewCount: Int + "The list of required deployment environments" + requiredDeploymentEnvironments: [String!] + "List of required status check contexts that must pass for commits to be accepted to matching branches." + requiredStatusCheckContexts: [String!] + "The list of required status checks" + requiredStatusChecks: [RequiredStatusCheckInput!] + "Are approving reviews required to update matching branches." + requiresApprovingReviews: Boolean + "Are reviews from code owners required to update matching branches." + requiresCodeOwnerReviews: Boolean + "Are commits required to be signed." + requiresCommitSignatures: Boolean + "Are conversations required to be resolved before merging." + requiresConversationResolution: Boolean + "Are successful deployments required before merging." + requiresDeployments: Boolean + "Are merge commits prohibited from being pushed to this branch." + requiresLinearHistory: Boolean + "Are status checks required to update matching branches." + requiresStatusChecks: Boolean + "Are branches required to be up to date before merging." + requiresStrictStatusChecks: Boolean + "Is pushing to matching branches restricted." + restrictsPushes: Boolean + "Is dismissal of pull request reviews restricted." + restrictsReviewDismissals: Boolean + "A list of User, Team, or App IDs allowed to dismiss reviews on pull requests targeting matching branches." + reviewDismissalActorIds: [ID!] +} + +"Autogenerated input type of UpdateCheckRun" +input UpdateCheckRunInput { + "Possible further actions the integrator can perform, which a user may trigger." + actions: [CheckRunAction!] + "The node of the check." + checkRunId: ID! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The time that the check run finished." + completedAt: DateTime + "The final conclusion of the check." + conclusion: CheckConclusionState + "The URL of the integrator's site that has the full details of the check." + detailsUrl: URI + "A reference for the run on the integrator's system." + externalId: String + "The name of the check." + name: String + "Descriptive details about the run." + output: CheckRunOutput + "The node ID of the repository." + repositoryId: ID! + "The time that the check run began." + startedAt: DateTime + "The current status." + status: RequestableCheckStatusState +} + +"Autogenerated input type of UpdateCheckSuitePreferences" +input UpdateCheckSuitePreferencesInput { + "The check suite preferences to modify." + autoTriggerPreferences: [CheckSuiteAutoTriggerPreference!]! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the repository." + repositoryId: ID! +} + +"Autogenerated input type of UpdateDiscussionComment" +input UpdateDiscussionCommentInput { + "The new contents of the comment body." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion comment to update." + commentId: ID! +} + +"Autogenerated input type of UpdateDiscussion" +input UpdateDiscussionInput { + "The new contents of the discussion body." + body: String + "The Node ID of a discussion category within the same repository to change this discussion to." + categoryId: ID + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion to update." + discussionId: ID! + "The new discussion title." + title: String +} + +"Autogenerated input type of UpdateEnterpriseAdministratorRole" +input UpdateEnterpriseAdministratorRoleInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Enterprise which the admin belongs to." + enterpriseId: ID! + "The login of a administrator whose role is being changed." + login: String! + "The new role for the Enterprise administrator." + role: EnterpriseAdministratorRole! +} + +"Autogenerated input type of UpdateEnterpriseAllowPrivateRepositoryForkingSetting" +input UpdateEnterpriseAllowPrivateRepositoryForkingSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the allow private repository forking setting." + enterpriseId: ID! + "The value for the allow private repository forking policy on the enterprise." + policyValue: EnterpriseAllowPrivateRepositoryForkingPolicyValue + "The value for the allow private repository forking setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseDefaultRepositoryPermissionSetting" +input UpdateEnterpriseDefaultRepositoryPermissionSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the base repository permission setting." + enterpriseId: ID! + "The value for the base repository permission setting on the enterprise." + settingValue: EnterpriseDefaultRepositoryPermissionSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseDeployKeySetting" +input UpdateEnterpriseDeployKeySettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the deploy key setting." + enterpriseId: ID! + "The value for the deploy key setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseMembersCanChangeRepositoryVisibilitySetting" +input UpdateEnterpriseMembersCanChangeRepositoryVisibilitySettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can change repository visibility setting." + enterpriseId: ID! + "The value for the members can change repository visibility setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseMembersCanCreateRepositoriesSetting" +input UpdateEnterpriseMembersCanCreateRepositoriesSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can create repositories setting." + enterpriseId: ID! + "Allow members to create internal repositories. Defaults to current value." + membersCanCreateInternalRepositories: Boolean + "Allow members to create private repositories. Defaults to current value." + membersCanCreatePrivateRepositories: Boolean + "Allow members to create public repositories. Defaults to current value." + membersCanCreatePublicRepositories: Boolean + "When false, allow member organizations to set their own repository creation member privileges." + membersCanCreateRepositoriesPolicyEnabled: Boolean + "Value for the members can create repositories setting on the enterprise. This or the granular public/private/internal allowed fields (but not both) must be provided." + settingValue: EnterpriseMembersCanCreateRepositoriesSettingValue +} + +"Autogenerated input type of UpdateEnterpriseMembersCanDeleteIssuesSetting" +input UpdateEnterpriseMembersCanDeleteIssuesSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can delete issues setting." + enterpriseId: ID! + "The value for the members can delete issues setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseMembersCanDeleteRepositoriesSetting" +input UpdateEnterpriseMembersCanDeleteRepositoriesSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can delete repositories setting." + enterpriseId: ID! + "The value for the members can delete repositories setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseMembersCanInviteCollaboratorsSetting" +input UpdateEnterpriseMembersCanInviteCollaboratorsSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can invite collaborators setting." + enterpriseId: ID! + "The value for the members can invite collaborators setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseMembersCanMakePurchasesSetting" +input UpdateEnterpriseMembersCanMakePurchasesSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can make purchases setting." + enterpriseId: ID! + "The value for the members can make purchases setting on the enterprise." + settingValue: EnterpriseMembersCanMakePurchasesSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseMembersCanUpdateProtectedBranchesSetting" +input UpdateEnterpriseMembersCanUpdateProtectedBranchesSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can update protected branches setting." + enterpriseId: ID! + "The value for the members can update protected branches setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseMembersCanViewDependencyInsightsSetting" +input UpdateEnterpriseMembersCanViewDependencyInsightsSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the members can view dependency insights setting." + enterpriseId: ID! + "The value for the members can view dependency insights setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseOrganizationProjectsSetting" +input UpdateEnterpriseOrganizationProjectsSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the organization projects setting." + enterpriseId: ID! + "The value for the organization projects setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseOwnerOrganizationRole" +input UpdateEnterpriseOwnerOrganizationRoleInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Enterprise which the owner belongs to." + enterpriseId: ID! + "The ID of the organization for membership change." + organizationId: ID! + "The role to assume in the organization." + organizationRole: RoleInOrganization! +} + +"Autogenerated input type of UpdateEnterpriseProfile" +input UpdateEnterpriseProfileInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The description of the enterprise." + description: String + "The Enterprise ID to update." + enterpriseId: ID! + "The location of the enterprise." + location: String + "The name of the enterprise." + name: String + "The security contact email address of the enterprise." + securityContactEmail: String + "The URL of the enterprise's website." + websiteUrl: String +} + +"Autogenerated input type of UpdateEnterpriseRepositoryProjectsSetting" +input UpdateEnterpriseRepositoryProjectsSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the repository projects setting." + enterpriseId: ID! + "The value for the repository projects setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseTeamDiscussionsSetting" +input UpdateEnterpriseTeamDiscussionsSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the team discussions setting." + enterpriseId: ID! + "The value for the team discussions setting on the enterprise." + settingValue: EnterpriseEnabledDisabledSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseTwoFactorAuthenticationDisallowedMethodsSetting" +input UpdateEnterpriseTwoFactorAuthenticationDisallowedMethodsSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the two-factor authentication disallowed methods setting." + enterpriseId: ID! + "The value for the two-factor authentication disallowed methods setting on the enterprise." + settingValue: EnterpriseDisallowedMethodsSettingValue! +} + +"Autogenerated input type of UpdateEnterpriseTwoFactorAuthenticationRequiredSetting" +input UpdateEnterpriseTwoFactorAuthenticationRequiredSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the enterprise on which to set the two factor authentication required setting." + enterpriseId: ID! + "The value for the two factor authentication required setting on the enterprise." + settingValue: EnterpriseEnabledSettingValue! +} + +"Autogenerated input type of UpdateEnvironment" +input UpdateEnvironmentInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The node ID of the environment." + environmentId: ID! + "Whether deployments to this environment can be approved by the user who created the deployment." + preventSelfReview: Boolean + "The ids of users or teams that can approve deployments to this environment" + reviewers: [ID!] + "The wait timer in minutes." + waitTimer: Int +} + +"Autogenerated input type of UpdateIpAllowListEnabledSetting" +input UpdateIpAllowListEnabledSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the owner on which to set the IP allow list enabled setting." + ownerId: ID! + "The value for the IP allow list enabled setting." + settingValue: IpAllowListEnabledSettingValue! +} + +"Autogenerated input type of UpdateIpAllowListEntry" +input UpdateIpAllowListEntryInput { + "An IP address or range of addresses in CIDR notation." + allowListValue: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the IP allow list entry to update." + ipAllowListEntryId: ID! + "Whether the IP allow list entry is active when an IP allow list is enabled." + isActive: Boolean! + "An optional name for the IP allow list entry." + name: String +} + +"Autogenerated input type of UpdateIpAllowListForInstalledAppsEnabledSetting" +input UpdateIpAllowListForInstalledAppsEnabledSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the owner." + ownerId: ID! + "The value for the IP allow list configuration for installed GitHub Apps setting." + settingValue: IpAllowListForInstalledAppsEnabledSettingValue! +} + +"Autogenerated input type of UpdateIssueComment" +input UpdateIssueCommentInput { + "The updated text of the comment." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the IssueComment to modify." + id: ID! +} + +"Autogenerated input type of UpdateIssue" +input UpdateIssueInput { + "An array of Node IDs of users for this issue." + assigneeIds: [ID!] + "The body for the issue description." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the Issue to modify." + id: ID! + "The ID of the Issue Type for this issue." + issueTypeId: ID + "An array of Node IDs of labels for this issue." + labelIds: [ID!] + "The Node ID of the milestone for this issue." + milestoneId: ID + "An array of Node IDs for projects associated with this issue." + projectIds: [ID!] + "The desired issue state." + state: IssueState + "The title for the issue." + title: String +} + +"Autogenerated input type of UpdateIssueIssueType" +input UpdateIssueIssueTypeInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the issue to update" + issueId: ID! + "The ID of the issue type to update on the issue" + issueTypeId: ID +} + +"Autogenerated input type of UpdateIssueType" +input UpdateIssueTypeInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Color for the issue type" + color: IssueTypeColor + "The description of the issue type" + description: String + "Whether or not the issue type is enabled for the organization" + isEnabled: Boolean + "The ID of the issue type to update" + issueTypeId: ID! + "The name of the issue type" + name: String +} + +"Autogenerated input type of UpdateLabel" +input UpdateLabelInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A 6 character hex code, without the leading #, identifying the updated color of the label." + color: String + "A brief description of the label, such as its purpose." + description: String + "The Node ID of the label to be updated." + id: ID! + "The updated name of the label." + name: String +} + +"Autogenerated input type of UpdateNotificationRestrictionSetting" +input UpdateNotificationRestrictionSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the owner on which to set the restrict notifications setting." + ownerId: ID! + "The value for the restrict notifications setting." + settingValue: NotificationRestrictionSettingValue! +} + +"Autogenerated input type of UpdateOrganizationAllowPrivateRepositoryForkingSetting" +input UpdateOrganizationAllowPrivateRepositoryForkingSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Enable forking of private repositories in the organization?" + forkingEnabled: Boolean! + "The ID of the organization on which to set the allow private repository forking setting." + organizationId: ID! +} + +"Autogenerated input type of UpdateOrganizationWebCommitSignoffSetting" +input UpdateOrganizationWebCommitSignoffSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the organization on which to set the web commit signoff setting." + organizationId: ID! + "Enable signoff on web-based commits for repositories in the organization?" + webCommitSignoffRequired: Boolean! +} + +"Only allow users with bypass permission to update matching refs." +input UpdateParametersInput { + "Branch can pull changes from its upstream repository" + updateAllowsFetchAndMerge: Boolean! +} + +"Autogenerated input type of UpdatePatreonSponsorability" +input UpdatePatreonSponsorabilityInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether Patreon tiers should be shown on the GitHub Sponsors profile page, allowing potential sponsors to make their payment through Patreon instead of GitHub." + enablePatreonSponsorships: Boolean! + "The username of the organization with the GitHub Sponsors profile, if any. Defaults to the GitHub Sponsors profile for the authenticated user if omitted." + sponsorableLogin: String +} + +"Autogenerated input type of UpdateProjectCard" +input UpdateProjectCardInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Whether or not the ProjectCard should be archived" + isArchived: Boolean + "The note of ProjectCard." + note: String + "The ProjectCard ID to update." + projectCardId: ID! +} + +"Autogenerated input type of UpdateProjectColumn" +input UpdateProjectColumnInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of project column." + name: String! + "The ProjectColumn ID to update." + projectColumnId: ID! +} + +"Autogenerated input type of UpdateProject" +input UpdateProjectInput { + "The description of project." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The name of project." + name: String + "The Project ID to update." + projectId: ID! + "Whether the project is public or not." + public: Boolean + "Whether the project is open or closed." + state: ProjectState +} + +"Autogenerated input type of UpdateProjectV2Collaborators" +input UpdateProjectV2CollaboratorsInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The collaborators to update." + collaborators: [ProjectV2Collaborator!]! + "The ID of the project to update the collaborators for." + projectId: ID! +} + +"Autogenerated input type of UpdateProjectV2DraftIssue" +input UpdateProjectV2DraftIssueInput { + "The IDs of the assignees of the draft issue." + assigneeIds: [ID!] + "The body of the draft issue." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the draft issue to update." + draftIssueId: ID! + "The title of the draft issue." + title: String +} + +"Autogenerated input type of UpdateProjectV2Field" +input UpdateProjectV2FieldInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the field to update." + fieldId: ID! + "Configuration for an iteration field." + iterationConfiguration: ProjectV2IterationFieldConfigurationInput + "The name to update." + name: String + "Options for a field of type SINGLE_SELECT. If empty, no changes will be made to the options. If values are present, they will overwrite the existing options for the field." + singleSelectOptions: [ProjectV2SingleSelectFieldOptionInput!] +} + +"Autogenerated input type of UpdateProjectV2" +input UpdateProjectV2Input { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Set the project to closed or open." + closed: Boolean + "The ID of the Project to update." + projectId: ID! + "Set the project to public or private." + public: Boolean + "Set the readme description of the project." + readme: String + "Set the short description of the project." + shortDescription: String + "Set the title of the project." + title: String +} + +"Autogenerated input type of UpdateProjectV2ItemFieldValue" +input UpdateProjectV2ItemFieldValueInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the field to be updated." + fieldId: ID! + "The ID of the item to be updated." + itemId: ID! + "The ID of the Project." + projectId: ID! + "The value which will be set on the field." + value: ProjectV2FieldValue! +} + +"Autogenerated input type of UpdateProjectV2ItemPosition" +input UpdateProjectV2ItemPositionInput { + "The ID of the item to position this item after. If omitted or set to null the item will be moved to top." + afterId: ID + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the item to be moved." + itemId: ID! + "The ID of the Project." + projectId: ID! +} + +"Autogenerated input type of UpdateProjectV2StatusUpdate" +input UpdateProjectV2StatusUpdateInput { + "The body of the status update." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The start date of the status update." + startDate: Date + "The status of the status update." + status: ProjectV2StatusUpdateStatus + "The ID of the status update to be updated." + statusUpdateId: ID! + "The target date of the status update." + targetDate: Date +} + +"Autogenerated input type of UpdatePullRequestBranch" +input UpdatePullRequestBranchInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The head ref oid for the upstream branch." + expectedHeadOid: GitObjectID + "The Node ID of the pull request." + pullRequestId: ID! + "The update branch method to use. If omitted, defaults to 'MERGE'" + updateMethod: PullRequestBranchUpdateMethod +} + +"Autogenerated input type of UpdatePullRequest" +input UpdatePullRequestInput { + "An array of Node IDs of users for this pull request." + assigneeIds: [ID!] + """ + + The name of the branch you want your changes pulled into. This should be an existing branch + on the current repository. + """ + baseRefName: String + "The contents of the pull request." + body: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "An array of Node IDs of labels for this pull request." + labelIds: [ID!] + "Indicates whether maintainers can modify the pull request." + maintainerCanModify: Boolean + "The Node ID of the milestone for this pull request." + milestoneId: ID + "An array of Node IDs for projects associated with this pull request." + projectIds: [ID!] + "The Node ID of the pull request." + pullRequestId: ID! + "The target state of the pull request." + state: PullRequestUpdateState + "The title of the pull request." + title: String +} + +"Autogenerated input type of UpdatePullRequestReviewComment" +input UpdatePullRequestReviewCommentInput { + "The text of the comment." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the comment to modify." + pullRequestReviewCommentId: ID! +} + +"Autogenerated input type of UpdatePullRequestReview" +input UpdatePullRequestReviewInput { + "The contents of the pull request review body." + body: String! + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the pull request review to modify." + pullRequestReviewId: ID! +} + +"Autogenerated input type of UpdateRef" +input UpdateRefInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Permit updates of branch Refs that are not fast-forwards?" + force: Boolean = false + "The GitObjectID that the Ref shall be updated to target." + oid: GitObjectID! + "The Node ID of the Ref to be updated." + refId: ID! +} + +"Autogenerated input type of UpdateRefs" +input UpdateRefsInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A list of ref updates." + refUpdates: [RefUpdate!]! + "The Node ID of the repository." + repositoryId: ID! +} + +"Autogenerated input type of UpdateRepository" +input UpdateRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A new description for the repository. Pass an empty string to erase the existing description." + description: String + "Indicates if the repository should have the discussions feature enabled." + hasDiscussionsEnabled: Boolean + "Indicates if the repository should have the issues feature enabled." + hasIssuesEnabled: Boolean + "Indicates if the repository should have the project boards feature enabled." + hasProjectsEnabled: Boolean + "Indicates if the repository displays a Sponsor button for financial contributions." + hasSponsorshipsEnabled: Boolean + "Indicates if the repository should have the wiki feature enabled." + hasWikiEnabled: Boolean + "The URL for a web page about this repository. Pass an empty string to erase the existing URL." + homepageUrl: URI + "The new name of the repository." + name: String + "The ID of the repository to update." + repositoryId: ID! + "Whether this repository should be marked as a template such that anyone who can access it can create new repositories with the same files and directory structure." + template: Boolean +} + +"Autogenerated input type of UpdateRepositoryRuleset" +input UpdateRepositoryRulesetInput { + "A list of actors that are allowed to bypass rules in this ruleset." + bypassActors: [RepositoryRulesetBypassActorInput!] + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The list of conditions for this ruleset" + conditions: RepositoryRuleConditionsInput + "The enforcement level for this ruleset" + enforcement: RuleEnforcement + "The name of the ruleset." + name: String + "The global relay id of the repository ruleset to be updated." + repositoryRulesetId: ID! + "The list of rules for this ruleset" + rules: [RepositoryRuleInput!] + "The target of the ruleset." + target: RepositoryRulesetTarget +} + +"Autogenerated input type of UpdateRepositoryWebCommitSignoffSetting" +input UpdateRepositoryWebCommitSignoffSettingInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the repository to update." + repositoryId: ID! + "Indicates if the repository should require signoff on web-based commits." + webCommitSignoffRequired: Boolean! +} + +"Autogenerated input type of UpdateSponsorshipPreferences" +input UpdateSponsorshipPreferencesInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Specify whether others should be able to see that the sponsor is sponsoring the sponsorable. Public visibility still does not reveal which tier is used." + privacyLevel: SponsorshipPrivacy = PUBLIC + "Whether the sponsor should receive email updates from the sponsorable." + receiveEmails: Boolean = true + "The ID of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorLogin is not given." + sponsorId: ID + "The username of the user or organization who is acting as the sponsor, paying for the sponsorship. Required if sponsorId is not given." + sponsorLogin: String + "The ID of the user or organization who is receiving the sponsorship. Required if sponsorableLogin is not given." + sponsorableId: ID + "The username of the user or organization who is receiving the sponsorship. Required if sponsorableId is not given." + sponsorableLogin: String +} + +"Autogenerated input type of UpdateSubscription" +input UpdateSubscriptionInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The new state of the subscription." + state: SubscriptionState! + "The Node ID of the subscribable object to modify." + subscribableId: ID! +} + +"Autogenerated input type of UpdateTeamDiscussionComment" +input UpdateTeamDiscussionCommentInput { + "The updated text of the comment." + body: String! + "The current version of the body content." + bodyVersion: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the comment to modify." + id: ID! +} + +"Autogenerated input type of UpdateTeamDiscussion" +input UpdateTeamDiscussionInput { + "The updated text of the discussion." + body: String + "The current version of the body content. If provided, this update operation will be rejected if the given version does not match the latest version on the server." + bodyVersion: String + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the discussion to modify." + id: ID! + "If provided, sets the pinned state of the updated discussion." + pinned: Boolean + "The updated title of the discussion." + title: String +} + +"Autogenerated input type of UpdateTeamReviewAssignment" +input UpdateTeamReviewAssignmentInput { + "The algorithm to use for review assignment" + algorithm: TeamReviewAssignmentAlgorithm = ROUND_ROBIN + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Count any members whose review has already been requested against the required number of members assigned to review" + countMembersAlreadyRequested: Boolean = true + "Turn on or off review assignment" + enabled: Boolean! + "An array of team member IDs to exclude" + excludedTeamMemberIds: [ID!] + "The Node ID of the team to update review assignments of" + id: ID! + "Include the members of any child teams when assigning" + includeChildTeamMembers: Boolean = true + "Notify the entire team of the PR if it is delegated" + notifyTeam: Boolean = true + "Remove the team review request when assigning" + removeTeamRequest: Boolean = true + "The number of team members to assign" + teamMemberCount: Int = 1 +} + +"Autogenerated input type of UpdateTeamsRepository" +input UpdateTeamsRepositoryInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "Permission that should be granted to the teams." + permission: RepositoryPermission! + "Repository ID being granted access to." + repositoryId: ID! + "A list of teams being granted access. Limit: 10" + teamIds: [ID!]! +} + +"Autogenerated input type of UpdateTopics" +input UpdateTopicsInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The Node ID of the repository." + repositoryId: ID! + "An array of topic names." + topicNames: [String!]! +} + +"Autogenerated input type of UpdateUserList" +input UpdateUserListInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "A description of the list" + description: String + "Whether or not the list is private" + isPrivate: Boolean + "The ID of the list to update." + listId: ID! + "The name of the list" + name: String +} + +"Autogenerated input type of UpdateUserListsForItem" +input UpdateUserListsForItemInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The item to add to the list" + itemId: ID! + "The lists to which this item should belong" + listIds: [ID!]! + "The suggested lists to create and add this item to" + suggestedListIds: [ID!] +} + +"Ordering options for user status connections." +input UserStatusOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order user statuses by." + field: UserStatusOrderField! +} + +"Ordering options for verifiable domain connections." +input VerifiableDomainOrder { + "The ordering direction." + direction: OrderDirection! + "The field to order verifiable domains by." + field: VerifiableDomainOrderField! +} + +"Autogenerated input type of VerifyVerifiableDomain" +input VerifyVerifiableDomainInput { + "A unique identifier for the client performing the mutation." + clientMutationId: String + "The ID of the verifiable domain to verify." + id: ID! +} + +"A workflow that must run for this rule to pass" +input WorkflowFileReferenceInput { + "The path to the workflow file" + path: String! + "The ref (branch or tag) of the workflow file to use" + ref: String + "The ID of the repository where the workflow is defined" + repositoryId: Int! + "The commit SHA of the workflow file to use" + sha: String +} + +"Ways in which lists of workflow runs can be ordered upon return." +input WorkflowRunOrder { + "The direction in which to order workflow runs by the specified field." + direction: OrderDirection! + "The field by which to order workflows." + field: WorkflowRunOrderField! +} + +"Require all changes made to a targeted branch to pass the specified workflows before they can be merged." +input WorkflowsParametersInput { + "Allow repositories and branches to be created if a check would otherwise prohibit it." + doNotEnforceOnCreate: Boolean + "Workflows that must pass for this rule to pass." + workflows: [WorkflowFileReferenceInput!]! +} diff --git a/graphql.config.yml b/graphql.config.yml new file mode 100644 index 0000000..f02dd05 --- /dev/null +++ b/graphql.config.yml @@ -0,0 +1,11 @@ +schema: + - 'https://api.github.com/graphql': + headers: + Authorization: Bearer ${GITHUB_TOKEN} +documents: '**/*.graphql' +extensions: + endpoints: + default: + url: https://api.github.com/graphql + headers: + Authorization: Bearer ${GITHUB_TOKEN} diff --git a/src/github_pr.graphql b/src/github_pr.graphql new file mode 100644 index 0000000..8af08ae --- /dev/null +++ b/src/github_pr.graphql @@ -0,0 +1,41 @@ +query PrDetailsQuery($owner: String!, $repo: String!, $oid: Int!) { + repository(owner: $owner, name: $repo) { + pullRequest(number: $oid) { + title + + commits(last: 100) { + nodes { + commit { + oid + messageHeadline + committedDate + status { + state + } + + # Check the latest check suites instead + checkSuites(last: 100, filterBy: { + appId: 15368 # GitHub Actions + }) { + nodes { + workflowRun { + workflow { + name + id + } + databaseId + } + conclusion + status + url + app { + name + } + } + } + } + } + } + } + } +} diff --git a/src/github_pr.rs b/src/github_pr.rs index 52f9155..3a60d81 100644 --- a/src/github_pr.rs +++ b/src/github_pr.rs @@ -1,12 +1,15 @@ use crate::DiffSource; use eframe::egui; -use eframe::egui::{Button, Context, Popup, Spinner}; +use eframe::egui::{Button, Context, Popup, ScrollArea, Spinner}; use egui_inbox::UiInbox; use futures::stream::FuturesUnordered; use futures::{StreamExt, TryStreamExt}; -use octocrab::{AuthState, Error, Octocrab, Page}; +use graphql_client::GraphQLQuery; +use octocrab::{AuthState, Octocrab, Page}; use re_ui::egui_ext::boxed_widget::BoxedWidgetLocalExt; -use std::collections::HashMap; +use std::borrow::Cow; +use std::collections::hash_map::Entry; +use std::collections::{HashMap, HashSet}; use std::future::ready; use std::pin::pin; use std::str::FromStr; @@ -18,7 +21,7 @@ use crate::octokit::RepoClient; use crate::state::{AppStateRef, SystemCommand}; use octocrab::models::commits::GithubCommitStatus; use octocrab::models::{ - CombinedStatus, Status, StatusState, + CombinedStatus, RunId, Status, pulls::PullRequest, repos::RepoCommit, workflows::{Run, WorkflowListArtifact}, @@ -26,7 +29,23 @@ use octocrab::models::{ use octocrab::params::repos::Reference; use octocrab::workflows::ListRunsBuilder; use re_ui::list_item::{LabelContent, ListItemContentButtonsExt, list_item_scope}; -use re_ui::{OnResponseExt, UiExt, icons}; +use re_ui::{OnResponseExt, SectionCollapsingHeader, UiExt, icons}; +// use chrono::DateTime; +pub type GitObjectID = String; +pub type DateTime = String; +pub type URI = String; + +// The paths are relative to the directory where your `Cargo.toml` is located. +// Both json and the GraphQL schema language are supported as sources for the schema +#[derive(GraphQLQuery, Debug)] +#[graphql( + schema_path = "github.graphql", + query_path = "src/github_pr.graphql", + response_derives = "Debug, Clone" +)] +pub struct PrDetailsQuery; +use crate::github_pr::pr_details_query::StatusState; +use anyhow::{Error, Result, anyhow}; pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { // Parse URLs like: https://github.com/rerun-io/rerun/pull/11253 @@ -52,10 +71,10 @@ pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { #[derive(Debug)] pub enum GithubPrCommand { - FetchedData(Result), + FetchedData(Result), FetchedCommitArtifacts { sha: String, - artifacts: Result, octocrab::Error>, + artifacts: Result, Error>, }, FetchCommitArtifacts { sha: String, @@ -82,27 +101,30 @@ pub struct GithubArtifact { pub struct GithubPr { link: GithubPrLink, inbox: UiInbox, - pub data: Poll>, + pub data: Poll>, client: Octocrab, } #[derive(Debug)] struct PrWithCommits { - pr: PullRequest, - commits: Vec, + title: String, + commits: Vec, + artifacts: HashMap>>>, } -#[derive(Debug)] -struct CommitWithArtifacts { - commit: RepoCommit, - status: CombinedStatus, - artifacts: Option, octocrab::Error>>>, +#[derive(Debug, Clone, Copy, PartialEq)] +enum CommitState { + Pending, + Success, + Failure, } -#[derive(Debug, Clone)] -struct ArtifactData { - artifact: WorkflowListArtifact, - run: Run, +#[derive(Debug)] +struct CommitData { + message: String, + sha: String, + status: CommitState, + workflow_run_ids: Vec, } impl GithubPr { @@ -112,7 +134,7 @@ impl GithubPr { { let client = RepoClient::new(client.clone(), link.repo.clone()); inbox.spawn(|tx| async move { - let details = get_all_pr_artifacts(&client, link.pr_number).await; + let details = get_pr_commits(&client, link.pr_number).await; let _ = tx.send(GithubPrCommand::FetchedData(details)); }); } @@ -133,127 +155,163 @@ impl GithubPr { } GithubPrCommand::FetchedCommitArtifacts { sha, artifacts } => { if let Poll::Ready(Ok(pr_data)) = &mut self.data { - for commit in &mut pr_data.commits { - if commit.commit.sha == sha { - commit.artifacts = Some(Poll::Ready(artifacts)); - break; - } - } + pr_data.artifacts.insert(sha, Poll::Ready(artifacts)); } } - GithubPrCommand::FetchCommitArtifacts { sha } => { - match &mut self.data { - Poll::Ready(Ok(pr_data)) => { - for commit in &mut pr_data.commits { - if commit.commit.sha == sha { - commit.artifacts = Some(Poll::Pending); - break; - } - } + GithubPrCommand::FetchCommitArtifacts { sha } => match &mut self.data { + Poll::Ready(Ok(pr_data)) => match pr_data.artifacts.entry(sha.clone()) { + Entry::Occupied(_) => {} + Entry::Vacant(entry) => { + entry.insert(Poll::Pending); + + let workflow_run_ids = pr_data + .commits + .iter() + .find(|c| c.sha == sha) + .map(|c| c.workflow_run_ids.clone()) + .unwrap_or_default(); + + let client = + RepoClient::new(self.client.clone(), self.link.repo.clone()); + self.inbox.spawn(move |tx| async move { + let artifacts = + fetch_commit_artifacts(&client, workflow_run_ids).await; + let _ = tx.send(GithubPrCommand::FetchedCommitArtifacts { + sha, + artifacts, + }); + }); } - _ => {} - } - - let client = RepoClient::new(self.client.clone(), self.link.repo.clone()); - self.inbox.spawn(move |tx| async move { - let artifacts = fetch_commit_artifacts(&client, &sha).await; - let _ = tx.send(GithubPrCommand::FetchedCommitArtifacts { sha, artifacts }); - }); - } + }, + _ => {} + }, } } } } -// Get all commits for a PR to get a complete picture -async fn get_pr_commits( - repo: &RepoClient, - pr: PrNumber, -) -> octocrab::Result> { - let page = repo.pulls().pr_commits(pr).send().await?; - let commits: Vec<_> = page - .into_stream(repo) - .map_ok(|commit| async move { - let status = repo - .get( - format!( - "/repos/{}/{}/commits/{}/status", - repo.repo().owner, - repo.repo().repo, - commit.sha - ), - None::<&()>, - ) - .await?; - Ok(CommitWithArtifacts { - commit, - status, - artifacts: None, - }) - }) - .try_buffered(10) - .try_collect() +async fn get_pr_commits(repo: &RepoClient, pr: PrNumber) -> Result { + let response: graphql_client::Response = repo + .graphql(&PrDetailsQuery::build_query(pr_details_query::Variables { + owner: repo.repo().owner.clone(), + repo: repo.repo().repo.clone(), + oid: pr as _, + })) .await?; - Ok(commits) -} + let response = response + .data + .ok_or_else(|| anyhow!("No data in response"))? + .repository + .ok_or_else(|| anyhow!("Repository not found"))? + .pull_request + .ok_or_else(|| anyhow!("Pull request not found"))?; + + let mut data = PrWithCommits { + title: response.title, + commits: Vec::new(), + artifacts: HashMap::new(), + }; + + for commit in response + .commits + .nodes + .ok_or_else(|| anyhow!("No commits found"))? + { + if let Some(commit) = commit { + let commit = commit.commit; + let sha = commit.oid; + let message = commit.message_headline; + + let mut status = CommitState::Success; + let mut workflow_run_ids = HashSet::new(); + + // Unfortunately github has no easy way to get the status for a commit, best thing seems to be + // to query all check suites and group them by workflow. + let mut last_suite_per_workflow = HashMap::new(); + + if let Some(suites) = commit.check_suites { + if let Some(nodes) = suites.nodes { + for node in nodes { + if let Some(node) = node { + if let Some(workflow_run) = node.workflow_run.clone() { + last_suite_per_workflow.insert(workflow_run.workflow.id, node); + } + } + } + } + } -async fn get_all_pr_artifacts( - repo: &RepoClient, - pr_number: PrNumber, -) -> octocrab::Result { - let pr = repo.pulls().get(pr_number).await?; - let commits = get_pr_commits(repo, pr_number).await?; + for (workflow_id, suite) in last_suite_per_workflow { + let pending = match suite.status { + pr_details_query::CheckStatusState::COMPLETED => false, + pr_details_query::CheckStatusState::IN_PROGRESS => true, + pr_details_query::CheckStatusState::PENDING => true, + pr_details_query::CheckStatusState::QUEUED => true, + pr_details_query::CheckStatusState::REQUESTED => true, + pr_details_query::CheckStatusState::WAITING => true, + pr_details_query::CheckStatusState::Other(_) => false, + }; + let error = if let Some(conclusion) = suite.conclusion { + match conclusion { + pr_details_query::CheckConclusionState::ACTION_REQUIRED => true, + pr_details_query::CheckConclusionState::CANCELLED => true, + pr_details_query::CheckConclusionState::FAILURE => true, + pr_details_query::CheckConclusionState::NEUTRAL => false, + pr_details_query::CheckConclusionState::SKIPPED => false, + pr_details_query::CheckConclusionState::STALE => false, + pr_details_query::CheckConclusionState::STARTUP_FAILURE => true, + pr_details_query::CheckConclusionState::SUCCESS => false, + pr_details_query::CheckConclusionState::TIMED_OUT => true, + pr_details_query::CheckConclusionState::Other(_) => true, + } + } else { + false + }; + if error { + status = CommitState::Failure + } else if pending && status != CommitState::Failure { + status = CommitState::Pending + } - Ok(PrWithCommits { pr, commits }) -} + if let Some(run) = suite.workflow_run { + if let Some(db_id) = run.database_id { + workflow_run_ids.insert(db_id as u64); + } + } + } + + data.commits.push(CommitData { + message, + sha, + status: status, + workflow_run_ids: workflow_run_ids.into_iter().collect(), + }); + } + } -#[derive(serde::Serialize)] -struct ListWorkflowRunsHeadSha { - head_sha: String, + Ok(data) } async fn fetch_commit_artifacts( repo: &RepoClient, - sha: &str, -) -> octocrab::Result> { - - let workflow_runs: Page = repo - .get( - // Unfortunately octocrab is missing the head_sha filter - format!( - "/repos/{}/{}/actions/runs", - repo.repo().owner, - repo.repo().repo - ), - Some(&ListWorkflowRunsHeadSha { - head_sha: sha.to_string(), - }), - ) - .await?; - - let runs: Vec = workflow_runs.into_stream(repo).try_collect().await?; - - let artifacts = FuturesUnordered::from_iter(runs.into_iter().map(|run| async move { + run_ids: Vec, +) -> Result> { + let artifacts = FuturesUnordered::from_iter(run_ids.into_iter().map(|run| async move { let artifacts_page = repo .actions() - .list_workflow_run_artifacts(&repo.repo().owner, &repo.repo().repo, run.id) + .list_workflow_run_artifacts(&repo.repo().owner, &repo.repo().repo, RunId(run)) .send() .await? .value .expect("No etag was provided, so we should have a value"); - let stream = artifacts_page - .into_stream(repo) - .map_ok(move |artifact| ArtifactData { - artifact, - run: run.clone(), - }); + let stream = artifacts_page.into_stream(repo); Ok(stream) })) .try_flatten() - .try_collect::>() + .try_collect::>() .await?; Ok(artifacts) @@ -262,108 +320,85 @@ async fn fetch_commit_artifacts( pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { let mut selected_source = None; - ui.group(|ui| { - ui.heading(format!("GitHub PR #{}", pr.link.pr_number)); - - match &pr.data { - Poll::Ready(Ok(data)) => { - let details = &data.pr; - - if let Some(title) = &details.title { - ui.label(title); - } - - ui.separator(); - - if let Some(html_url) = &details.html_url { - if ui.button("Compare PR Branches").clicked() { - selected_source = - Some(DiffSource::Pr(html_url.to_string().parse().unwrap())); - } - } - - ui.separator(); - ui.heading("Recent Commits & Artifacts"); - - ui.style_mut().wrap_mode = Some(egui::TextWrapMode::Truncate); - - list_item_scope(ui, "pr_info", |ui| { - for commit in data.commits.iter().rev() { - let item = ui.list_item(); - - let button = match &commit.status.state { - StatusState::Failure | StatusState::Error => Button::image( - icons::ERROR.as_image().tint(ui.tokens().alert_error.icon), - ) - .boxed_local(), - StatusState::Pending => Spinner::new().boxed_local(), - StatusState::Success => Button::image( - icons::SUCCESS - .as_image() - .tint(ui.tokens().alert_success.icon), - ) - .boxed_local(), - _ => Button::image(icons::HELP.as_image()).boxed_local(), - }; - - let button = button.on_menu(|ui| { - ui.set_min_width(250.0); - match &commit.artifacts { - None => { - pr.inbox - .sender() - .send(GithubPrCommand::FetchCommitArtifacts { - sha: commit.commit.sha.clone(), - }) - .ok(); - } - Some(Poll::Pending) => { - ui.spinner(); - } - Some(Poll::Ready(Err(error))) => { - ui.colored_label( - ui.visuals().error_fg_color, - format!("Error: {}", error), - ); - } - Some(Poll::Ready(Ok(artifacts))) => { - if artifacts.is_empty() { - ui.label("No artifacts found"); - } else { - for artifact in artifacts { - // let label = format!( - // "{} (from run: {})", - // artifact.artifact.name, artifact.run.name - // ); - - if ui.button(&artifact.artifact.name).clicked() { - selected_source = Some(DiffSource::GHArtifact { - repo: pr.link.repo.clone(), - artifact_id: artifact.artifact.id.to_string(), - }); + match &pr.data { + Poll::Ready(Ok(data)) => { + list_item_scope(ui, "pr_info", |ui| { + SectionCollapsingHeader::new(format!("PR: {}", data.title)).show(ui, |ui| { + ui.set_max_height(100.0); + ScrollArea::vertical().show(ui, |ui| { + for commit in data.commits.iter().rev() { + let item = ui.list_item(); + + let button = match &commit.status { + CommitState::Failure => Button::image( + icons::ERROR.as_image().tint(ui.tokens().alert_error.icon), + ) + .boxed_local(), + CommitState::Pending => Spinner::new().boxed_local(), + CommitState::Success => Button::image( + icons::SUCCESS + .as_image() + .tint(ui.tokens().alert_success.icon), + ) + .boxed_local(), + _ => Button::image(icons::HELP.as_image()).boxed_local(), + }; + + let button = button.on_menu(|ui| { + ui.set_min_width(250.0); + match data.artifacts.get(&commit.sha) { + None => { + pr.inbox + .sender() + .send(GithubPrCommand::FetchCommitArtifacts { + sha: commit.sha.clone(), + }) + .ok(); + } + Some(Poll::Pending) => { + ui.spinner(); + } + Some(Poll::Ready(Err(error))) => { + ui.colored_label( + ui.visuals().error_fg_color, + format!("Error: {}", error), + ); + } + Some(Poll::Ready(Ok(artifacts))) => { + if artifacts.is_empty() { + ui.label("No artifacts found"); + } else { + for artifact in artifacts { + if ui.button(&artifact.name).clicked() { + selected_source = + Some(DiffSource::GHArtifact { + repo: pr.link.repo.clone(), + artifact_id: artifact.id.to_string(), + }); + } } } } } - } - }); + }); - let content = LabelContent::new(&commit.commit.commit.message) - .with_button(button) - .with_always_show_buttons(true); + let content = LabelContent::new(&commit.message) + .with_button(button) + .with_always_show_buttons(true); - let response = item.show_hierarchical(ui, content); - } + item.show_hierarchical(ui, content); + } + }); }); - } - Poll::Ready(Err(error)) => { - ui.colored_label(ui.visuals().error_fg_color, format!("Error: {}", error)); - } - Poll::Pending => { - ui.spinner(); - } + }); } - }); + Poll::Ready(Err(error)) => { + ui.colored_label(ui.visuals().error_fg_color, format!("Error: {}", error)); + } + Poll::Pending => { + ui.spinner(); + } + } if let Some(source) = selected_source { state.send(SystemCommand::Open(source)); diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs index 617a98a..40a45ce 100644 --- a/src/loaders/pr_loader.rs +++ b/src/loaders/pr_loader.rs @@ -1,8 +1,9 @@ use crate::github_model::{GithubPrLink, GithubRepoLink}; -use crate::github_pr::{pr_ui, GithubPr}; +use crate::github_pr::{GithubPr, pr_ui}; use crate::loaders::{LoadSnapshots, SnapshotLoader}; use crate::octokit::RepoClient; use crate::snapshot::{FileReference, Snapshot}; +use crate::state::AppStateRef; use anyhow::Error; use eframe::egui::{Context, Ui}; use egui_inbox::{UiInbox, UiInboxSender}; @@ -13,7 +14,6 @@ use std::ops::Deref; use std::path::Path; use std::pin::pin; use std::task::Poll; -use crate::state::AppStateRef; pub struct PrLoader { snapshots: Vec, @@ -111,7 +111,10 @@ impl LoadSnapshots for PrLoader { fn update(&mut self, ctx: &Context) { for snapshot in self.inbox.read(ctx) { match snapshot { - Some(s) => self.snapshots.push(s), + Some(s) => { + self.snapshots.push(s); + self.snapshots.sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); + } None => self.loading = false, } } diff --git a/src/viewer/file_tree.rs b/src/viewer/file_tree.rs index 349bf56..9fbfd40 100644 --- a/src/viewer/file_tree.rs +++ b/src/viewer/file_tree.rs @@ -10,6 +10,8 @@ pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { state.loader.extra_ui(ui, state.app); + ui.panel_title_bar("Files", None); + let mut filter = state.filter.clone(); TextEdit::singleline(&mut filter) .hint_text("Filter") @@ -64,7 +66,7 @@ fn show_prefix( } if selected && state.index_just_selected { - response.scroll_to_me(Some(eframe::egui::Align::Center)); + response.scroll_to_me(None); } } } diff --git a/src/viewer/mod.rs b/src/viewer/mod.rs index f6ac494..7a1f4cd 100644 --- a/src/viewer/mod.rs +++ b/src/viewer/mod.rs @@ -9,7 +9,6 @@ use eframe::egui::{Context, Ui}; pub fn viewer_ui(ctx: &Context, state: &ViewerAppStateRef<'_>) { egui::SidePanel::new(Side::Left, "files").show(ctx, |ui| { - ui.heading("Files"); file_tree::file_tree(ui, state); }); From 08be7297f6f4902759cfbbe4eb4ad15ad16f8c93 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Thu, 25 Sep 2025 13:15:15 +0200 Subject: [PATCH 06/25] Reimplement archive loader --- Cargo.lock | 2 + Cargo.toml | 2 + src/cli.rs | 18 +- src/github_model.rs | 19 +++ src/github_pr.rs | 12 +- src/lib.rs | 25 +-- src/loaders/archive_loader.rs | 269 ++++++++++++++++++++++++++++++ src/loaders/gh_archive_loader.rs | 101 +++++++++++ src/loaders/mod.rs | 49 +++++- src/loaders/pr_loader.rs | 7 +- src/loaders/tar_loader.rs | 167 ------------------- src/loaders/zip_loader.rs | 175 ------------------- src/main.rs | 9 +- src/native_loaders/file_loader.rs | 8 +- src/snapshot.rs | 19 ++- src/viewer/diff_view.rs | 5 - src/viewer/file_tree.rs | 28 +++- 17 files changed, 522 insertions(+), 393 deletions(-) create mode 100644 src/loaders/archive_loader.rs create mode 100644 src/loaders/gh_archive_loader.rs delete mode 100644 src/loaders/tar_loader.rs delete mode 100644 src/loaders/zip_loader.rs diff --git a/Cargo.lock b/Cargo.lock index a84cfe0..febf207 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -3116,6 +3116,7 @@ name = "kitdiff" version = "0.1.0" dependencies = [ "anyhow", + "bytes", "chrono", "clap", "dify", @@ -3135,6 +3136,7 @@ dependencies = [ "octocrab", "octocrab-wasm", "re_ui", + "reqwest", "serde", "serde_json", "tar", diff --git a/Cargo.toml b/Cargo.toml index 1f4c41e..4296cab 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -39,6 +39,8 @@ getrandom = { version = "0.3", features = ["wasm_js"] } anyhow = "1.0.99" graphql_client = "0.14.0" thiserror = "1.0.69" +bytes = "1.10.1" +reqwest = "0.12.23" # native: [target.'cfg(not(target_arch = "wasm32"))'.dependencies] diff --git a/src/cli.rs b/src/cli.rs index ab76c80..995c381 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -1,6 +1,8 @@ use clap::{Parser, Subcommand}; use kitdiff::DiffSource; use kitdiff::github_auth::parse_github_artifact_url; +use kitdiff::github_model::GithubArtifactLink; +use octocrab::models::ArtifactId; #[derive(Parser)] #[command(name = "kitdiff")] @@ -13,9 +15,7 @@ pub struct Cli { #[derive(Subcommand)] pub enum Commands { /// Compare snapshot test files (.png with .old/.new/.diff variants) (default) - Files { - directory: Option, - }, + Files { directory: Option }, /// Compare images between current branch and default branch Git, /// Compare images between PR branches from GitHub PR URL (needs to be run from within the repo) @@ -29,14 +29,18 @@ pub enum Commands { impl Commands { pub fn to_source(&self) -> DiffSource { match self { - Commands::Files {directory} => DiffSource::Files( - directory.clone().unwrap_or_else(|| ".".into()).into(), - ), + Commands::Files { directory } => { + DiffSource::Files(directory.clone().unwrap_or_else(|| ".".into()).into()) + } Commands::Git => DiffSource::Git, Commands::Pr { url } => { // Check if the PR URL is actually a GitHub artifact URL if let Some((repo, artifact_id)) = parse_github_artifact_url(url) { - DiffSource::GHArtifact { repo, artifact_id } + DiffSource::GHArtifact(GithubArtifactLink { + repo, + artifact_id: ArtifactId(artifact_id.parse().unwrap()), + name: None, + }) } else { if let Ok(parsed_url) = url.parse() { DiffSource::Pr(parsed_url) diff --git a/src/github_model.rs b/src/github_model.rs index db2a809..9178eda 100644 --- a/src/github_model.rs +++ b/src/github_model.rs @@ -1,5 +1,6 @@ use std::fmt::Display; use std::str::FromStr; +use octocrab::models::ArtifactId; pub type PrNumber = u64; @@ -84,3 +85,21 @@ impl Display for GithubPrLink { ) } } + +#[derive(Debug, Clone)] +pub struct GithubArtifactLink { + pub repo: GithubRepoLink, + pub artifact_id: ArtifactId, + pub name: Option, +} + +impl GithubArtifactLink { + pub fn name(&self) -> String { + self.name + .as_deref() + .unwrap_or(&self.artifact_id.to_string()) + .to_string() + } +} + + diff --git a/src/github_pr.rs b/src/github_pr.rs index 3a60d81..0e4d78b 100644 --- a/src/github_pr.rs +++ b/src/github_pr.rs @@ -16,7 +16,7 @@ use std::str::FromStr; use std::sync::mpsc; use std::task::Poll; // Import octocrab models -use crate::github_model::{GithubPrLink, PrNumber}; +use crate::github_model::{GithubArtifactLink, GithubPrLink, PrNumber}; use crate::octokit::RepoClient; use crate::state::{AppStateRef, SystemCommand}; use octocrab::models::commits::GithubCommitStatus; @@ -370,11 +370,13 @@ pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { } else { for artifact in artifacts { if ui.button(&artifact.name).clicked() { - selected_source = - Some(DiffSource::GHArtifact { + selected_source = Some(DiffSource::GHArtifact( + GithubArtifactLink { repo: pr.link.repo.clone(), - artifact_id: artifact.id.to_string(), - }); + artifact_id: artifact.id, + name: Some(artifact.name.clone()), + }, + )); } } } diff --git a/src/lib.rs b/src/lib.rs index 5d152bd..92bec6d 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -6,7 +6,7 @@ use eframe::egui::load::Bytes; use std::any::Any; use std::path::PathBuf; use std::sync::mpsc::Sender; -use crate::github_model::{GithubPrLink, GithubRepoLink}; +use crate::github_model::{GithubArtifactLink, GithubPrLink, GithubRepoLink}; use crate::state::AppState; pub mod app; @@ -34,10 +34,7 @@ pub enum DiffSource { Pr(GithubPrLink), Zip(PathOrBlob), TarGz(PathOrBlob), - GHArtifact { - repo: GithubRepoLink, - artifact_id: String, - }, + GHArtifact(GithubArtifactLink), } impl DiffSource { @@ -58,20 +55,14 @@ impl DiffSource { // None // } DiffSource::Pr(url) => { - // #[cfg(not(target_arch = "wasm32"))] - // { - // native_loaders::git_loader::pr_git_discovery(url, tx, ctx) - // .expect("Failed to run PR git discovery"); - // } - // #[cfg(target_arch = "wasm32")] - // { - // eprintln!( - // "PR git discovery not supported on WASM. Use GitHub artifacts instead." - // ); - // } - // None Box::new(loaders::pr_loader::PrLoader::new(url, state.github_auth.client())) } + DiffSource::GHArtifact(artifact) => { + Box::new(loaders::gh_archive_loader::GHArtifactLoader::new( + state.github_auth.client(), + artifact, + )) + } // DiffSource::Zip(data) => { // #[cfg(target_arch = "wasm32")] // { diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs new file mode 100644 index 0000000..a98f8bf --- /dev/null +++ b/src/loaders/archive_loader.rs @@ -0,0 +1,269 @@ +use crate::loaders::{DataReference, LoadSnapshots}; +use crate::snapshot::{FileReference, Snapshot}; +use anyhow::{Error, Result}; +use bytes::Bytes; +use eframe::egui::{Context, ImageSource}; +use egui_inbox::{UiInbox, UiInboxSender}; +use flate2::read::GzDecoder; +use std::borrow::Cow; +use std::collections::HashMap; +use std::io::{Cursor, Read}; +use std::path::{Path, PathBuf}; +use std::sync::mpsc; +use std::task::Poll; +use tar::Archive; +use zip::ZipArchive; + +type Sender = UiInboxSender>>; + +#[derive(Debug)] +pub struct ArchiveLoader { + data: Poll>>, + inbox: UiInbox>>, + name: String, +} + +fn is_zip(data: &[u8]) -> bool { + data.starts_with(b"PK") +} + +fn is_tar_gz(data: &[u8]) -> bool { + data.starts_with(&[0x1F, 0x8B, 0x08]) +} + +impl ArchiveLoader { + pub fn new(data: DataReference) -> Self { + let name = data.file_name().to_string(); + let mut inbox = UiInbox::new(); + + inbox.spawn(|tx| async move { + let result = run_discovery(data).await; + tx.send(result).ok(); + }); + + Self { + name, + data: Poll::Pending, + inbox, + } + } +} + +impl LoadSnapshots for ArchiveLoader { + fn files_header(&self) -> String { + format!("Archive: {}", self.name) + } + + fn update(&mut self, ctx: &Context) { + if let Some(mut new_data) = self.inbox.read(ctx).last() { + match &mut new_data { + Ok(data) => { + data.sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); + for snapshot in data { + // We need to register bytes so that the diff loader can find them + snapshot.register_bytes(ctx); + } + } + _ => {} + } + self.data = Poll::Ready(new_data); + } + } + + fn snapshots(&self) -> &[Snapshot] { + match &self.data { + Poll::Ready(Ok(snapshots)) => snapshots, + _ => &[], + } + } + + fn state(&self) -> Poll> { + match &self.data { + Poll::Ready(Ok(_)) => Poll::Ready(Ok(())), + Poll::Ready(Err(e)) => Poll::Ready(Err(e)), + Poll::Pending => Poll::Pending, + } + } +} + +pub async fn run_discovery(file: DataReference) -> anyhow::Result> { + let data = file.into_bytes().await?; + + #[cfg(target_arch = "wasm32")] + { + sync_discovery(data) + } + #[cfg(not(target_arch = "wasm32"))] + { + let data = tokio::task::spawn_blocking(move || sync_discovery(data)).await?; + data + } +} + +fn sync_discovery(data: Bytes) -> anyhow::Result> { + let files = if is_zip(&data) { + run_zip_discovery(data)? + } else if is_tar_gz(&data) { + run_tar_discovery(data)? + } else { + anyhow::bail!("Unsupported archive format"); + }; + + Ok(get_snapshots(files)) +} + +fn run_zip_discovery(zip_data: Bytes) -> Result>> { + // Extract all files into memory (similar to tar loader) + let cursor = Cursor::new(zip_data); + let mut archive = ZipArchive::new(cursor)?; + + let mut files = HashMap::new(); + + for i in 0..archive.len() { + let mut file = archive.by_index(i)?; + let file_path = match file.enclosed_name() { + Some(path) => path.to_path_buf(), + None => continue, // Skip files with invalid names + }; + + // Only process PNG files + if file_path.extension().and_then(|s| s.to_str()) == Some("png") { + let mut data = Vec::new(); + file.read_to_end(&mut data)?; + files.insert(file_path, data); + } + } + + Ok(files) +} + +fn run_tar_discovery(tar_data: Bytes) -> Result>> { + let cursor = Cursor::new(tar_data); + let gz_decoder = GzDecoder::new(cursor); + let mut archive = Archive::new(gz_decoder); + + // Extract all files into memory + let mut files = HashMap::new(); + + for entry in archive.entries()? { + let mut entry = entry?; + let path = entry.path()?.to_path_buf(); + + // Only process PNG files + if path.extension().and_then(|s| s.to_str()) == Some("png") { + let mut data = Vec::new(); + entry.read_to_end(&mut data)?; + files.insert(path, data); + } + } + + Ok(files) +} + +fn get_snapshots(files: HashMap>) -> Vec { + let mut snapshots = Vec::new(); + let mut processed_files = std::collections::HashSet::new(); + + for (png_path, _) in &files { + if processed_files.contains(png_path) { + continue; + } + + if let Some(snapshot) = try_create_snapshot(png_path, &files) { + // Mark related files as processed + processed_files.insert(png_path.clone()); + if let Some(old_path) = get_variant_path(png_path, "old") { + processed_files.insert(old_path); + } + if let Some(new_path) = get_variant_path(png_path, "new") { + processed_files.insert(new_path); + } + if let Some(diff_path) = get_variant_path(png_path, "diff") { + processed_files.insert(diff_path); + } + + snapshots.push(snapshot); + } + } + + snapshots +} + +fn try_create_snapshot(png_path: &Path, files: &HashMap>) -> Option { + let file_name = png_path.file_name()?.to_str()?; + + // Skip files that are already variants (.old.png, .new.png, .diff.png) + if file_name.ends_with(".old.png") + || file_name.ends_with(".new.png") + || file_name.ends_with(".diff.png") + { + return None; + } + + // Get variant paths + let old_path = get_variant_path(png_path, "old")?; + let new_path = get_variant_path(png_path, "new")?; + let diff_path = get_variant_path(png_path, "diff")?; + + // // Check if diff exists (required for a valid snapshot) + // if !files.contains_key(&diff_path) { + // return None; + // } + + let base_data = files.get(png_path)?; + + let diff_data = files.get(&diff_path); + let diff_reference = diff_data.map(|data| FileReference::Source(ImageSource::Bytes { + uri: Cow::Owned(format!("bytes://{}", diff_path.display())), + bytes: eframe::egui::load::Bytes::Shared(data.clone().into()), + })); + + if files.contains_key(&old_path) { + // old.png exists, use original as new and old.png as old + let old_data = files.get(&old_path)?; + if old_data == base_data { + // If old and new are identical, skip this snapshot + return None; + } + Some(Snapshot { + path: png_path.to_path_buf(), + old: Some(FileReference::Source(ImageSource::Bytes { + uri: Cow::Owned(format!("bytes://{}", old_path.display())), + bytes: eframe::egui::load::Bytes::Shared(old_data.clone().into()), + })), + new: Some(FileReference::Source(ImageSource::Bytes { + uri: Cow::Owned(format!("bytes://{}", png_path.display())), + bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), + })), + diff: diff_reference, // We'll handle diff separately if needed + }) + } else if files.contains_key(&new_path) { + // new.png exists, use original as old and new.png as new + let new_data = files.get(&new_path)?; + if new_data == base_data { + // If old and new are identical, skip this snapshot + return None; + } + Some(Snapshot { + path: png_path.to_path_buf(), + old: Some(FileReference::Source(ImageSource::Bytes { + uri: Cow::Owned(format!("bytes://{}", png_path.display())), + bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), + })), + new: Some(FileReference::Source(ImageSource::Bytes { + uri: Cow::Owned(format!("bytes://{}", new_path.display())), + bytes: eframe::egui::load::Bytes::Shared(new_data.clone().into()), + })), + diff: diff_reference, // We'll handle diff separately if needed + }) + } else { + // No old or new variant, skip this snapshot + None + } +} + +fn get_variant_path(base_path: &Path, variant: &str) -> Option { + let stem = base_path.file_stem()?.to_str()?; + let parent = base_path.parent().unwrap_or(Path::new("")); + Some(parent.join(format!("{}.{}.png", stem, variant))) +} diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs new file mode 100644 index 0000000..387bc05 --- /dev/null +++ b/src/loaders/gh_archive_loader.rs @@ -0,0 +1,101 @@ +use crate::github_model::GithubArtifactLink; +use crate::loaders::LoadSnapshots; +use crate::loaders::archive_loader::ArchiveLoader; +use crate::snapshot::Snapshot; +use anyhow::Error; +use bytes::Bytes; +use eframe::egui::Context; +use egui_inbox::UiInbox; +use futures::SinkExt; +use octocrab::Octocrab; +use octocrab::models::ArtifactId; +use octocrab::params::actions::ArchiveFormat; +use std::task::Poll; + +#[derive(Debug)] +pub enum GHArtifactLoader { + LoadingData(UiInbox>), + LoadingArchive(ArchiveLoader), + Error(anyhow::Error), +} + +impl GHArtifactLoader { + pub fn new(client: Octocrab, artifact: GithubArtifactLink) -> Self { + let mut inbox = UiInbox::new(); + + inbox.spawn(move |tx| async move { + tx.send(download_artifact(&client, &artifact).await).ok(); + }); + + Self::LoadingData(inbox) + } +} + +pub async fn download_artifact( + client: &Octocrab, + artifact: &GithubArtifactLink, +) -> anyhow::Result<(Bytes, String)> { + let data = client + .actions() + .download_artifact( + &artifact.repo.owner, + &artifact.repo.repo, + artifact.artifact_id, + ArchiveFormat::Zip, + ) + .await?; + let name = artifact.name(); + Ok((data, name)) +} + +impl LoadSnapshots for GHArtifactLoader { + fn update(&mut self, ctx: &Context) { + let mut new_self = None; + match self { + GHArtifactLoader::LoadingData(inbox) => { + if let Some(result) = inbox.read(ctx).last() { + match result { + Ok((data, name)) => { + new_self = Some(GHArtifactLoader::LoadingArchive(ArchiveLoader::new( + crate::loaders::DataReference::Data(data.clone(), name), + ))); + } + Err(e) => { + new_self = Some(GHArtifactLoader::Error(e)); + } + } + } + } + GHArtifactLoader::LoadingArchive(loader) => { + loader.update(ctx); + } + GHArtifactLoader::Error(_) => {} + } + if let Some(new_self) = new_self { + *self = new_self; + } + } + + fn snapshots(&self) -> &[Snapshot] { + match self { + GHArtifactLoader::LoadingArchive(loader) => loader.snapshots(), + _ => &[], + } + } + + fn state(&self) -> Poll> { + match self { + GHArtifactLoader::LoadingData(_) => Poll::Pending, + GHArtifactLoader::LoadingArchive(loader) => loader.state(), + GHArtifactLoader::Error(e) => Poll::Ready(Err(e)), + } + } + + fn files_header(&self) -> String { + match self { + GHArtifactLoader::LoadingData(_) => "Github Artifact".to_string(), + GHArtifactLoader::LoadingArchive(loader) => loader.files_header(), + GHArtifactLoader::Error(_) => "Github Artifact".to_string(), + } + } +} diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index d6d9a44..b4e6145 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -1,11 +1,12 @@ use crate::snapshot::Snapshot; +use crate::state::AppStateRef; use eframe::egui; +use std::path::PathBuf; use std::task::Poll; -use crate::state::AppStateRef; -pub mod tar_loader; -pub mod zip_loader; +pub mod archive_loader; pub mod pr_loader; +pub mod gh_archive_loader; pub trait LoadSnapshots { fn update(&mut self, ctx: &egui::Context); @@ -14,8 +15,46 @@ pub trait LoadSnapshots { /// State is separate so that snapshots can be streamed in fn state(&self) -> Poll>; - + fn extra_ui(&self, ui: &mut egui::Ui, state: &AppStateRef<'_>) {} + + fn files_header(&self) -> String; } -pub type SnapshotLoader = Box; \ No newline at end of file +pub type SnapshotLoader = Box; + +pub enum DataReference { + Url(String), + Data(bytes::Bytes, String), + Path(PathBuf), +} + +impl DataReference { + pub fn file_name(&self) -> &str { + match self { + DataReference::Url(url) => url.split('/').last().unwrap_or(url), + DataReference::Data(_, name) => name, + DataReference::Path(path) => path.file_name().and_then(|n| n.to_str()).unwrap_or("unknown"), + } + } + + pub async fn into_bytes(self) -> anyhow::Result { + match self { + DataReference::Url(url) => { + let resp = reqwest::get(&url).await?; + let bytes = resp.bytes().await?; + Ok(bytes) + } + DataReference::Data(data, _) => Ok(data), + DataReference::Path(_path) => { + #[cfg(target_arch = "wasm32")] + anyhow::bail!("FileReference::Path is not supported on wasm32"); + #[cfg(not(target_arch = "wasm32"))] + { + let data = tokio::fs::read(_path).await?; + Ok(bytes::Bytes::from(data)) + } + } + } + } +} diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs index 40a45ce..77f9343 100644 --- a/src/loaders/pr_loader.rs +++ b/src/loaders/pr_loader.rs @@ -113,7 +113,8 @@ impl LoadSnapshots for PrLoader { match snapshot { Some(s) => { self.snapshots.push(s); - self.snapshots.sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); + self.snapshots + .sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); } None => self.loading = false, } @@ -136,4 +137,8 @@ impl LoadSnapshots for PrLoader { fn extra_ui(&self, ui: &mut Ui, state: &AppStateRef<'_>) { pr_ui(ui, state, &self.pr_info); } + + fn files_header(&self) -> String { + format!("{}", self.link) + } } diff --git a/src/loaders/tar_loader.rs b/src/loaders/tar_loader.rs deleted file mode 100644 index 4d1a03a..0000000 --- a/src/loaders/tar_loader.rs +++ /dev/null @@ -1,167 +0,0 @@ -use crate::snapshot::{FileReference, Snapshot}; -use eframe::egui::{Context, ImageSource}; -use flate2::read::GzDecoder; -use std::borrow::Cow; -use std::collections::HashMap; -use std::io::{Cursor, Read}; -use std::path::{Path, PathBuf}; -use std::sync::mpsc; -use tar::Archive; - -#[derive(Debug)] -pub enum TarError { - IoError(std::io::Error), - TarError, - InvalidData, -} - -impl From for TarError { - fn from(err: std::io::Error) -> Self { - TarError::IoError(err) - } -} - -pub fn extract_and_discover_tar_gz( - tar_data: Vec, - sender: mpsc::Sender, - ctx: Context, -) -> Result<(), TarError> { - if let Err(e) = run_tar_gz_discovery(tar_data, sender, ctx) { - eprintln!("Tar.gz discovery error: {:?}", e); - } - Ok(()) -} - -fn run_tar_gz_discovery( - tar_data: Vec, - sender: mpsc::Sender, - ctx: Context, -) -> Result<(), TarError> { - // Decompress gzip data - let cursor = Cursor::new(tar_data); - let gz_decoder = GzDecoder::new(cursor); - let mut archive = Archive::new(gz_decoder); - - // Extract all files into memory - let mut files: HashMap> = HashMap::new(); - - for entry in archive.entries()? { - let mut entry = entry?; - let path = entry.path()?.to_path_buf(); - - // Only process PNG files - if path.extension().and_then(|s| s.to_str()) == Some("png") { - let mut data = Vec::new(); - entry.read_to_end(&mut data)?; - files.insert(path, data); - } - } - - // Process the extracted files to create snapshots - let mut processed_files = std::collections::HashSet::new(); - - for (png_path, _) in &files { - if processed_files.contains(png_path) { - continue; - } - - if let Some(snapshot) = try_create_tar_snapshot(png_path, &files) { - // Mark related files as processed - processed_files.insert(png_path.clone()); - if let Some(old_path) = get_variant_path(png_path, "old") { - processed_files.insert(old_path); - } - if let Some(new_path) = get_variant_path(png_path, "new") { - processed_files.insert(new_path); - } - if let Some(diff_path) = get_variant_path(png_path, "diff") { - processed_files.insert(diff_path); - } - - // Include bytes in egui context for loading - match &snapshot.old { - Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { - ctx.include_bytes(uri.clone(), bytes.clone()); - } - _ => {} - } - match &snapshot.new { - Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { - ctx.include_bytes(uri.clone(), bytes.clone()); - } - _ => {} - } - - if sender.send(snapshot).is_ok() { - ctx.request_repaint(); - } - } - } - - Ok(()) -} - -fn try_create_tar_snapshot(png_path: &Path, files: &HashMap>) -> Option { - let file_name = png_path.file_name()?.to_str()?; - - // Skip files that are already variants (.old.png, .new.png, .diff.png) - if file_name.ends_with(".old.png") - || file_name.ends_with(".new.png") - || file_name.ends_with(".diff.png") - { - return None; - } - - // Get variant paths - let old_path = get_variant_path(png_path, "old")?; - let new_path = get_variant_path(png_path, "new")?; - let diff_path = get_variant_path(png_path, "diff")?; - - // Check if diff exists (required for a valid snapshot) - if !files.contains_key(&diff_path) { - return None; - } - - let base_data = files.get(png_path)?; - - if files.contains_key(&old_path) { - // old.png exists, use original as new and old.png as old - let old_data = files.get(&old_path)?; - Some(Snapshot { - path: png_path.to_path_buf(), - old: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("tar://{}", old_path.display())), - bytes: eframe::egui::load::Bytes::Shared(old_data.clone().into()), - })), - new: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("tar://{}", png_path.display())), - bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - })), - diff: None, // We'll handle diff separately if needed - }) - } else if files.contains_key(&new_path) { - // new.png exists, use original as old and new.png as new - let new_data = files.get(&new_path)?; - Some(Snapshot { - path: png_path.to_path_buf(), - old: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("tar://{}", png_path.display())), - bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - })), - new: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("tar://{}", new_path.display())), - bytes: eframe::egui::load::Bytes::Shared(new_data.clone().into()), - })), - diff: None, // We'll handle diff separately if needed - }) - } else { - // No old or new variant, skip this snapshot - None - } -} - -fn get_variant_path(base_path: &Path, variant: &str) -> Option { - let stem = base_path.file_stem()?.to_str()?; - let parent = base_path.parent().unwrap_or(Path::new("")); - Some(parent.join(format!("{}.{}.png", stem, variant))) -} diff --git a/src/loaders/zip_loader.rs b/src/loaders/zip_loader.rs deleted file mode 100644 index 8330207..0000000 --- a/src/loaders/zip_loader.rs +++ /dev/null @@ -1,175 +0,0 @@ -use crate::snapshot::{FileReference, Snapshot}; -use eframe::egui::{Context, ImageSource}; -use std::borrow::Cow; -use std::collections::HashMap; -use std::io::{Cursor, Read}; -use std::path::{Path, PathBuf}; -use std::sync::mpsc; -use zip::ZipArchive; - -#[derive(Debug)] -pub enum ZipError { - NetworkError(String), - IoError(std::io::Error), - ZipError(zip::result::ZipError), - TempDirError, -} - -impl From for ZipError { - fn from(err: std::io::Error) -> Self { - ZipError::IoError(err) - } -} - -impl From for ZipError { - fn from(err: zip::result::ZipError) -> Self { - ZipError::ZipError(err) - } -} - -pub fn extract_and_discover_zip( - zip_data: Vec, - sender: mpsc::Sender, - ctx: Context, -) -> Result<(), ZipError> { - if let Err(e) = run_zip_discovery(zip_data, sender, ctx) { - eprintln!("Zip discovery error: {:?}", e); - panic!("Zip discovery failed: {:?}", e); - } - Ok(()) -} - -fn run_zip_discovery( - zip_data: Vec, - sender: mpsc::Sender, - ctx: Context, -) -> Result<(), ZipError> { - // Extract all files into memory (similar to tar loader) - let cursor = Cursor::new(zip_data); - let mut archive = ZipArchive::new(cursor)?; - - let mut files: HashMap> = HashMap::new(); - - for i in 0..archive.len() { - let mut file = archive.by_index(i)?; - let file_path = match file.enclosed_name() { - Some(path) => path.to_path_buf(), - None => continue, // Skip files with invalid names - }; - - // Only process PNG files - if file_path.extension().and_then(|s| s.to_str()) == Some("png") { - let mut data = Vec::new(); - file.read_to_end(&mut data)?; - files.insert(file_path, data); - } - } - - // Process the extracted files to create snapshots - let mut processed_files = std::collections::HashSet::new(); - - for (png_path, _) in &files { - if processed_files.contains(png_path) { - continue; - } - - if let Some(snapshot) = try_create_zip_snapshot(png_path, &files) { - // Mark related files as processed - processed_files.insert(png_path.clone()); - if let Some(old_path) = get_variant_path(png_path, "old") { - processed_files.insert(old_path); - } - if let Some(new_path) = get_variant_path(png_path, "new") { - processed_files.insert(new_path); - } - if let Some(diff_path) = get_variant_path(png_path, "diff") { - processed_files.insert(diff_path); - } - - // Include bytes in egui context for loading - match &snapshot.old { - Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { - ctx.include_bytes(uri.clone(), bytes.clone()); - } - _ => {} - } - match &snapshot.new { - Some(FileReference::Source(ImageSource::Bytes { uri, bytes })) => { - ctx.include_bytes(uri.clone(), bytes.clone()); - } - _ => {} - } - - if sender.send(snapshot).is_ok() { - ctx.request_repaint(); - } - } - } - - Ok(()) -} - -fn try_create_zip_snapshot(png_path: &Path, files: &HashMap>) -> Option { - let file_name = png_path.file_name()?.to_str()?; - - // Skip files that are already variants (.old.png, .new.png, .diff.png) - if file_name.ends_with(".old.png") - || file_name.ends_with(".new.png") - || file_name.ends_with(".diff.png") - { - return None; - } - - // Get variant paths - let old_path = get_variant_path(png_path, "old")?; - let new_path = get_variant_path(png_path, "new")?; - let diff_path = get_variant_path(png_path, "diff")?; - - // Check if diff exists (required for a valid snapshot) - if !files.contains_key(&diff_path) { - return None; - } - - let base_data = files.get(png_path)?; - - if files.contains_key(&old_path) { - // old.png exists, use original as new and old.png as old - let old_data = files.get(&old_path)?; - Some(Snapshot { - path: png_path.to_path_buf(), - old: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("zip://{}", old_path.display())), - bytes: eframe::egui::load::Bytes::Shared(old_data.clone().into()), - })), - new: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("zip://{}", png_path.display())), - bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - })), - diff: None, // We'll handle diff separately if needed - }) - } else if files.contains_key(&new_path) { - // new.png exists, use original as old and new.png as new - let new_data = files.get(&new_path)?; - Some(Snapshot { - path: png_path.to_path_buf(), - old: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("zip://{}", png_path.display())), - bytes: eframe::egui::load::Bytes::Shared(base_data.clone().into()), - })), - new: Some(FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("zip://{}", new_path.display())), - bytes: eframe::egui::load::Bytes::Shared(new_data.clone().into()), - })), - diff: None, // We'll handle diff separately if needed - }) - } else { - // No old or new variant, skip this snapshot - None - } -} - -fn get_variant_path(base_path: &Path, variant: &str) -> Option { - let stem = base_path.file_stem()?.to_str()?; - let parent = base_path.parent().unwrap_or(Path::new("")); - Some(parent.join(format!("{}.{}.png", stem, variant))) -} diff --git a/src/main.rs b/src/main.rs index 5292543..69abc03 100644 --- a/src/main.rs +++ b/src/main.rs @@ -5,7 +5,8 @@ mod cli; use eframe::NativeOptions; use kitdiff::DiffSource; use kitdiff::app::App; -use kitdiff::github_model::GithubPrLink; +use kitdiff::github_model::{GithubArtifactLink, GithubPrLink}; +use octocrab::models::ArtifactId; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { @@ -53,7 +54,11 @@ fn parse_url_query_params() -> Option { // Try to parse as GitHub artifact URL if let Some((repo, artifact_id)) = parse_github_artifact_url(&decoded_url) { - return Some(DiffSource::GHArtifact { repo, artifact_id }); + return Some(DiffSource::GHArtifact(GithubArtifactLink { + repo, + artifact_id: ArtifactId(artifact_id.parse().unwrap()), + name: None, + })); } // Try to parse as direct zip/tar.gz URL diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 447d089..31430d2 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -78,6 +78,10 @@ impl LoadSnapshots for FileLoader { Poll::Ready(Ok(())) } } + + fn files_header(&self) -> String { + format!("Files in {}", self.base_path.display()) + } } fn try_create_snapshot(png_path: &Path, base_path: &Path) -> Option { @@ -111,7 +115,7 @@ fn try_create_snapshot(png_path: &Path, base_path: &Path) -> Option { path: relative_path.to_path_buf(), old: Some(FileReference::Path(old_path)), new: Some(FileReference::Path(png_path.to_path_buf())), - diff: Some(diff_path), + diff: Some(FileReference::Path(diff_path)), }) } else if new_path.exists() { // new.png exists, use original as old and new.png as new @@ -119,7 +123,7 @@ fn try_create_snapshot(png_path: &Path, base_path: &Path) -> Option { path: relative_path.to_path_buf(), old: Some(FileReference::Path(png_path.to_path_buf())), new: Some(FileReference::Path(new_path)), - diff: Some(diff_path), + diff: Some(FileReference::Path(diff_path)), }) } else { // No old or new variant, skip this snapshot diff --git a/src/snapshot.rs b/src/snapshot.rs index 5c25527..b8a6e1b 100644 --- a/src/snapshot.rs +++ b/src/snapshot.rs @@ -1,6 +1,7 @@ use crate::diff_image_loader; use crate::diff_image_loader::DiffOptions; use crate::state::{AppStateRef, PageRef, ViewerStateRef}; +use eframe::egui; use eframe::egui::{Color32, ImageSource}; use std::path::PathBuf; @@ -11,7 +12,7 @@ pub struct Snapshot { pub old: Option, /// If only new is set, the file was added. pub new: Option, - pub diff: Option, + pub diff: Option, } #[derive(Debug, Clone)] @@ -57,10 +58,20 @@ impl Snapshot { self.new.as_ref().map(|p| p.to_uri()) } + pub fn register_bytes(&self, ctx: &egui::Context) { + if let Some(FileReference::Source(ImageSource::Bytes { bytes, uri })) = &self.old { + ctx.include_bytes(uri.clone(), bytes.clone()); + } + if let Some(FileReference::Source(ImageSource::Bytes { bytes, uri })) = &self.new { + ctx.include_bytes(uri.clone(), bytes.clone()); + } + if let Some(FileReference::Source(ImageSource::Bytes { bytes, uri })) = &self.diff { + ctx.include_bytes(uri.clone(), bytes.clone()); + } + } + pub fn file_diff_uri(&self) -> Option { - self.diff - .as_ref() - .map(|p| format!("file://{}", p.display())) + self.diff.as_ref().map(|p| p.to_uri()) } pub fn diff_uri(&self, use_file_if_available: bool, options: DiffOptions) -> Option { diff --git a/src/viewer/diff_view.rs b/src/viewer/diff_view.rs index e41de72..f42fcb8 100644 --- a/src/viewer/diff_view.rs +++ b/src/viewer/diff_view.rs @@ -78,10 +78,5 @@ pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { } } } - } else if state.loader.state().is_pending() { - // TODO: Display error - ui.label("Searching for snapshots..."); - } else { - ui.label("No snapshots found."); } } diff --git a/src/viewer/file_tree.rs b/src/viewer/file_tree.rs index 9fbfd40..5b92c14 100644 --- a/src/viewer/file_tree.rs +++ b/src/viewer/file_tree.rs @@ -1,16 +1,30 @@ use crate::state::{FilteredSnapshot, ViewerAppStateRef, ViewerSystemCommand}; +use anyhow::Error; use eframe::egui; -use eframe::egui::{Id, ScrollArea, TextEdit, Ui}; -use re_ui::UiExt; +use eframe::egui::{Id, ScrollArea, TextEdit, Ui, Widget}; use re_ui::list_item::{LabelContent, ListItem}; +use re_ui::{UiExt, icons}; use std::collections::BTreeMap; +use std::task::Poll; pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { ui.style_mut().wrap_mode = Some(egui::TextWrapMode::Truncate); state.loader.extra_ui(ui, state.app); - ui.panel_title_bar("Files", None); + ui.panel_title_bar_with_buttons(&state.loader.files_header(), None, |ui| match state.loader.state() { + Poll::Ready(Ok(())) => {} + Poll::Ready(Err(e)) => { + icons::ERROR + .as_image() + .tint(ui.tokens().alert_error.icon) + .ui(ui) + .on_hover_text(e.to_string()); + } + Poll::Pending => { + ui.spinner(); + } + }); let mut filter = state.filter.clone(); TextEdit::singleline(&mut filter) @@ -45,6 +59,14 @@ pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { show_prefix(ui, state, &snapshots); } } + + if state.loader.snapshots().is_empty() { + if state.loader.state().is_ready() { + ui.label("No snapshots were found."); + } + } else if state.filtered_snapshots.is_empty() { + ui.label("No snapshots match the filter."); + } }); }); } From a28aa557349f7e6e92f861a47b576773fb9dee62 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Thu, 25 Sep 2025 13:43:26 +0200 Subject: [PATCH 07/25] Move github to module --- src/app.rs | 4 - src/bar.rs | 2 +- src/cli.rs | 4 +- src/{github_auth.rs => github/auth.rs} | 2 +- src/github/mod.rs | 4 + src/{github_model.rs => github/model.rs} | 0 src/{ => github}/octokit.rs | 2 +- src/{github_pr.graphql => github/pr.graphql} | 0 src/{github_pr.rs => github/pr.rs} | 138 +++++++++---------- src/lib.rs | 12 +- src/loaders/gh_archive_loader.rs | 2 +- src/loaders/pr_loader.rs | 6 +- src/main.rs | 7 +- src/settings.rs | 2 +- src/state.rs | 6 +- 15 files changed, 92 insertions(+), 99 deletions(-) rename src/{github_auth.rs => github/auth.rs} (99%) create mode 100644 src/github/mod.rs rename src/{github_model.rs => github/model.rs} (100%) rename src/{ => github}/octokit.rs (95%) rename src/{github_pr.graphql => github/pr.graphql} (100%) rename src/{github_pr.rs => github/pr.rs} (74%) diff --git a/src/app.rs b/src/app.rs index d1f98e6..1d2bb11 100644 --- a/src/app.rs +++ b/src/app.rs @@ -1,8 +1,4 @@ use crate::diff_image_loader::{DiffImageLoader, DiffOptions}; -use crate::github_auth::{AuthState, LoggedInState}; -#[cfg(target_arch = "wasm32")] -use crate::github_auth::{GitHubAuth, github_artifact_api_url, parse_github_artifact_url}; -use crate::github_pr::{GithubPr, parse_github_pr_url}; use crate::settings::Settings; use crate::snapshot::{FileReference, Snapshot}; use crate::state::{AppState, AppStateRef, PageRef, SystemCommand, ViewerSystemCommand}; diff --git a/src/bar.rs b/src/bar.rs index ee82321..85daa4b 100644 --- a/src/bar.rs +++ b/src/bar.rs @@ -1,8 +1,8 @@ -use crate::github_auth::{AuthState, GithubAuthCommand, LoggedInState}; use crate::state::{AppStateRef, SystemCommand}; use eframe::egui; use eframe::egui::panel::TopBottomSide; use eframe::egui::{Context, Ui}; +use crate::github::auth::GithubAuthCommand; pub fn bar(ctx: &Context, state: &AppStateRef<'_>) { egui::TopBottomPanel::top("top bar") diff --git a/src/cli.rs b/src/cli.rs index 995c381..537e3c7 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -1,8 +1,8 @@ use clap::{Parser, Subcommand}; use kitdiff::DiffSource; -use kitdiff::github_auth::parse_github_artifact_url; -use kitdiff::github_model::GithubArtifactLink; use octocrab::models::ArtifactId; +use kitdiff::github::auth::parse_github_artifact_url; +use kitdiff::github::model::GithubArtifactLink; #[derive(Parser)] #[command(name = "kitdiff")] diff --git a/src/github_auth.rs b/src/github/auth.rs similarity index 99% rename from src/github_auth.rs rename to src/github/auth.rs index 015c36f..6a021b2 100644 --- a/src/github_auth.rs +++ b/src/github/auth.rs @@ -1,10 +1,10 @@ -use crate::github_model::GithubRepoLink; use crate::state::SystemCommand; use eframe::egui; use ehttp; use serde_json; use std::fmt; use std::sync::mpsc; +use crate::github::model::GithubRepoLink; pub enum GithubAuthCommand { Login, diff --git a/src/github/mod.rs b/src/github/mod.rs new file mode 100644 index 0000000..fbc1c13 --- /dev/null +++ b/src/github/mod.rs @@ -0,0 +1,4 @@ +pub mod auth; +pub mod model; +pub mod pr; +pub mod octokit; diff --git a/src/github_model.rs b/src/github/model.rs similarity index 100% rename from src/github_model.rs rename to src/github/model.rs diff --git a/src/octokit.rs b/src/github/octokit.rs similarity index 95% rename from src/octokit.rs rename to src/github/octokit.rs index b740ad9..2aef745 100644 --- a/src/octokit.rs +++ b/src/github/octokit.rs @@ -1,6 +1,6 @@ -use crate::github_model::{GithubPrLink, GithubRepoLink}; use std::ops::Deref; use octocrab::Page; +use crate::github::model::GithubRepoLink; pub struct RepoClient { client: octocrab::Octocrab, diff --git a/src/github_pr.graphql b/src/github/pr.graphql similarity index 100% rename from src/github_pr.graphql rename to src/github/pr.graphql diff --git a/src/github_pr.rs b/src/github/pr.rs similarity index 74% rename from src/github_pr.rs rename to src/github/pr.rs index 0e4d78b..3702126 100644 --- a/src/github_pr.rs +++ b/src/github/pr.rs @@ -16,8 +16,7 @@ use std::str::FromStr; use std::sync::mpsc; use std::task::Poll; // Import octocrab models -use crate::github_model::{GithubArtifactLink, GithubPrLink, PrNumber}; -use crate::octokit::RepoClient; +use crate::github::octokit::RepoClient; use crate::state::{AppStateRef, SystemCommand}; use octocrab::models::commits::GithubCommitStatus; use octocrab::models::{ @@ -40,11 +39,11 @@ pub type URI = String; #[derive(GraphQLQuery, Debug)] #[graphql( schema_path = "github.graphql", - query_path = "src/github_pr.graphql", + query_path = "src/github/pr.graphql", response_derives = "Debug, Clone" )] pub struct PrDetailsQuery; -use crate::github_pr::pr_details_query::StatusState; +use crate::github::model::{GithubArtifactLink, GithubPrLink, PrNumber}; use anyhow::{Error, Result, anyhow}; pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { @@ -320,77 +319,75 @@ async fn fetch_commit_artifacts( pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { let mut selected_source = None; - match &pr.data { + list_item_scope(ui, "pr_info", |ui| match &pr.data { Poll::Ready(Ok(data)) => { - list_item_scope(ui, "pr_info", |ui| { - SectionCollapsingHeader::new(format!("PR: {}", data.title)).show(ui, |ui| { - ui.set_max_height(100.0); - ScrollArea::vertical().show(ui, |ui| { - for commit in data.commits.iter().rev() { - let item = ui.list_item(); - - let button = match &commit.status { - CommitState::Failure => Button::image( - icons::ERROR.as_image().tint(ui.tokens().alert_error.icon), - ) - .boxed_local(), - CommitState::Pending => Spinner::new().boxed_local(), - CommitState::Success => Button::image( - icons::SUCCESS - .as_image() - .tint(ui.tokens().alert_success.icon), - ) - .boxed_local(), - _ => Button::image(icons::HELP.as_image()).boxed_local(), - }; - - let button = button.on_menu(|ui| { - ui.set_min_width(250.0); - match data.artifacts.get(&commit.sha) { - None => { - pr.inbox - .sender() - .send(GithubPrCommand::FetchCommitArtifacts { - sha: commit.sha.clone(), - }) - .ok(); - } - Some(Poll::Pending) => { - ui.spinner(); - } - Some(Poll::Ready(Err(error))) => { - ui.colored_label( - ui.visuals().error_fg_color, - format!("Error: {}", error), - ); - } - Some(Poll::Ready(Ok(artifacts))) => { - if artifacts.is_empty() { - ui.label("No artifacts found"); - } else { - for artifact in artifacts { - if ui.button(&artifact.name).clicked() { - selected_source = Some(DiffSource::GHArtifact( - GithubArtifactLink { - repo: pr.link.repo.clone(), - artifact_id: artifact.id, - name: Some(artifact.name.clone()), - }, - )); - } + SectionCollapsingHeader::new(format!("PR: {}", data.title)).show(ui, |ui| { + ui.set_max_height(100.0); + ScrollArea::vertical().show(ui, |ui| { + for commit in data.commits.iter().rev() { + let item = ui.list_item(); + + let button = match &commit.status { + CommitState::Failure => Button::image( + icons::ERROR.as_image().tint(ui.tokens().alert_error.icon), + ) + .boxed_local(), + CommitState::Pending => Spinner::new().boxed_local(), + CommitState::Success => Button::image( + icons::SUCCESS + .as_image() + .tint(ui.tokens().alert_success.icon), + ) + .boxed_local(), + _ => Button::image(icons::HELP.as_image()).boxed_local(), + }; + + let button = button.on_menu(|ui| { + ui.set_min_width(250.0); + match data.artifacts.get(&commit.sha) { + None => { + pr.inbox + .sender() + .send(GithubPrCommand::FetchCommitArtifacts { + sha: commit.sha.clone(), + }) + .ok(); + } + Some(Poll::Pending) => { + ui.spinner(); + } + Some(Poll::Ready(Err(error))) => { + ui.colored_label( + ui.visuals().error_fg_color, + format!("Error: {}", error), + ); + } + Some(Poll::Ready(Ok(artifacts))) => { + if artifacts.is_empty() { + ui.label("No artifacts found"); + } else { + for artifact in artifacts { + if ui.button(&artifact.name).clicked() { + selected_source = Some(DiffSource::GHArtifact( + GithubArtifactLink { + repo: pr.link.repo.clone(), + artifact_id: artifact.id, + name: Some(artifact.name.clone()), + }, + )); } } } } - }); + } + }); - let content = LabelContent::new(&commit.message) - .with_button(button) - .with_always_show_buttons(true); + let content = LabelContent::new(&commit.message) + .with_button(button) + .with_always_show_buttons(true); - item.show_hierarchical(ui, content); - } - }); + item.show_hierarchical(ui, content); + } }); }); } @@ -398,9 +395,12 @@ pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { ui.colored_label(ui.visuals().error_fg_color, format!("Error: {}", error)); } Poll::Pending => { + SectionCollapsingHeader::new(format!("PR: {}", pr.link)) + .with_button(Spinner::new()) + .show(ui, |ui| {}); ui.spinner(); } - } + }); if let Some(source) = selected_source { state.send(SystemCommand::Open(source)); diff --git a/src/lib.rs b/src/lib.rs index 92bec6d..85e5a06 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -1,29 +1,23 @@ -use crate::github_auth::{AuthState, LoggedInState}; use crate::loaders::SnapshotLoader; -use crate::snapshot::Snapshot; use eframe::egui::Context; use eframe::egui::load::Bytes; use std::any::Any; use std::path::PathBuf; -use std::sync::mpsc::Sender; -use crate::github_model::{GithubArtifactLink, GithubPrLink, GithubRepoLink}; +use crate::github::model::{GithubArtifactLink, GithubPrLink}; use crate::state::AppState; pub mod app; pub mod diff_image_loader; -pub mod github_auth; -pub mod github_pr; pub mod loaders; #[cfg(not(target_arch = "wasm32"))] pub mod native_loaders; mod settings; pub mod snapshot; mod state; -pub mod github_model; -mod octokit; mod viewer; mod home; mod bar; +pub mod github; #[derive(Debug, Clone)] pub enum DiffSource { @@ -32,9 +26,9 @@ pub enum DiffSource { #[cfg(not(target_arch = "wasm32"))] Git, Pr(GithubPrLink), + GHArtifact(GithubArtifactLink), Zip(PathOrBlob), TarGz(PathOrBlob), - GHArtifact(GithubArtifactLink), } impl DiffSource { diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs index 387bc05..2e8c994 100644 --- a/src/loaders/gh_archive_loader.rs +++ b/src/loaders/gh_archive_loader.rs @@ -1,4 +1,3 @@ -use crate::github_model::GithubArtifactLink; use crate::loaders::LoadSnapshots; use crate::loaders::archive_loader::ArchiveLoader; use crate::snapshot::Snapshot; @@ -11,6 +10,7 @@ use octocrab::Octocrab; use octocrab::models::ArtifactId; use octocrab::params::actions::ArchiveFormat; use std::task::Poll; +use crate::github::model::GithubArtifactLink; #[derive(Debug)] pub enum GHArtifactLoader { diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs index 77f9343..d9e63fd 100644 --- a/src/loaders/pr_loader.rs +++ b/src/loaders/pr_loader.rs @@ -1,7 +1,5 @@ -use crate::github_model::{GithubPrLink, GithubRepoLink}; -use crate::github_pr::{GithubPr, pr_ui}; use crate::loaders::{LoadSnapshots, SnapshotLoader}; -use crate::octokit::RepoClient; +use crate::github::octokit::RepoClient; use crate::snapshot::{FileReference, Snapshot}; use crate::state::AppStateRef; use anyhow::Error; @@ -14,6 +12,8 @@ use std::ops::Deref; use std::path::Path; use std::pin::pin; use std::task::Poll; +use crate::github::model::{GithubPrLink, GithubRepoLink}; +use crate::github::pr::{pr_ui, GithubPr}; pub struct PrLoader { snapshots: Vec, diff --git a/src/main.rs b/src/main.rs index 69abc03..6dbdd1f 100644 --- a/src/main.rs +++ b/src/main.rs @@ -5,7 +5,6 @@ mod cli; use eframe::NativeOptions; use kitdiff::DiffSource; use kitdiff::app::App; -use kitdiff::github_model::{GithubArtifactLink, GithubPrLink}; use octocrab::models::ArtifactId; #[cfg(not(target_arch = "wasm32"))] @@ -33,8 +32,8 @@ fn main() -> eframe::Result<()> { #[cfg(target_arch = "wasm32")] fn parse_url_query_params() -> Option { - use kitdiff::github_auth::parse_github_artifact_url; - use kitdiff::github_pr::parse_github_pr_url; + use kitdiff::github::auth::parse_github_artifact_url; + use kitdiff::github::pr::parse_github_pr_url; if let Some(window) = web_sys::window() { if let Ok(search) = window.location().search() { @@ -54,7 +53,7 @@ fn parse_url_query_params() -> Option { // Try to parse as GitHub artifact URL if let Some((repo, artifact_id)) = parse_github_artifact_url(&decoded_url) { - return Some(DiffSource::GHArtifact(GithubArtifactLink { + return Some(DiffSource::GHArtifact(kitdiff::github::model::GithubArtifactLink { repo, artifact_id: ArtifactId(artifact_id.parse().unwrap()), name: None, diff --git a/src/settings.rs b/src/settings.rs index bce0d2c..1eeea41 100644 --- a/src/settings.rs +++ b/src/settings.rs @@ -1,6 +1,6 @@ use crate::diff_image_loader::DiffOptions; -use crate::github_auth::{AuthState, LoggedInState}; use eframe::egui::TextureFilter; +use crate::github::auth::{AuthState, LoggedInState}; #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] pub enum ImageMode { diff --git a/src/state.rs b/src/state.rs index 50a160c..2ff844c 100644 --- a/src/state.rs +++ b/src/state.rs @@ -1,7 +1,4 @@ use crate::diff_image_loader::DiffImageLoader; -use crate::github_auth::{GitHubAuth, GithubAuthCommand}; -use crate::github_model::GithubPrLink; -use crate::github_pr::GithubPr; use crate::loaders::SnapshotLoader; use crate::settings::Settings; use crate::snapshot::Snapshot; @@ -9,6 +6,9 @@ use eframe::egui; use eframe::egui::Context; use egui_inbox::UiInboxSender; use std::ops::Deref; +use crate::github::auth::{GitHubAuth, GithubAuthCommand}; +use crate::github::model::GithubPrLink; +use crate::github::pr::GithubPr; pub struct AppState { pub github_auth: GitHubAuth, From 13d586cf9afa46db845bcac53ff0ac65d38b5166 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Thu, 25 Sep 2025 18:28:23 +0200 Subject: [PATCH 08/25] Update snapshots button --- Cargo.lock | 1 + Cargo.toml | 1 + kitdiff.toml | 2 + src/app.rs | 5 +- src/bar.rs | 10 +++- src/config.rs | 12 +++++ src/github/model.rs | 4 +- src/github/pr.graphql | 2 + src/github/pr.rs | 36 +++++++++---- src/lib.rs | 1 + src/loaders/gh_archive_loader.rs | 93 +++++++++++++++++++++++--------- src/main.rs | 5 +- src/state.rs | 5 +- 13 files changed, 135 insertions(+), 42 deletions(-) create mode 100644 kitdiff.toml create mode 100644 src/config.rs diff --git a/Cargo.lock b/Cargo.lock index febf207..131e41a 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -3130,6 +3130,7 @@ dependencies = [ "getrandom 0.3.3", "git2", "graphql_client", + "hello_egui_utils", "ignore", "image", "js-sys", diff --git a/Cargo.toml b/Cargo.toml index 4296cab..096912d 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -41,6 +41,7 @@ graphql_client = "0.14.0" thiserror = "1.0.69" bytes = "1.10.1" reqwest = "0.12.23" +hello_egui_utils = "0.9.0" # native: [target.'cfg(not(target_arch = "wasm32"))'.dependencies] diff --git a/kitdiff.toml b/kitdiff.toml new file mode 100644 index 0000000..740ec88 --- /dev/null +++ b/kitdiff.toml @@ -0,0 +1,2 @@ +[github] +update_snapshot_workflow_name = "update_kittest_snapshots.yml" diff --git a/src/app.rs b/src/app.rs index 1d2bb11..3d54d08 100644 --- a/src/app.rs +++ b/src/app.rs @@ -12,6 +12,7 @@ use eframe::{Frame, Storage, egui}; use egui_extras::install_image_loaders; use egui_inbox::UiInbox; use std::sync::{Arc, mpsc}; +use crate::config::Config; pub struct App { diff_loader: Arc, @@ -20,7 +21,7 @@ pub struct App { } impl App { - pub fn new(cc: &eframe::CreationContext, source: Option) -> Self { + pub fn new(cc: &eframe::CreationContext, source: Option, config: Config) -> Self { re_ui::apply_style_and_install_loaders(&cc.egui_ctx); let settings: Settings = cc @@ -28,7 +29,7 @@ impl App { .and_then(|s| eframe::get_value(s, eframe::APP_KEY)) .unwrap_or_default(); - let state = AppState::new(settings); + let state = AppState::new(settings, config); install_image_loaders(&cc.egui_ctx); let diff_loader = Arc::new(DiffImageLoader::default()); diff --git a/src/bar.rs b/src/bar.rs index 85daa4b..95a3d4d 100644 --- a/src/bar.rs +++ b/src/bar.rs @@ -1,7 +1,7 @@ use crate::state::{AppStateRef, SystemCommand}; use eframe::egui; use eframe::egui::panel::TopBottomSide; -use eframe::egui::{Context, Ui}; +use eframe::egui::{Context, Popup, Ui}; use crate::github::auth::GithubAuthCommand; pub fn bar(ctx: &Context, state: &AppStateRef<'_>) { @@ -18,7 +18,13 @@ pub fn auth_ui(ui: &mut Ui, state: &AppStateRef<'_>) { if let Some(image) = &logged_in.user_image { ui.image(image); } - ui.label(&logged_in.username); + let response = ui.button(&logged_in.username); + + Popup::menu(&response).show(|ui| { + if ui.button("Log out").clicked() { + state.send(GithubAuthCommand::Logout); + } + }); } None => { if ui.button("Log in with GitHub").clicked() { diff --git a/src/config.rs b/src/config.rs new file mode 100644 index 0000000..0c37921 --- /dev/null +++ b/src/config.rs @@ -0,0 +1,12 @@ +use octocrab::models::WorkflowId; + +#[derive(Debug, Clone, PartialEq, Default, serde::Serialize, serde::Deserialize)] +pub struct Config { + #[serde(default)] + pub github: Github, +} + +#[derive(Debug, Clone, PartialEq, Default, serde::Serialize, serde::Deserialize)] +pub struct Github { + pub update_snapshot_workflow_name: Option, +} diff --git a/src/github/model.rs b/src/github/model.rs index 9178eda..7816c47 100644 --- a/src/github/model.rs +++ b/src/github/model.rs @@ -1,6 +1,6 @@ use std::fmt::Display; use std::str::FromStr; -use octocrab::models::ArtifactId; +use octocrab::models::{ArtifactId, RunId}; pub type PrNumber = u64; @@ -91,6 +91,8 @@ pub struct GithubArtifactLink { pub repo: GithubRepoLink, pub artifact_id: ArtifactId, pub name: Option, + pub branch_name: Option, + pub run_id: Option, } impl GithubArtifactLink { diff --git a/src/github/pr.graphql b/src/github/pr.graphql index 8af08ae..7017342 100644 --- a/src/github/pr.graphql +++ b/src/github/pr.graphql @@ -2,6 +2,8 @@ query PrDetailsQuery($owner: String!, $repo: String!, $oid: Int!) { repository(owner: $owner, name: $repo) { pullRequest(number: $oid) { title + headRefName + baseRefName commits(last: 100) { nodes { diff --git a/src/github/pr.rs b/src/github/pr.rs index 3702126..d1c2d3a 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -73,7 +73,7 @@ pub enum GithubPrCommand { FetchedData(Result), FetchedCommitArtifacts { sha: String, - artifacts: Result, Error>, + artifacts: Result, Error>, }, FetchCommitArtifacts { sha: String, @@ -107,8 +107,16 @@ pub struct GithubPr { #[derive(Debug)] struct PrWithCommits { title: String, + head_branch: String, + base_branch: String, commits: Vec, - artifacts: HashMap>>>, + artifacts: HashMap>>>, +} + +#[derive(Debug)] +struct ArtifactData { + data: WorkflowListArtifact, + run_id: RunId, } #[derive(Debug, Clone, Copy, PartialEq)] @@ -208,6 +216,8 @@ async fn get_pr_commits(repo: &RepoClient, pr: PrNumber) -> Result Result, -) -> Result> { +async fn fetch_commit_artifacts(repo: &RepoClient, run_ids: Vec) -> Result> { let artifacts = FuturesUnordered::from_iter(run_ids.into_iter().map(|run| async move { let artifacts_page = repo .actions() @@ -305,12 +312,17 @@ async fn fetch_commit_artifacts( .value .expect("No etag was provided, so we should have a value"); - let stream = artifacts_page.into_stream(repo); + let stream = artifacts_page + .into_stream(repo) + .map_ok(move |artifact| ArtifactData { + data: artifact, + run_id: RunId(run), + }); Ok(stream) })) .try_flatten() - .try_collect::>() + .try_collect::>() .await?; Ok(artifacts) @@ -367,12 +379,14 @@ pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { ui.label("No artifacts found"); } else { for artifact in artifacts { - if ui.button(&artifact.name).clicked() { + if ui.button(&artifact.data.name).clicked() { selected_source = Some(DiffSource::GHArtifact( GithubArtifactLink { repo: pr.link.repo.clone(), - artifact_id: artifact.id, - name: Some(artifact.name.clone()), + artifact_id: artifact.data.id, + name: Some(artifact.data.name.clone()), + branch_name: Some(data.head_branch.clone()), + run_id: Some(artifact.run_id), }, )); } diff --git a/src/lib.rs b/src/lib.rs index 85e5a06..f61c66d 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -18,6 +18,7 @@ mod viewer; mod home; mod bar; pub mod github; +pub mod config; #[derive(Debug, Clone)] pub enum DiffSource { diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs index 2e8c994..742c1c7 100644 --- a/src/loaders/gh_archive_loader.rs +++ b/src/loaders/gh_archive_loader.rs @@ -1,19 +1,27 @@ +use crate::github::model::GithubArtifactLink; use crate::loaders::LoadSnapshots; use crate::loaders::archive_loader::ArchiveLoader; use crate::snapshot::Snapshot; +use crate::state::AppStateRef; use anyhow::Error; use bytes::Bytes; -use eframe::egui::Context; +use eframe::egui::{Context, Ui}; use egui_inbox::UiInbox; use futures::SinkExt; use octocrab::Octocrab; use octocrab::models::ArtifactId; use octocrab::params::actions::ArchiveFormat; use std::task::Poll; -use crate::github::model::GithubArtifactLink; +use serde_json::json; + +pub struct GHArtifactLoader { + state: LoaderState, + artifact: GithubArtifactLink, + inbox: UiInbox<()>, +} #[derive(Debug)] -pub enum GHArtifactLoader { +pub enum LoaderState { LoadingData(UiInbox>), LoadingArchive(ArchiveLoader), Error(anyhow::Error), @@ -23,11 +31,18 @@ impl GHArtifactLoader { pub fn new(client: Octocrab, artifact: GithubArtifactLink) -> Self { let mut inbox = UiInbox::new(); - inbox.spawn(move |tx| async move { - tx.send(download_artifact(&client, &artifact).await).ok(); - }); + { + let artifact = artifact.clone(); + inbox.spawn(move |tx| async move { + tx.send(download_artifact(&client, &artifact).await).ok(); + }); + } - Self::LoadingData(inbox) + Self { + state: LoaderState::LoadingData(inbox), + artifact, + inbox: UiInbox::new(), + } } } @@ -51,51 +66,81 @@ pub async fn download_artifact( impl LoadSnapshots for GHArtifactLoader { fn update(&mut self, ctx: &Context) { let mut new_self = None; - match self { - GHArtifactLoader::LoadingData(inbox) => { + match &mut self.state { + LoaderState::LoadingData(inbox) => { if let Some(result) = inbox.read(ctx).last() { match result { Ok((data, name)) => { - new_self = Some(GHArtifactLoader::LoadingArchive(ArchiveLoader::new( + new_self = Some(LoaderState::LoadingArchive(ArchiveLoader::new( crate::loaders::DataReference::Data(data.clone(), name), ))); } Err(e) => { - new_self = Some(GHArtifactLoader::Error(e)); + new_self = Some(LoaderState::Error(e)); } } } } - GHArtifactLoader::LoadingArchive(loader) => { + LoaderState::LoadingArchive(loader) => { loader.update(ctx); } - GHArtifactLoader::Error(_) => {} + LoaderState::Error(_) => {} } if let Some(new_self) = new_self { - *self = new_self; + self.state = new_self; } } fn snapshots(&self) -> &[Snapshot] { - match self { - GHArtifactLoader::LoadingArchive(loader) => loader.snapshots(), + match &self.state { + LoaderState::LoadingArchive(loader) => loader.snapshots(), _ => &[], } } fn state(&self) -> Poll> { - match self { - GHArtifactLoader::LoadingData(_) => Poll::Pending, - GHArtifactLoader::LoadingArchive(loader) => loader.state(), - GHArtifactLoader::Error(e) => Poll::Ready(Err(e)), + match &self.state { + LoaderState::LoadingData(_) => Poll::Pending, + LoaderState::LoadingArchive(loader) => loader.state(), + LoaderState::Error(e) => Poll::Ready(Err(e)), } } fn files_header(&self) -> String { - match self { - GHArtifactLoader::LoadingData(_) => "Github Artifact".to_string(), - GHArtifactLoader::LoadingArchive(loader) => loader.files_header(), - GHArtifactLoader::Error(_) => "Github Artifact".to_string(), + match &self.state { + LoaderState::LoadingData(_) => "Github Artifact".to_string(), + LoaderState::LoadingArchive(loader) => loader.files_header(), + LoaderState::Error(_) => "Github Artifact".to_string(), + } + } + + fn extra_ui(&self, ui: &mut Ui, state: &AppStateRef<'_>) { + if let Some((git_ref, run_id)) = self.artifact.branch_name.clone().zip(self.artifact.run_id) { + let response = ui + .button("Update snapshots from this archive") + .on_hover_text( + "This will create a commit on the PR branch with the updated snapshots.", + ); + if response.clicked() { + let client = state.github_auth.client(); + let artifact = self.artifact.clone(); + hello_egui_utils::spawn(async move { + client + .actions() + .create_workflow_dispatch( + artifact.repo.owner, + artifact.repo.repo, + "update_kittest_snapshots.yml", + git_ref, + ) + .inputs(json!({ + "artifact_id": artifact.artifact_id.to_string(), + "run_id": run_id.to_string(), + })) + .send() + .await; + }); + } } } } diff --git a/src/main.rs b/src/main.rs index 6dbdd1f..061b834 100644 --- a/src/main.rs +++ b/src/main.rs @@ -6,6 +6,7 @@ use eframe::NativeOptions; use kitdiff::DiffSource; use kitdiff::app::App; use octocrab::models::ArtifactId; +use kitdiff::config::Config; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { @@ -57,6 +58,8 @@ fn parse_url_query_params() -> Option { repo, artifact_id: ArtifactId(artifact_id.parse().unwrap()), name: None, + branch_name: None, + run_id: None, })); } @@ -103,7 +106,7 @@ fn main() { .start( canvas, web_options, - Box::new(move |cc| Ok(Box::new(App::new(cc, diff_source)))), + Box::new(move |cc| Ok(Box::new(App::new(cc, diff_source, Config::default())))), ) .await; diff --git a/src/state.rs b/src/state.rs index 2ff844c..2c889c0 100644 --- a/src/state.rs +++ b/src/state.rs @@ -6,6 +6,7 @@ use eframe::egui; use eframe::egui::Context; use egui_inbox::UiInboxSender; use std::ops::Deref; +use crate::config::Config; use crate::github::auth::{GitHubAuth, GithubAuthCommand}; use crate::github::model::GithubPrLink; use crate::github::pr::GithubPr; @@ -14,6 +15,7 @@ pub struct AppState { pub github_auth: GitHubAuth, pub github_pr: Option, pub settings: Settings, + pub config: Config, pub page: Page, } @@ -67,11 +69,12 @@ impl ViewFilter { } impl AppState { - pub fn new(settings: Settings) -> AppState { + pub fn new(settings: Settings, config: Config) -> AppState { Self { github_auth: GitHubAuth::new(settings.auth.clone()), github_pr: None, settings, + config, page: Page::Home, } } From 1d866d451858d472e34c9f2ea15552cdb6c49847 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 12:40:53 +0200 Subject: [PATCH 09/25] Unregister service worker --- index.html | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/index.html b/index.html index ffb2a30..010e3a8 100644 --- a/index.html +++ b/index.html @@ -135,3 +135,11 @@ + From c8322fc3142392367b98fe9785d9eb7ca758c7f1 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 15:30:04 +0200 Subject: [PATCH 10/25] Update git loader to new trait --- src/cli.rs | 10 +- src/lib.rs | 41 ++- src/loaders/mod.rs | 4 + src/loaders/pr_loader.rs | 56 ++-- src/main.rs | 20 +- src/native_loaders/git_loader.rs | 463 ++++++++++--------------------- 6 files changed, 209 insertions(+), 385 deletions(-) diff --git a/src/cli.rs b/src/cli.rs index 537e3c7..7887718 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -1,8 +1,8 @@ use clap::{Parser, Subcommand}; use kitdiff::DiffSource; -use octocrab::models::ArtifactId; use kitdiff::github::auth::parse_github_artifact_url; use kitdiff::github::model::GithubArtifactLink; +use octocrab::models::ArtifactId; #[derive(Parser)] #[command(name = "kitdiff")] @@ -17,7 +17,7 @@ pub enum Commands { /// Compare snapshot test files (.png with .old/.new/.diff variants) (default) Files { directory: Option }, /// Compare images between current branch and default branch - Git, + Git { repo_path: Option }, /// Compare images between PR branches from GitHub PR URL (needs to be run from within the repo) Pr { url: String }, /// Load and compare snapshot files from a zip archive (URL or local file) @@ -32,7 +32,9 @@ impl Commands { Commands::Files { directory } => { DiffSource::Files(directory.clone().unwrap_or_else(|| ".".into()).into()) } - Commands::Git => DiffSource::Git, + Commands::Git { repo_path } => { + DiffSource::Git(repo_path.clone().unwrap_or_else(|| ".".into()).into()) + } Commands::Pr { url } => { // Check if the PR URL is actually a GitHub artifact URL if let Some((repo, artifact_id)) = parse_github_artifact_url(url) { @@ -40,6 +42,8 @@ impl Commands { repo, artifact_id: ArtifactId(artifact_id.parse().unwrap()), name: None, + branch_name: None, + run_id: None, }) } else { if let Ok(parsed_url) = url.parse() { diff --git a/src/lib.rs b/src/lib.rs index f61c66d..ef44192 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -1,13 +1,17 @@ +use crate::github::model::{GithubArtifactLink, GithubPrLink}; use crate::loaders::SnapshotLoader; +use crate::state::AppState; use eframe::egui::Context; use eframe::egui::load::Bytes; use std::any::Any; use std::path::PathBuf; -use crate::github::model::{GithubArtifactLink, GithubPrLink}; -use crate::state::AppState; pub mod app; +mod bar; +pub mod config; pub mod diff_image_loader; +pub mod github; +mod home; pub mod loaders; #[cfg(not(target_arch = "wasm32"))] pub mod native_loaders; @@ -15,17 +19,13 @@ mod settings; pub mod snapshot; mod state; mod viewer; -mod home; -mod bar; -pub mod github; -pub mod config; #[derive(Debug, Clone)] pub enum DiffSource { #[cfg(not(target_arch = "wasm32"))] Files(PathBuf), #[cfg(not(target_arch = "wasm32"))] - Git, + Git(PathBuf), Pr(GithubPrLink), GHArtifact(GithubArtifactLink), Zip(PathOrBlob), @@ -33,25 +33,16 @@ pub enum DiffSource { } impl DiffSource { - pub fn load( - self, - ctx: Context, - state: &AppState, - ) -> SnapshotLoader { + pub fn load(self, ctx: Context, state: &AppState) -> SnapshotLoader { match self { #[cfg(not(target_arch = "wasm32"))] - DiffSource::Files(path) => { - Box::new(native_loaders::file_loader::FileLoader::new(path)) - } - // #[cfg(not(target_arch = "wasm32"))] - // DiffSource::Git => { - // native_loaders::git_loader::git_discovery(tx, ctx) - // .expect("Failed to run git discovery"); - // None - // } - DiffSource::Pr(url) => { - Box::new(loaders::pr_loader::PrLoader::new(url, state.github_auth.client())) - } + DiffSource::Files(path) => Box::new(native_loaders::file_loader::FileLoader::new(path)), + #[cfg(not(target_arch = "wasm32"))] + DiffSource::Git(path) => Box::new(native_loaders::git_loader::GitLoader::new(path)), + DiffSource::Pr(url) => Box::new(loaders::pr_loader::PrLoader::new( + url, + state.github_auth.client(), + )), DiffSource::GHArtifact(artifact) => { Box::new(loaders::gh_archive_loader::GHArtifactLoader::new( state.github_auth.client(), @@ -185,7 +176,7 @@ impl DiffSource { // None // } // } - _ => todo!() + _ => todo!(), } } } diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index b4e6145..3829369 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -58,3 +58,7 @@ impl DataReference { } } } + +pub fn sort_snapshots(snapshots: &mut [Snapshot]) { + snapshots.sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); +} diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs index d9e63fd..c7459fe 100644 --- a/src/loaders/pr_loader.rs +++ b/src/loaders/pr_loader.rs @@ -1,24 +1,25 @@ -use crate::loaders::{LoadSnapshots, SnapshotLoader}; +use crate::github::model::{GithubPrLink, GithubRepoLink}; use crate::github::octokit::RepoClient; +use crate::github::pr::{GithubPr, pr_ui}; +use crate::loaders::{LoadSnapshots, SnapshotLoader, sort_snapshots}; use crate::snapshot::{FileReference, Snapshot}; use crate::state::AppStateRef; -use anyhow::Error; use eframe::egui::{Context, Ui}; use egui_inbox::{UiInbox, UiInboxSender}; use futures::StreamExt; -use octocrab::Octocrab; use octocrab::models::repos::{DiffEntry, DiffEntryStatus}; +use octocrab::{Error, Octocrab, Result}; use std::ops::Deref; use std::path::Path; use std::pin::pin; use std::task::Poll; -use crate::github::model::{GithubPrLink, GithubRepoLink}; -use crate::github::pr::{pr_ui, GithubPr}; + +type Sender = UiInboxSender>>; pub struct PrLoader { snapshots: Vec, - inbox: UiInbox>, - loading: bool, + inbox: UiInbox>>, + state: Poll>, link: GithubPrLink, pr_info: GithubPr, } @@ -29,16 +30,21 @@ impl PrLoader { let repo_client = RepoClient::new(client.clone(), link.repo.clone()); inbox.spawn(|tx| async move { - let result = stream_files(repo_client, link.pr_number, tx).await; - if let Err(e) = result { - eprintln!("Error loading PR files: {}", e); + let result = stream_files(repo_client, link.pr_number, tx.clone()).await; + match result { + Ok(()) => { + tx.send(None).ok(); + } + Err(err) => { + tx.send(Some(Err(err))).ok(); + } } }); Self { snapshots: Vec::new(), inbox, - loading: true, + state: Poll::Pending, pr_info: GithubPr::new(link.clone(), client), link, } @@ -48,7 +54,7 @@ impl PrLoader { async fn stream_files( repo_client: RepoClient, pr_number: u64, - sender: UiInboxSender>, + sender: Sender, ) -> octocrab::Result<()> { let pr = repo_client.pulls().get(pr_number).await?; @@ -91,12 +97,10 @@ async fn stream_files( new: new_url.map(|url| FileReference::Source(url.into())), diff: None, }; - sender.send(Some(snapshot)).ok(); + sender.send(Some(Ok(snapshot))).ok(); } } - sender.send(None).ok(); - Ok(()) } @@ -111,12 +115,16 @@ impl LoadSnapshots for PrLoader { fn update(&mut self, ctx: &Context) { for snapshot in self.inbox.read(ctx) { match snapshot { - Some(s) => { + Some(Ok(s)) => { self.snapshots.push(s); - self.snapshots - .sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); + sort_snapshots(&mut self.snapshots); + } + Some(Err(e)) => { + self.state = Poll::Ready(Err(e.into())); + } + None => { + self.state = Poll::Ready(Ok(())); } - None => self.loading = false, } } self.pr_info.update(ctx); @@ -126,11 +134,11 @@ impl LoadSnapshots for PrLoader { &self.snapshots } - fn state(&self) -> Poll> { - if self.loading { - Poll::Pending - } else { - Poll::Ready(Ok(())) + fn state(&self) -> Poll> { + match &self.state { + Poll::Ready(Ok(())) => Poll::Ready(Ok(())), + Poll::Ready(Err(e)) => Poll::Ready(Err(e)), + Poll::Pending => Poll::Pending, } } diff --git a/src/main.rs b/src/main.rs index 061b834..a60df8e 100644 --- a/src/main.rs +++ b/src/main.rs @@ -5,8 +5,8 @@ mod cli; use eframe::NativeOptions; use kitdiff::DiffSource; use kitdiff::app::App; -use octocrab::models::ArtifactId; use kitdiff::config::Config; +use octocrab::models::ArtifactId; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { @@ -27,7 +27,7 @@ fn main() -> eframe::Result<()> { eframe::run_native( "kitdiff", NativeOptions::default(), - Box::new(move |cc| Ok(Box::new(App::new(cc, Some(source))))), + Box::new(move |cc| Ok(Box::new(App::new(cc, Some(source), Config::default())))), ) } @@ -54,13 +54,15 @@ fn parse_url_query_params() -> Option { // Try to parse as GitHub artifact URL if let Some((repo, artifact_id)) = parse_github_artifact_url(&decoded_url) { - return Some(DiffSource::GHArtifact(kitdiff::github::model::GithubArtifactLink { - repo, - artifact_id: ArtifactId(artifact_id.parse().unwrap()), - name: None, - branch_name: None, - run_id: None, - })); + return Some(DiffSource::GHArtifact( + kitdiff::github::model::GithubArtifactLink { + repo, + artifact_id: ArtifactId(artifact_id.parse().unwrap()), + name: None, + branch_name: None, + run_id: None, + }, + )); } // Try to parse as direct zip/tar.gz URL diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index 1860575..c98bbcb 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -1,12 +1,114 @@ +use crate::loaders::{LoadSnapshots, sort_snapshots}; use crate::snapshot::{FileReference, Snapshot}; use eframe::egui::load::Bytes; use eframe::egui::{Context, ImageSource}; +use egui_inbox::{UiInbox, UiInboxSender}; use git2::{ObjectType, Repository}; use serde_json::Value; use std::borrow::Cow; -use std::path::Path; +use std::fmt::Display; +use std::path::{Path, PathBuf}; use std::str; use std::sync::mpsc; +use std::task::Poll; + +enum Command { + Snapshot(Snapshot), + Error(GitError), + Done, + GitInfo(GitInfo), +} + +type Sender = UiInboxSender; + +struct GitInfo { + current_branch: String, + default_branch: String, + repo_name: String, +} + +pub struct GitLoader { + base_path: PathBuf, + inbox: UiInbox, + git_info: Option, + snapshots: Vec, + state: Poll>, +} + +impl GitLoader { + pub fn new(base_path: PathBuf) -> Self { + let (sender, inbox) = UiInbox::channel(); + + { + let base_path = base_path.clone(); + std::thread::spawn(move || { + let result = run_git_discovery(sender.clone(), base_path); + match result { + Ok(()) => { + // Signal done + sender.send(Command::Done).ok(); + } + Err(e) => { + // Send error + sender.send(Command::Error(e)).ok(); + } + } + }); + } + + Self { + base_path, + inbox, + git_info: None, + snapshots: Vec::new(), + state: Poll::Pending, + } + } +} + +impl LoadSnapshots for GitLoader { + fn update(&mut self, ctx: &Context) { + if let Some(new_data) = self.inbox.read(ctx).last() { + match new_data { + Command::Snapshot(snapshot) => { + self.snapshots.push(snapshot); + sort_snapshots(&mut self.snapshots); + } + Command::Error(e) => { + self.state = Poll::Ready(Err(e.into())); + } + Command::GitInfo(info) => { + self.git_info = Some(info); + } + Command::Done => { + self.state = Poll::Ready(Ok(())); + } + } + } + } + + fn snapshots(&self) -> &[Snapshot] { + &self.snapshots + } + + fn state(&self) -> Poll> { + match &self.state { + Poll::Ready(Ok(())) => Poll::Ready(Ok(())), + Poll::Ready(Err(e)) => Poll::Ready(Err(e)), + Poll::Pending => Poll::Pending, + } + } + + fn files_header(&self) -> String { + match &self.git_info { + Some(info) => format!( + "Git: {} ({} ➡ {})", + info.repo_name, info.current_branch, info.default_branch + ), + None => format!("Git: {}", self.base_path.display()), + } + } +} #[derive(Debug)] pub enum GitError { @@ -19,15 +121,22 @@ pub enum GitError { NetworkError(String), } -#[derive(Debug, Clone)] -pub struct PrInfo { - pub org: String, - pub repo: String, - pub pr_number: u32, - pub head_ref: String, - pub base_ref: String, +impl Display for GitError { + fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + match self { + GitError::RepoNotFound => write!(f, "Git repository not found"), + GitError::BranchNotFound => write!(f, "Default branch not found"), + GitError::FileNotFound => write!(f, "File not found in git tree"), + GitError::GitError(err) => write!(f, "Git error: {}", err), + GitError::IoError(err) => write!(f, "IO error: {}", err), + GitError::PrUrlParseError => write!(f, "Failed to parse PR URL"), + GitError::NetworkError(msg) => write!(f, "Network error: {}", msg), + } + } } +impl std::error::Error for GitError {} + impl From for GitError { fn from(err: git2::Error) -> Self { GitError::GitError(err) @@ -40,31 +149,9 @@ impl From for GitError { } } -pub fn git_discovery(sender: mpsc::Sender, ctx: Context) -> Result<(), GitError> { - std::thread::spawn(move || { - if let Err(e) = run_git_discovery(sender, ctx) { - eprintln!("Git discovery error: {:?}", e); - } - }); - Ok(()) -} - -pub fn pr_git_discovery( - pr_url: String, - sender: mpsc::Sender, - ctx: Context, -) -> Result<(), GitError> { - std::thread::spawn(move || { - if let Err(e) = run_pr_git_discovery(pr_url, sender, ctx) { - eprintln!("PR git discovery error: {:?}", e); - } - }); - Ok(()) -} - -fn run_git_discovery(sender: mpsc::Sender, ctx: Context) -> Result<(), GitError> { +fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> { // Open git repository in current directory - let repo = Repository::open(".").map_err(|_| GitError::RepoNotFound)?; + let repo = Repository::open(base_path).map_err(|_| GitError::RepoNotFound)?; // Get current branch let head = repo.head()?; @@ -73,6 +160,22 @@ fn run_git_discovery(sender: mpsc::Sender, ctx: Context) -> Result<(), // Find default branch (try main, then master, then first branch) let default_branch = find_default_branch(&repo)?; + // Send git info + let repo_name = repo + .path() + .parent() + .and_then(|p| p.file_name()) + .and_then(|n| n.to_str()) + .unwrap_or("unknown") + .to_string(); + sender + .send(Command::GitInfo(GitInfo { + current_branch: current_branch.clone(), + default_branch: default_branch.clone(), + repo_name, + })) + .ok(); + // Don't compare branch with itself if current_branch == default_branch { eprintln!( @@ -116,71 +219,7 @@ fn run_git_discovery(sender: mpsc::Sender, ctx: Context) -> Result<(), &github_repo_info, &commit_sha, ) { - if sender.send(snapshot).is_ok() { - ctx.request_repaint(); - } - } - break; // Only process once per delta - } - } - } - true // Continue iteration - }, - None, - None, - None, - )?; - - Ok(()) -} - -fn run_pr_git_discovery( - pr_url: String, - sender: mpsc::Sender, - ctx: Context, -) -> Result<(), GitError> { - // Parse the PR URL - let (org, repo, pr_number) = parse_github_pr_url(&pr_url)?; - - // Fetch PR info from GitHub API - let pr_info = fetch_pr_info(&org, &repo, pr_number)?; - - // Open git repository in current directory - let repo = Repository::open("../../../../../..").map_err(|_| GitError::RepoNotFound)?; - - // Get GitHub repository info for LFS support - let github_repo_info = get_github_repo_info(&repo); - - // Fetch and resolve the head and base branches - let (head_tree, base_tree, head_commit_sha, base_commit_sha) = - resolve_pr_branches(&repo, &pr_info)?; - - // Use git2 diff to find changed PNG files between branches - let diff = repo.diff_tree_to_tree(Some(&base_tree), Some(&head_tree), None)?; - - // Process each delta (changed file) - diff.foreach( - &mut |delta, _progress| { - // Check both old and new file paths (handles renames/moves) - let files_to_check = [delta.old_file().path(), delta.new_file().path()]; - - for file_path in files_to_check.into_iter().flatten() { - // Check if this is a PNG file - if let Some(extension) = file_path.extension() { - if extension == "png" { - // Create snapshot for this changed PNG file - if let Ok(Some(snapshot)) = create_pr_snapshot( - &repo, - &base_tree, - &head_tree, - file_path, - &github_repo_info, - &head_commit_sha, - &base_commit_sha, - ) { - if sender.send(snapshot).is_ok() { - ctx.request_repaint(); - } + sender.send(Command::Snapshot(snapshot)).ok(); } break; // Only process once per delta } @@ -216,53 +255,15 @@ fn find_default_branch(repo: &Repository) -> Result { Err(GitError::BranchNotFound) } -fn resolve_pr_branches<'a>( - repo: &'a Repository, - pr_info: &PrInfo, -) -> Result<(git2::Tree<'a>, git2::Tree<'a>, String, String), GitError> { - // Get the origin remote to fetch branches if needed - let mut remote = repo.find_remote("origin")?; - - // Construct refspecs for head and base branches - let head_refspec = format!( - "+refs/heads/{}:refs/remotes/origin/{}", - pr_info.head_ref, pr_info.head_ref - ); - let base_refspec = format!( - "+refs/heads/{}:refs/remotes/origin/{}", - pr_info.base_ref, pr_info.base_ref - ); - - // Fetch the branches - remote.fetch(&[&head_refspec, &base_refspec], None, None)?; - - // Resolve head branch commit - let head_ref_name = format!("refs/remotes/origin/{}", pr_info.head_ref); - let head_ref = repo.find_reference(&head_ref_name)?; - let head_commit = head_ref.peel_to_commit()?; - let head_tree = head_commit.tree()?; - let head_commit_sha = head_commit.id().to_string(); - - // Resolve base branch commit - let base_ref_name = format!("refs/remotes/origin/{}", pr_info.base_ref); - let base_ref = repo.find_reference(&base_ref_name)?; - let base_commit = base_ref.peel_to_commit()?; - let base_tree = base_commit.tree()?; - - let base_commit_sha = base_commit.id().to_string(); - - Ok((head_tree, base_tree, head_commit_sha, base_commit_sha)) -} - fn create_git_snapshot( repo: &Repository, default_tree: &git2::Tree, - current_path: &Path, + relative_path: &Path, github_repo_info: &Option<(String, String)>, commit_sha: &str, ) -> Result, GitError> { // Skip files that are variants - let file_name = current_path + let file_name = relative_path .file_name() .and_then(|n| n.to_str()) .ok_or(GitError::FileNotFound)?; @@ -274,11 +275,6 @@ fn create_git_snapshot( return Ok(None); } - // Try to get the file from default branch - let relative_path = current_path - .strip_prefix("../../../../../..") - .unwrap_or(current_path); - let default_file_content = match get_file_from_tree(repo, default_tree, relative_path) { Ok(content) => content, Err(_) => { @@ -322,123 +318,11 @@ fn create_git_snapshot( Ok(Some(Snapshot { path: relative_path.to_path_buf(), old: Some(FileReference::Source(default_image_source)), // Default branch version as ImageSource - new: Some(FileReference::Path(current_path.to_path_buf())), // Current working tree version + new: Some(FileReference::Path(relative_path.to_path_buf())), // Current working tree version diff: None, // Always None for git mode })) } -fn create_pr_snapshot( - repo: &Repository, - base_tree: &git2::Tree, - head_tree: &git2::Tree, - current_path: &Path, - github_repo_info: &Option<(String, String)>, - head_commit_sha: &str, - base_commit_sha: &str, -) -> Result, GitError> { - // Skip files that are variants - let file_name = current_path - .file_name() - .and_then(|n| n.to_str()) - .ok_or(GitError::FileNotFound)?; - - if file_name.ends_with(".old.png") - || file_name.ends_with(".new.png") - || file_name.ends_with(".diff.png") - { - return Ok(None); - } - - let relative_path = current_path - .strip_prefix("../../../../../..") - .unwrap_or(current_path); - - // Try to get the file from base branch - let base_file_content = match get_file_from_tree(repo, base_tree, relative_path) { - Ok(content) => Some(content), - Err(_) => None, // File doesn't exist in base branch - }; - - // Try to get the file from head branch - let head_file_content = match get_file_from_tree(repo, head_tree, relative_path) { - Ok(content) => Some(content), - Err(_) => None, // File doesn't exist in head branch - }; - - // git2 diff already confirmed this file changed, so we can proceed - // Handle the case where file exists in only one branch - if base_file_content.is_none() && head_file_content.is_none() { - return Ok(None); // File doesn't exist in either branch (shouldn't happen with diff) - } - - // Create ImageSource for base branch (old) - let base_image_source = match base_file_content { - Some(content) => { - if is_lfs_pointer(&content) { - if let Some((org, repo_name)) = github_repo_info { - let media_url = - create_lfs_media_url(org, repo_name, base_commit_sha, relative_path); - ImageSource::Uri(Cow::Owned(media_url)) - } else { - ImageSource::Bytes { - uri: Cow::Owned(format!("bytes://base/{}", relative_path.display())), - bytes: Bytes::Shared(content.into()), - } - } - } else { - ImageSource::Bytes { - uri: Cow::Owned(format!("bytes://base/{}", relative_path.display())), - bytes: Bytes::Shared(content.into()), - } - } - } - None => { - // Create a placeholder for missing file - ImageSource::Bytes { - uri: Cow::Owned(format!("bytes://missing/{}", relative_path.display())), - bytes: Bytes::Static(&[]), // Empty bytes for missing file - } - } - }; - - // Create ImageSource for head branch (new) - let head_image_source = match head_file_content { - Some(content) => { - if is_lfs_pointer(&content) { - if let Some((org, repo_name)) = github_repo_info { - let media_url = - create_lfs_media_url(org, repo_name, head_commit_sha, relative_path); - ImageSource::Uri(Cow::Owned(media_url)) - } else { - ImageSource::Bytes { - uri: Cow::Owned(format!("bytes://head/{}", relative_path.display())), - bytes: Bytes::Shared(content.into()), - } - } - } else { - ImageSource::Bytes { - uri: Cow::Owned(format!("bytes://head/{}", relative_path.display())), - bytes: Bytes::Shared(content.into()), - } - } - } - None => { - // Create a placeholder for missing file - ImageSource::Bytes { - uri: Cow::Owned(format!("bytes://missing/{}", relative_path.display())), - bytes: Bytes::Static(&[]), // Empty bytes for missing file - } - } - }; - - Ok(Some(Snapshot { - path: relative_path.to_path_buf(), - old: Some(FileReference::Source(base_image_source)), // Base branch version - new: Some(FileReference::Source(head_image_source)), // Head branch version - diff: None, // Always None for PR mode - })) -} - fn get_file_from_tree( repo: &Repository, tree: &git2::Tree, @@ -549,72 +433,3 @@ fn create_lfs_media_url(org: &str, repo: &str, commit_sha: &str, file_path: &Pat file_path.display() ) } - -pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), GitError> { - // Parse URLs like: https://github.com/rerun-io/rerun/pull/11253 - if !url.starts_with("https://github.com/") { - return Err(GitError::PrUrlParseError); - } - - let path = url - .strip_prefix("https://github.com/") - .ok_or(GitError::PrUrlParseError)?; - - let parts: Vec<&str> = path.split('/').collect(); - if parts.len() != 4 || parts[2] != "pull" { - return Err(GitError::PrUrlParseError); - } - - let org = parts[0].to_string(); - let repo = parts[1].to_string(); - let pr_number = parts[3] - .parse::() - .map_err(|_| GitError::PrUrlParseError)?; - - Ok((org, repo, pr_number)) -} - -pub fn fetch_pr_info(org: &str, repo: &str, pr_number: u32) -> Result { - let url = format!( - "https://api.github.com/repos/{}/{}/pulls/{}", - org, repo, pr_number - ); - - // Use ehttp for HTTP request (blocking) - let request = ehttp::Request::get(url); - - let response = - ehttp::fetch_blocking(&request).map_err(|e| GitError::NetworkError(e.to_string()))?; - - if !response.ok { - return Err(GitError::NetworkError(format!( - "HTTP {}: {}", - response.status, response.status_text - ))); - } - - let json: Value = serde_json::from_slice(&response.bytes) - .map_err(|e| GitError::NetworkError(format!("JSON parse error: {}", e)))?; - - let head_ref = json["head"]["ref"] - .as_str() - .ok_or(GitError::NetworkError( - "Missing head.ref in PR data".to_string(), - ))? - .to_string(); - - let base_ref = json["base"]["ref"] - .as_str() - .ok_or(GitError::NetworkError( - "Missing base.ref in PR data".to_string(), - ))? - .to_string(); - - Ok(PrInfo { - org: org.to_string(), - repo: repo.to_string(), - pr_number, - head_ref, - base_ref, - }) -} From dcb5400a07ec5a136602c7b338156c93035f69a2 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 15:47:30 +0200 Subject: [PATCH 11/25] Compare with merge commit --- src/native_loaders/git_loader.rs | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index c98bbcb..e7b8d10 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -185,21 +185,23 @@ fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> return Ok(()); } - // Get the commit from default branch + // Get the merge base between current branch and default branch + let head_commit = repo.head()?.peel_to_commit()?; let default_commit = repo .resolve_reference_from_short_name(&default_branch)? .peel_to_commit()?; + let base_commit = repo.merge_base(head_commit.id(), default_commit.id())?; + let base_commit = repo.find_commit(base_commit)?; // Get GitHub repository info for LFS support let github_repo_info = get_github_repo_info(&repo); - let commit_sha = default_commit.id().to_string(); + let commit_sha = base_commit.id().to_string(); - // Get current HEAD for comparison with default branch - let head_commit = repo.head()?.peel_to_commit()?; + // Get current HEAD tree for comparison let head_tree = head_commit.tree()?; - // Use git2 diff to find changed PNG files between default branch and current HEAD - let diff = repo.diff_tree_to_tree(Some(&default_commit.tree()?), Some(&head_tree), None)?; + // Use git2 diff to find changed PNG files between merge base and current HEAD + let diff = repo.diff_tree_to_tree(Some(&base_commit.tree()?), Some(&head_tree), None)?; // Process each delta (changed file) diff.foreach( @@ -214,7 +216,7 @@ fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> // Create snapshot for this changed PNG file if let Ok(Some(snapshot)) = create_git_snapshot( &repo, - &default_commit.tree().unwrap(), + &base_commit.tree().unwrap(), file_path, &github_repo_info, &commit_sha, From b20908bc67fa2b1c51dfdf56bfb9cb44d990901a Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 15:47:48 +0200 Subject: [PATCH 12/25] Remove service worker --- assets/sw.js | 25 ------------------------- 1 file changed, 25 deletions(-) delete mode 100644 assets/sw.js diff --git a/assets/sw.js b/assets/sw.js deleted file mode 100644 index 6d58009..0000000 --- a/assets/sw.js +++ /dev/null @@ -1,25 +0,0 @@ -var cacheName = 'egui-template-pwa'; -var filesToCache = [ - './', - './index.html', - './kitdiff.js', - './kitdiff_bg.wasm', -]; - -/* Start the service worker and cache all of the app's content */ -self.addEventListener('install', function (e) { - e.waitUntil( - caches.open(cacheName).then(function (cache) { - return cache.addAll(filesToCache); - }) - ); -}); - -/* Serve cached content when offline */ -self.addEventListener('fetch', function (e) { - e.respondWith( - caches.match(e.request).then(function (response) { - return response || fetch(e.request); - }) - ); -}); From 4a1ad30943922fa84859203a8c6409fa559d60d3 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 15:57:52 +0200 Subject: [PATCH 13/25] Make some ui more obvious --- src/viewer/viewer_options.rs | 26 +++++++++++++++++--------- 1 file changed, 17 insertions(+), 9 deletions(-) diff --git a/src/viewer/viewer_options.rs b/src/viewer/viewer_options.rs index 8c9e870..caa54ed 100644 --- a/src/viewer/viewer_options.rs +++ b/src/viewer/viewer_options.rs @@ -1,6 +1,6 @@ use crate::settings::ImageMode; use crate::state::{SystemCommand, ViewerAppStateRef, ViewerSystemCommand}; -use eframe::egui::{Key, KeyboardShortcut, Modifiers, Slider, TextureFilter, Ui}; +use eframe::egui::{Checkbox, Key, KeyboardShortcut, Modifiers, Slider, TextureFilter, Ui}; pub fn viewer_options(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { let mut settings = state.app.settings.clone(); @@ -8,6 +8,10 @@ pub fn viewer_options(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { ui.group(|ui| { ui.strong("View only"); let mut view_filter = state.view_filter; + ui.add_enabled( + false, + Checkbox::new(&mut state.view_filter.all(), "All with opacity"), + ); ui.checkbox(&mut view_filter.show_old, "Old (1)"); ui.checkbox(&mut view_filter.show_new, "New (2)"); ui.checkbox(&mut view_filter.show_diff, "Diff (3)"); @@ -18,8 +22,10 @@ pub fn viewer_options(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { } }); - ui.add(Slider::new(&mut settings.new_opacity, 0.0..=1.0).text("New Opacity")); - ui.add(Slider::new(&mut settings.diff_opacity, 0.0..=1.0).text("Diff Opacity")); + ui.add_enabled_ui(state.view_filter.all(), |ui| { + ui.add(Slider::new(&mut settings.new_opacity, 0.0..=1.0).text("New Opacity")); + ui.add(Slider::new(&mut settings.diff_opacity, 0.0..=1.0).text("Diff Opacity")); + }); let mut filtered_index = state.active_filtered_index; @@ -60,12 +66,14 @@ pub fn viewer_options(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { "Use original diff if available", ); - ui.add( - Slider::new(&mut settings.options.threshold, 0.01..=1000.0) - .logarithmic(true) - .text("Diff Threshold"), - ); - ui.checkbox(&mut settings.options.detect_aa_pixels, "Detect AA Pixels"); + ui.add_enabled_ui(!settings.use_original_diff, |ui| { + ui.add( + Slider::new(&mut settings.options.threshold, 0.01..=1000.0) + .logarithmic(true) + .text("Diff Threshold"), + ); + ui.checkbox(&mut settings.options.detect_aa_pixels, "Detect AA Pixels"); + }); }); if settings != state.app.settings { From c2283562be905363316cbaf7a710f8d41bb94bac Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 16:02:18 +0200 Subject: [PATCH 14/25] Clippy & fmt --- src/app.rs | 18 ++---- src/bar.rs | 17 ++++-- src/cli.rs | 18 +++--- src/config.rs | 4 +- src/diff_image_loader.rs | 71 +++++++++++------------ src/github/auth.rs | 45 +++++++-------- src/github/mod.rs | 2 +- src/github/model.rs | 18 +++--- src/github/octokit.rs | 3 +- src/github/pr.rs | 96 ++++++++++++++----------------- src/home.rs | 2 +- src/lib.rs | 12 ++-- src/loaders/archive_loader.rs | 37 ++++++------ src/loaders/gh_archive_loader.rs | 12 ++-- src/loaders/mod.rs | 17 +++--- src/loaders/pr_loader.rs | 13 ++--- src/main.rs | 3 +- src/native_loaders/file_loader.rs | 3 +- src/native_loaders/git_loader.rs | 37 ++++++------ src/settings.rs | 4 +- src/snapshot.rs | 8 +-- src/state.rs | 22 +++---- src/viewer/diff_view.rs | 5 +- src/viewer/file_tree.rs | 33 +++++------ src/viewer/mod.rs | 4 +- src/viewer/viewer_options.rs | 2 +- 26 files changed, 232 insertions(+), 274 deletions(-) diff --git a/src/app.rs b/src/app.rs index 3d54d08..9924b89 100644 --- a/src/app.rs +++ b/src/app.rs @@ -1,18 +1,13 @@ -use crate::diff_image_loader::{DiffImageLoader, DiffOptions}; +use crate::config::Config; +use crate::diff_image_loader::DiffImageLoader; use crate::settings::Settings; -use crate::snapshot::{FileReference, Snapshot}; use crate::state::{AppState, AppStateRef, PageRef, SystemCommand, ViewerSystemCommand}; -use crate::{DiffSource, PathOrBlob, home, viewer, bar}; -use eframe::egui::panel::Side; -use eframe::egui::{ - Align, Context, Image, ImageSource, Key, Modifiers, RichText, ScrollArea, SizeHint, Slider, - TextEdit, TextureFilter, TextureOptions, -}; +use crate::{DiffSource, bar, home, viewer}; +use eframe::egui::{Context, Key, Modifiers}; use eframe::{Frame, Storage, egui}; use egui_extras::install_image_loaders; use egui_inbox::UiInbox; -use std::sync::{Arc, mpsc}; -use crate::config::Config; +use std::sync::Arc; pub struct App { diff_loader: Arc, @@ -101,7 +96,7 @@ impl eframe::App for App { } } - Self::end_frame(ctx, &state_ref) + Self::end_frame(ctx, &state_ref); } // for file in &ctx.input(|i| i.raw.dropped_files.clone()) { @@ -199,7 +194,6 @@ impl App { state.send(ViewerSystemCommand::SelectSnapshot(new_index)); } - let handle_key = |key: Key, toggle: &mut bool| { if ctx.input_mut(|i| i.key_pressed(key)) { *toggle = true; diff --git a/src/bar.rs b/src/bar.rs index 95a3d4d..d698051 100644 --- a/src/bar.rs +++ b/src/bar.rs @@ -1,15 +1,20 @@ -use crate::state::{AppStateRef, SystemCommand}; +use crate::github::auth::GithubAuthCommand; +use crate::state::AppStateRef; use eframe::egui; -use eframe::egui::panel::TopBottomSide; use eframe::egui::{Context, Popup, Ui}; -use crate::github::auth::GithubAuthCommand; pub fn bar(ctx: &Context, state: &AppStateRef<'_>) { egui::TopBottomPanel::top("top bar") .resizable(false) - .show(ctx, |ui| egui::Sides::new().show(ui, |ui| {}, |ui| { - auth_ui(ui, state); - })); + .show(ctx, |ui| { + egui::Sides::new().show( + ui, + |ui| {}, + |ui| { + auth_ui(ui, state); + }, + ) + }); } pub fn auth_ui(ui: &mut Ui, state: &AppStateRef<'_>) { diff --git a/src/cli.rs b/src/cli.rs index 7887718..82c4a2a 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -29,13 +29,13 @@ pub enum Commands { impl Commands { pub fn to_source(&self) -> DiffSource { match self { - Commands::Files { directory } => { + Self::Files { directory } => { DiffSource::Files(directory.clone().unwrap_or_else(|| ".".into()).into()) } - Commands::Git { repo_path } => { + Self::Git { repo_path } => { DiffSource::Git(repo_path.clone().unwrap_or_else(|| ".".into()).into()) } - Commands::Pr { url } => { + Self::Pr { url } => { // Check if the PR URL is actually a GitHub artifact URL if let Some((repo, artifact_id)) = parse_github_artifact_url(url) { DiffSource::GHArtifact(GithubArtifactLink { @@ -45,15 +45,13 @@ impl Commands { branch_name: None, run_id: None, }) + } else if let Ok(parsed_url) = url.parse() { + DiffSource::Pr(parsed_url) } else { - if let Ok(parsed_url) = url.parse() { - DiffSource::Pr(parsed_url) - } else { - panic!("Invalid GitHub PR URL: {}", url); - } + panic!("Invalid GitHub PR URL: {url}"); } } - Commands::Zip { source } => { + Self::Zip { source } => { // // Check if it's a GitHub artifact URL first // if let Some((repo, artifact_id)) = parse_github_artifact_url(source) { // DiffSource::GHArtifact { @@ -85,7 +83,7 @@ impl Commands { // } todo!() } - Commands::GhArtifact { url } => { + Self::GhArtifact { url } => { // if let Some((owner, repo, artifact_id)) = parse_github_artifact_url(url) { // DiffSource::GHArtifact { // owner, diff --git a/src/config.rs b/src/config.rs index 0c37921..181e7b4 100644 --- a/src/config.rs +++ b/src/config.rs @@ -1,12 +1,12 @@ use octocrab::models::WorkflowId; -#[derive(Debug, Clone, PartialEq, Default, serde::Serialize, serde::Deserialize)] +#[derive(Debug, Clone, PartialEq, Eq, Default, serde::Serialize, serde::Deserialize)] pub struct Config { #[serde(default)] pub github: Github, } -#[derive(Debug, Clone, PartialEq, Default, serde::Serialize, serde::Deserialize)] +#[derive(Debug, Clone, PartialEq, Eq, Default, serde::Serialize, serde::Deserialize)] pub struct Github { pub update_snapshot_workflow_name: Option, } diff --git a/src/diff_image_loader.rs b/src/diff_image_loader.rs index 14f542b..53a2cfe 100644 --- a/src/diff_image_loader.rs +++ b/src/diff_image_loader.rs @@ -1,6 +1,6 @@ use eframe::egui::load::{ImageLoadResult, ImageLoader, ImagePoll, LoadError}; use eframe::egui::mutex::Mutex; -use eframe::egui::{Color32, ColorImage, Context, Image, ImageSource, SizeHint}; +use eframe::egui::{Color32, ColorImage, Context, SizeHint}; use eframe::epaint::ahash::HashMap; use egui_extras::loaders::image_loader::ImageCrateLoader; use std::sync::Arc; @@ -80,7 +80,7 @@ impl DiffImageLoader { } impl ImageLoader for DiffImageLoader { - fn id(&self) -> &str { + fn id(&self) -> &'static str { "DiffLoader" } @@ -96,46 +96,41 @@ impl ImageLoader for DiffImageLoader { Ok(Poll::Pending) => ImageLoadResult::Ok(ImagePoll::Pending { size: None }), Err(err) => ImageLoadResult::Err(err.clone()), } - } else { - if let Some(diff_uri) = DiffUri::from_uri(uri) { - let old_image = self.image_loader.load(ctx, &diff_uri.old, size_hint); - let new_image = self.image_loader.load(ctx, &diff_uri.new, size_hint); - - let (old_image, new_image) = (old_image?, new_image?); - - if let ( - ImagePoll::Ready { image: old_image }, - ImagePoll::Ready { image: new_image }, - ) = (old_image, new_image) + } else if let Some(diff_uri) = DiffUri::from_uri(uri) { + let old_image = self.image_loader.load(ctx, &diff_uri.old, size_hint); + let new_image = self.image_loader.load(ctx, &diff_uri.new, size_hint); + + let (old_image, new_image) = (old_image?, new_image?); + + if let (ImagePoll::Ready { image: old_image }, ImagePoll::Ready { image: new_image }) = + (old_image, new_image) + { + let cache = self.diffs.clone(); + let ctx = ctx.clone(); + + self.diffs + .lock() + .insert(diff_uri.to_uri(), Ok(Poll::Pending)); + + let uri = uri.to_owned(); + #[cfg(not(target_arch = "wasm32"))] + std::thread::spawn(move || { + ctx.request_repaint(); + let result = load_diffs(&ctx, old_image, new_image, size_hint, diff_uri); + cache.lock().insert(uri, result.map(Poll::Ready)); + }); + #[cfg(target_arch = "wasm32")] { - let cache = self.diffs.clone(); - let ctx = ctx.clone(); - - self.diffs - .lock() - .insert(diff_uri.to_uri(), Ok(Poll::Pending)); - - let uri = uri.to_string(); - #[cfg(not(target_arch = "wasm32"))] - std::thread::spawn(move || { + wasm_bindgen_futures::spawn_local(async move { ctx.request_repaint(); let result = load_diffs(&ctx, old_image, new_image, size_hint, diff_uri); cache.lock().insert(uri, result.map(Poll::Ready)); }); - #[cfg(target_arch = "wasm32")] - { - wasm_bindgen_futures::spawn_local(async move { - ctx.request_repaint(); - let result = - load_diffs(&ctx, old_image, new_image, size_hint, diff_uri); - cache.lock().insert(uri, result.map(Poll::Ready)); - }); - } } - ImageLoadResult::Ok(ImagePoll::Pending { size: None }) - } else { - ImageLoadResult::Err(LoadError::NotSupported) } + ImageLoadResult::Ok(ImagePoll::Pending { size: None }) + } else { + ImageLoadResult::Err(LoadError::NotSupported) } } @@ -172,7 +167,7 @@ pub fn load_diffs( old_img.as_raw().to_vec(), ) .ok_or(LoadError::Loading( - "Failed to convert to RgbaImage".to_string(), + "Failed to convert to RgbaImage".to_owned(), ))?; let new = image::RgbaImage::from_vec( @@ -181,12 +176,12 @@ pub fn load_diffs( new_img.as_raw().to_vec(), ) .ok_or(LoadError::Loading( - "Failed to convert to RgbaImage".to_string(), + "Failed to convert to RgbaImage".to_owned(), ))?; if old.dimensions() != new.dimensions() { return Err(LoadError::Loading( - "Images must have the same dimensions".to_string(), + "Images must have the same dimensions".to_owned(), )); } diff --git a/src/github/auth.rs b/src/github/auth.rs index 6a021b2..c00a5f6 100644 --- a/src/github/auth.rs +++ b/src/github/auth.rs @@ -1,10 +1,10 @@ +use crate::github::model::GithubRepoLink; use crate::state::SystemCommand; use eframe::egui; use ehttp; use serde_json; use std::fmt; use std::sync::mpsc; -use crate::github::model::GithubRepoLink; pub enum GithubAuthCommand { Login, @@ -13,16 +13,16 @@ pub enum GithubAuthCommand { impl From for SystemCommand { fn from(cmd: GithubAuthCommand) -> Self { - SystemCommand::GithubAuth(cmd) + Self::GithubAuth(cmd) } } -#[derive(Debug, Clone, Default, PartialEq, serde::Serialize, serde::Deserialize)] +#[derive(Debug, Clone, Default, PartialEq, Eq, serde::Serialize, serde::Deserialize)] pub struct AuthState { pub logged_in: Option, } -#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] +#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)] pub struct LoggedInState { pub supabase_token: String, pub github_token: String, // GitHub OAuth token @@ -48,7 +48,7 @@ impl GitHubAuth { if let Some(token) = token { client = client - .user_access_token(token.to_string()) + .user_access_token(token.to_owned()) .expect("Invalid token"); } @@ -70,9 +70,9 @@ pub enum AuthError { impl fmt::Display for AuthError { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { match self { - AuthError::NetworkError(msg) => write!(f, "Network error: {}", msg), - AuthError::ParseError(msg) => write!(f, "Parse error: {}", msg), - AuthError::AuthenticationError(msg) => write!(f, "Authentication error: {}", msg), + Self::NetworkError(msg) => write!(f, "Network error: {msg}"), + Self::ParseError(msg) => write!(f, "Parse error: {msg}"), + Self::AuthenticationError(msg) => write!(f, "Authentication error: {msg}"), } } } @@ -121,11 +121,11 @@ pub fn parse_github_artifact_url(url: &str) -> Option<(GithubRepoLink, String)> && parts[6] == "artifacts" && parts.len() >= 8 { - let owner = parts[1].to_string(); - let repo = parts[2].to_string(); + let owner = parts[1].to_owned(); + let repo = parts[2].to_owned(); Some(( GithubRepoLink { owner, repo }, - parts[7].to_string(), // artifact_id + parts[7].to_owned(), // artifact_id )) } else { None @@ -133,17 +133,14 @@ pub fn parse_github_artifact_url(url: &str) -> Option<(GithubRepoLink, String)> } pub fn github_artifact_api_url(owner: &str, repo: &str, artifact_id: &str) -> String { - format!( - "https://api.github.com/repos/{}/{}/actions/artifacts/{}/zip", - owner, repo, artifact_id - ) + format!("https://api.github.com/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip") } impl GitHubAuth { pub fn new(state: AuthState) -> Self { // Supabase configuration - let supabase_url = "https://fqhsaeyjqrjmlkqflvho.supabase.co".to_string(); // Replace with your project - let supabase_anon_key = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZxaHNhZXlqcXJqbWxrcWZsdmhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTgyMTk4MzIsImV4cCI6MjA3Mzc5NTgzMn0.TuhMjHhBCNyKquyVWq3djOfpBVDhcpSmNRWSErpseuw".to_string(); // Replace with your anon key + let supabase_url = "https://fqhsaeyjqrjmlkqflvho.supabase.co".to_owned(); // Replace with your project + let supabase_anon_key = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZxaHNhZXlqcXJqbWxrcWZsdmhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTgyMTk4MzIsImV4cCI6MjA3Mzc5NTgzMn0.TuhMjHhBCNyKquyVWq3djOfpBVDhcpSmNRWSErpseuw".to_owned(); // Replace with your anon key let (auth_sender, auth_receiver) = mpsc::channel(); @@ -278,23 +275,23 @@ impl GitHubAuth { let mut request = ehttp::Request::get("https://api.github.com/user"); request .headers - .insert("Authorization".to_string(), format!("Bearer {}", token)); + .insert("Authorization".to_owned(), format!("Bearer {token}")); request .headers - .insert("User-Agent".to_string(), "kitdiff-app".to_string()); + .insert("User-Agent".to_owned(), "kitdiff-app".to_owned()); let response = ehttp::fetch_async(request) .await - .map_err(|e| AuthError::NetworkError(format!("Failed to fetch user info: {}", e)))?; + .map_err(|e| AuthError::NetworkError(format!("Failed to fetch user info: {e}")))?; if response.status == 200 { let user_info: serde_json::Value = serde_json::from_slice(&response.bytes) - .map_err(|e| AuthError::ParseError(format!("Failed to parse user info: {}", e)))?; + .map_err(|e| AuthError::ParseError(format!("Failed to parse user info: {e}")))?; let username = user_info["login"] .as_str() - .ok_or_else(|| AuthError::ParseError("Username not found in response".to_string()))? - .to_string(); + .ok_or_else(|| AuthError::ParseError("Username not found in response".to_owned()))? + .to_owned(); Ok(username) } else { @@ -348,7 +345,7 @@ impl GitHubAuth { self.state = state; } AuthEvent::Error(error) => { - eprintln!("Auth error: {}", error); + eprintln!("Auth error: {error}"); } _ => {} } diff --git a/src/github/mod.rs b/src/github/mod.rs index fbc1c13..9ffbc82 100644 --- a/src/github/mod.rs +++ b/src/github/mod.rs @@ -1,4 +1,4 @@ pub mod auth; pub mod model; -pub mod pr; pub mod octokit; +pub mod pr; diff --git a/src/github/model.rs b/src/github/model.rs index 7816c47..c5b1090 100644 --- a/src/github/model.rs +++ b/src/github/model.rs @@ -1,6 +1,6 @@ +use octocrab::models::{ArtifactId, RunId}; use std::fmt::Display; use std::str::FromStr; -use octocrab::models::{ArtifactId, RunId}; pub type PrNumber = u64; @@ -31,9 +31,9 @@ impl FromStr for GithubRepoLink { let owner = parts.next().ok_or(GithubParseErr::MissingOwner)?; let repo = parts.next().ok_or(GithubParseErr::MissingRepo)?; - Ok(GithubRepoLink { - owner: owner.to_string(), - repo: repo.to_string(), + Ok(Self { + owner: owner.to_owned(), + repo: repo.to_owned(), }) } } @@ -66,10 +66,10 @@ impl FromStr for GithubPrLink { .parse() .map_err(GithubParseErr::InvalidPrNumber)?; - Ok(GithubPrLink { + Ok(Self { repo: GithubRepoLink { - owner: owner.to_string(), - repo: repo.to_string(), + owner: owner.to_owned(), + repo: repo.to_owned(), }, pr_number: number, }) @@ -100,8 +100,6 @@ impl GithubArtifactLink { self.name .as_deref() .unwrap_or(&self.artifact_id.to_string()) - .to_string() + .to_owned() } } - - diff --git a/src/github/octokit.rs b/src/github/octokit.rs index 2aef745..942799b 100644 --- a/src/github/octokit.rs +++ b/src/github/octokit.rs @@ -1,6 +1,5 @@ -use std::ops::Deref; -use octocrab::Page; use crate::github::model::GithubRepoLink; +use std::ops::Deref; pub struct RepoClient { client: octocrab::Octocrab, diff --git a/src/github/pr.rs b/src/github/pr.rs index d1c2d3a..6c392a0 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -1,34 +1,21 @@ use crate::DiffSource; use eframe::egui; -use eframe::egui::{Button, Context, Popup, ScrollArea, Spinner}; +use eframe::egui::{Button, Context, ScrollArea, Spinner}; use egui_inbox::UiInbox; use futures::stream::FuturesUnordered; -use futures::{StreamExt, TryStreamExt}; +use futures::{StreamExt as _, TryStreamExt as _}; use graphql_client::GraphQLQuery; -use octocrab::{AuthState, Octocrab, Page}; -use re_ui::egui_ext::boxed_widget::BoxedWidgetLocalExt; -use std::borrow::Cow; +use octocrab::Octocrab; +use re_ui::egui_ext::boxed_widget::BoxedWidgetLocalExt as _; use std::collections::hash_map::Entry; use std::collections::{HashMap, HashSet}; -use std::future::ready; -use std::pin::pin; -use std::str::FromStr; -use std::sync::mpsc; use std::task::Poll; // Import octocrab models use crate::github::octokit::RepoClient; use crate::state::{AppStateRef, SystemCommand}; -use octocrab::models::commits::GithubCommitStatus; -use octocrab::models::{ - CombinedStatus, RunId, Status, - pulls::PullRequest, - repos::RepoCommit, - workflows::{Run, WorkflowListArtifact}, -}; -use octocrab::params::repos::Reference; -use octocrab::workflows::ListRunsBuilder; -use re_ui::list_item::{LabelContent, ListItemContentButtonsExt, list_item_scope}; -use re_ui::{OnResponseExt, SectionCollapsingHeader, UiExt, icons}; +use octocrab::models::{RunId, workflows::WorkflowListArtifact}; +use re_ui::list_item::{LabelContent, ListItemContentButtonsExt as _, list_item_scope}; +use re_ui::{OnResponseExt as _, SectionCollapsingHeader, UiExt as _, icons}; // use chrono::DateTime; pub type GitObjectID = String; pub type DateTime = String; @@ -49,7 +36,7 @@ use anyhow::{Error, Result, anyhow}; pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { // Parse URLs like: https://github.com/rerun-io/rerun/pull/11253 if !url.starts_with("https://github.com/") { - return Err("URL must start with https://github.com/".to_string()); + return Err("URL must start with https://github.com/".to_owned()); } let path = url @@ -58,11 +45,11 @@ pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { let parts: Vec<&str> = path.split('/').collect(); if parts.len() != 4 || parts[2] != "pull" { - return Err("Expected format: https://github.com/owner/repo/pull/123".to_string()); + return Err("Expected format: https://github.com/owner/repo/pull/123".to_owned()); } - let user = parts[0].to_string(); - let repo = parts[1].to_string(); + let user = parts[0].to_owned(); + let repo = parts[1].to_owned(); let pr_number = parts[3].parse::().map_err(|_| "Invalid PR number")?; Ok((user, repo, pr_number)) @@ -165,33 +152,34 @@ impl GithubPr { pr_data.artifacts.insert(sha, Poll::Ready(artifacts)); } } - GithubPrCommand::FetchCommitArtifacts { sha } => match &mut self.data { - Poll::Ready(Ok(pr_data)) => match pr_data.artifacts.entry(sha.clone()) { - Entry::Occupied(_) => {} - Entry::Vacant(entry) => { - entry.insert(Poll::Pending); - - let workflow_run_ids = pr_data - .commits - .iter() - .find(|c| c.sha == sha) - .map(|c| c.workflow_run_ids.clone()) - .unwrap_or_default(); - - let client = - RepoClient::new(self.client.clone(), self.link.repo.clone()); - self.inbox.spawn(move |tx| async move { - let artifacts = - fetch_commit_artifacts(&client, workflow_run_ids).await; - let _ = tx.send(GithubPrCommand::FetchedCommitArtifacts { - sha, - artifacts, + GithubPrCommand::FetchCommitArtifacts { sha } => { + if let Poll::Ready(Ok(pr_data)) = &mut self.data { + match pr_data.artifacts.entry(sha.clone()) { + Entry::Occupied(_) => {} + Entry::Vacant(entry) => { + entry.insert(Poll::Pending); + + let workflow_run_ids = pr_data + .commits + .iter() + .find(|c| c.sha == sha) + .map(|c| c.workflow_run_ids.clone()) + .unwrap_or_default(); + + let client = + RepoClient::new(self.client.clone(), self.link.repo.clone()); + self.inbox.spawn(move |tx| async move { + let artifacts = + fetch_commit_artifacts(&client, workflow_run_ids).await; + let _ = tx.send(GithubPrCommand::FetchedCommitArtifacts { + sha, + artifacts, + }); }); - }); + } } - }, - _ => {} - }, + } + } } } } @@ -278,9 +266,9 @@ async fn get_pr_commits(repo: &RepoClient, pr: PrNumber) -> Result Result, pr: &GithubPr) { Some(Poll::Ready(Err(error))) => { ui.colored_label( ui.visuals().error_fg_color, - format!("Error: {}", error), + format!("Error: {error}"), ); } Some(Poll::Ready(Ok(artifacts))) => { @@ -406,7 +394,7 @@ pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { }); } Poll::Ready(Err(error)) => { - ui.colored_label(ui.visuals().error_fg_color, format!("Error: {}", error)); + ui.colored_label(ui.visuals().error_fg_color, format!("Error: {error}")); } Poll::Pending => { SectionCollapsingHeader::new(format!("PR: {}", pr.link)) diff --git a/src/home.rs b/src/home.rs index 02191cf..50311c2 100644 --- a/src/home.rs +++ b/src/home.rs @@ -1,5 +1,5 @@ use crate::state::AppStateRef; -use eframe::egui::{CentralPanel, Context, Ui}; +use eframe::egui::{CentralPanel, Context}; pub fn home_view(ctx: &Context, app: &AppStateRef<'_>) { CentralPanel::default().show(ctx, |ui| { diff --git a/src/lib.rs b/src/lib.rs index ef44192..a1b166c 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -36,14 +36,14 @@ impl DiffSource { pub fn load(self, ctx: Context, state: &AppState) -> SnapshotLoader { match self { #[cfg(not(target_arch = "wasm32"))] - DiffSource::Files(path) => Box::new(native_loaders::file_loader::FileLoader::new(path)), + Self::Files(path) => Box::new(native_loaders::file_loader::FileLoader::new(path)), #[cfg(not(target_arch = "wasm32"))] - DiffSource::Git(path) => Box::new(native_loaders::git_loader::GitLoader::new(path)), - DiffSource::Pr(url) => Box::new(loaders::pr_loader::PrLoader::new( + Self::Git(path) => Box::new(native_loaders::git_loader::GitLoader::new(path)), + Self::Pr(url) => Box::new(loaders::pr_loader::PrLoader::new( url, state.github_auth.client(), )), - DiffSource::GHArtifact(artifact) => { + Self::GHArtifact(artifact) => { Box::new(loaders::gh_archive_loader::GHArtifactLoader::new( state.github_auth.client(), artifact, @@ -195,8 +195,8 @@ impl PathOrBlob { pub fn load_bytes(&self) -> Option { match self { #[cfg(not(target_arch = "wasm32"))] - PathOrBlob::Path(path) => std::fs::read(path).ok().map(Bytes::from), - PathOrBlob::Blob(bytes) => Some(bytes.clone()), + Self::Path(path) => std::fs::read(path).ok().map(Bytes::from), + Self::Blob(bytes) => Some(bytes.clone()), #[cfg(target_arch = "wasm32")] PathOrBlob::Path(_) => None, // Paths not supported in wasm #[cfg(target_arch = "wasm32")] diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs index a98f8bf..368a3d3 100644 --- a/src/loaders/archive_loader.rs +++ b/src/loaders/archive_loader.rs @@ -7,9 +7,8 @@ use egui_inbox::{UiInbox, UiInboxSender}; use flate2::read::GzDecoder; use std::borrow::Cow; use std::collections::HashMap; -use std::io::{Cursor, Read}; +use std::io::{Cursor, Read as _}; use std::path::{Path, PathBuf}; -use std::sync::mpsc; use std::task::Poll; use tar::Archive; use zip::ZipArchive; @@ -33,7 +32,7 @@ fn is_tar_gz(data: &[u8]) -> bool { impl ArchiveLoader { pub fn new(data: DataReference) -> Self { - let name = data.file_name().to_string(); + let name = data.file_name().to_owned(); let mut inbox = UiInbox::new(); inbox.spawn(|tx| async move { @@ -56,15 +55,12 @@ impl LoadSnapshots for ArchiveLoader { fn update(&mut self, ctx: &Context) { if let Some(mut new_data) = self.inbox.read(ctx).last() { - match &mut new_data { - Ok(data) => { - data.sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); - for snapshot in data { - // We need to register bytes so that the diff loader can find them - snapshot.register_bytes(ctx); - } + if let Ok(data) = &mut new_data { + data.sort_by_key(|s| s.path.to_string_lossy().to_lowercase()); + for snapshot in data { + // We need to register bytes so that the diff loader can find them + snapshot.register_bytes(ctx); } - _ => {} } self.data = Poll::Ready(new_data); } @@ -95,8 +91,7 @@ pub async fn run_discovery(file: DataReference) -> anyhow::Result> } #[cfg(not(target_arch = "wasm32"))] { - let data = tokio::task::spawn_blocking(move || sync_discovery(data)).await?; - data + tokio::task::spawn_blocking(move || sync_discovery(data)).await? } } @@ -122,7 +117,7 @@ fn run_zip_discovery(zip_data: Bytes) -> Result>> { for i in 0..archive.len() { let mut file = archive.by_index(i)?; let file_path = match file.enclosed_name() { - Some(path) => path.to_path_buf(), + Some(path) => path.clone(), None => continue, // Skip files with invalid names }; @@ -164,7 +159,7 @@ fn get_snapshots(files: HashMap>) -> Vec { let mut snapshots = Vec::new(); let mut processed_files = std::collections::HashSet::new(); - for (png_path, _) in &files { + for png_path in files.keys() { if processed_files.contains(png_path) { continue; } @@ -213,10 +208,12 @@ fn try_create_snapshot(png_path: &Path, files: &HashMap>) -> Op let base_data = files.get(png_path)?; let diff_data = files.get(&diff_path); - let diff_reference = diff_data.map(|data| FileReference::Source(ImageSource::Bytes { - uri: Cow::Owned(format!("bytes://{}", diff_path.display())), - bytes: eframe::egui::load::Bytes::Shared(data.clone().into()), - })); + let diff_reference = diff_data.map(|data| { + FileReference::Source(ImageSource::Bytes { + uri: Cow::Owned(format!("bytes://{}", diff_path.display())), + bytes: eframe::egui::load::Bytes::Shared(data.clone().into()), + }) + }); if files.contains_key(&old_path) { // old.png exists, use original as new and old.png as old @@ -265,5 +262,5 @@ fn try_create_snapshot(png_path: &Path, files: &HashMap>) -> Op fn get_variant_path(base_path: &Path, variant: &str) -> Option { let stem = base_path.file_stem()?.to_str()?; let parent = base_path.parent().unwrap_or(Path::new("")); - Some(parent.join(format!("{}.{}.png", stem, variant))) + Some(parent.join(format!("{stem}.{variant}.png"))) } diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs index 742c1c7..a0a62fe 100644 --- a/src/loaders/gh_archive_loader.rs +++ b/src/loaders/gh_archive_loader.rs @@ -7,12 +7,11 @@ use anyhow::Error; use bytes::Bytes; use eframe::egui::{Context, Ui}; use egui_inbox::UiInbox; -use futures::SinkExt; +use futures::SinkExt as _; use octocrab::Octocrab; -use octocrab::models::ArtifactId; use octocrab::params::actions::ArchiveFormat; -use std::task::Poll; use serde_json::json; +use std::task::Poll; pub struct GHArtifactLoader { state: LoaderState, @@ -108,14 +107,15 @@ impl LoadSnapshots for GHArtifactLoader { fn files_header(&self) -> String { match &self.state { - LoaderState::LoadingData(_) => "Github Artifact".to_string(), + LoaderState::LoadingData(_) => "Github Artifact".to_owned(), LoaderState::LoadingArchive(loader) => loader.files_header(), - LoaderState::Error(_) => "Github Artifact".to_string(), + LoaderState::Error(_) => "Github Artifact".to_owned(), } } fn extra_ui(&self, ui: &mut Ui, state: &AppStateRef<'_>) { - if let Some((git_ref, run_id)) = self.artifact.branch_name.clone().zip(self.artifact.run_id) { + if let Some((git_ref, run_id)) = self.artifact.branch_name.clone().zip(self.artifact.run_id) + { let response = ui .button("Update snapshots from this archive") .on_hover_text( diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index 3829369..a4be966 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -5,8 +5,8 @@ use std::path::PathBuf; use std::task::Poll; pub mod archive_loader; -pub mod pr_loader; pub mod gh_archive_loader; +pub mod pr_loader; pub trait LoadSnapshots { fn update(&mut self, ctx: &egui::Context); @@ -32,21 +32,24 @@ pub enum DataReference { impl DataReference { pub fn file_name(&self) -> &str { match self { - DataReference::Url(url) => url.split('/').last().unwrap_or(url), - DataReference::Data(_, name) => name, - DataReference::Path(path) => path.file_name().and_then(|n| n.to_str()).unwrap_or("unknown"), + Self::Url(url) => url.split('/').next_back().unwrap_or(url), + Self::Data(_, name) => name, + Self::Path(path) => path + .file_name() + .and_then(|n| n.to_str()) + .unwrap_or("unknown"), } } pub async fn into_bytes(self) -> anyhow::Result { match self { - DataReference::Url(url) => { + Self::Url(url) => { let resp = reqwest::get(&url).await?; let bytes = resp.bytes().await?; Ok(bytes) } - DataReference::Data(data, _) => Ok(data), - DataReference::Path(_path) => { + Self::Data(data, _) => Ok(data), + Self::Path(_path) => { #[cfg(target_arch = "wasm32")] anyhow::bail!("FileReference::Path is not supported on wasm32"); #[cfg(not(target_arch = "wasm32"))] diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs index c7459fe..3a4dd8e 100644 --- a/src/loaders/pr_loader.rs +++ b/src/loaders/pr_loader.rs @@ -1,16 +1,14 @@ use crate::github::model::{GithubPrLink, GithubRepoLink}; use crate::github::octokit::RepoClient; use crate::github::pr::{GithubPr, pr_ui}; -use crate::loaders::{LoadSnapshots, SnapshotLoader, sort_snapshots}; +use crate::loaders::{LoadSnapshots, sort_snapshots}; use crate::snapshot::{FileReference, Snapshot}; use crate::state::AppStateRef; use eframe::egui::{Context, Ui}; use egui_inbox::{UiInbox, UiInboxSender}; -use futures::StreamExt; +use futures::StreamExt as _; use octocrab::models::repos::{DiffEntry, DiffEntryStatus}; -use octocrab::{Error, Octocrab, Result}; -use std::ops::Deref; -use std::path::Path; +use octocrab::{Octocrab, Result}; use std::pin::pin; use std::task::Poll; @@ -68,10 +66,7 @@ async fn stream_files( let file: DiffEntry = file; if file.filename.ends_with(".png") { let old_url = if file.status != DiffEntryStatus::Added { - let old_file_name = file - .previous_filename - .as_deref() - .unwrap_or(file.filename.deref()); + let old_file_name = file.previous_filename.as_deref().unwrap_or(&*file.filename); Some(create_media_url( repo_client.repo(), &pr.base.sha, diff --git a/src/main.rs b/src/main.rs index a60df8e..ccb4884 100644 --- a/src/main.rs +++ b/src/main.rs @@ -6,7 +6,6 @@ use eframe::NativeOptions; use kitdiff::DiffSource; use kitdiff::app::App; use kitdiff::config::Config; -use octocrab::models::ArtifactId; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { @@ -16,7 +15,7 @@ fn main() -> eframe::Result<()> { .expect("Failed to create Tokio runtime"); let _guard = rt.enter(); - use clap::Parser; + use clap::Parser as _; let mode = cli::Cli::parse(); let source = mode diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 31430d2..4c75597 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -6,7 +6,6 @@ use egui_inbox::UiInbox; use ignore::WalkBuilder; use ignore::types::TypesBuilder; use std::path::{Path, PathBuf}; -use std::sync::mpsc; use std::task::Poll; pub struct FileLoader { @@ -32,7 +31,7 @@ impl FileLoader { for result in WalkBuilder::new(&base_path).types(types).build() { if let Ok(entry) = result { - if entry.file_type().map_or(false, |ft| ft.is_file()) { + if entry.file_type().is_some_and(|ft| ft.is_file()) { if let Some(snapshot) = try_create_snapshot(entry.path(), &base_path) { if sender.send(Some(snapshot)).is_err() { break; diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index e7b8d10..cdc4868 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -4,12 +4,10 @@ use eframe::egui::load::Bytes; use eframe::egui::{Context, ImageSource}; use egui_inbox::{UiInbox, UiInboxSender}; use git2::{ObjectType, Repository}; -use serde_json::Value; use std::borrow::Cow; use std::fmt::Display; use std::path::{Path, PathBuf}; use std::str; -use std::sync::mpsc; use std::task::Poll; enum Command { @@ -124,13 +122,13 @@ pub enum GitError { impl Display for GitError { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { match self { - GitError::RepoNotFound => write!(f, "Git repository not found"), - GitError::BranchNotFound => write!(f, "Default branch not found"), - GitError::FileNotFound => write!(f, "File not found in git tree"), - GitError::GitError(err) => write!(f, "Git error: {}", err), - GitError::IoError(err) => write!(f, "IO error: {}", err), - GitError::PrUrlParseError => write!(f, "Failed to parse PR URL"), - GitError::NetworkError(msg) => write!(f, "Network error: {}", msg), + Self::RepoNotFound => write!(f, "Git repository not found"), + Self::BranchNotFound => write!(f, "Default branch not found"), + Self::FileNotFound => write!(f, "File not found in git tree"), + Self::GitError(err) => write!(f, "Git error: {err}"), + Self::IoError(err) => write!(f, "IO error: {err}"), + Self::PrUrlParseError => write!(f, "Failed to parse PR URL"), + Self::NetworkError(msg) => write!(f, "Network error: {msg}"), } } } @@ -139,13 +137,13 @@ impl std::error::Error for GitError {} impl From for GitError { fn from(err: git2::Error) -> Self { - GitError::GitError(err) + Self::GitError(err) } } impl From for GitError { fn from(err: std::io::Error) -> Self { - GitError::IoError(err) + Self::IoError(err) } } @@ -155,7 +153,7 @@ fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> // Get current branch let head = repo.head()?; - let current_branch = head.shorthand().unwrap_or("HEAD").to_string(); + let current_branch = head.shorthand().unwrap_or("HEAD").to_owned(); // Find default branch (try main, then master, then first branch) let default_branch = find_default_branch(&repo)?; @@ -167,7 +165,7 @@ fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> .and_then(|p| p.file_name()) .and_then(|n| n.to_str()) .unwrap_or("unknown") - .to_string(); + .to_owned(); sender .send(Command::GitInfo(GitInfo { current_branch: current_branch.clone(), @@ -178,10 +176,7 @@ fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> // Don't compare branch with itself if current_branch == default_branch { - eprintln!( - "Current branch is the same as default branch ({})", - current_branch - ); + eprintln!("Current branch is the same as default branch ({current_branch})"); return Ok(()); } @@ -241,7 +236,7 @@ fn find_default_branch(repo: &Repository) -> Result { // Try common default branch names for branch_name in ["main", "master"] { if repo.resolve_reference_from_short_name(branch_name).is_ok() { - return Ok(branch_name.to_string()); + return Ok(branch_name.to_owned()); } } @@ -250,7 +245,7 @@ fn find_default_branch(repo: &Repository) -> Result { for branch in branches { let (branch, _) = branch?; if let Some(name) = branch.name()? { - return Ok(name.to_string()); + return Ok(name.to_owned()); } } @@ -406,7 +401,7 @@ fn parse_github_https_url(url: &str) -> Option<(String, String)> { let parts: Vec<&str> = path.split('/').collect(); if parts.len() >= 2 { - return Some((parts[0].to_string(), parts[1].to_string())); + return Some((parts[0].to_owned(), parts[1].to_owned())); } } None @@ -420,7 +415,7 @@ fn parse_github_ssh_url(url: &str) -> Option<(String, String)> { let parts: Vec<&str> = path.split('/').collect(); if parts.len() >= 2 { - return Some((parts[0].to_string(), parts[1].to_string())); + return Some((parts[0].to_owned(), parts[1].to_owned())); } } None diff --git a/src/settings.rs b/src/settings.rs index 1eeea41..12282a7 100644 --- a/src/settings.rs +++ b/src/settings.rs @@ -1,8 +1,8 @@ use crate::diff_image_loader::DiffOptions; -use eframe::egui::TextureFilter; use crate::github::auth::{AuthState, LoggedInState}; +use eframe::egui::TextureFilter; -#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)] +#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)] pub enum ImageMode { Pixel, Fit, diff --git a/src/snapshot.rs b/src/snapshot.rs index b8a6e1b..6cd3e4b 100644 --- a/src/snapshot.rs +++ b/src/snapshot.rs @@ -1,6 +1,6 @@ use crate::diff_image_loader; use crate::diff_image_loader::DiffOptions; -use crate::state::{AppStateRef, PageRef, ViewerStateRef}; +use crate::state::{AppStateRef, PageRef}; use eframe::egui; use eframe::egui::{Color32, ImageSource}; use std::path::PathBuf; @@ -24,11 +24,11 @@ pub enum FileReference { impl FileReference { pub fn to_uri(&self) -> String { match self { - FileReference::Path(path) => format!("file://{}", path.display()), - FileReference::Source(source) => match source { + Self::Path(path) => format!("file://{}", path.display()), + Self::Source(source) => match source { ImageSource::Uri(uri) => uri.to_string(), ImageSource::Bytes { uri, .. } => uri.to_string(), - _ => "unknown://unknown".to_string(), + _ => "unknown://unknown".to_owned(), }, } } diff --git a/src/state.rs b/src/state.rs index 2c889c0..b3ef413 100644 --- a/src/state.rs +++ b/src/state.rs @@ -1,15 +1,14 @@ +use crate::config::Config; use crate::diff_image_loader::DiffImageLoader; +use crate::github::auth::{GitHubAuth, GithubAuthCommand}; +use crate::github::model::GithubPrLink; +use crate::github::pr::GithubPr; use crate::loaders::SnapshotLoader; use crate::settings::Settings; use crate::snapshot::Snapshot; -use eframe::egui; use eframe::egui::Context; use egui_inbox::UiInboxSender; use std::ops::Deref; -use crate::config::Config; -use crate::github::auth::{GitHubAuth, GithubAuthCommand}; -use crate::github::model::GithubPrLink; -use crate::github::pr::GithubPr; pub struct AppState { pub github_auth: GitHubAuth, @@ -55,7 +54,7 @@ impl ViewerState { /// If any is true, only show those, but at full opacity /// /// If all are false, show all at their set opacities -#[derive(Default, Copy, Clone, PartialEq)] +#[derive(Default, Copy, Clone, PartialEq, Eq)] pub struct ViewFilter { pub show_old: bool, pub show_new: bool, @@ -69,7 +68,7 @@ impl ViewFilter { } impl AppState { - pub fn new(settings: Settings, config: Config) -> AppState { + pub fn new(settings: Settings, config: Config) -> Self { Self { github_auth: GitHubAuth::new(settings.auth.clone()), github_pr: None, @@ -202,7 +201,7 @@ pub enum ViewerSystemCommand { impl From for SystemCommand { fn from(value: ViewerSystemCommand) -> Self { - SystemCommand::ViewerCommand(value) + Self::ViewerCommand(value) } } @@ -210,7 +209,7 @@ impl AppState { pub fn handle(&mut self, ctx: &Context, command: SystemCommand) { match command { SystemCommand::Open(source) => { - let loader = source.load(ctx.clone(), &self); + let loader = source.load(ctx.clone(), self); self.page = Page::DiffViewer(ViewerState { filter: String::new(), index: 0, @@ -223,10 +222,7 @@ impl AppState { self.github_auth.handle(auth); } SystemCommand::LoadPrDetails(url) => { - self.github_pr = Some(GithubPr::new( - url, - self.github_auth.client(), - )); + self.github_pr = Some(GithubPr::new(url, self.github_auth.client())); } SystemCommand::UpdateSettings(settings) => { self.settings = settings; diff --git a/src/viewer/diff_view.rs b/src/viewer/diff_view.rs index f42fcb8..c817eaf 100644 --- a/src/viewer/diff_view.rs +++ b/src/viewer/diff_view.rs @@ -1,6 +1,5 @@ -use crate::settings::ImageMode; -use crate::state::{AppStateRef, PageRef, ViewFilter, ViewerAppStateRef, ViewerStateRef}; -use eframe::egui::{Image, RichText, SizeHint, TextureOptions, Ui}; +use crate::state::ViewerAppStateRef; +use eframe::egui::{Image, RichText, SizeHint, Ui}; pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { ui.label("Use 1/2/3 to only show old / new / diff at 100% opacity. Arrow keys to navigate."); diff --git a/src/viewer/file_tree.rs b/src/viewer/file_tree.rs index 5b92c14..d3b6060 100644 --- a/src/viewer/file_tree.rs +++ b/src/viewer/file_tree.rs @@ -1,9 +1,8 @@ use crate::state::{FilteredSnapshot, ViewerAppStateRef, ViewerSystemCommand}; -use anyhow::Error; use eframe::egui; -use eframe::egui::{Id, ScrollArea, TextEdit, Ui, Widget}; -use re_ui::list_item::{LabelContent, ListItem}; -use re_ui::{UiExt, icons}; +use eframe::egui::{Id, ScrollArea, TextEdit, Ui, Widget as _}; +use re_ui::list_item::LabelContent; +use re_ui::{UiExt as _, icons}; use std::collections::BTreeMap; use std::task::Poll; @@ -12,17 +11,19 @@ pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { state.loader.extra_ui(ui, state.app); - ui.panel_title_bar_with_buttons(&state.loader.files_header(), None, |ui| match state.loader.state() { - Poll::Ready(Ok(())) => {} - Poll::Ready(Err(e)) => { - icons::ERROR - .as_image() - .tint(ui.tokens().alert_error.icon) - .ui(ui) - .on_hover_text(e.to_string()); - } - Poll::Pending => { - ui.spinner(); + ui.panel_title_bar_with_buttons(&state.loader.files_header(), None, |ui| { + match state.loader.state() { + Poll::Ready(Ok(())) => {} + Poll::Ready(Err(e)) => { + icons::ERROR + .as_image() + .tint(ui.tokens().alert_error.icon) + .ui(ui) + .on_hover_text(e.to_string()); + } + Poll::Pending => { + ui.spinner(); + } } }); @@ -43,7 +44,7 @@ pub fn file_tree(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { let prefix = snapshot.path.parent().and_then(|p| p.to_str()); tree.entry(prefix) .or_insert(vec![]) - .push((*snapshot_index, *snapshot)) + .push((*snapshot_index, *snapshot)); } for (prefix, snapshots) in tree { diff --git a/src/viewer/mod.rs b/src/viewer/mod.rs index 7a1f4cd..c0adc40 100644 --- a/src/viewer/mod.rs +++ b/src/viewer/mod.rs @@ -2,10 +2,10 @@ mod diff_view; mod file_tree; mod viewer_options; -use crate::state::{AppStateRef, ViewerAppStateRef}; +use crate::state::ViewerAppStateRef; use eframe::egui; +use eframe::egui::Context; use eframe::egui::panel::Side; -use eframe::egui::{Context, Ui}; pub fn viewer_ui(ctx: &Context, state: &ViewerAppStateRef<'_>) { egui::SidePanel::new(Side::Left, "files").show(ctx, |ui| { diff --git a/src/viewer/viewer_options.rs b/src/viewer/viewer_options.rs index caa54ed..a8727cf 100644 --- a/src/viewer/viewer_options.rs +++ b/src/viewer/viewer_options.rs @@ -1,6 +1,6 @@ use crate::settings::ImageMode; use crate::state::{SystemCommand, ViewerAppStateRef, ViewerSystemCommand}; -use eframe::egui::{Checkbox, Key, KeyboardShortcut, Modifiers, Slider, TextureFilter, Ui}; +use eframe::egui::{Checkbox, Slider, TextureFilter, Ui}; pub fn viewer_options(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { let mut settings = state.app.settings.clone(); From 9bbfe373bddad9db3089e42c65d55b9740678f61 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 16:55:24 +0200 Subject: [PATCH 15/25] Clippy fixes and general improvements --- src/app.rs | 27 +--- src/bar.rs | 2 +- src/cli.rs | 64 +++------- src/diff_image_loader.rs | 14 +-- src/github/auth.rs | 16 ++- src/github/pr.rs | 15 +-- src/home.rs | 2 +- src/lib.rs | 196 +----------------------------- src/loaders/archive_loader.rs | 2 - src/loaders/gh_archive_loader.rs | 5 +- src/loaders/mod.rs | 2 + src/main.rs | 31 ++--- src/native_loaders/file_loader.rs | 1 + src/native_loaders/git_loader.rs | 46 ++++--- src/settings.rs | 15 +-- src/snapshot.rs | 24 ++-- src/state.rs | 4 +- src/viewer/diff_view.rs | 2 +- 18 files changed, 98 insertions(+), 370 deletions(-) diff --git a/src/app.rs b/src/app.rs index 9924b89..3b51e8d 100644 --- a/src/app.rs +++ b/src/app.rs @@ -16,7 +16,7 @@ pub struct App { } impl App { - pub fn new(cc: &eframe::CreationContext, source: Option, config: Config) -> Self { + pub fn new(cc: &eframe::CreationContext<'_>, source: Option, config: Config) -> Self { re_ui::apply_style_and_install_loaders(&cc.egui_ctx); let settings: Settings = cc @@ -30,31 +30,6 @@ impl App { let diff_loader = Arc::new(DiffImageLoader::default()); cc.egui_ctx.add_image_loader(diff_loader.clone()); - let ctx = cc.egui_ctx.clone(); - - // if let Some(source) = source { - // match source { - // // TODO: This kinda sucks, maybe sources should just have an UI? - // DiffSource::Pr(pr) => { - // if let Ok((user, repo, pr_number)) = parse_github_pr_url(&pr) { - // let auth_token = settings.auth().map(|auth| auth.provider_token.clone()); - // github_pr = Some(GithubPr::new( - // user, - // repo, - // pr_number, - // ctx.clone(), - // auth_token, - // )); - // } else { - // eprintln!("Invalid GitHub PR URL"); - // } - // } - // source => { - // source.load(sender.clone(), ctx, settings.auth()); - // } - // } - // } - let inbox = UiInbox::new(); if let Some(source) = source { diff --git a/src/bar.rs b/src/bar.rs index d698051..291da66 100644 --- a/src/bar.rs +++ b/src/bar.rs @@ -9,7 +9,7 @@ pub fn bar(ctx: &Context, state: &AppStateRef<'_>) { .show(ctx, |ui| { egui::Sides::new().show( ui, - |ui| {}, + |_ui| {}, |ui| { auth_ui(ui, state); }, diff --git a/src/cli.rs b/src/cli.rs index 82c4a2a..5ca91de 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -21,7 +21,7 @@ pub enum Commands { /// Compare images between PR branches from GitHub PR URL (needs to be run from within the repo) Pr { url: String }, /// Load and compare snapshot files from a zip archive (URL or local file) - Zip { source: String }, + Archive { source: String }, /// Load and compare snapshot files from a GitHub artifact GhArtifact { url: String }, } @@ -37,63 +37,27 @@ impl Commands { } Self::Pr { url } => { // Check if the PR URL is actually a GitHub artifact URL - if let Some((repo, artifact_id)) = parse_github_artifact_url(url) { - DiffSource::GHArtifact(GithubArtifactLink { - repo, - artifact_id: ArtifactId(artifact_id.parse().unwrap()), - name: None, - branch_name: None, - run_id: None, - }) + if let Some(link) = parse_github_artifact_url(url) { + DiffSource::GHArtifact(link) } else if let Ok(parsed_url) = url.parse() { DiffSource::Pr(parsed_url) } else { panic!("Invalid GitHub PR URL: {url}"); } } - Self::Zip { source } => { - // // Check if it's a GitHub artifact URL first - // if let Some((repo, artifact_id)) = parse_github_artifact_url(source) { - // DiffSource::GHArtifact { - // owner, - // repo, - // artifact_id, - // } - // } else if source.starts_with("http://") || source.starts_with("https://") { - // #[cfg(target_arch = "wasm32")] - // { - // if source.ends_with(".tar.gz") || source.ends_with(".tgz") { - // DiffSource::TarGz(kitdiff::PathOrBlob::Url(source.clone(), None)) - // } else { - // DiffSource::Zip(kitdiff::PathOrBlob::Url(source.clone(), None)) - // } - // } - // #[cfg(not(target_arch = "wasm32"))] - // { - // panic!( - // "URL sources not supported on native platforms. Use 'gh-artifact' command for GitHub artifacts or download and provide a local file path." - // ); - // } - // } else { - // if source.ends_with(".tar.gz") || source.ends_with(".tgz") { - // DiffSource::TarGz(kitdiff::PathOrBlob::Path(source.clone().into())) - // } else { - // DiffSource::Zip(kitdiff::PathOrBlob::Path(source.clone().into())) - // } - // } - todo!() + Self::Archive { source } => { + if source.starts_with("http://") || source.starts_with("https://") { + DiffSource::Archive(kitdiff::DataReference::Url(source.clone())) + } else { + DiffSource::Archive(kitdiff::DataReference::Path(source.clone().into())) + } } Self::GhArtifact { url } => { - // if let Some((owner, repo, artifact_id)) = parse_github_artifact_url(url) { - // DiffSource::GHArtifact { - // owner, - // repo, - // artifact_id, - // } - // } else { - // panic!("Invalid GitHub artifact URL: {}", url); - // } - todo!() + if let Some(link) = parse_github_artifact_url(url) { + DiffSource::GHArtifact(link) + } else { + panic!("Invalid GitHub artifact URL: {}", url); + } } } } diff --git a/src/diff_image_loader.rs b/src/diff_image_loader.rs index 53a2cfe..678520c 100644 --- a/src/diff_image_loader.rs +++ b/src/diff_image_loader.rs @@ -116,14 +116,14 @@ impl ImageLoader for DiffImageLoader { #[cfg(not(target_arch = "wasm32"))] std::thread::spawn(move || { ctx.request_repaint(); - let result = load_diffs(&ctx, old_image, new_image, size_hint, diff_uri); + let result = load_diffs(&ctx, &old_image, &new_image, size_hint, &diff_uri); cache.lock().insert(uri, result.map(Poll::Ready)); }); #[cfg(target_arch = "wasm32")] { wasm_bindgen_futures::spawn_local(async move { ctx.request_repaint(); - let result = load_diffs(&ctx, old_image, new_image, size_hint, diff_uri); + let result = load_diffs(&ctx, &old_image, &new_image, size_hint, &diff_uri); cache.lock().insert(uri, result.map(Poll::Ready)); }); } @@ -155,11 +155,11 @@ impl ImageLoader for DiffImageLoader { } pub fn load_diffs( - ctx: &Context, - old_img: Arc, - new_img: Arc, - size_hint: SizeHint, - diff_uri: DiffUri, + _ctx: &Context, + old_img: &ColorImage, + new_img: &ColorImage, + _size_hint: SizeHint, + diff_uri: &DiffUri, ) -> Result { let old = image::RgbaImage::from_vec( old_img.width() as u32, diff --git a/src/github/auth.rs b/src/github/auth.rs index c00a5f6..41bc6f2 100644 --- a/src/github/auth.rs +++ b/src/github/auth.rs @@ -1,7 +1,8 @@ -use crate::github::model::GithubRepoLink; +use crate::github::model::{GithubArtifactLink, GithubRepoLink}; use crate::state::SystemCommand; use eframe::egui; use ehttp; +use octocrab::models::ArtifactId; use serde_json; use std::fmt; use std::sync::mpsc; @@ -107,7 +108,7 @@ fn get_current_timestamp() -> u64 { } // URL parsing utilities -pub fn parse_github_artifact_url(url: &str) -> Option<(GithubRepoLink, String)> { +pub fn parse_github_artifact_url(url: &str) -> Option { // Expected format: github.com/owner/repo/actions/runs/12345/artifacts/67890 let url = url .trim_start_matches("https://") @@ -123,10 +124,13 @@ pub fn parse_github_artifact_url(url: &str) -> Option<(GithubRepoLink, String)> { let owner = parts[1].to_owned(); let repo = parts[2].to_owned(); - Some(( - GithubRepoLink { owner, repo }, - parts[7].to_owned(), // artifact_id - )) + Some(GithubArtifactLink { + repo: GithubRepoLink { owner, repo }, + artifact_id: ArtifactId(parts[7].parse().ok()?), + name: None, + branch_name: None, + run_id: None, + }) } else { None } diff --git a/src/github/pr.rs b/src/github/pr.rs index 6c392a0..26aefd8 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -3,7 +3,7 @@ use eframe::egui; use eframe::egui::{Button, Context, ScrollArea, Spinner}; use egui_inbox::UiInbox; use futures::stream::FuturesUnordered; -use futures::{StreamExt as _, TryStreamExt as _}; +use futures::TryStreamExt as _; use graphql_client::GraphQLQuery; use octocrab::Octocrab; use re_ui::egui_ext::boxed_widget::BoxedWidgetLocalExt as _; @@ -50,7 +50,7 @@ pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { let user = parts[0].to_owned(); let repo = parts[1].to_owned(); - let pr_number = parts[3].parse::().map_err(|_| "Invalid PR number")?; + let pr_number = parts[3].parse::().map_err(|_err| "Invalid PR number")?; Ok((user, repo, pr_number)) } @@ -92,16 +92,17 @@ pub struct GithubPr { } #[derive(Debug)] -struct PrWithCommits { +pub(crate) struct PrWithCommits { title: String, head_branch: String, + #[allow(dead_code)] base_branch: String, commits: Vec, artifacts: HashMap>>>, } #[derive(Debug)] -struct ArtifactData { +pub(crate) struct ArtifactData { data: WorkflowListArtifact, run_id: RunId, } @@ -239,7 +240,7 @@ async fn get_pr_commits(repo: &RepoClient, pr: PrNumber) -> Result false, pr_details_query::CheckStatusState::IN_PROGRESS => true, @@ -339,7 +340,6 @@ pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { .tint(ui.tokens().alert_success.icon), ) .boxed_local(), - _ => Button::image(icons::HELP.as_image()).boxed_local(), }; let button = button.on_menu(|ui| { @@ -362,6 +362,7 @@ pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { format!("Error: {error}"), ); } + #[expect(clippy::excessive_nesting)] Some(Poll::Ready(Ok(artifacts))) => { if artifacts.is_empty() { ui.label("No artifacts found"); @@ -399,7 +400,7 @@ pub fn pr_ui(ui: &mut egui::Ui, state: &AppStateRef<'_>, pr: &GithubPr) { Poll::Pending => { SectionCollapsingHeader::new(format!("PR: {}", pr.link)) .with_button(Spinner::new()) - .show(ui, |ui| {}); + .show(ui, |_ui| {}); ui.spinner(); } }); diff --git a/src/home.rs b/src/home.rs index 50311c2..a47d431 100644 --- a/src/home.rs +++ b/src/home.rs @@ -1,7 +1,7 @@ use crate::state::AppStateRef; use eframe::egui::{CentralPanel, Context}; -pub fn home_view(ctx: &Context, app: &AppStateRef<'_>) { +pub fn home_view(ctx: &Context, _app: &AppStateRef<'_>) { CentralPanel::default().show(ctx, |ui| { ui.heading("Kitdiff"); ui.label("Drag in a file to start"); diff --git a/src/lib.rs b/src/lib.rs index a1b166c..aa6b76b 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -1,10 +1,11 @@ use crate::github::model::{GithubArtifactLink, GithubPrLink}; -use crate::loaders::SnapshotLoader; +pub use crate::loaders::{DataReference, SnapshotLoader}; use crate::state::AppState; use eframe::egui::Context; use eframe::egui::load::Bytes; use std::any::Any; use std::path::PathBuf; +use crate::snapshot::FileReference; pub mod app; mod bar; @@ -28,12 +29,11 @@ pub enum DiffSource { Git(PathBuf), Pr(GithubPrLink), GHArtifact(GithubArtifactLink), - Zip(PathOrBlob), - TarGz(PathOrBlob), + Archive(DataReference), } impl DiffSource { - pub fn load(self, ctx: Context, state: &AppState) -> SnapshotLoader { + pub fn load(self, _ctx: &Context, state: &AppState) -> SnapshotLoader { match self { #[cfg(not(target_arch = "wasm32"))] Self::Files(path) => Box::new(native_loaders::file_loader::FileLoader::new(path)), @@ -49,193 +49,9 @@ impl DiffSource { artifact, )) } - // DiffSource::Zip(data) => { - // #[cfg(target_arch = "wasm32")] - // { - // // For URLs in wasm, spawn async task - // if matches!(data, PathOrBlob::Url(_, _)) { - // let data_clone = data.clone(); - // let tx_clone = tx.clone(); - // let ctx_clone = ctx.clone(); - // - // wasm_bindgen_futures::spawn_local(async move { - // if let Some(bytes) = data_clone.load_bytes_async().await { - // if let Err(e) = loaders::zip_loader::extract_and_discover_zip( - // bytes.to_vec(), - // tx_clone, - // ctx_clone, - // ) { - // eprintln!("Failed to run zip discovery: {:?}", e); - // } - // } - // }); - // None - // } else { - // // For blobs, use sync method - // loaders::zip_loader::extract_and_discover_zip( - // data.load_bytes()?.to_vec(), - // tx, - // ctx, - // ) - // .expect("Failed to run zip discovery"); - // None - // } - // } - // #[cfg(not(target_arch = "wasm32"))] - // { - // loaders::zip_loader::extract_and_discover_zip( - // data.load_bytes()?.to_vec(), - // tx, - // ctx, - // ) - // .expect("Failed to run zip discovery"); - // None - // } - // } - // DiffSource::TarGz(data) => { - // #[cfg(target_arch = "wasm32")] - // { - // // For URLs in wasm, spawn async task - // if matches!(data, PathOrBlob::Url(_, _)) { - // let data_clone = data.clone(); - // let tx_clone = tx.clone(); - // let ctx_clone = ctx.clone(); - // - // wasm_bindgen_futures::spawn_local(async move { - // if let Some(bytes) = data_clone.load_bytes_async().await { - // if let Err(e) = loaders::tar_loader::extract_and_discover_tar_gz( - // bytes.to_vec(), - // tx_clone, - // ctx_clone, - // ) { - // eprintln!("Failed to run tar.gz discovery: {:?}", e); - // } - // } - // }); - // None - // } else { - // // For blobs, use sync method - // loaders::tar_loader::extract_and_discover_tar_gz( - // data.load_bytes()?.to_vec(), - // tx, - // ctx, - // ) - // .expect("Failed to run tar.gz discovery"); - // None - // } - // } - // #[cfg(not(target_arch = "wasm32"))] - // { - // loaders::tar_loader::extract_and_discover_tar_gz( - // data.load_bytes()?.to_vec(), - // tx, - // ctx, - // ) - // .expect("Failed to run tar.gz discovery"); - // None - // } - // } - // DiffSource::GHArtifact { - // owner, - // repo, - // artifact_id, - // } => { - // #[cfg(target_arch = "wasm32")] - // { - // use crate::github_auth::github_artifact_api_url; - // - // // Create GitHub API URL for artifact - // let api_url = github_artifact_api_url(&owner, &repo, &artifact_id); - // - // // TODO: Get GitHub token from auth state - we'll need to pass this context - // // For now, try without token (works for public repos) - // let data = PathOrBlob::Url(api_url, auth.map(|l| l.provider_token.clone())); - // - // // Use async zip loading since it's a URL - // let tx_clone = tx.clone(); - // let ctx_clone = ctx.clone(); - // - // wasm_bindgen_futures::spawn_local(async move { - // if let Some(bytes) = data.load_bytes_async().await { - // if let Err(e) = loaders::zip_loader::extract_and_discover_zip( - // bytes.to_vec(), - // tx_clone, - // ctx_clone, - // ) { - // eprintln!("Failed to run GitHub artifact zip discovery: {:?}", e); - // } - // } - // }); - // None - // } - // #[cfg(not(target_arch = "wasm32"))] - // { - // eprintln!( - // "GitHub artifact loading not supported on native platforms yet. Please download the artifact manually and use the zip command instead." - // ); - // None - // } - // } - _ => todo!(), - } - } -} - -struct DropMeLater(Box); - -#[derive(Debug, Clone)] -pub enum PathOrBlob { - Path(std::path::PathBuf), - Blob(Bytes), - #[cfg(target_arch = "wasm32")] - Url(String, Option), // URL and optional auth token -} - -impl PathOrBlob { - pub fn load_bytes(&self) -> Option { - match self { - #[cfg(not(target_arch = "wasm32"))] - Self::Path(path) => std::fs::read(path).ok().map(Bytes::from), - Self::Blob(bytes) => Some(bytes.clone()), - #[cfg(target_arch = "wasm32")] - PathOrBlob::Path(_) => None, // Paths not supported in wasm - #[cfg(target_arch = "wasm32")] - PathOrBlob::Url(_, _) => None, // URLs require async, handled separately - } - } - - #[cfg(target_arch = "wasm32")] - pub async fn load_bytes_async(&self) -> Option { - match self { - PathOrBlob::Blob(bytes) => Some(bytes.clone()), - PathOrBlob::Url(url, token) => { - let auth_header = token.as_ref().map(|t| format!("Bearer {}", t)); - let mut headers = vec![("User-Agent", "kitdiff")]; - if let Some(ref auth) = auth_header { - headers.push(("Authorization", auth.as_str())); - } - - let request = ehttp::Request { - method: "GET".to_string(), - url: url.clone(), - body: vec![], - headers: ehttp::Headers::new(&headers), - mode: ehttp::Mode::Cors, - }; - - match ehttp::fetch_async(request).await { - Ok(response) if response.ok => Some(Bytes::from(response.bytes)), - Ok(response) => { - eprintln!("Failed to download {}: HTTP {}", url, response.status); - None - } - Err(e) => { - eprintln!("Failed to download {}: {}", url, e); - None - } - } + Self::Archive(file_ref) => { + Box::new(loaders::archive_loader::ArchiveLoader::new(file_ref)) } - PathOrBlob::Path(_) => None, // Paths not supported in wasm } } } diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs index 368a3d3..e0c9be7 100644 --- a/src/loaders/archive_loader.rs +++ b/src/loaders/archive_loader.rs @@ -13,8 +13,6 @@ use std::task::Poll; use tar::Archive; use zip::ZipArchive; -type Sender = UiInboxSender>>; - #[derive(Debug)] pub struct ArchiveLoader { data: Poll>>, diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs index a0a62fe..cdcc1ac 100644 --- a/src/loaders/gh_archive_loader.rs +++ b/src/loaders/gh_archive_loader.rs @@ -7,7 +7,6 @@ use anyhow::Error; use bytes::Bytes; use eframe::egui::{Context, Ui}; use egui_inbox::UiInbox; -use futures::SinkExt as _; use octocrab::Octocrab; use octocrab::params::actions::ArchiveFormat; use serde_json::json; @@ -16,7 +15,6 @@ use std::task::Poll; pub struct GHArtifactLoader { state: LoaderState, artifact: GithubArtifactLink, - inbox: UiInbox<()>, } #[derive(Debug)] @@ -40,7 +38,6 @@ impl GHArtifactLoader { Self { state: LoaderState::LoadingData(inbox), artifact, - inbox: UiInbox::new(), } } } @@ -125,7 +122,7 @@ impl LoadSnapshots for GHArtifactLoader { let client = state.github_auth.client(); let artifact = self.artifact.clone(); hello_egui_utils::spawn(async move { - client + let _ = client .actions() .create_workflow_dispatch( artifact.repo.owner, diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index a4be966..6c58517 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -16,6 +16,7 @@ pub trait LoadSnapshots { /// State is separate so that snapshots can be streamed in fn state(&self) -> Poll>; + #[allow(unused_variables)] fn extra_ui(&self, ui: &mut egui::Ui, state: &AppStateRef<'_>) {} fn files_header(&self) -> String; @@ -23,6 +24,7 @@ pub trait LoadSnapshots { pub type SnapshotLoader = Box; +#[derive(Debug, Clone)] pub enum DataReference { Url(String), Data(bytes::Bytes, String), diff --git a/src/main.rs b/src/main.rs index ccb4884..4f11687 100644 --- a/src/main.rs +++ b/src/main.rs @@ -3,9 +3,9 @@ mod cli; #[cfg(not(target_arch = "wasm32"))] use eframe::NativeOptions; -use kitdiff::DiffSource; use kitdiff::app::App; use kitdiff::config::Config; +use kitdiff::{DataReference, DiffSource}; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { @@ -34,6 +34,7 @@ fn main() -> eframe::Result<()> { fn parse_url_query_params() -> Option { use kitdiff::github::auth::parse_github_artifact_url; use kitdiff::github::pr::parse_github_pr_url; + use octocrab::models::ArtifactId; if let Some(window) = web_sys::window() { if let Ok(search) = window.location().search() { @@ -52,30 +53,16 @@ fn parse_url_query_params() -> Option { } // Try to parse as GitHub artifact URL - if let Some((repo, artifact_id)) = parse_github_artifact_url(&decoded_url) { - return Some(DiffSource::GHArtifact( - kitdiff::github::model::GithubArtifactLink { - repo, - artifact_id: ArtifactId(artifact_id.parse().unwrap()), - name: None, - branch_name: None, - run_id: None, - }, - )); + if let Some(link) = parse_github_artifact_url(&decoded_url) { + return Some(DiffSource::GHArtifact(link)); } // Try to parse as direct zip/tar.gz URL - if decoded_url.ends_with(".zip") { - return Some(DiffSource::Zip(kitdiff::PathOrBlob::Url( - decoded_url, - None, - ))); - } - if decoded_url.ends_with(".tar.gz") || decoded_url.ends_with(".tgz") { - return Some(DiffSource::TarGz(kitdiff::PathOrBlob::Url( - decoded_url, - None, - ))); + if decoded_url.ends_with(".zip") + || decoded_url.ends_with(".tar.gz") + || decoded_url.ends_with(".tgz") + { + return Some(DiffSource::Archive(DataReference::Url(decoded_url))); } } } diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 4c75597..8cb1d52 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -29,6 +29,7 @@ impl FileLoader { types_builder.select("png"); let types = types_builder.build().unwrap(); + #[expect(clippy::excessive_nesting)] for result in WalkBuilder::new(&base_path).types(types).build() { if let Ok(entry) = result { if entry.file_type().is_some_and(|ft| ft.is_file()) { diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index cdc4868..2d0bd5f 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -40,7 +40,7 @@ impl GitLoader { { let base_path = base_path.clone(); std::thread::spawn(move || { - let result = run_git_discovery(sender.clone(), base_path); + let result = run_git_discovery(sender.clone(), &base_path); match result { Ok(()) => { // Signal done @@ -147,9 +147,9 @@ impl From for GitError { } } -fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> { +fn run_git_discovery(sender: Sender, base_path: &Path) -> Result<(), GitError> { // Open git repository in current directory - let repo = Repository::open(base_path).map_err(|_| GitError::RepoNotFound)?; + let repo = Repository::open(base_path).map_err(|_err| GitError::RepoNotFound)?; // Get current branch let head = repo.head()?; @@ -209,14 +209,16 @@ fn run_git_discovery(sender: Sender, base_path: PathBuf) -> Result<(), GitError> if let Some(extension) = file_path.extension() { if extension == "png" { // Create snapshot for this changed PNG file - if let Ok(Some(snapshot)) = create_git_snapshot( - &repo, - &base_commit.tree().unwrap(), - file_path, - &github_repo_info, - &commit_sha, - ) { - sender.send(Command::Snapshot(snapshot)).ok(); + if let Ok(base_tree) = base_commit.tree() { + if let Ok(Some(snapshot)) = create_git_snapshot( + &repo, + &base_tree, + file_path, + &github_repo_info, + &commit_sha, + ) { + sender.send(Command::Snapshot(snapshot)).ok(); + } } break; // Only process once per delta } @@ -254,7 +256,7 @@ fn find_default_branch(repo: &Repository) -> Result { fn create_git_snapshot( repo: &Repository, - default_tree: &git2::Tree, + default_tree: &git2::Tree<'_>, relative_path: &Path, github_repo_info: &Option<(String, String)>, commit_sha: &str, @@ -272,12 +274,9 @@ fn create_git_snapshot( return Ok(None); } - let default_file_content = match get_file_from_tree(repo, default_tree, relative_path) { - Ok(content) => content, - Err(_) => { - // File doesn't exist in default branch, skip - return Ok(None); - } + let Ok(default_file_content) = get_file_from_tree(repo, default_tree, relative_path) else { + // File doesn't exist in default branch, skip + return Ok(None); }; // Get the current file from the current branch's tree to compare git objects properly @@ -322,7 +321,7 @@ fn create_git_snapshot( fn get_file_from_tree( repo: &Repository, - tree: &git2::Tree, + tree: &git2::Tree<'_>, path: &Path, ) -> Result, GitError> { let entry = tree.get_path(path)?; @@ -330,7 +329,7 @@ fn get_file_from_tree( match object.kind() { Some(ObjectType::Blob) => { - let blob = object.as_blob().unwrap(); + let blob = object.as_blob().ok_or(GitError::FileNotFound)?; Ok(blob.content().to_vec()) } _ => Err(GitError::FileNotFound), @@ -344,14 +343,13 @@ fn is_lfs_pointer(content: &[u8]) -> bool { } // Try to parse as UTF-8 - let text = match str::from_utf8(content) { - Ok(text) => text, - Err(_) => return false, + let Ok(text) = str::from_utf8(content) else { + return false; }; // Check for LFS pointer format // Must start with "version https://git-lfs.github.com/spec/v1" - let lines: Vec<&str> = text.trim().split('\n').collect(); + let lines: Vec<&str> = text.lines().collect(); if lines.is_empty() { return false; } diff --git a/src/settings.rs b/src/settings.rs index 12282a7..6bfbc8a 100644 --- a/src/settings.rs +++ b/src/settings.rs @@ -1,5 +1,5 @@ use crate::diff_image_loader::DiffOptions; -use crate::github::auth::{AuthState, LoggedInState}; +use crate::github::auth::AuthState; use eframe::egui::TextureFilter; #[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)] @@ -19,19 +19,6 @@ pub struct Settings { pub auth: AuthState, } -impl Settings { - fn auth(&self) -> Option<&LoggedInState> { - #[cfg(target_arch = "wasm32")] - { - self.auth.logged_in.as_ref() - } - #[cfg(not(target_arch = "wasm32"))] - { - None - } - } -} - impl Default for Settings { fn default() -> Self { Self { diff --git a/src/snapshot.rs b/src/snapshot.rs index 6cd3e4b..06e14dc 100644 --- a/src/snapshot.rs +++ b/src/snapshot.rs @@ -26,9 +26,8 @@ impl FileReference { match self { Self::Path(path) => format!("file://{}", path.display()), Self::Source(source) => match source { - ImageSource::Uri(uri) => uri.to_string(), - ImageSource::Bytes { uri, .. } => uri.to_string(), - _ => "unknown://unknown".to_owned(), + ImageSource::Bytes { uri, .. } | ImageSource::Uri(uri) => uri.to_string(), + ImageSource::Texture(_) => "unknown://unknown".to_owned(), }, } } @@ -85,13 +84,12 @@ impl Snapshot { }) } - fn make_image( - &self, - state: &AppStateRef<'_>, + fn make_image<'a>( + state: &AppStateRef<'a>, uri: String, opacity: f32, show_all: bool, - ) -> eframe::egui::Image { + ) -> eframe::egui::Image<'a> { let mut image = eframe::egui::Image::new(uri) .texture_options(eframe::egui::TextureOptions { magnification: state.settings.texture_magnification, @@ -112,7 +110,7 @@ impl Snapshot { image } - pub fn old_image(&self, state: &AppStateRef<'_>) -> Option { + pub fn old_image<'a>(&self, state: &AppStateRef<'a>) -> Option> { let PageRef::DiffViewer(vs) = &state.page else { return None; }; @@ -121,10 +119,10 @@ impl Snapshot { (show_all || show_old) .then(|| self.old_uri()) .flatten() - .map(|uri| self.make_image(state, uri, 1.0, show_all)) + .map(|uri| Self::make_image(state, uri, 1.0, show_all)) } - pub fn new_image(&self, state: &AppStateRef<'_>) -> Option { + pub fn new_image<'a>(&self, state: &AppStateRef<'a>) -> Option> { let PageRef::DiffViewer(vs) = &state.page else { return None; }; @@ -133,10 +131,10 @@ impl Snapshot { (show_all || show_new) .then(|| self.new_uri()) .flatten() - .map(|new_uri| self.make_image(state, new_uri, state.settings.new_opacity, show_all)) + .map(|new_uri| Self::make_image(state, new_uri, state.settings.new_opacity, show_all)) } - pub fn diff_image(&self, state: &AppStateRef<'_>) -> Option { + pub fn diff_image<'a>(&self, state: &AppStateRef<'a>) -> Option> { let PageRef::DiffViewer(vs) = &state.page else { return None; }; @@ -145,6 +143,6 @@ impl Snapshot { (show_all || show_diff) .then(|| self.diff_uri(state.settings.use_original_diff, state.settings.options)) .flatten() - .map(|diff_uri| self.make_image(state, diff_uri, state.settings.diff_opacity, show_all)) + .map(|diff_uri| Self::make_image(state, diff_uri, state.settings.diff_opacity, show_all)) } } diff --git a/src/state.rs b/src/state.rs index b3ef413..117bcba 100644 --- a/src/state.rs +++ b/src/state.rs @@ -209,7 +209,7 @@ impl AppState { pub fn handle(&mut self, ctx: &Context, command: SystemCommand) { match command { SystemCommand::Open(source) => { - let loader = source.load(ctx.clone(), self); + let loader = source.load(ctx, self); self.page = Page::DiffViewer(ViewerState { filter: String::new(), index: 0, @@ -249,7 +249,7 @@ impl AppState { } impl ViewerState { - pub fn handle(&mut self, ctx: &Context, command: ViewerSystemCommand) { + pub fn handle(&mut self, _ctx: &Context, command: ViewerSystemCommand) { match command { ViewerSystemCommand::SetFilter(filter) => { self.filter = filter; diff --git a/src/viewer/diff_view.rs b/src/viewer/diff_view.rs index c817eaf..d973e17 100644 --- a/src/viewer/diff_view.rs +++ b/src/viewer/diff_view.rs @@ -31,7 +31,7 @@ pub fn diff_view(ui: &mut Ui, state: &ViewerAppStateRef<'_>) { let new = snapshot.new_image(state.app); let diff = snapshot.diff_image(state.app); - let is_loading = |maybe_image: &Option| { + let is_loading = |maybe_image: &Option>| { maybe_image .as_ref() .map(|img| { From c95801f98847d60260690c723f55a803eec4b613 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Tue, 30 Sep 2025 16:56:05 +0200 Subject: [PATCH 16/25] Fixes --- src/app.rs | 6 +++++- src/cli.rs | 4 +--- src/github/pr.rs | 8 +++++--- src/lib.rs | 3 --- src/loaders/archive_loader.rs | 2 +- src/loaders/mod.rs | 2 +- src/main.rs | 2 +- src/snapshot.rs | 4 +++- 8 files changed, 17 insertions(+), 14 deletions(-) diff --git a/src/app.rs b/src/app.rs index 3b51e8d..af30d66 100644 --- a/src/app.rs +++ b/src/app.rs @@ -16,7 +16,11 @@ pub struct App { } impl App { - pub fn new(cc: &eframe::CreationContext<'_>, source: Option, config: Config) -> Self { + pub fn new( + cc: &eframe::CreationContext<'_>, + source: Option, + config: Config, + ) -> Self { re_ui::apply_style_and_install_loaders(&cc.egui_ctx); let settings: Settings = cc diff --git a/src/cli.rs b/src/cli.rs index 5ca91de..462f034 100644 --- a/src/cli.rs +++ b/src/cli.rs @@ -1,8 +1,6 @@ use clap::{Parser, Subcommand}; use kitdiff::DiffSource; use kitdiff::github::auth::parse_github_artifact_url; -use kitdiff::github::model::GithubArtifactLink; -use octocrab::models::ArtifactId; #[derive(Parser)] #[command(name = "kitdiff")] @@ -56,7 +54,7 @@ impl Commands { if let Some(link) = parse_github_artifact_url(url) { DiffSource::GHArtifact(link) } else { - panic!("Invalid GitHub artifact URL: {}", url); + panic!("Invalid GitHub artifact URL: {url}"); } } } diff --git a/src/github/pr.rs b/src/github/pr.rs index 26aefd8..eed78d8 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -2,8 +2,8 @@ use crate::DiffSource; use eframe::egui; use eframe::egui::{Button, Context, ScrollArea, Spinner}; use egui_inbox::UiInbox; -use futures::stream::FuturesUnordered; use futures::TryStreamExt as _; +use futures::stream::FuturesUnordered; use graphql_client::GraphQLQuery; use octocrab::Octocrab; use re_ui::egui_ext::boxed_widget::BoxedWidgetLocalExt as _; @@ -50,7 +50,9 @@ pub fn parse_github_pr_url(url: &str) -> Result<(String, String, u32), String> { let user = parts[0].to_owned(); let repo = parts[1].to_owned(); - let pr_number = parts[3].parse::().map_err(|_err| "Invalid PR number")?; + let pr_number = parts[3] + .parse::() + .map_err(|_err| "Invalid PR number")?; Ok((user, repo, pr_number)) } @@ -95,7 +97,7 @@ pub struct GithubPr { pub(crate) struct PrWithCommits { title: String, head_branch: String, - #[allow(dead_code)] + #[expect(dead_code)] base_branch: String, commits: Vec, artifacts: HashMap>>>, diff --git a/src/lib.rs b/src/lib.rs index aa6b76b..bd8dfae 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -2,10 +2,7 @@ use crate::github::model::{GithubArtifactLink, GithubPrLink}; pub use crate::loaders::{DataReference, SnapshotLoader}; use crate::state::AppState; use eframe::egui::Context; -use eframe::egui::load::Bytes; -use std::any::Any; use std::path::PathBuf; -use crate::snapshot::FileReference; pub mod app; mod bar; diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs index e0c9be7..279fe47 100644 --- a/src/loaders/archive_loader.rs +++ b/src/loaders/archive_loader.rs @@ -3,7 +3,7 @@ use crate::snapshot::{FileReference, Snapshot}; use anyhow::{Error, Result}; use bytes::Bytes; use eframe::egui::{Context, ImageSource}; -use egui_inbox::{UiInbox, UiInboxSender}; +use egui_inbox::UiInbox; use flate2::read::GzDecoder; use std::borrow::Cow; use std::collections::HashMap; diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index 6c58517..d886a60 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -16,7 +16,7 @@ pub trait LoadSnapshots { /// State is separate so that snapshots can be streamed in fn state(&self) -> Poll>; - #[allow(unused_variables)] + #[expect(unused_variables)] fn extra_ui(&self, ui: &mut egui::Ui, state: &AppStateRef<'_>) {} fn files_header(&self) -> String; diff --git a/src/main.rs b/src/main.rs index 4f11687..31be4aa 100644 --- a/src/main.rs +++ b/src/main.rs @@ -3,9 +3,9 @@ mod cli; #[cfg(not(target_arch = "wasm32"))] use eframe::NativeOptions; +use kitdiff::DiffSource; use kitdiff::app::App; use kitdiff::config::Config; -use kitdiff::{DataReference, DiffSource}; #[cfg(not(target_arch = "wasm32"))] fn main() -> eframe::Result<()> { diff --git a/src/snapshot.rs b/src/snapshot.rs index 06e14dc..9fd4b55 100644 --- a/src/snapshot.rs +++ b/src/snapshot.rs @@ -143,6 +143,8 @@ impl Snapshot { (show_all || show_diff) .then(|| self.diff_uri(state.settings.use_original_diff, state.settings.options)) .flatten() - .map(|diff_uri| Self::make_image(state, diff_uri, state.settings.diff_opacity, show_all)) + .map(|diff_uri| { + Self::make_image(state, diff_uri, state.settings.diff_opacity, show_all) + }) } } From cb2d954be994b22c2a2fc59721a2397d10ef8124 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 11:51:51 +0200 Subject: [PATCH 17/25] Native auth and improved auth flow --- Cargo.lock | 60 +++++++ Cargo.toml | 3 +- clippy.toml | 4 +- src/github/auth.rs | 248 ++++++++------------------- src/github/auth/handle_redirect.html | 26 +++ src/github/auth/native.rs | 66 +++++++ src/github/auth/wasm.rs | 31 ++++ src/github/pr.rs | 4 +- src/main.rs | 2 +- src/state.rs | 2 +- 10 files changed, 266 insertions(+), 180 deletions(-) create mode 100644 src/github/auth/handle_redirect.html create mode 100644 src/github/auth/native.rs create mode 100644 src/github/auth/wasm.rs diff --git a/Cargo.lock b/Cargo.lock index 131e41a..9ac22fc 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -718,6 +718,58 @@ dependencies = [ "arrayvec", ] +[[package]] +name = "axum" +version = "0.8.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8a18ed336352031311f4e0b4dd2ff392d4fbb370777c9d18d7fc9d7359f73871" +dependencies = [ + "axum-core", + "bytes", + "form_urlencoded", + "futures-util", + "http", + "http-body", + "http-body-util", + "hyper", + "hyper-util", + "itoa", + "matchit", + "memchr", + "mime", + "percent-encoding", + "pin-project-lite", + "serde_core", + "serde_json", + "serde_path_to_error", + "serde_urlencoded", + "sync_wrapper", + "tokio", + "tower", + "tower-layer", + "tower-service", + "tracing", +] + +[[package]] +name = "axum-core" +version = "0.5.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "59446ce19cd142f8833f856eb31f3eb097812d1479ab224f54d72428ca21ea22" +dependencies = [ + "bytes", + "futures-core", + "http", + "http-body", + "http-body-util", + "mime", + "pin-project-lite", + "sync_wrapper", + "tower-layer", + "tower-service", + "tracing", +] + [[package]] name = "az" version = "1.2.1" @@ -3116,6 +3168,7 @@ name = "kitdiff" version = "0.1.0" dependencies = [ "anyhow", + "axum", "bytes", "chrono", "clap", @@ -3140,6 +3193,7 @@ dependencies = [ "reqwest", "serde", "serde_json", + "serde_urlencoded", "tar", "tempfile", "thiserror 1.0.69", @@ -3418,6 +3472,12 @@ dependencies = [ "libc", ] +[[package]] +name = "matchit" +version = "0.8.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "47e1ffaa40ddd1f3ed91f717a33c8c0ee23fff369e3aa8772b9605cc1d22f4c3" + [[package]] name = "maybe-rayon" version = "0.1.1" diff --git a/Cargo.toml b/Cargo.toml index 096912d..fe3f949 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -42,9 +42,11 @@ thiserror = "1.0.69" bytes = "1.10.1" reqwest = "0.12.23" hello_egui_utils = "0.9.0" +serde_urlencoded = "0.7" # native: [target.'cfg(not(target_arch = "wasm32"))'.dependencies] +axum = "0.8.6" env_logger = "0.11.8" ignore = { version = "0.4" } clap = { version = "4.0", features = ["derive"] } @@ -189,7 +191,6 @@ manual_string_new = "warn" map_err_ignore = "warn" map_flatten = "warn" match_bool = "warn" -match_on_vec_items = "warn" match_same_arms = "warn" match_wild_err_arm = "warn" match_wildcard_for_single_variants = "warn" diff --git a/clippy.toml b/clippy.toml index f71ee7d..dfde28d 100644 --- a/clippy.toml +++ b/clippy.toml @@ -28,7 +28,7 @@ too-many-lines-threshold = 200 # ----------------------------------------------------------------------------- # https://rust-lang.github.io/rust-clippy/master/index.html#disallowed_macros -disallowed-macros = ['dbg'] +disallowed-macros = ['std::dbg'] # https://rust-lang.github.io/rust-clippy/master/index.html#disallowed_methods disallowed-methods = [ @@ -50,8 +50,6 @@ disallowed-names = [] # https://rust-lang.github.io/rust-clippy/master/index.html#disallowed_types disallowed-types = [ - { path = "ring::digest::SHA1_FOR_LEGACY_USE_ONLY", reason = "SHA1 is cryptographically broken" }, - { path = "std::sync::Condvar", reason = "Use parking_lot instead" }, { path = "std::sync::Mutex", reason = "Use parking_lot instead" }, { path = "std::sync::RwLock", reason = "Use parking_lot instead" }, diff --git a/src/github/auth.rs b/src/github/auth.rs index 41bc6f2..801194d 100644 --- a/src/github/auth.rs +++ b/src/github/auth.rs @@ -1,12 +1,21 @@ use crate::github::model::{GithubArtifactLink, GithubRepoLink}; use crate::state::SystemCommand; use eframe::egui; +use eframe::egui::{Context, ViewportCommand}; +use egui_inbox::{UiInbox, UiInboxSender}; use ehttp; -use octocrab::models::ArtifactId; +use octocrab::models::{ArtifactId, Author}; use serde_json; use std::fmt; use std::sync::mpsc; +#[cfg(target_arch = "wasm32")] +#[path = "auth/wasm.rs"] +mod auth_impl; +#[cfg(not(target_arch = "wasm32"))] +#[path = "auth/native.rs"] +mod auth_impl; + pub enum GithubAuthCommand { Login, Logout, @@ -34,11 +43,8 @@ pub struct LoggedInState { #[derive(Debug)] pub struct GitHubAuth { - supabase_url: String, - supabase_anon_key: String, state: AuthState, - auth_sender: AuthSender, - auth_receiver: AuthReceiver, + inbox: UiInbox, } impl GitHubAuth { @@ -61,34 +67,13 @@ impl GitHubAuth { } } -#[derive(Debug)] -pub enum AuthError { - NetworkError(String), - ParseError(String), - AuthenticationError(String), -} - -impl fmt::Display for AuthError { - fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { - match self { - Self::NetworkError(msg) => write!(f, "Network error: {msg}"), - Self::ParseError(msg) => write!(f, "Parse error: {msg}"), - Self::AuthenticationError(msg) => write!(f, "Authentication error: {msg}"), - } - } -} - -impl std::error::Error for AuthError {} - #[derive(Debug, Clone)] pub enum AuthEvent { LoginSuccessful(AuthState), - LogoutCompleted, Error(String), } -pub type AuthSender = mpsc::Sender; -pub type AuthReceiver = mpsc::Receiver; +pub type AuthSender = UiInboxSender; // Helper function to get current timestamp in seconds fn get_current_timestamp() -> u64 { @@ -140,170 +125,93 @@ pub fn github_artifact_api_url(owner: &str, repo: &str, artifact_id: &str) -> St format!("https://api.github.com/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip") } -impl GitHubAuth { - pub fn new(state: AuthState) -> Self { - // Supabase configuration - let supabase_url = "https://fqhsaeyjqrjmlkqflvho.supabase.co".to_owned(); // Replace with your project - let supabase_anon_key = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZxaHNhZXlqcXJqbWxrcWZsdmhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTgyMTk4MzIsImV4cCI6MjA3Mzc5NTgzMn0.TuhMjHhBCNyKquyVWq3djOfpBVDhcpSmNRWSErpseuw".to_owned(); // Replace with your anon key +#[derive(serde::Deserialize)] +struct AuthFragment { + access_token: String, + provider_token: String, // The github token + expires_at: u64, +} + +fn parse_supabase_fragment(fragment: &str) -> anyhow::Result { + Ok(serde_urlencoded::from_str(fragment)?) +} - let (auth_sender, auth_receiver) = mpsc::channel(); +impl GitHubAuth { + pub const SUPABASE_URL: &'static str = "https://fqhsaeyjqrjmlkqflvho.supabase.co"; + pub const SUPABASE_ANON_KEY: &'static str = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZxaHNhZXlqcXJqbWxrcWZsdmhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTgyMTk4MzIsImV4cCI6MjA3Mzc5NTgzMn0.TuhMjHhBCNyKquyVWq3djOfpBVDhcpSmNRWSErpseuw"; + pub fn new(state: AuthState) -> Self { let mut this = Self { - supabase_url, - supabase_anon_key, state, - auth_sender, - auth_receiver, + inbox: UiInbox::new(), }; - this.check_for_auth_callback(); + auth_impl::check_for_auth_callback(this.inbox.sender()); this } - pub fn handle(&mut self, cmd: GithubAuthCommand) { + pub fn handle(&mut self, ctx: &Context, cmd: GithubAuthCommand) { match cmd { - GithubAuthCommand::Login => { - self.login_github(); - } + GithubAuthCommand::Login => auth_impl::login_github(&ctx, self.inbox.sender()), GithubAuthCommand::Logout => { self.logout(); } } } - pub fn login_github(&self) { - #[cfg(target_arch = "wasm32")] - { - if let Some(window) = web_sys::window() { - if let Ok(origin) = window.location().href() { - let auth_url = format!( - "{}/auth/v1/authorize?provider=github&redirect_to={}&scopes=repo", - self.supabase_url, origin - ); - - let _ = window.location().set_href(&auth_url); - } - } + pub fn auth_url(origin: &str) -> String { + #[derive(serde::Serialize)] + struct AuthParams { + redirect_to: String, + provider: String, + scopes: String, } - } - pub fn check_for_auth_callback(&mut self) { - #[cfg(target_arch = "wasm32")] - { - // Check if we have auth tokens in the URL fragment - if let Some(window) = web_sys::window() { - if let Ok(hash) = window.location().hash() { - if hash.contains("access_token") { - // Parse tokens directly from URL fragment - let tokens = self.parse_url_fragment(&hash); - - if let (Some(access_token), Some(provider_token)) = - (tokens.get("access_token"), tokens.get("provider_token")) - { - let sender = self.auth_sender.clone(); - let github_token = provider_token.clone(); - - let access_token = access_token.clone(); - - wasm_bindgen_futures::spawn_local(async move { - match Self::fetch_user_info(&github_token).await { - Ok(username) => { - let expires_at = get_current_timestamp() + (24 * 60 * 60); // 24 hours - - let logged_in_state = LoggedInState { - supabase_token: access_token.clone(), - github_token: github_token, - expires_at, - username, - user_image: None, // Could fetch user image if needed - }; - let auth_state = AuthState { - logged_in: Some(logged_in_state), - }; - let _ = sender.send(AuthEvent::LoginSuccessful(auth_state)); - - // Clear the URL hash - if let Some(window) = web_sys::window() { - if let Ok(history) = window.history() { - let _ = history.replace_state_with_url( - &wasm_bindgen::JsValue::NULL, - "", - Some("./"), - ); - } - } - } - Err(e) => { - let _ = sender.send(AuthEvent::Error(format!( - "Failed to fetch user info: {}", - e - ))); - } - } - }); - } else { - let _ = self.auth_sender.send(AuthEvent::Error( - "Missing required tokens in OAuth callback".to_string(), - )); - } - } - } - } - } + let query = serde_urlencoded::to_string(&AuthParams { + redirect_to: origin.to_string(), + provider: "github".to_string(), + scopes: "repo".to_string(), + }).unwrap_or_default(); + + format!( + "{}/auth/v1/authorize?{}", + Self::SUPABASE_URL, + query + ) } - #[cfg(target_arch = "wasm32")] - fn parse_url_fragment(&self, hash: &str) -> std::collections::HashMap { - let mut params = std::collections::HashMap::new(); - - // Remove the leading # if present - let hash = hash.strip_prefix('#').unwrap_or(hash); - - // Parse key=value pairs separated by & - for pair in hash.split('&') { - if let Some((key, value)) = pair.split_once('=') { - // URL decode the value - let decoded_value = js_sys::decode_uri_component(value) - .unwrap_or_else(|_| value.into()) - .as_string() - .unwrap_or_else(|| value.to_string()); - params.insert(key.to_string(), decoded_value); + async fn handle_callback_fragment(tx: AuthSender, data: AuthFragment) { + let username = GitHubAuth::fetch_user_info(&data.provider_token).await; + + match username { + Ok(username) => { + tx.send(AuthEvent::LoginSuccessful(AuthState { + logged_in: Some(LoggedInState { + github_token: data.provider_token, + supabase_token: data.access_token, + expires_at: data.expires_at, + username: username.login, + user_image: Some(username.avatar_url.to_string()), + }), + })) + .ok(); + } + Err(err) => { + tx.send(AuthEvent::Error(format!( + "Failed to fetch user info: {}", + err + ))) + .ok(); } } - - params } - async fn fetch_user_info(token: &str) -> Result { - let mut request = ehttp::Request::get("https://api.github.com/user"); - request - .headers - .insert("Authorization".to_owned(), format!("Bearer {token}")); - request - .headers - .insert("User-Agent".to_owned(), "kitdiff-app".to_owned()); - - let response = ehttp::fetch_async(request) - .await - .map_err(|e| AuthError::NetworkError(format!("Failed to fetch user info: {e}")))?; - - if response.status == 200 { - let user_info: serde_json::Value = serde_json::from_slice(&response.bytes) - .map_err(|e| AuthError::ParseError(format!("Failed to parse user info: {e}")))?; - - let username = user_info["login"] - .as_str() - .ok_or_else(|| AuthError::ParseError("Username not found in response".to_owned()))? - .to_owned(); - - Ok(username) - } else { - Err(AuthError::NetworkError(format!( - "GitHub API returned status: {}", - response.status - ))) - } + async fn fetch_user_info(token: &str) -> anyhow::Result { + let client = GitHubAuth::make_client(Some(token)); + let user = client.current().user().await?; + + Ok(user) } pub fn is_authenticated(&self) -> bool { @@ -331,7 +239,6 @@ impl GitHubAuth { pub fn logout(&mut self) { self.state.logged_in = None; - let _ = self.auth_sender.send(AuthEvent::LogoutCompleted); } pub fn get_auth_state(&self) -> &AuthState { @@ -339,19 +246,16 @@ impl GitHubAuth { } pub fn update(&mut self, _ctx: &egui::Context) { - // Check for auth callback in URL - self.check_for_auth_callback(); - // Check for messages from auth flow - while let Ok(event) = self.auth_receiver.try_recv() { + for event in self.inbox.read(_ctx) { match event { AuthEvent::LoginSuccessful(state) => { self.state = state; + _ctx.send_viewport_cmd(ViewportCommand::Focus); } AuthEvent::Error(error) => { eprintln!("Auth error: {error}"); } - _ => {} } } } diff --git a/src/github/auth/handle_redirect.html b/src/github/auth/handle_redirect.html new file mode 100644 index 0000000..553dd27 --- /dev/null +++ b/src/github/auth/handle_redirect.html @@ -0,0 +1,26 @@ + + + Handling Login + + + +Redirecting... + + diff --git a/src/github/auth/native.rs b/src/github/auth/native.rs new file mode 100644 index 0000000..3777909 --- /dev/null +++ b/src/github/auth/native.rs @@ -0,0 +1,66 @@ +use crate::github::auth::{ + AuthEvent, AuthSender, AuthState, GitHubAuth, LoggedInState, parse_supabase_fragment, +}; +use axum::Json; +use axum::extract::State; +use axum::http::StatusCode; +use axum::response::{Html, Response}; +use eframe::egui; +use eframe::egui::{Context, OpenUrl}; +use std::net::{IpAddr, Ipv4Addr, SocketAddr, SocketAddrV4}; +use tokio::spawn; + +pub fn login_github(ctx: &Context, tx: AuthSender) { + let ctx = ctx.clone(); + spawn(async move { + if let Err(err) = login(ctx, tx).await { + eprintln!("Error during GitHub login: {:?}", err); + } + }); +} + +pub fn check_for_auth_callback(sender: AuthSender) { + // Not implemented for native +} + + +pub async fn login(ctx: Context, tx: AuthSender) -> anyhow::Result<()> { + let listener = tokio::net::TcpListener::bind(SocketAddrV4::new(Ipv4Addr::LOCALHOST, 0)).await?; + + let addr = listener.local_addr()?; + + ctx.open_url(OpenUrl::new_tab(GitHubAuth::auth_url(&format!( + "http://{addr}" + )))); + + let router = axum::Router::new() + .route("/", axum::routing::get(home_route)) + .route("/api/auth", axum::routing::post(auth_route)) + .with_state(tx); + + axum::serve(listener, router).await?; + + Ok(()) +} + +pub async fn home_route() -> Html<&'static str> { + Html(include_str!("handle_redirect.html")) +} + +#[derive(serde::Deserialize)] +struct AuthBody { + fragment: String, +} + +async fn auth_route( + State(tx): State, + Json(body): Json, +) -> Result { + let fragment = body.fragment; + + let data = parse_supabase_fragment(&fragment).map_err(|_| StatusCode::BAD_REQUEST)?; + + GitHubAuth::handle_callback_fragment(tx, data).await; + + Ok("Success".to_string()) +} diff --git a/src/github/auth/wasm.rs b/src/github/auth/wasm.rs new file mode 100644 index 0000000..1c2478a --- /dev/null +++ b/src/github/auth/wasm.rs @@ -0,0 +1,31 @@ +use crate::github::auth::{AuthSender, GitHubAuth, parse_supabase_fragment}; +use eframe::egui; +use eframe::egui::OpenUrl; +use hello_egui_utils::spawn; +use wasm_bindgen::JsValue; + +pub fn login_github(ctx: &egui::Context, _tx: AuthSender) { + if let Some(window) = web_sys::window() { + if let Ok(origin) = window.location().href() { + let auth_url = GitHubAuth::auth_url(&origin); + ctx.open_url(OpenUrl::same_tab(auth_url)); + } + } +} + +pub fn check_for_auth_callback(sender: AuthSender) { + if let Some(window) = web_sys::window() { + if let Ok(hash) = window.location().hash() { + if let Ok(hash) = parse_supabase_fragment(hash.strip_prefix('#').unwrap_or(&hash)) { + // Remove the hash from the URL to clean it up + let path = window.location().pathname().unwrap_or_default(); + let search = window.location().search().unwrap_or_default(); + let new_url = format!("{}{}", path, search); + let _ = window.history().unwrap().replace_state_with_url(&JsValue::NULL, "", Some(&new_url)); + spawn(async move { + GitHubAuth::handle_callback_fragment(sender, hash).await; + }); + } + } + } +} diff --git a/src/github/pr.rs b/src/github/pr.rs index eed78d8..bab315d 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -94,7 +94,7 @@ pub struct GithubPr { } #[derive(Debug)] -pub(crate) struct PrWithCommits { +pub struct PrWithCommits { title: String, head_branch: String, #[expect(dead_code)] @@ -104,7 +104,7 @@ pub(crate) struct PrWithCommits { } #[derive(Debug)] -pub(crate) struct ArtifactData { +pub struct ArtifactData { data: WorkflowListArtifact, run_id: RunId, } diff --git a/src/main.rs b/src/main.rs index 31be4aa..cc81fb1 100644 --- a/src/main.rs +++ b/src/main.rs @@ -62,7 +62,7 @@ fn parse_url_query_params() -> Option { || decoded_url.ends_with(".tar.gz") || decoded_url.ends_with(".tgz") { - return Some(DiffSource::Archive(DataReference::Url(decoded_url))); + return Some(DiffSource::Archive(kitdiff::DataReference::Url(decoded_url))); } } } diff --git a/src/state.rs b/src/state.rs index 117bcba..d614659 100644 --- a/src/state.rs +++ b/src/state.rs @@ -219,7 +219,7 @@ impl AppState { }); } SystemCommand::GithubAuth(auth) => { - self.github_auth.handle(auth); + self.github_auth.handle(ctx, auth); } SystemCommand::LoadPrDetails(url) => { self.github_pr = Some(GithubPr::new(url, self.github_auth.client())); From b9d5dce12a9721bf66dee7f5ca3acb0651d8ba22 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 12:12:37 +0200 Subject: [PATCH 18/25] Reload on login --- src/app.rs | 4 ++-- src/github/auth.rs | 7 +++++-- src/loaders/archive_loader.rs | 19 ++++++++++++++----- src/loaders/gh_archive_loader.rs | 4 ++++ src/loaders/mod.rs | 4 ++++ src/loaders/pr_loader.rs | 4 ++++ src/native_loaders/file_loader.rs | 5 +++++ src/native_loaders/git_loader.rs | 5 +++++ src/state.rs | 18 ++++++++++++++++-- 9 files changed, 59 insertions(+), 11 deletions(-) diff --git a/src/app.rs b/src/app.rs index af30d66..be9dc3b 100644 --- a/src/app.rs +++ b/src/app.rs @@ -28,13 +28,13 @@ impl App { .and_then(|s| eframe::get_value(s, eframe::APP_KEY)) .unwrap_or_default(); - let state = AppState::new(settings, config); + let inbox = UiInbox::new(); + let state = AppState::new(settings, config, inbox.sender()); install_image_loaders(&cc.egui_ctx); let diff_loader = Arc::new(DiffImageLoader::default()); cc.egui_ctx.add_image_loader(diff_loader.clone()); - let inbox = UiInbox::new(); if let Some(source) = source { inbox.sender().send(SystemCommand::Open(source)).ok(); diff --git a/src/github/auth.rs b/src/github/auth.rs index 801194d..0bcb630 100644 --- a/src/github/auth.rs +++ b/src/github/auth.rs @@ -45,6 +45,7 @@ pub struct LoggedInState { pub struct GitHubAuth { state: AuthState, inbox: UiInbox, + sender: UiInboxSender, } impl GitHubAuth { @@ -140,10 +141,11 @@ impl GitHubAuth { pub const SUPABASE_URL: &'static str = "https://fqhsaeyjqrjmlkqflvho.supabase.co"; pub const SUPABASE_ANON_KEY: &'static str = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZxaHNhZXlqcXJqbWxrcWZsdmhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTgyMTk4MzIsImV4cCI6MjA3Mzc5NTgzMn0.TuhMjHhBCNyKquyVWq3djOfpBVDhcpSmNRWSErpseuw"; - pub fn new(state: AuthState) -> Self { - let mut this = Self { + pub fn new(state: AuthState, sender: UiInboxSender) -> Self { + let this = Self { state, inbox: UiInbox::new(), + sender, }; auth_impl::check_for_auth_callback(this.inbox.sender()); @@ -252,6 +254,7 @@ impl GitHubAuth { AuthEvent::LoginSuccessful(state) => { self.state = state; _ctx.send_viewport_cmd(ViewportCommand::Focus); + self.sender.send(SystemCommand::Refresh).ok(); } AuthEvent::Error(error) => { eprintln!("Auth error: {error}"); diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs index 279fe47..e4cffcd 100644 --- a/src/loaders/archive_loader.rs +++ b/src/loaders/archive_loader.rs @@ -18,6 +18,7 @@ pub struct ArchiveLoader { data: Poll>>, inbox: UiInbox>>, name: String, + pub reference: DataReference, } fn is_zip(data: &[u8]) -> bool { @@ -30,15 +31,19 @@ fn is_tar_gz(data: &[u8]) -> bool { impl ArchiveLoader { pub fn new(data: DataReference) -> Self { - let name = data.file_name().to_owned(); let mut inbox = UiInbox::new(); + { + let data = data.clone(); - inbox.spawn(|tx| async move { - let result = run_discovery(data).await; - tx.send(result).ok(); - }); + inbox.spawn(|tx| async move { + let result = run_discovery(data).await; + tx.send(result).ok(); + }); + } + let name = data.file_name().to_owned(); Self { + reference: data, name, data: Poll::Pending, inbox, @@ -78,6 +83,10 @@ impl LoadSnapshots for ArchiveLoader { Poll::Pending => Poll::Pending, } } + + fn refresh(&mut self, _client: octocrab::Octocrab) { + *self = ArchiveLoader::new(self.reference.clone()); + } } pub async fn run_discovery(file: DataReference) -> anyhow::Result> { diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs index cdcc1ac..2c5c7ea 100644 --- a/src/loaders/gh_archive_loader.rs +++ b/src/loaders/gh_archive_loader.rs @@ -140,4 +140,8 @@ impl LoadSnapshots for GHArtifactLoader { } } } + + fn refresh(&mut self, client: Octocrab) { + *self = Self::new(client, self.artifact.clone()); + } } diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index d886a60..1743974 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -3,6 +3,7 @@ use crate::state::AppStateRef; use eframe::egui; use std::path::PathBuf; use std::task::Poll; +use octocrab::Octocrab; pub mod archive_loader; pub mod gh_archive_loader; @@ -10,6 +11,8 @@ pub mod pr_loader; pub trait LoadSnapshots { fn update(&mut self, ctx: &egui::Context); + + fn refresh(&mut self, client: Octocrab); fn snapshots(&self) -> &[Snapshot]; @@ -20,6 +23,7 @@ pub trait LoadSnapshots { fn extra_ui(&self, ui: &mut egui::Ui, state: &AppStateRef<'_>) {} fn files_header(&self) -> String; + } pub type SnapshotLoader = Box; diff --git a/src/loaders/pr_loader.rs b/src/loaders/pr_loader.rs index 3a4dd8e..dbb4ffc 100644 --- a/src/loaders/pr_loader.rs +++ b/src/loaders/pr_loader.rs @@ -125,6 +125,10 @@ impl LoadSnapshots for PrLoader { self.pr_info.update(ctx); } + fn refresh(&mut self, client: Octocrab) { + *self = Self::new(self.link.clone(), client); + } + fn snapshots(&self) -> &[Snapshot] { &self.snapshots } diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 8cb1d52..16e7cd5 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -7,6 +7,7 @@ use ignore::WalkBuilder; use ignore::types::TypesBuilder; use std::path::{Path, PathBuf}; use std::task::Poll; +use octocrab::Octocrab; pub struct FileLoader { base_path: PathBuf, @@ -67,6 +68,10 @@ impl LoadSnapshots for FileLoader { } } + fn refresh(&mut self, client: Octocrab) { + *self = Self::new(self.base_path.clone()); + } + fn snapshots(&self) -> &[Snapshot] { &self.snapshots } diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index 2d0bd5f..43ee856 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -9,6 +9,7 @@ use std::fmt::Display; use std::path::{Path, PathBuf}; use std::str; use std::task::Poll; +use octocrab::Octocrab; enum Command { Snapshot(Snapshot), @@ -85,6 +86,10 @@ impl LoadSnapshots for GitLoader { } } + fn refresh(&mut self, _client: Octocrab) { + *self = Self::new(self.base_path.clone()); + } + fn snapshots(&self) -> &[Snapshot] { &self.snapshots } diff --git a/src/state.rs b/src/state.rs index d614659..e5fff5f 100644 --- a/src/state.rs +++ b/src/state.rs @@ -8,6 +8,7 @@ use crate::settings::Settings; use crate::snapshot::Snapshot; use eframe::egui::Context; use egui_inbox::UiInboxSender; +use octocrab::Octocrab; use std::ops::Deref; pub struct AppState { @@ -68,9 +69,9 @@ impl ViewFilter { } impl AppState { - pub fn new(settings: Settings, config: Config) -> Self { + pub fn new(settings: Settings, config: Config, sender: UiInboxSender) -> Self { Self { - github_auth: GitHubAuth::new(settings.auth.clone()), + github_auth: GitHubAuth::new(settings.auth.clone(), sender), github_pr: None, settings, config, @@ -191,6 +192,7 @@ pub enum SystemCommand { LoadPrDetails(GithubPrLink), UpdateSettings(Settings), ViewerCommand(ViewerSystemCommand), + Refresh, } pub enum ViewerSystemCommand { @@ -235,6 +237,13 @@ impl AppState { eprintln!("Received ViewerCommand but not in DiffViewer page"); // TODO: Better logging } } + SystemCommand::Refresh => match &mut self.page { + Page::Home => {} + Page::DiffViewer(viewer) => { + let client = self.github_auth.client(); + viewer.refresh(client); + } + }, } } @@ -266,4 +275,9 @@ impl ViewerState { } } } + + pub fn refresh(&mut self, client: Octocrab) { + self.loader.refresh(client); + self.index = 0; + } } From db49ee611a65c77e73e90e18f260413000b11ef7 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 12:21:28 +0200 Subject: [PATCH 19/25] Clippy --- src/app.rs | 1 - src/github/auth.rs | 30 +++++++++++------------------- src/github/auth/native.rs | 18 +++++++----------- src/github/auth/wasm.rs | 6 +++++- src/loaders/archive_loader.rs | 2 +- src/loaders/mod.rs | 5 ++--- src/main.rs | 4 +++- src/native_loaders/file_loader.rs | 2 +- src/native_loaders/git_loader.rs | 2 +- 9 files changed, 31 insertions(+), 39 deletions(-) diff --git a/src/app.rs b/src/app.rs index be9dc3b..f2bc659 100644 --- a/src/app.rs +++ b/src/app.rs @@ -35,7 +35,6 @@ impl App { let diff_loader = Arc::new(DiffImageLoader::default()); cc.egui_ctx.add_image_loader(diff_loader.clone()); - if let Some(source) = source { inbox.sender().send(SystemCommand::Open(source)).ok(); } diff --git a/src/github/auth.rs b/src/github/auth.rs index 0bcb630..fd19246 100644 --- a/src/github/auth.rs +++ b/src/github/auth.rs @@ -3,11 +3,7 @@ use crate::state::SystemCommand; use eframe::egui; use eframe::egui::{Context, ViewportCommand}; use egui_inbox::{UiInbox, UiInboxSender}; -use ehttp; use octocrab::models::{ArtifactId, Author}; -use serde_json; -use std::fmt; -use std::sync::mpsc; #[cfg(target_arch = "wasm32")] #[path = "auth/wasm.rs"] @@ -155,7 +151,7 @@ impl GitHubAuth { pub fn handle(&mut self, ctx: &Context, cmd: GithubAuthCommand) { match cmd { - GithubAuthCommand::Login => auth_impl::login_github(&ctx, self.inbox.sender()), + GithubAuthCommand::Login => auth_impl::login_github(ctx, self.inbox.sender()), GithubAuthCommand::Logout => { self.logout(); } @@ -171,20 +167,17 @@ impl GitHubAuth { } let query = serde_urlencoded::to_string(&AuthParams { - redirect_to: origin.to_string(), - provider: "github".to_string(), - scopes: "repo".to_string(), - }).unwrap_or_default(); - - format!( - "{}/auth/v1/authorize?{}", - Self::SUPABASE_URL, - query - ) + redirect_to: origin.to_owned(), + provider: "github".to_owned(), + scopes: "repo".to_owned(), + }) + .unwrap_or_default(); + + format!("{}/auth/v1/authorize?{}", Self::SUPABASE_URL, query) } async fn handle_callback_fragment(tx: AuthSender, data: AuthFragment) { - let username = GitHubAuth::fetch_user_info(&data.provider_token).await; + let username = Self::fetch_user_info(&data.provider_token).await; match username { Ok(username) => { @@ -201,8 +194,7 @@ impl GitHubAuth { } Err(err) => { tx.send(AuthEvent::Error(format!( - "Failed to fetch user info: {}", - err + "Failed to fetch user info: {err}" ))) .ok(); } @@ -210,7 +202,7 @@ impl GitHubAuth { } async fn fetch_user_info(token: &str) -> anyhow::Result { - let client = GitHubAuth::make_client(Some(token)); + let client = Self::make_client(Some(token)); let user = client.current().user().await?; Ok(user) diff --git a/src/github/auth/native.rs b/src/github/auth/native.rs index 3777909..197c15d 100644 --- a/src/github/auth/native.rs +++ b/src/github/auth/native.rs @@ -1,20 +1,17 @@ -use crate::github::auth::{ - AuthEvent, AuthSender, AuthState, GitHubAuth, LoggedInState, parse_supabase_fragment, -}; +use crate::github::auth::{AuthSender, GitHubAuth, parse_supabase_fragment}; use axum::Json; use axum::extract::State; use axum::http::StatusCode; -use axum::response::{Html, Response}; -use eframe::egui; +use axum::response::Html; use eframe::egui::{Context, OpenUrl}; -use std::net::{IpAddr, Ipv4Addr, SocketAddr, SocketAddrV4}; +use std::net::{Ipv4Addr, SocketAddrV4}; use tokio::spawn; pub fn login_github(ctx: &Context, tx: AuthSender) { let ctx = ctx.clone(); spawn(async move { if let Err(err) = login(ctx, tx).await { - eprintln!("Error during GitHub login: {:?}", err); + eprintln!("Error during GitHub login: {err:?}"); } }); } @@ -23,7 +20,6 @@ pub fn check_for_auth_callback(sender: AuthSender) { // Not implemented for native } - pub async fn login(ctx: Context, tx: AuthSender) -> anyhow::Result<()> { let listener = tokio::net::TcpListener::bind(SocketAddrV4::new(Ipv4Addr::LOCALHOST, 0)).await?; @@ -59,8 +55,8 @@ async fn auth_route( let fragment = body.fragment; let data = parse_supabase_fragment(&fragment).map_err(|_| StatusCode::BAD_REQUEST)?; - + GitHubAuth::handle_callback_fragment(tx, data).await; - - Ok("Success".to_string()) + + Ok("Success".to_owned()) } diff --git a/src/github/auth/wasm.rs b/src/github/auth/wasm.rs index 1c2478a..55889a8 100644 --- a/src/github/auth/wasm.rs +++ b/src/github/auth/wasm.rs @@ -21,7 +21,11 @@ pub fn check_for_auth_callback(sender: AuthSender) { let path = window.location().pathname().unwrap_or_default(); let search = window.location().search().unwrap_or_default(); let new_url = format!("{}{}", path, search); - let _ = window.history().unwrap().replace_state_with_url(&JsValue::NULL, "", Some(&new_url)); + let _ = window.history().unwrap().replace_state_with_url( + &JsValue::NULL, + "", + Some(&new_url), + ); spawn(async move { GitHubAuth::handle_callback_fragment(sender, hash).await; }); diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs index e4cffcd..e5c3195 100644 --- a/src/loaders/archive_loader.rs +++ b/src/loaders/archive_loader.rs @@ -85,7 +85,7 @@ impl LoadSnapshots for ArchiveLoader { } fn refresh(&mut self, _client: octocrab::Octocrab) { - *self = ArchiveLoader::new(self.reference.clone()); + *self = Self::new(self.reference.clone()); } } diff --git a/src/loaders/mod.rs b/src/loaders/mod.rs index 1743974..04c6005 100644 --- a/src/loaders/mod.rs +++ b/src/loaders/mod.rs @@ -1,9 +1,9 @@ use crate::snapshot::Snapshot; use crate::state::AppStateRef; use eframe::egui; +use octocrab::Octocrab; use std::path::PathBuf; use std::task::Poll; -use octocrab::Octocrab; pub mod archive_loader; pub mod gh_archive_loader; @@ -11,7 +11,7 @@ pub mod pr_loader; pub trait LoadSnapshots { fn update(&mut self, ctx: &egui::Context); - + fn refresh(&mut self, client: Octocrab); fn snapshots(&self) -> &[Snapshot]; @@ -23,7 +23,6 @@ pub trait LoadSnapshots { fn extra_ui(&self, ui: &mut egui::Ui, state: &AppStateRef<'_>) {} fn files_header(&self) -> String; - } pub type SnapshotLoader = Box; diff --git a/src/main.rs b/src/main.rs index cc81fb1..e21735d 100644 --- a/src/main.rs +++ b/src/main.rs @@ -62,7 +62,9 @@ fn parse_url_query_params() -> Option { || decoded_url.ends_with(".tar.gz") || decoded_url.ends_with(".tgz") { - return Some(DiffSource::Archive(kitdiff::DataReference::Url(decoded_url))); + return Some(DiffSource::Archive(kitdiff::DataReference::Url( + decoded_url, + ))); } } } diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 16e7cd5..751e502 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -5,9 +5,9 @@ use eframe::egui::Context; use egui_inbox::UiInbox; use ignore::WalkBuilder; use ignore::types::TypesBuilder; +use octocrab::Octocrab; use std::path::{Path, PathBuf}; use std::task::Poll; -use octocrab::Octocrab; pub struct FileLoader { base_path: PathBuf, diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index 43ee856..2c784eb 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -4,12 +4,12 @@ use eframe::egui::load::Bytes; use eframe::egui::{Context, ImageSource}; use egui_inbox::{UiInbox, UiInboxSender}; use git2::{ObjectType, Repository}; +use octocrab::Octocrab; use std::borrow::Cow; use std::fmt::Display; use std::path::{Path, PathBuf}; use std::str; use std::task::Poll; -use octocrab::Octocrab; enum Command { Snapshot(Snapshot), From f63ec3116e0f5d1241039347a78ec5d35ad34d86 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 13:00:19 +0200 Subject: [PATCH 20/25] Auth improvements and clippy fixes --- Cargo.lock | 1 + Cargo.toml | 1 + src/diff_image_loader.rs | 10 +- src/github/auth.rs | 57 ++++------ src/github/auth/native.rs | 14 ++- src/github/pr.rs | 172 +++++++++++++++--------------- src/loaders/archive_loader.rs | 5 +- src/loaders/gh_archive_loader.rs | 78 +++++++++++--- src/native_loaders/file_loader.rs | 2 +- 9 files changed, 198 insertions(+), 142 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index 9ac22fc..1d53b5a 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -3201,6 +3201,7 @@ dependencies = [ "wasm-bindgen", "wasm-bindgen-futures", "web-sys", + "web-time", "zip", ] diff --git a/Cargo.toml b/Cargo.toml index fe3f949..c951098 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -43,6 +43,7 @@ bytes = "1.10.1" reqwest = "0.12.23" hello_egui_utils = "0.9.0" serde_urlencoded = "0.7" +web-time = "1" # native: [target.'cfg(not(target_arch = "wasm32"))'.dependencies] diff --git a/src/diff_image_loader.rs b/src/diff_image_loader.rs index 678520c..8ae9871 100644 --- a/src/diff_image_loader.rs +++ b/src/diff_image_loader.rs @@ -6,10 +6,12 @@ use egui_extras::loaders::image_loader::ImageCrateLoader; use std::sync::Arc; use std::task::Poll; +type DiffMap = HashMap, LoadError>>; + #[derive(Default)] pub struct DiffImageLoader { image_loader: Arc, - diffs: Arc, LoadError>>>>, + diffs: Arc>, } #[derive(Debug, Clone)] @@ -47,7 +49,7 @@ impl DiffUri { } pub fn to_uri(&self) -> String { - format!("diff://{}", serde_json::to_string(self).unwrap()) + format!("diff://{}", serde_json::to_string(self).expect("Failed to serialize DiffUri")) } } @@ -114,11 +116,11 @@ impl ImageLoader for DiffImageLoader { let uri = uri.to_owned(); #[cfg(not(target_arch = "wasm32"))] - std::thread::spawn(move || { + std::thread::Builder::new().name(format!("diff for {uri}")).spawn(move || { ctx.request_repaint(); let result = load_diffs(&ctx, &old_image, &new_image, size_hint, &diff_uri); cache.lock().insert(uri, result.map(Poll::Ready)); - }); + }).expect("Failed to spawn diff thread"); #[cfg(target_arch = "wasm32")] { wasm_bindgen_futures::spawn_local(async move { diff --git a/src/github/auth.rs b/src/github/auth.rs index fd19246..06c16e1 100644 --- a/src/github/auth.rs +++ b/src/github/auth.rs @@ -72,23 +72,6 @@ pub enum AuthEvent { pub type AuthSender = UiInboxSender; -// Helper function to get current timestamp in seconds -fn get_current_timestamp() -> u64 { - #[cfg(target_arch = "wasm32")] - { - // Use JavaScript Date.now() for WASM - (js_sys::Date::now() / 1000.0) as u64 - } - - #[cfg(not(target_arch = "wasm32"))] - { - std::time::SystemTime::now() - .duration_since(std::time::UNIX_EPOCH) - .unwrap() - .as_secs() - } -} - // URL parsing utilities pub fn parse_github_artifact_url(url: &str) -> Option { // Expected format: github.com/owner/repo/actions/runs/12345/artifacts/67890 @@ -138,16 +121,34 @@ impl GitHubAuth { pub const SUPABASE_ANON_KEY: &'static str = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZxaHNhZXlqcXJqbWxrcWZsdmhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTgyMTk4MzIsImV4cCI6MjA3Mzc5NTgzMn0.TuhMjHhBCNyKquyVWq3djOfpBVDhcpSmNRWSErpseuw"; pub fn new(state: AuthState, sender: UiInboxSender) -> Self { - let this = Self { + let mut this = Self { state, inbox: UiInbox::new(), sender, }; + // if this.check_expired() { + // this.sender + // .send(SystemCommand::GithubAuth(GithubAuthCommand::Login)) + // .ok(); + // } auth_impl::check_for_auth_callback(this.inbox.sender()); this } + // Apparently the github token is valid indefinitely? + // fn check_expired(&mut self) -> bool { + // if let Some(logged_in) = &self.state.logged_in { + // let now = web_time::SystemTime::now() + // .duration_since(web_time::UNIX_EPOCH) + // .expect("Time went backwards") + // .as_secs(); + // dbg!(now, logged_in.expires_at); + // now >= logged_in.expires_at - 60 * 60 // When opening the app the token is valid for at least 1 hour + // } else { + // false + // } + // } pub fn handle(&mut self, ctx: &Context, cmd: GithubAuthCommand) { match cmd { @@ -208,27 +209,15 @@ impl GitHubAuth { Ok(user) } - pub fn is_authenticated(&self) -> bool { - if let Some(state) = &self.state.logged_in { - let now = get_current_timestamp(); - return now < state.expires_at; - } - false - } - pub fn get_username(&self) -> Option<&str> { self.state.logged_in.as_ref().map(|s| s.username.as_str()) } pub fn get_token(&self) -> Option<&str> { - if self.is_authenticated() { - self.state - .logged_in - .as_ref() - .map(|s| s.github_token.as_str()) - } else { - None - } + self.state + .logged_in + .as_ref() + .map(|s| s.github_token.as_str()) } pub fn logout(&mut self) { diff --git a/src/github/auth/native.rs b/src/github/auth/native.rs index 197c15d..ef8121e 100644 --- a/src/github/auth/native.rs +++ b/src/github/auth/native.rs @@ -2,7 +2,7 @@ use crate::github::auth::{AuthSender, GitHubAuth, parse_supabase_fragment}; use axum::Json; use axum::extract::State; use axum::http::StatusCode; -use axum::response::Html; +use axum::response::{Html, Response}; use eframe::egui::{Context, OpenUrl}; use std::net::{Ipv4Addr, SocketAddrV4}; use tokio::spawn; @@ -16,7 +16,8 @@ pub fn login_github(ctx: &Context, tx: AuthSender) { }); } -pub fn check_for_auth_callback(sender: AuthSender) { +#[expect(clippy::needless_pass_by_value)] +pub fn check_for_auth_callback(_sender: AuthSender) { // Not implemented for native } @@ -51,10 +52,15 @@ struct AuthBody { async fn auth_route( State(tx): State, Json(body): Json, -) -> Result { +) -> Result> { let fragment = body.fragment; - let data = parse_supabase_fragment(&fragment).map_err(|_| StatusCode::BAD_REQUEST)?; + let data = parse_supabase_fragment(&fragment).map_err(|e| { + Response::builder() + .status(StatusCode::INTERNAL_SERVER_ERROR) + .body(e.to_string()) + .expect("Failed to build error response") + })?; GitHubAuth::handle_callback_fragment(tx, data).await; diff --git a/src/github/pr.rs b/src/github/pr.rs index bab315d..3c9598b 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -19,6 +19,7 @@ use re_ui::{OnResponseExt as _, SectionCollapsingHeader, UiExt as _, icons}; // use chrono::DateTime; pub type GitObjectID = String; pub type DateTime = String; +#[allow(clippy::upper_case_acronyms)] pub type URI = String; // The paths are relative to the directory where your `Cargo.toml` is located. @@ -132,7 +133,7 @@ impl GithubPr { let client = RepoClient::new(client.clone(), link.repo.clone()); inbox.spawn(|tx| async move { let details = get_pr_commits(&client, link.pr_number).await; - let _ = tx.send(GithubPrCommand::FetchedData(details)); + tx.send(GithubPrCommand::FetchedData(details)).ok(); }); } @@ -174,10 +175,11 @@ impl GithubPr { self.inbox.spawn(move |tx| async move { let artifacts = fetch_commit_artifacts(&client, workflow_run_ids).await; - let _ = tx.send(GithubPrCommand::FetchedCommitArtifacts { + tx.send(GithubPrCommand::FetchedCommitArtifacts { sha, artifacts, - }); + }) + .ok(); }); } } @@ -217,104 +219,106 @@ async fn get_pr_commits(repo: &RepoClient, pr: PrNumber) -> Result false, - pr_details_query::CheckStatusState::IN_PROGRESS => true, - pr_details_query::CheckStatusState::PENDING => true, - pr_details_query::CheckStatusState::QUEUED => true, - pr_details_query::CheckStatusState::REQUESTED => true, - pr_details_query::CheckStatusState::WAITING => true, - pr_details_query::CheckStatusState::Other(_) => false, - }; - let error = if let Some(conclusion) = suite.conclusion { - match conclusion { - pr_details_query::CheckConclusionState::ACTION_REQUIRED => true, - pr_details_query::CheckConclusionState::CANCELLED => true, - pr_details_query::CheckConclusionState::FAILURE => true, - pr_details_query::CheckConclusionState::NEUTRAL => false, - pr_details_query::CheckConclusionState::SKIPPED => false, - pr_details_query::CheckConclusionState::STALE => false, - pr_details_query::CheckConclusionState::STARTUP_FAILURE => true, - pr_details_query::CheckConclusionState::SUCCESS => false, - pr_details_query::CheckConclusionState::TIMED_OUT => true, - pr_details_query::CheckConclusionState::Other(_) => true, - } - } else { - false - }; - if error { - status = CommitState::Failure; - } else if pending && status != CommitState::Failure { - status = CommitState::Pending; + #[expect(clippy::iter_over_hash_type)] + for suite in last_suite_per_workflow.values() { + let pending = match suite.status { + pr_details_query::CheckStatusState::COMPLETED => false, + pr_details_query::CheckStatusState::IN_PROGRESS => true, + pr_details_query::CheckStatusState::PENDING => true, + pr_details_query::CheckStatusState::QUEUED => true, + pr_details_query::CheckStatusState::REQUESTED => true, + pr_details_query::CheckStatusState::WAITING => true, + pr_details_query::CheckStatusState::Other(_) => false, + }; + let error = if let Some(conclusion) = &suite.conclusion { + match conclusion { + pr_details_query::CheckConclusionState::ACTION_REQUIRED => true, + pr_details_query::CheckConclusionState::CANCELLED => true, + pr_details_query::CheckConclusionState::FAILURE => true, + pr_details_query::CheckConclusionState::NEUTRAL => false, + pr_details_query::CheckConclusionState::SKIPPED => false, + pr_details_query::CheckConclusionState::STALE => false, + pr_details_query::CheckConclusionState::STARTUP_FAILURE => true, + pr_details_query::CheckConclusionState::SUCCESS => false, + pr_details_query::CheckConclusionState::TIMED_OUT => true, + pr_details_query::CheckConclusionState::Other(_) => true, } + } else { + false + }; + if error { + status = CommitState::Failure; + } else if pending && status != CommitState::Failure { + status = CommitState::Pending; + } - if let Some(run) = suite.workflow_run { - if let Some(db_id) = run.database_id { - workflow_run_ids.insert(db_id as u64); - } + if let Some(run) = &suite.workflow_run { + if let Some(db_id) = run.database_id { + workflow_run_ids.insert(db_id as u64); } } - - data.commits.push(CommitData { - message, - sha, - status, - workflow_run_ids: workflow_run_ids.into_iter().collect(), - }); } + + data.commits.push(CommitData { + message, + sha, + status, + workflow_run_ids: workflow_run_ids.into_iter().collect(), + }); } Ok(data) } async fn fetch_commit_artifacts(repo: &RepoClient, run_ids: Vec) -> Result> { - let artifacts = FuturesUnordered::from_iter(run_ids.into_iter().map(|run| async move { - let artifacts_page = repo - .actions() - .list_workflow_run_artifacts(&repo.repo().owner, &repo.repo().repo, RunId(run)) - .send() - .await? - .value - .expect("No etag was provided, so we should have a value"); - - let stream = artifacts_page - .into_stream(repo) - .map_ok(move |artifact| ArtifactData { - data: artifact, - run_id: RunId(run), - }); + let artifacts = run_ids + .into_iter() + .map(|run| async move { + let artifacts_page = repo + .actions() + .list_workflow_run_artifacts(&repo.repo().owner, &repo.repo().repo, RunId(run)) + .send() + .await? + .value + .expect("No etag was provided, so we should have a value"); + + let stream = artifacts_page + .into_stream(repo) + .map_ok(move |artifact| ArtifactData { + data: artifact, + run_id: RunId(run), + }); - Ok(stream) - })) - .try_flatten() - .try_collect::>() - .await?; + Ok(stream) + }) + .collect::>() + .try_flatten() + .try_collect::>() + .await?; Ok(artifacts) } diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs index e5c3195..6965b7a 100644 --- a/src/loaders/archive_loader.rs +++ b/src/loaders/archive_loader.rs @@ -111,7 +111,7 @@ fn sync_discovery(data: Bytes) -> anyhow::Result> { anyhow::bail!("Unsupported archive format"); }; - Ok(get_snapshots(files)) + Ok(get_snapshots(&files)) } fn run_zip_discovery(zip_data: Bytes) -> Result>> { @@ -162,10 +162,11 @@ fn run_tar_discovery(tar_data: Bytes) -> Result>> { Ok(files) } -fn get_snapshots(files: HashMap>) -> Vec { +fn get_snapshots(files: &HashMap>) -> Vec { let mut snapshots = Vec::new(); let mut processed_files = std::collections::HashSet::new(); + #[expect(clippy::iter_over_hash_type)] for png_path in files.keys() { if processed_files.contains(png_path) { continue; diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs index 2c5c7ea..5da493a 100644 --- a/src/loaders/gh_archive_loader.rs +++ b/src/loaders/gh_archive_loader.rs @@ -12,9 +12,21 @@ use octocrab::params::actions::ArchiveFormat; use serde_json::json; use std::task::Poll; +enum PipelineState { + Loading, + Triggered, + Error(anyhow::Error), +} + +enum Event { + PipelineState(PipelineState), +} + pub struct GHArtifactLoader { state: LoaderState, artifact: GithubArtifactLink, + pipeline_state: Option, + inbox: UiInbox, } #[derive(Debug)] @@ -26,18 +38,22 @@ pub enum LoaderState { impl GHArtifactLoader { pub fn new(client: Octocrab, artifact: GithubArtifactLink) -> Self { - let mut inbox = UiInbox::new(); + let mut data_inbox = UiInbox::new(); { let artifact = artifact.clone(); - inbox.spawn(move |tx| async move { + data_inbox.spawn(move |tx| async move { tx.send(download_artifact(&client, &artifact).await).ok(); }); } + let inbox = UiInbox::new(); + Self { - state: LoaderState::LoadingData(inbox), + state: LoaderState::LoadingData(data_inbox), artifact, + pipeline_state: None, + inbox, } } } @@ -61,18 +77,26 @@ pub async fn download_artifact( impl LoadSnapshots for GHArtifactLoader { fn update(&mut self, ctx: &Context) { - let mut new_self = None; + for event in self.inbox.read(ctx) { + match event { + Event::PipelineState(state) => { + self.pipeline_state = Some(state); + } + } + } + + let mut new_state = None; match &mut self.state { LoaderState::LoadingData(inbox) => { if let Some(result) = inbox.read(ctx).last() { match result { Ok((data, name)) => { - new_self = Some(LoaderState::LoadingArchive(ArchiveLoader::new( + new_state = Some(LoaderState::LoadingArchive(ArchiveLoader::new( crate::loaders::DataReference::Data(data.clone(), name), ))); } Err(e) => { - new_self = Some(LoaderState::Error(e)); + new_state = Some(LoaderState::Error(e)); } } } @@ -82,7 +106,7 @@ impl LoadSnapshots for GHArtifactLoader { } LoaderState::Error(_) => {} } - if let Some(new_self) = new_self { + if let Some(new_self) = new_state { self.state = new_self; } } @@ -113,16 +137,18 @@ impl LoadSnapshots for GHArtifactLoader { fn extra_ui(&self, ui: &mut Ui, state: &AppStateRef<'_>) { if let Some((git_ref, run_id)) = self.artifact.branch_name.clone().zip(self.artifact.run_id) { - let response = ui - .button("Update snapshots from this archive") - .on_hover_text( - "This will create a commit on the PR branch with the updated snapshots.", - ); + let response = ui.button("Commit the updated snapshots").on_hover_text( + "This will create a commit on the PR branch with the updated snapshots.", + ); if response.clicked() { let client = state.github_auth.client(); let artifact = self.artifact.clone(); + let sender = self.inbox.sender(); + sender + .send(Event::PipelineState(PipelineState::Loading)) + .ok(); hello_egui_utils::spawn(async move { - let _ = client + let result = client .actions() .create_workflow_dispatch( artifact.repo.owner, @@ -136,8 +162,34 @@ impl LoadSnapshots for GHArtifactLoader { })) .send() .await; + + match result { + Ok(()) => { + sender + .send(Event::PipelineState(PipelineState::Triggered)) + .ok(); + } + Err(err) => { + sender + .send(Event::PipelineState(PipelineState::Error(err.into()))) + .ok(); + } + } }); } + + match &self.pipeline_state { + Some(PipelineState::Loading) => { + ui.label("Triggering pipeline..."); + } + Some(PipelineState::Triggered) => { + ui.label("Pipeline triggered! Check the PR workflows for progress."); + } + Some(PipelineState::Error(err)) => { + ui.colored_label(ui.visuals().error_fg_color, format!("Error: {err}")); + } + None => {} + } } } diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 751e502..2d5dfc9 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -68,7 +68,7 @@ impl LoadSnapshots for FileLoader { } } - fn refresh(&mut self, client: Octocrab) { + fn refresh(&mut self, _client: Octocrab) { *self = Self::new(self.base_path.clone()); } From f36184d27fb6ee1f58fb24d7adb65a946fd21d17 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 13:05:10 +0200 Subject: [PATCH 21/25] Clippy --- src/diff_image_loader.rs | 18 ++++++++++------ src/github/auth.rs | 3 ++- src/github/auth/native.rs | 2 +- src/github/pr.rs | 2 +- src/loaders/archive_loader.rs | 2 +- src/native_loaders/file_loader.rs | 26 +++++++++++------------ src/native_loaders/git_loader.rs | 35 +++++++++++++++++-------------- 7 files changed, 49 insertions(+), 39 deletions(-) diff --git a/src/diff_image_loader.rs b/src/diff_image_loader.rs index 8ae9871..aee81e2 100644 --- a/src/diff_image_loader.rs +++ b/src/diff_image_loader.rs @@ -49,7 +49,10 @@ impl DiffUri { } pub fn to_uri(&self) -> String { - format!("diff://{}", serde_json::to_string(self).expect("Failed to serialize DiffUri")) + format!( + "diff://{}", + serde_json::to_string(self).expect("Failed to serialize DiffUri") + ) } } @@ -116,11 +119,14 @@ impl ImageLoader for DiffImageLoader { let uri = uri.to_owned(); #[cfg(not(target_arch = "wasm32"))] - std::thread::Builder::new().name(format!("diff for {uri}")).spawn(move || { - ctx.request_repaint(); - let result = load_diffs(&ctx, &old_image, &new_image, size_hint, &diff_uri); - cache.lock().insert(uri, result.map(Poll::Ready)); - }).expect("Failed to spawn diff thread"); + std::thread::Builder::new() + .name(format!("diff for {uri}")) + .spawn(move || { + ctx.request_repaint(); + let result = load_diffs(&ctx, &old_image, &new_image, size_hint, &diff_uri); + cache.lock().insert(uri, result.map(Poll::Ready)); + }) + .expect("Failed to spawn diff thread"); #[cfg(target_arch = "wasm32")] { wasm_bindgen_futures::spawn_local(async move { diff --git a/src/github/auth.rs b/src/github/auth.rs index 06c16e1..b9fbe09 100644 --- a/src/github/auth.rs +++ b/src/github/auth.rs @@ -121,7 +121,7 @@ impl GitHubAuth { pub const SUPABASE_ANON_KEY: &'static str = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImZxaHNhZXlqcXJqbWxrcWZsdmhvIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTgyMTk4MzIsImV4cCI6MjA3Mzc5NTgzMn0.TuhMjHhBCNyKquyVWq3djOfpBVDhcpSmNRWSErpseuw"; pub fn new(state: AuthState, sender: UiInboxSender) -> Self { - let mut this = Self { + let this = Self { state, inbox: UiInbox::new(), sender, @@ -150,6 +150,7 @@ impl GitHubAuth { // } // } + #[expect(clippy::needless_pass_by_value)] pub fn handle(&mut self, ctx: &Context, cmd: GithubAuthCommand) { match cmd { GithubAuthCommand::Login => auth_impl::login_github(ctx, self.inbox.sender()), diff --git a/src/github/auth/native.rs b/src/github/auth/native.rs index ef8121e..dd16216 100644 --- a/src/github/auth/native.rs +++ b/src/github/auth/native.rs @@ -16,7 +16,7 @@ pub fn login_github(ctx: &Context, tx: AuthSender) { }); } -#[expect(clippy::needless_pass_by_value)] +#[allow(clippy::needless_pass_by_value)] pub fn check_for_auth_callback(_sender: AuthSender) { // Not implemented for native } diff --git a/src/github/pr.rs b/src/github/pr.rs index 3c9598b..d4e9b73 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -19,7 +19,7 @@ use re_ui::{OnResponseExt as _, SectionCollapsingHeader, UiExt as _, icons}; // use chrono::DateTime; pub type GitObjectID = String; pub type DateTime = String; -#[allow(clippy::upper_case_acronyms)] +#[expect(clippy::upper_case_acronyms)] pub type URI = String; // The paths are relative to the directory where your `Cargo.toml` is located. diff --git a/src/loaders/archive_loader.rs b/src/loaders/archive_loader.rs index 6965b7a..793fb38 100644 --- a/src/loaders/archive_loader.rs +++ b/src/loaders/archive_loader.rs @@ -172,7 +172,7 @@ fn get_snapshots(files: &HashMap>) -> Vec { continue; } - if let Some(snapshot) = try_create_snapshot(png_path, &files) { + if let Some(snapshot) = try_create_snapshot(png_path, files) { // Mark related files as processed processed_files.insert(png_path.clone()); if let Some(old_path) = get_variant_path(png_path, "old") { diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 2d5dfc9..76e4ca4 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -24,15 +24,16 @@ impl FileLoader { { let base_path = base_path.clone(); - std::thread::spawn(move || { - let mut types_builder = TypesBuilder::new(); - types_builder.add("png", "*.png").unwrap(); - types_builder.select("png"); - let types = types_builder.build().unwrap(); - - #[expect(clippy::excessive_nesting)] - for result in WalkBuilder::new(&base_path).types(types).build() { - if let Ok(entry) = result { + std::thread::Builder::new() + .name(format!("File loader {}", base_path.display())) + .spawn(move || { + let mut types_builder = TypesBuilder::new(); + types_builder.add("png", "*.png").unwrap(); + types_builder.select("png"); + let types = types_builder.build().expect("Failed to build types"); + + #[expect(clippy::excessive_nesting)] + for entry in WalkBuilder::new(&base_path).types(types).build().flatten() { if entry.file_type().is_some_and(|ft| ft.is_file()) { if let Some(snapshot) = try_create_snapshot(entry.path(), &base_path) { if sender.send(Some(snapshot)).is_err() { @@ -41,11 +42,10 @@ impl FileLoader { } } } - } - // Signal completion - sender.send(None).ok(); - }); + // Signal completion + sender.send(None).ok(); + }).expect("Failed to spawn file loader thread"); } Self { diff --git a/src/native_loaders/git_loader.rs b/src/native_loaders/git_loader.rs index 2c784eb..2372f17 100644 --- a/src/native_loaders/git_loader.rs +++ b/src/native_loaders/git_loader.rs @@ -40,19 +40,22 @@ impl GitLoader { { let base_path = base_path.clone(); - std::thread::spawn(move || { - let result = run_git_discovery(sender.clone(), &base_path); - match result { - Ok(()) => { - // Signal done - sender.send(Command::Done).ok(); - } - Err(e) => { - // Send error - sender.send(Command::Error(e)).ok(); + std::thread::Builder::new() + .name(format!("Git loader {}", base_path.display())) + .spawn(move || { + let result = run_git_discovery(&sender, &base_path); + match result { + Ok(()) => { + // Signal done + sender.send(Command::Done).ok(); + } + Err(e) => { + // Send error + sender.send(Command::Error(e)).ok(); + } } - } - }); + }) + .expect("Failed to spawn git loader thread"); } Self { @@ -118,7 +121,7 @@ pub enum GitError { RepoNotFound, BranchNotFound, FileNotFound, - GitError(git2::Error), + Git2(git2::Error), IoError(std::io::Error), PrUrlParseError, NetworkError(String), @@ -130,7 +133,7 @@ impl Display for GitError { Self::RepoNotFound => write!(f, "Git repository not found"), Self::BranchNotFound => write!(f, "Default branch not found"), Self::FileNotFound => write!(f, "File not found in git tree"), - Self::GitError(err) => write!(f, "Git error: {err}"), + Self::Git2(err) => write!(f, "Git error: {err}"), Self::IoError(err) => write!(f, "IO error: {err}"), Self::PrUrlParseError => write!(f, "Failed to parse PR URL"), Self::NetworkError(msg) => write!(f, "Network error: {msg}"), @@ -142,7 +145,7 @@ impl std::error::Error for GitError {} impl From for GitError { fn from(err: git2::Error) -> Self { - Self::GitError(err) + Self::Git2(err) } } @@ -152,7 +155,7 @@ impl From for GitError { } } -fn run_git_discovery(sender: Sender, base_path: &Path) -> Result<(), GitError> { +fn run_git_discovery(sender: &Sender, base_path: &Path) -> Result<(), GitError> { // Open git repository in current directory let repo = Repository::open(base_path).map_err(|_err| GitError::RepoNotFound)?; From c21c138ac48b01075c002b3399e609197829671e Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 13:08:58 +0200 Subject: [PATCH 22/25] Clippy2 --- src/github/auth/native.rs | 1 - src/github/pr.rs | 34 +++++++++++++++---------------- src/loaders/gh_archive_loader.rs | 3 +-- src/native_loaders/file_loader.rs | 8 +++++--- 4 files changed, 23 insertions(+), 23 deletions(-) diff --git a/src/github/auth/native.rs b/src/github/auth/native.rs index dd16216..2988c0d 100644 --- a/src/github/auth/native.rs +++ b/src/github/auth/native.rs @@ -16,7 +16,6 @@ pub fn login_github(ctx: &Context, tx: AuthSender) { }); } -#[allow(clippy::needless_pass_by_value)] pub fn check_for_auth_callback(_sender: AuthSender) { // Not implemented for native } diff --git a/src/github/pr.rs b/src/github/pr.rs index d4e9b73..cbf2338 100644 --- a/src/github/pr.rs +++ b/src/github/pr.rs @@ -246,26 +246,26 @@ async fn get_pr_commits(repo: &RepoClient, pr: PrNumber) -> Result false, - pr_details_query::CheckStatusState::IN_PROGRESS => true, - pr_details_query::CheckStatusState::PENDING => true, - pr_details_query::CheckStatusState::QUEUED => true, - pr_details_query::CheckStatusState::REQUESTED => true, - pr_details_query::CheckStatusState::WAITING => true, - pr_details_query::CheckStatusState::Other(_) => false, + pr_details_query::CheckStatusState::IN_PROGRESS + | pr_details_query::CheckStatusState::PENDING + | pr_details_query::CheckStatusState::QUEUED + | pr_details_query::CheckStatusState::REQUESTED + | pr_details_query::CheckStatusState::WAITING => true, + pr_details_query::CheckStatusState::COMPLETED + | pr_details_query::CheckStatusState::Other(_) => false, }; let error = if let Some(conclusion) = &suite.conclusion { match conclusion { - pr_details_query::CheckConclusionState::ACTION_REQUIRED => true, - pr_details_query::CheckConclusionState::CANCELLED => true, - pr_details_query::CheckConclusionState::FAILURE => true, - pr_details_query::CheckConclusionState::NEUTRAL => false, - pr_details_query::CheckConclusionState::SKIPPED => false, - pr_details_query::CheckConclusionState::STALE => false, - pr_details_query::CheckConclusionState::STARTUP_FAILURE => true, - pr_details_query::CheckConclusionState::SUCCESS => false, - pr_details_query::CheckConclusionState::TIMED_OUT => true, - pr_details_query::CheckConclusionState::Other(_) => true, + pr_details_query::CheckConclusionState::ACTION_REQUIRED + | pr_details_query::CheckConclusionState::CANCELLED + | pr_details_query::CheckConclusionState::FAILURE + | pr_details_query::CheckConclusionState::STARTUP_FAILURE + | pr_details_query::CheckConclusionState::TIMED_OUT + | pr_details_query::CheckConclusionState::Other(_) => true, + pr_details_query::CheckConclusionState::NEUTRAL + | pr_details_query::CheckConclusionState::SKIPPED + | pr_details_query::CheckConclusionState::STALE + | pr_details_query::CheckConclusionState::SUCCESS => false, } } else { false diff --git a/src/loaders/gh_archive_loader.rs b/src/loaders/gh_archive_loader.rs index 5da493a..2bb72f4 100644 --- a/src/loaders/gh_archive_loader.rs +++ b/src/loaders/gh_archive_loader.rs @@ -128,9 +128,8 @@ impl LoadSnapshots for GHArtifactLoader { fn files_header(&self) -> String { match &self.state { - LoaderState::LoadingData(_) => "Github Artifact".to_owned(), + LoaderState::LoadingData(_) | LoaderState::Error(_) => "Github Artifact".to_owned(), LoaderState::LoadingArchive(loader) => loader.files_header(), - LoaderState::Error(_) => "Github Artifact".to_owned(), } } diff --git a/src/native_loaders/file_loader.rs b/src/native_loaders/file_loader.rs index 76e4ca4..62ba3b3 100644 --- a/src/native_loaders/file_loader.rs +++ b/src/native_loaders/file_loader.rs @@ -28,11 +28,12 @@ impl FileLoader { .name(format!("File loader {}", base_path.display())) .spawn(move || { let mut types_builder = TypesBuilder::new(); - types_builder.add("png", "*.png").unwrap(); + types_builder + .add("png", "*.png") + .expect("Failed to add png type"); types_builder.select("png"); let types = types_builder.build().expect("Failed to build types"); - #[expect(clippy::excessive_nesting)] for entry in WalkBuilder::new(&base_path).types(types).build().flatten() { if entry.file_type().is_some_and(|ft| ft.is_file()) { if let Some(snapshot) = try_create_snapshot(entry.path(), &base_path) { @@ -45,7 +46,8 @@ impl FileLoader { // Signal completion sender.send(None).ok(); - }).expect("Failed to spawn file loader thread"); + }) + .expect("Failed to spawn file loader thread"); } Self { From 0d7e5379933f69d9c4b61adc841aace23740b5f8 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 13:20:16 +0200 Subject: [PATCH 23/25] Fix config.toml --- .cargo/config.toml | 2 +- .typos.toml | 5 +++++ 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/.cargo/config.toml b/.cargo/config.toml index cb9ecf9..aad1c6a 100644 --- a/.cargo/config.toml +++ b/.cargo/config.toml @@ -1,2 +1,2 @@ [target.wasm32-unknown-unknown] -rustflags = ['--cfg', 'getrandom_backend="wasm_js"'] \ No newline at end of file +rustflags = ["--cfg", "getrandom_backend=\"wasm_js\""] \ No newline at end of file diff --git a/.typos.toml b/.typos.toml index 0e66a4e..f26dfb2 100644 --- a/.typos.toml +++ b/.typos.toml @@ -4,3 +4,8 @@ [default.extend-words] egui = "egui" # Example for how to ignore a false positive + +[files] +extend-exclude = [ + "github.graphql", +] From c61ef146dc3af12537d7cd40e2f81b435ddb007f Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 13:27:18 +0200 Subject: [PATCH 24/25] Add RUSTFLAGS --- .cargo/config.toml | 2 +- .github/workflows/pages.yml | 2 ++ .github/workflows/rust.yml | 4 ++++ crates/octocrab-wasm/src/reqwest_tower_service.rs | 8 ++++---- src/lib.rs | 5 ++--- src/main.rs | 2 -- 6 files changed, 13 insertions(+), 10 deletions(-) diff --git a/.cargo/config.toml b/.cargo/config.toml index aad1c6a..0e465b2 100644 --- a/.cargo/config.toml +++ b/.cargo/config.toml @@ -1,2 +1,2 @@ [target.wasm32-unknown-unknown] -rustflags = ["--cfg", "getrandom_backend=\"wasm_js\""] \ No newline at end of file +rustflags = ["--cfg", "getrandom_backend=\"wasm_js\""] diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml index 3878bdc..55275f2 100644 --- a/.github/workflows/pages.yml +++ b/.github/workflows/pages.yml @@ -17,6 +17,8 @@ permissions: jobs: build-github-pages: runs-on: ubuntu-latest + env: + RUSTFLAGS: '--cfg getrandom_backend="wasm_js"' steps: - uses: actions/checkout@v4 # repo checkout - name: Setup toolchain for wasm diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml index fc6d0de..8cecab0 100644 --- a/.github/workflows/rust.yml +++ b/.github/workflows/rust.yml @@ -25,6 +25,8 @@ jobs: check_wasm: name: Check wasm32 runs-on: ubuntu-latest + env: + RUSTFLAGS: '--cfg getrandom_backend="wasm_js"' steps: - uses: actions/checkout@v4 - uses: actions-rs/toolchain@v1 @@ -89,6 +91,8 @@ jobs: trunk: name: trunk runs-on: ubuntu-latest + env: + RUSTFLAGS: '--cfg getrandom_backend="wasm_js"' steps: - uses: actions/checkout@v4 - uses: actions-rs/toolchain@v1 diff --git a/crates/octocrab-wasm/src/reqwest_tower_service.rs b/crates/octocrab-wasm/src/reqwest_tower_service.rs index 359e99d..752740a 100644 --- a/crates/octocrab-wasm/src/reqwest_tower_service.rs +++ b/crates/octocrab-wasm/src/reqwest_tower_service.rs @@ -37,14 +37,14 @@ where Box> + Send>, >; - fn poll_ready(&mut self, cx: &mut std::task::Context<'_>) -> Poll> { + fn poll_ready(&mut self, _cx: &mut std::task::Context<'_>) -> Poll> { Poll::Ready(Ok(())) } fn call(&mut self, req: http::Request) -> Self::Future { let Self { - base_url: base_url, - client: client, + base_url, + client, } = self.clone(); Box::pin(async move { @@ -78,7 +78,7 @@ where .map_err(ReqwestTowerError::BodyError)? .to_bytes(); - let mut uri = parts.uri; + let uri = parts.uri; let mut uri_parts = uri.into_parts(); if uri_parts.authority.is_none() { diff --git a/src/lib.rs b/src/lib.rs index bd8dfae..9db3804 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -2,7 +2,6 @@ use crate::github::model::{GithubArtifactLink, GithubPrLink}; pub use crate::loaders::{DataReference, SnapshotLoader}; use crate::state::AppState; use eframe::egui::Context; -use std::path::PathBuf; pub mod app; mod bar; @@ -21,9 +20,9 @@ mod viewer; #[derive(Debug, Clone)] pub enum DiffSource { #[cfg(not(target_arch = "wasm32"))] - Files(PathBuf), + Files(std::path::PathBuf), #[cfg(not(target_arch = "wasm32"))] - Git(PathBuf), + Git(std::path::PathBuf), Pr(GithubPrLink), GHArtifact(GithubArtifactLink), Archive(DataReference), diff --git a/src/main.rs b/src/main.rs index e21735d..2cadc7a 100644 --- a/src/main.rs +++ b/src/main.rs @@ -33,8 +33,6 @@ fn main() -> eframe::Result<()> { #[cfg(target_arch = "wasm32")] fn parse_url_query_params() -> Option { use kitdiff::github::auth::parse_github_artifact_url; - use kitdiff::github::pr::parse_github_pr_url; - use octocrab::models::ArtifactId; if let Some(window) = web_sys::window() { if let Ok(search) = window.location().search() { From 03d1df7864f9a06d0cce7f87293d70c8c9d5bea6 Mon Sep 17 00:00:00 2001 From: lucasmerlin Date: Wed, 1 Oct 2025 13:36:51 +0200 Subject: [PATCH 25/25] Fmt --- crates/octocrab-wasm/src/reqwest_tower_service.rs | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/crates/octocrab-wasm/src/reqwest_tower_service.rs b/crates/octocrab-wasm/src/reqwest_tower_service.rs index 752740a..c2d0ae0 100644 --- a/crates/octocrab-wasm/src/reqwest_tower_service.rs +++ b/crates/octocrab-wasm/src/reqwest_tower_service.rs @@ -42,10 +42,7 @@ where } fn call(&mut self, req: http::Request) -> Self::Future { - let Self { - base_url, - client, - } = self.clone(); + let Self { base_url, client } = self.clone(); Box::pin(async move { let (tx, rx) = futures::channel::oneshot::channel();