@pulumi/github 6.12.0-alpha.1770156575 → 6.12.0

package/types/output.d.ts

@@ -1150,7 +1150,7 @@ export interface IssueLabelsLabel {
 }
 export interface OrganizationRulesetBypassActor {
     /**
-     * (Number) The ID of the actor that can bypass a ruleset.
+     * (Number) The ID of the actor that can bypass a ruleset. Some actor types such as `DeployKey` do not have an ID.
      */
     actorId?: number;
     /**
@@ -1169,9 +1169,9 @@ export interface OrganizationRulesetBypassActor {
 }
 export interface OrganizationRulesetConditions {
     /**
-     * (Block List, Min: 1, Max: 1) (see below for nested schema)
+     * (Block List, Max: 1) Required for `branch` and `tag` targets. Must NOT be set for `push` targets. (see below for nested schema)
      */
-    refName: outputs.OrganizationRulesetConditionsRefName;
+    refName?: outputs.OrganizationRulesetConditionsRefName;
     /**
      * The repository IDs that the ruleset applies to. One of these IDs must match for the condition to pass. Conflicts with `repositoryName`.
      */
@@ -1180,6 +1180,8 @@ export interface OrganizationRulesetConditions {
      * Conflicts with `repositoryId`. (see below for nested schema)
      *
      * One of `repositoryId` and `repositoryName` must be set for the rule to target any repositories.
+     *
+     * > **Note:** For `push` targets, do not include `refName` in conditions. Push rulesets operate on file content, not on refs.
      */
     repositoryName?: outputs.OrganizationRulesetConditionsRepositoryName;
 }
@@ -1399,7 +1401,7 @@ export interface OrganizationRulesetRulesPullRequest {
     /**
      * Array of allowed merge methods. Allowed values include `merge`, `squash`, and `rebase`. At least one option must be enabled.
      */
-    allowedMergeMethods?: string[];
+    allowedMergeMethods: string[];
     /**
      * New, reviewable commits pushed will dismiss previous pull request review approvals. Defaults to `false`.
      */
@@ -1420,6 +1422,34 @@ export interface OrganizationRulesetRulesPullRequest {
      * All conversations on code must be resolved before a pull request can be merged. Defaults to `false`.
      */
     requiredReviewThreadResolution?: boolean;
+    /**
+     * Require specific reviewers to approve pull requests targeting matching branches. Note: This feature is in beta and subject to change.
+     */
+    requiredReviewers?: outputs.OrganizationRulesetRulesPullRequestRequiredReviewer[];
+}
+export interface OrganizationRulesetRulesPullRequestRequiredReviewer {
+    /**
+     * File patterns (fnmatch syntax) that this reviewer must approve.
+     */
+    filePatterns: string[];
+    /**
+     * Minimum number of approvals required from this reviewer. Set to 0 to make approval optional.
+     */
+    minimumApprovals: number;
+    /**
+     * The reviewer that must review matching files.
+     */
+    reviewer: outputs.OrganizationRulesetRulesPullRequestRequiredReviewerReviewer;
+}
+export interface OrganizationRulesetRulesPullRequestRequiredReviewerReviewer {
+    /**
+     * The ID of the reviewer that must review.
+     */
+    id: number;
+    /**
+     * The type of reviewer. Currently only `Team` is supported.
+     */
+    type: string;
 }
 export interface OrganizationRulesetRulesRequiredCodeScanning {
     /**
@@ -1614,7 +1644,7 @@ export interface RepositoryPagesSource {
 }
 export interface RepositoryRulesetBypassActor {
     /**
-     * The ID of the actor that can bypass a ruleset. If `actorType` is `Integration`, `actorId` is a GitHub App ID. App ID can be obtained by following instructions from the [Get an App API docs](https://docs.github.com/en/rest/apps/apps?apiVersion=2022-11-28#get-an-app)
+     * (Number) The ID of the actor that can bypass a ruleset. If `actorType` is `Integration`, `actorId` is a GitHub App ID. App ID can be obtained by following instructions from the [Get an App API docs](https://docs.github.com/en/rest/apps/apps?apiVersion=2022-11-28#get-an-app). Some actor types such as `DeployKey` do not have an ID.
      */
     actorId?: number;
     /**
@@ -1633,7 +1663,9 @@ export interface RepositoryRulesetBypassActor {
 }
 export interface RepositoryRulesetConditions {
     /**
-     * (Block List, Min: 1, Max: 1) (see below for nested schema)
+     * (Block List, Max: 1) Required for `branch` and `tag` targets. Must NOT be set for `push` targets. (see below for nested schema)
+     *
+     * > **Note:** For `push` targets, do not include `refName` in conditions. Push rulesets operate on file content, not on refs. The `conditions` block is optional for push targets.
      */
     refName: outputs.RepositoryRulesetConditionsRefName;
 }
@@ -1877,7 +1909,7 @@ export interface RepositoryRulesetRulesPullRequest {
     /**
      * Array of allowed merge methods. Allowed values include `merge`, `squash`, and `rebase`. At least one option must be enabled.
      */
-    allowedMergeMethods?: string[];
+    allowedMergeMethods: string[];
     /**
      * New, reviewable commits pushed will dismiss previous pull request review approvals. Defaults to `false`.
      */
@@ -1898,6 +1930,34 @@ export interface RepositoryRulesetRulesPullRequest {
      * All conversations on code must be resolved before a pull request can be merged. Defaults to `false`.
      */
     requiredReviewThreadResolution?: boolean;
+    /**
+     * Require specific reviewers to approve pull requests targeting matching branches. Note: This feature is in beta and subject to change.
+     */
+    requiredReviewers?: outputs.RepositoryRulesetRulesPullRequestRequiredReviewer[];
+}
+export interface RepositoryRulesetRulesPullRequestRequiredReviewer {
+    /**
+     * File patterns (fnmatch syntax) that this reviewer must approve.
+     */
+    filePatterns: string[];
+    /**
+     * Minimum number of approvals required from this reviewer. Set to 0 to make approval optional.
+     */
+    minimumApprovals: number;
+    /**
+     * The reviewer that must review matching files.
+     */
+    reviewer: outputs.RepositoryRulesetRulesPullRequestRequiredReviewerReviewer;
+}
+export interface RepositoryRulesetRulesPullRequestRequiredReviewerReviewer {
+    /**
+     * The ID of the reviewer that must review.
+     */
+    id: number;
+    /**
+     * The type of reviewer. Currently only `Team` is supported.
+     */
+    type: string;
 }
 export interface RepositoryRulesetRulesRequiredCodeScanning {
     /**
@@ -2032,6 +2092,8 @@ export interface RepositorySecurityAndAnalysisSecretScanningPushProtection {
 export interface RepositoryTemplate {
     /**
      * Whether the new repository should include all the branches from the template repository (defaults to false, which includes only the default branch from the template).
+     *
+     * > **Note on `internal` visibility with templates**: When creating a repository from a template with `visibility = "internal"`, the provider uses a two-step process due to GitHub API limitations. The template creation API only supports a `private` boolean parameter. Therefore, repositories with `visibility = "internal"` are initially created as private and then immediately updated to internal visibility. This ensures internal repositories are never exposed publicly during creation.
      */
     includeAllBranches?: boolean;
     /**