@confighub/rtk-query 0.10.6 → 0.10.8

package/dist/index.d.cts

@@ -13262,7 +13262,7 @@ type GetUnitBlameApiArg = {
     resource?: string;
     /** Only the fields with at least one of these flags, comma-separated. Conflict,Absent,Finding,ValidationError,ValidationWarning selects the fields that need attention.
       
-      Supported values: Protected, Guarded, Conflict, Absent, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
+      Supported values: Protected, Guarded, Conflict, Absent, Deleted, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
     flags?: string;
     /** Follow each merge and Link resolve into the unit it took the value from, to where the value was set. Default true; false reports each unit's own record, which names the upstream unit without reading it. */
     upstream?: boolean;
@@ -17453,7 +17453,7 @@ type SearchUnitBlameApiArg = {
     resource?: string;
     /** Only the fields with at least one of these flags, comma-separated. Conflict,Absent,Finding,ValidationError,ValidationWarning selects the fields that need attention.
       
-      Supported values: Protected, Guarded, Conflict, Absent, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
+      Supported values: Protected, Guarded, Conflict, Absent, Deleted, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
     flags?: string;
     /** Follow each merge and Link resolve into the unit it took the value from, to where the value was set. Default true; false reports each unit's own record, which names the upstream unit without reading it. */
     upstream?: boolean;
@@ -21324,6 +21324,8 @@ type MutationConflict = {
     Guard?: WithheldGuard;
     /** For GuardWithheld: the guard change that did not propagate */
     GuardChange?: GuardDelta;
+    /** For Guarded and GuardWithheld: every guard the operation's clearance did not cover, those it forbade with DoesNotExist first and then in key order. Guard is the first of them. */
+    Guards?: WithheldGuard[];
     /** Path of the mutation; empty for resource-level conflicts */
     Path?: string;
     /** Why the mutation was dropped */
@@ -23936,9 +23938,11 @@ type BlameField = {
     Chain?: BlameOrigin[];
     /** The unit's outstanding conflicts about the field: upstream changes to it a merge or resolve dropped. */
     Conflicts?: MutationConflict[];
+    /** True for a field, or a resource, that the unit does not have because a change deleted it: the unit's record still names the deletion. It has no value; its chain is the change that deleted it, and Protected says whether a merge from upstream leaves it deleted. */
+    Deleted?: boolean;
     /** The unit's Link findings about the field: what a Link's resolve could not do here. */
     Findings?: LinkFinding[];
-    /** What there is to know about the field, one code each: Protected, Guarded, Conflict, Absent, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed and Provided. */
+    /** What there is to know about the field, one code each: Protected, Guarded, Conflict, Absent, Deleted, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed and Provided. */
     Flags?: string[];
     /** The guards on the field: its own, its ancestors' and its resource's, which an operation writing here has to be cleared for. */
     Guards?: {
@@ -23946,9 +23950,9 @@ type BlameField = {
     };
     /** The unit's needed paths that are the field: a value it is to take from an upstream unit through a NeedsProvides Link. */
     Needed?: BlameNeededPath[];
-    /** The field's path, in the syntax functions and Links take. */
+    /** The field's path, in the syntax functions and Links take. Empty on the row about the resource as a whole, which comes first among the resource's fields and carries what is recorded about the resource rather than one of its fields: the change that added or deleted it, whether it is protected as a whole, its guards, and its conflicts, findings and failed checks that name no path. */
     Path?: string;
-    /** True for a local override, which a merge from upstream leaves alone. */
+    /** True for a local override, which a merge from upstream leaves alone. On the row about a resource as a whole, true when the resource is protected as a whole. */
     Protected?: boolean;
     /** The unit's provided paths that are the field: a value it offers downstream units through NeedsProvides Links. */
     Provided?: AttributeInfo[];
@@ -23958,7 +23962,7 @@ type BlameField = {
     ResourceName?: string;
     /** The name of the resource without its scope, such as its namespace, which is how a resource a variant renamed is matched. */
     ResourceNameWithoutScope?: string;
-    /** True when the field is protected because its resource is protected as a whole. */
+    /** True when the field is protected because its resource is protected as a whole, and on the row about that resource. */
     ResourceProtected?: boolean;
     /** The type of the resource the field is in. */
     ResourceType?: string;
@@ -23995,6 +23999,10 @@ type UnitConflictsResponse = {
     /** Number of conflicts dropped without changing the configuration data */
     Dismissed?: number;
     Error?: ResponseError;
+    /** Number of permanent dismissals recorded, each a reason (or a reason and a guard) at one path of one resource */
+    Recorded?: number;
+    /** Number of permanent dismissals removed by Undismiss */
+    Removed?: number;
     /** The Unit as the request left it, or would have left it for a dry run */
     Unit?: Unit;
 };
@@ -24008,25 +24016,35 @@ type UnitConflictsResponseRead = {
     /** Number of conflicts dropped without changing the configuration data */
     Dismissed?: number;
     Error?: ResponseError;
+    /** Number of permanent dismissals recorded, each a reason (or a reason and a guard) at one path of one resource */
+    Recorded?: number;
+    /** Number of permanent dismissals removed by Undismiss */
+    Removed?: number;
     /** The Unit as the request left it, or would have left it for a dry run */
     Unit?: UnitRead;
 };
 type UnitConflictSelector = {
-    /** Match conflicts at this path; empty matches any path, including resource-level conflicts */
+    /** Match Guarded and GuardWithheld conflicts every one of whose guards is named here, as key or key=value; empty matches any conflict, guarded or not */
+    Guards?: string[];
+    /** Match conflicts at this path; empty matches any path, including resource-level conflicts. An element of a list may be named by position (spec.data.0.secretKey), by merge key (containers.?name=main.image), or as the conflict records it, and * matches any one list element or map key (spec.data.*.secretKey). */
     Path?: string;
-    /** Match conflicts dropped for this reason: Subtracted, DeleteShadowed, ProtectedPath, or UnresolvedPath; empty matches any reason */
+    /** Match conflicts dropped for this reason, as their Reason names it; empty matches any reason */
     Reason?: string;
-    /** Match conflicts on this resource; empty matches any resource */
+    /** Match conflicts on this resource, by its whole name (namespace/name, or /name for a cluster-scoped Kubernetes resource) or a name it had before a rename; empty matches any resource */
     ResourceName?: string;
+    /** Match conflicts on every resource with this name without its namespace, now or before a rename; empty matches any. With Permanent or Undismiss it has to match only one resource. */
+    ResourceNameWithoutScope?: string;
     /** Match conflicts on resources of this type, in any API version; empty matches any type. With ResourceName, it picks out one of several resources of that name. */
     ResourceType?: string;
 };
 type UnitConflictsRequest = {
-    /** Apply re-applies the withheld change; Dismiss drops the conflict without changing the configuration data */
+    /** Apply re-applies the withheld change; Dismiss drops the conflict without changing the configuration data; Undismiss removes dismissals recorded with Permanent */
     Action?: string;
     /** Report what the request would do without writing anything. The response carries the Unit as it would be. */
     DryRun?: boolean;
-    /** Which outstanding conflicts to act on. Empty acts on all of them. */
+    /** With Dismiss, also dismiss the conflicts each selector matches whenever a later merge reports them. Each selector names one resource, by ResourceName or ResourceNameWithoutScope, and a Reason, and Guards for a guard-caused reason; an empty Path covers every path of the resource. */
+    Permanent?: boolean;
+    /** Which outstanding conflicts to act on. Empty acts on all of them. Permanent and Undismiss need at least one, each naming a ResourceName or ResourceNameWithoutScope, and for Permanent a Reason. */
     Select?: UnitConflictSelector[];
 };
 type UnitDiff = {
@@ -24061,6 +24079,8 @@ type ResourceGuards = {
     };
 };
 type UnitGuardRequest = {
+    /** Recorded on the Revision the edit creates. Defaults to "Set path guards". */
+    ChangeDescription?: string;
     /** The classes of reason this edit is cleared for; required to edit a path that already carries guards */
     Clearance?: Clearance;
     /** Per-resource guard edits to apply to the Unit's PathAnnotations */
@@ -24180,6 +24200,8 @@ type ResourceProtection = {
     Resource?: ResourceInfo;
 };
 type UnitProtectionRequest = {
+    /** Recorded on the Revision the edit creates. Defaults to "Set path protection". */
+    ChangeDescription?: string;
     /** Per-resource Protected edits to apply to the Unit's MutationSources */
     ResourceProtection?: ResourceProtection[] | null;
     /** Clear every Protected value on the Unit's MutationSources before applying ResourceProtection */

package/dist/index.d.ts

@@ -13262,7 +13262,7 @@ type GetUnitBlameApiArg = {
     resource?: string;
     /** Only the fields with at least one of these flags, comma-separated. Conflict,Absent,Finding,ValidationError,ValidationWarning selects the fields that need attention.
       
-      Supported values: Protected, Guarded, Conflict, Absent, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
+      Supported values: Protected, Guarded, Conflict, Absent, Deleted, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
     flags?: string;
     /** Follow each merge and Link resolve into the unit it took the value from, to where the value was set. Default true; false reports each unit's own record, which names the upstream unit without reading it. */
     upstream?: boolean;
@@ -17453,7 +17453,7 @@ type SearchUnitBlameApiArg = {
     resource?: string;
     /** Only the fields with at least one of these flags, comma-separated. Conflict,Absent,Finding,ValidationError,ValidationWarning selects the fields that need attention.
       
-      Supported values: Protected, Guarded, Conflict, Absent, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
+      Supported values: Protected, Guarded, Conflict, Absent, Deleted, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed, Provided. */
     flags?: string;
     /** Follow each merge and Link resolve into the unit it took the value from, to where the value was set. Default true; false reports each unit's own record, which names the upstream unit without reading it. */
     upstream?: boolean;
@@ -21324,6 +21324,8 @@ type MutationConflict = {
     Guard?: WithheldGuard;
     /** For GuardWithheld: the guard change that did not propagate */
     GuardChange?: GuardDelta;
+    /** For Guarded and GuardWithheld: every guard the operation's clearance did not cover, those it forbade with DoesNotExist first and then in key order. Guard is the first of them. */
+    Guards?: WithheldGuard[];
     /** Path of the mutation; empty for resource-level conflicts */
     Path?: string;
     /** Why the mutation was dropped */
@@ -23936,9 +23938,11 @@ type BlameField = {
     Chain?: BlameOrigin[];
     /** The unit's outstanding conflicts about the field: upstream changes to it a merge or resolve dropped. */
     Conflicts?: MutationConflict[];
+    /** True for a field, or a resource, that the unit does not have because a change deleted it: the unit's record still names the deletion. It has no value; its chain is the change that deleted it, and Protected says whether a merge from upstream leaves it deleted. */
+    Deleted?: boolean;
     /** The unit's Link findings about the field: what a Link's resolve could not do here. */
     Findings?: LinkFinding[];
-    /** What there is to know about the field, one code each: Protected, Guarded, Conflict, Absent, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed and Provided. */
+    /** What there is to know about the field, one code each: Protected, Guarded, Conflict, Absent, Deleted, Finding, ValidationError, ValidationWarning, Upgraded, SetByLink, SetByTrigger, ChangeOrder, Unreleased, Needed and Provided. */
     Flags?: string[];
     /** The guards on the field: its own, its ancestors' and its resource's, which an operation writing here has to be cleared for. */
     Guards?: {
@@ -23946,9 +23950,9 @@ type BlameField = {
     };
     /** The unit's needed paths that are the field: a value it is to take from an upstream unit through a NeedsProvides Link. */
     Needed?: BlameNeededPath[];
-    /** The field's path, in the syntax functions and Links take. */
+    /** The field's path, in the syntax functions and Links take. Empty on the row about the resource as a whole, which comes first among the resource's fields and carries what is recorded about the resource rather than one of its fields: the change that added or deleted it, whether it is protected as a whole, its guards, and its conflicts, findings and failed checks that name no path. */
     Path?: string;
-    /** True for a local override, which a merge from upstream leaves alone. */
+    /** True for a local override, which a merge from upstream leaves alone. On the row about a resource as a whole, true when the resource is protected as a whole. */
     Protected?: boolean;
     /** The unit's provided paths that are the field: a value it offers downstream units through NeedsProvides Links. */
     Provided?: AttributeInfo[];
@@ -23958,7 +23962,7 @@ type BlameField = {
     ResourceName?: string;
     /** The name of the resource without its scope, such as its namespace, which is how a resource a variant renamed is matched. */
     ResourceNameWithoutScope?: string;
-    /** True when the field is protected because its resource is protected as a whole. */
+    /** True when the field is protected because its resource is protected as a whole, and on the row about that resource. */
     ResourceProtected?: boolean;
     /** The type of the resource the field is in. */
     ResourceType?: string;
@@ -23995,6 +23999,10 @@ type UnitConflictsResponse = {
     /** Number of conflicts dropped without changing the configuration data */
     Dismissed?: number;
     Error?: ResponseError;
+    /** Number of permanent dismissals recorded, each a reason (or a reason and a guard) at one path of one resource */
+    Recorded?: number;
+    /** Number of permanent dismissals removed by Undismiss */
+    Removed?: number;
     /** The Unit as the request left it, or would have left it for a dry run */
     Unit?: Unit;
 };
@@ -24008,25 +24016,35 @@ type UnitConflictsResponseRead = {
     /** Number of conflicts dropped without changing the configuration data */
     Dismissed?: number;
     Error?: ResponseError;
+    /** Number of permanent dismissals recorded, each a reason (or a reason and a guard) at one path of one resource */
+    Recorded?: number;
+    /** Number of permanent dismissals removed by Undismiss */
+    Removed?: number;
     /** The Unit as the request left it, or would have left it for a dry run */
     Unit?: UnitRead;
 };
 type UnitConflictSelector = {
-    /** Match conflicts at this path; empty matches any path, including resource-level conflicts */
+    /** Match Guarded and GuardWithheld conflicts every one of whose guards is named here, as key or key=value; empty matches any conflict, guarded or not */
+    Guards?: string[];
+    /** Match conflicts at this path; empty matches any path, including resource-level conflicts. An element of a list may be named by position (spec.data.0.secretKey), by merge key (containers.?name=main.image), or as the conflict records it, and * matches any one list element or map key (spec.data.*.secretKey). */
     Path?: string;
-    /** Match conflicts dropped for this reason: Subtracted, DeleteShadowed, ProtectedPath, or UnresolvedPath; empty matches any reason */
+    /** Match conflicts dropped for this reason, as their Reason names it; empty matches any reason */
     Reason?: string;
-    /** Match conflicts on this resource; empty matches any resource */
+    /** Match conflicts on this resource, by its whole name (namespace/name, or /name for a cluster-scoped Kubernetes resource) or a name it had before a rename; empty matches any resource */
     ResourceName?: string;
+    /** Match conflicts on every resource with this name without its namespace, now or before a rename; empty matches any. With Permanent or Undismiss it has to match only one resource. */
+    ResourceNameWithoutScope?: string;
     /** Match conflicts on resources of this type, in any API version; empty matches any type. With ResourceName, it picks out one of several resources of that name. */
     ResourceType?: string;
 };
 type UnitConflictsRequest = {
-    /** Apply re-applies the withheld change; Dismiss drops the conflict without changing the configuration data */
+    /** Apply re-applies the withheld change; Dismiss drops the conflict without changing the configuration data; Undismiss removes dismissals recorded with Permanent */
     Action?: string;
     /** Report what the request would do without writing anything. The response carries the Unit as it would be. */
     DryRun?: boolean;
-    /** Which outstanding conflicts to act on. Empty acts on all of them. */
+    /** With Dismiss, also dismiss the conflicts each selector matches whenever a later merge reports them. Each selector names one resource, by ResourceName or ResourceNameWithoutScope, and a Reason, and Guards for a guard-caused reason; an empty Path covers every path of the resource. */
+    Permanent?: boolean;
+    /** Which outstanding conflicts to act on. Empty acts on all of them. Permanent and Undismiss need at least one, each naming a ResourceName or ResourceNameWithoutScope, and for Permanent a Reason. */
     Select?: UnitConflictSelector[];
 };
 type UnitDiff = {
@@ -24061,6 +24079,8 @@ type ResourceGuards = {
     };
 };
 type UnitGuardRequest = {
+    /** Recorded on the Revision the edit creates. Defaults to "Set path guards". */
+    ChangeDescription?: string;
     /** The classes of reason this edit is cleared for; required to edit a path that already carries guards */
     Clearance?: Clearance;
     /** Per-resource guard edits to apply to the Unit's PathAnnotations */
@@ -24180,6 +24200,8 @@ type ResourceProtection = {
     Resource?: ResourceInfo;
 };
 type UnitProtectionRequest = {
+    /** Recorded on the Revision the edit creates. Defaults to "Set path protection". */
+    ChangeDescription?: string;
     /** Per-resource Protected edits to apply to the Unit's MutationSources */
     ResourceProtection?: ResourceProtection[] | null;
     /** Clear every Protected value on the Unit's MutationSources before applying ResourceProtection */