@confighub/rtk-query 0.4.4 → 0.4.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1349,7 +1349,7 @@ type BulkDeleteChangeOrdersApiArg = {
1349
1349
  An example conjunction is:
1350
1350
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
1351
1351
 
1352
- Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, Labels, OrganizationID, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UpdateType, UpdatedAt.
1352
+ Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, InvocationID, Labels, OrganizationID, Parameters, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UnitFilterID, UpdateType, UpdatedAt, WhereUnit.
1353
1353
 
1354
1354
  The whole string must be query-encoded. */
1355
1355
  where?: string;
@@ -1385,7 +1385,7 @@ type BulkDeleteChangeOrdersApiArg = {
1385
1385
  The attribute names are case-sensitive, PascalCase, and
1386
1386
  expected in a comma-separated list format as in the JSON encoding.
1387
1387
 
1388
- Supported attributes for ChangeOrder are EndTagID, OrganizationID, RestoreTagID, SpaceID, StartTagID.
1388
+ Supported attributes for ChangeOrder are EndTagID, InvocationID, OrganizationID, RestoreTagID, SpaceID, StartTagID, UnitFilterID.
1389
1389
 
1390
1390
  The whole string must be query-encoded. */
1391
1391
  include?: string;
@@ -1427,7 +1427,7 @@ type ListAllChangeOrdersApiArg = {
1427
1427
  An example conjunction is:
1428
1428
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
1429
1429
 
1430
- Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, Labels, OrganizationID, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UpdateType, UpdatedAt.
1430
+ Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, InvocationID, Labels, OrganizationID, Parameters, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UnitFilterID, UpdateType, UpdatedAt, WhereUnit.
1431
1431
 
1432
1432
  The whole string must be query-encoded. */
1433
1433
  where?: string;
@@ -1463,7 +1463,7 @@ type ListAllChangeOrdersApiArg = {
1463
1463
  The attribute names are case-sensitive, PascalCase, and
1464
1464
  expected in a comma-separated list format as in the JSON encoding.
1465
1465
 
1466
- Supported attributes for ChangeOrder are EndTagID, OrganizationID, RestoreTagID, SpaceID, StartTagID.
1466
+ Supported attributes for ChangeOrder are EndTagID, InvocationID, OrganizationID, RestoreTagID, SpaceID, StartTagID, UnitFilterID.
1467
1467
 
1468
1468
  The whole string must be query-encoded. */
1469
1469
  include?: string;
@@ -1513,7 +1513,7 @@ type BulkPatchChangeOrdersApiArg = {
1513
1513
  An example conjunction is:
1514
1514
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
1515
1515
 
1516
- Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, Labels, OrganizationID, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UpdateType, UpdatedAt.
1516
+ Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, InvocationID, Labels, OrganizationID, Parameters, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UnitFilterID, UpdateType, UpdatedAt, WhereUnit.
1517
1517
 
1518
1518
  The whole string must be query-encoded. */
1519
1519
  where?: string;
@@ -1549,7 +1549,7 @@ type BulkPatchChangeOrdersApiArg = {
1549
1549
  The attribute names are case-sensitive, PascalCase, and
1550
1550
  expected in a comma-separated list format as in the JSON encoding.
1551
1551
 
1552
- Supported attributes for ChangeOrder are EndTagID, OrganizationID, RestoreTagID, SpaceID, StartTagID.
1552
+ Supported attributes for ChangeOrder are EndTagID, InvocationID, OrganizationID, RestoreTagID, SpaceID, StartTagID, UnitFilterID.
1553
1553
 
1554
1554
  The whole string must be query-encoded. */
1555
1555
  include?: string;
@@ -1568,15 +1568,19 @@ type BulkPatchChangeOrdersApiArg = {
1568
1568
  DisplayName?: string | null;
1569
1569
  EndTagID?: string | null;
1570
1570
  InScopeSpaceIDs?: (string | null)[] | null;
1571
+ InvocationID?: string | null;
1571
1572
  /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
1572
1573
  Labels?: {
1573
1574
  [key: string]: string | null;
1574
1575
  } | null;
1576
+ Parameters?: object | null;
1575
1577
  /** Unique URL-safe identifier for the entity. */
1576
1578
  Slug?: string | null;
1579
+ UnitFilterID?: string | null;
1577
1580
  UpdateType?: string | null;
1578
1581
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
1579
1582
  Version?: number | null;
1583
+ WhereUnit?: string | null;
1580
1584
  };
1581
1585
  };
1582
1586
  type BulkCreateChangeOrdersApiResponse = /** status 200 OK */ ChangeOrderCreateOrUpdateResponseRead[] | /** status 207 Multi-Status (partial success) */ ChangeOrderCreateOrUpdateResponseRead[];
@@ -1615,7 +1619,7 @@ type BulkCreateChangeOrdersApiArg = {
1615
1619
  An example conjunction is:
1616
1620
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
1617
1621
 
1618
- Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, Labels, OrganizationID, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UpdateType, UpdatedAt.
1622
+ Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, InvocationID, Labels, OrganizationID, Parameters, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UnitFilterID, UpdateType, UpdatedAt, WhereUnit.
1619
1623
 
1620
1624
  The whole string must be query-encoded. */
1621
1625
  where?: string;
@@ -1651,7 +1655,7 @@ type BulkCreateChangeOrdersApiArg = {
1651
1655
  The attribute names are case-sensitive, PascalCase, and
1652
1656
  expected in a comma-separated list format as in the JSON encoding.
1653
1657
 
1654
- Supported attributes for ChangeOrder are EndTagID, OrganizationID, RestoreTagID, SpaceID, StartTagID.
1658
+ Supported attributes for ChangeOrder are EndTagID, InvocationID, OrganizationID, RestoreTagID, SpaceID, StartTagID, UnitFilterID.
1655
1659
 
1656
1660
  The whole string must be query-encoded. */
1657
1661
  include?: string;
@@ -1730,15 +1734,19 @@ type BulkCreateChangeOrdersApiArg = {
1730
1734
  DisplayName?: string | null;
1731
1735
  EndTagID?: string | null;
1732
1736
  InScopeSpaceIDs?: (string | null)[] | null;
1737
+ InvocationID?: string | null;
1733
1738
  /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
1734
1739
  Labels?: {
1735
1740
  [key: string]: string | null;
1736
1741
  } | null;
1742
+ Parameters?: object | null;
1737
1743
  /** Unique URL-safe identifier for the entity. */
1738
1744
  Slug?: string | null;
1745
+ UnitFilterID?: string | null;
1739
1746
  UpdateType?: string | null;
1740
1747
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
1741
1748
  Version?: number | null;
1749
+ WhereUnit?: string | null;
1742
1750
  };
1743
1751
  };
1744
1752
  type BulkDeleteChangeSetsApiResponse = /** status 200 OK */ DeleteResponse[] | /** status 207 Multi-Status: Mixed success and failure results */ DeleteResponse[];
@@ -2654,6 +2662,8 @@ type InvokeFunctionsOnOrgApiArg = {
2654
2662
  guards?: string;
2655
2663
  /** Must match ChangeSetID of affected Units unless in dry run mode; not valid when invoked on Revisions */
2656
2664
  changeSetId?: string;
2665
+ /** ChangeOrder to promote, which must have UpdateType Invoke. What runs then comes from the ChangeOrder rather than from the request body, which may not carry functions, triggers or invocations of its own; that is what holds every Space in scope to the same change. Only the Units the ChangeOrder covers are reached, a Unit that has already taken it is passed over, and every Unit reached is marked with the ChangeOrder's start and end Tags -- both on the head, with no Revision made, where the invocation changed nothing. Not valid when invoked on Revisions. */
2666
+ changeOrder?: string;
2657
2667
  /** User-defined category for the Mutation. Must be alphanumeric, at most 64 characters. The prefix 'ConfigHub' is reserved. */
2658
2668
  subgroup?: string;
2659
2669
  /** Source of additional configuration data to pass to functions that need it (e.g., vet-immutable). Supports named revision specifiers: LastReleasedRevisionNum, HeadRevisionNum. Can be prefixed with 'Before:' (e.g., Before:HeadRevisionNum). May be repeated for multiple sources. */
@@ -2692,7 +2702,7 @@ type InvokeFunctionsOnOrgApiArg = {
2692
2702
  An example conjunction is:
2693
2703
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
2694
2704
 
2695
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
2705
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
2696
2706
 
2697
2707
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
2698
2708
 
@@ -4119,7 +4129,7 @@ type ListAllRevisionsApiArg = {
4119
4129
  An example conjunction is:
4120
4130
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
4121
4131
 
4122
- Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
4132
+ Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
4123
4133
 
4124
4134
  To list tagged Revisions use `Tags ? '<tag-id>'`.
4125
4135
 
@@ -4178,7 +4188,7 @@ type ListAllRevisionsApiArg = {
4178
4188
 
4179
4189
  Field names are case-sensitive and PascalCase, as in the JSON encoding. Sort direction defaults to ASC when the 'DIRECTION:' prefix is omitted.
4180
4190
 
4181
- Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
4191
+ Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
4182
4192
 
4183
4193
  Example: 'DESC:CreatedAt' or 'DisplayName,DESC:CreatedAt'.
4184
4194
 
@@ -4231,7 +4241,7 @@ type SearchRevisionDataApiArg = {
4231
4241
  An example conjunction is:
4232
4242
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
4233
4243
 
4234
- Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
4244
+ Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
4235
4245
 
4236
4246
  To list tagged Revisions use `Tags ? '<tag-id>'`.
4237
4247
 
@@ -4290,7 +4300,7 @@ type SearchRevisionDataApiArg = {
4290
4300
 
4291
4301
  Field names are case-sensitive and PascalCase, as in the JSON encoding. Sort direction defaults to ASC when the 'DIRECTION:' prefix is omitted.
4292
4302
 
4293
- Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
4303
+ Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
4294
4304
 
4295
4305
  Example: 'DESC:CreatedAt' or 'DisplayName,DESC:CreatedAt'.
4296
4306
 
@@ -4344,7 +4354,7 @@ type SearchRevisionMutationSourcesApiArg = {
4344
4354
  An example conjunction is:
4345
4355
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
4346
4356
 
4347
- Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
4357
+ Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
4348
4358
 
4349
4359
  To list tagged Revisions use `Tags ? '<tag-id>'`.
4350
4360
 
@@ -4403,7 +4413,7 @@ type SearchRevisionMutationSourcesApiArg = {
4403
4413
 
4404
4414
  Field names are case-sensitive and PascalCase, as in the JSON encoding. Sort direction defaults to ASC when the 'DIRECTION:' prefix is omitted.
4405
4415
 
4406
- Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
4416
+ Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
4407
4417
 
4408
4418
  Example: 'DESC:CreatedAt' or 'DisplayName,DESC:CreatedAt'.
4409
4419
 
@@ -5039,7 +5049,7 @@ type ListChangeOrdersApiArg = {
5039
5049
  An example conjunction is:
5040
5050
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
5041
5051
 
5042
- Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, Labels, OrganizationID, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UpdateType, UpdatedAt.
5052
+ Supported attributes for filtering on ChangeOrder: AbortedReason, AdoptedEndTagID, Annotations, ChangeOrderID, CreatedAt, DeleteGates, Description, DisplayName, EndTagID, InScopeSpaceIDs, InvocationID, Labels, OrganizationID, Parameters, ReleasedRestoredSpaceIDs, ReleasedSpaceIDs, ResolvedSpaceIDs, RestoreTagID, RestoredSpaceIDs, SkippedUnits, Slug, SpaceID, StartTagID, State, UnitFilterID, UpdateType, UpdatedAt, WhereUnit.
5043
5053
 
5044
5054
  The whole string must be query-encoded. */
5045
5055
  where?: string;
@@ -5075,7 +5085,7 @@ type ListChangeOrdersApiArg = {
5075
5085
  The attribute names are case-sensitive, PascalCase, and
5076
5086
  expected in a comma-separated list format as in the JSON encoding.
5077
5087
 
5078
- Supported attributes for ChangeOrder are EndTagID, OrganizationID, RestoreTagID, SpaceID, StartTagID.
5088
+ Supported attributes for ChangeOrder are EndTagID, InvocationID, OrganizationID, RestoreTagID, SpaceID, StartTagID, UnitFilterID.
5079
5089
 
5080
5090
  The whole string must be query-encoded. */
5081
5091
  include?: string;
@@ -5115,7 +5125,7 @@ type GetChangeOrderApiArg = {
5115
5125
  The attribute names are case-sensitive, PascalCase, and
5116
5126
  expected in a comma-separated list format as in the JSON encoding.
5117
5127
 
5118
- Supported attributes for ChangeOrder are EndTagID, OrganizationID, RestoreTagID, SpaceID, StartTagID.
5128
+ Supported attributes for ChangeOrder are EndTagID, InvocationID, OrganizationID, RestoreTagID, SpaceID, StartTagID, UnitFilterID.
5119
5129
 
5120
5130
  The whole string must be query-encoded. */
5121
5131
  include?: string;
@@ -5153,15 +5163,19 @@ type PatchChangeOrderApiArg = {
5153
5163
  DisplayName?: string | null;
5154
5164
  EndTagID?: string | null;
5155
5165
  InScopeSpaceIDs?: (string | null)[] | null;
5166
+ InvocationID?: string | null;
5156
5167
  /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
5157
5168
  Labels?: {
5158
5169
  [key: string]: string | null;
5159
5170
  } | null;
5171
+ Parameters?: object | null;
5160
5172
  /** Unique URL-safe identifier for the entity. */
5161
5173
  Slug?: string | null;
5174
+ UnitFilterID?: string | null;
5162
5175
  UpdateType?: string | null;
5163
5176
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
5164
5177
  Version?: number | null;
5178
+ WhereUnit?: string | null;
5165
5179
  };
5166
5180
  };
5167
5181
  type UpdateChangeOrderApiResponse =
@@ -5586,6 +5600,8 @@ type InvokeFunctionsApiArg = {
5586
5600
  guards?: string;
5587
5601
  /** Must match ChangeSetID of affected Units unless in dry run mode; not valid when invoked on Revisions */
5588
5602
  changeSetId?: string;
5603
+ /** ChangeOrder to promote, which must have UpdateType Invoke. What runs then comes from the ChangeOrder rather than from the request body, which may not carry functions, triggers or invocations of its own; that is what holds every Space in scope to the same change. Only the Units the ChangeOrder covers are reached, a Unit that has already taken it is passed over, and every Unit reached is marked with the ChangeOrder's start and end Tags -- both on the head, with no Revision made, where the invocation changed nothing. Not valid when invoked on Revisions. */
5604
+ changeOrder?: string;
5589
5605
  /** User-defined category for the Mutation. Must be alphanumeric, at most 64 characters. The prefix 'ConfigHub' is reserved. */
5590
5606
  subgroup?: string;
5591
5607
  /** Source of additional configuration data to pass to functions that need it (e.g., vet-immutable). Supports named revision specifiers: LastReleasedRevisionNum, HeadRevisionNum. Can be prefixed with 'Before:' (e.g., Before:HeadRevisionNum). May be repeated for multiple sources. */
@@ -5624,7 +5640,7 @@ type InvokeFunctionsApiArg = {
5624
5640
  An example conjunction is:
5625
5641
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
5626
5642
 
5627
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
5643
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
5628
5644
 
5629
5645
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
5630
5646
 
@@ -6663,7 +6679,7 @@ to execute on events.
6663
6679
 
6664
6680
  Triggers can be either validating (checking configuration validity without modifying it)
6665
6681
  or mutating (making changes to the configuration). They can be disabled, and validating
6666
- triggers can be set to Warn mode to produce non-blocking ApplyWarnings instead of ApplyGates. */ TriggerRead;
6682
+ triggers can be set to Warn mode to produce non-blocking ValidationWarnings instead of ValidationErrors. */ TriggerRead;
6667
6683
  type CreateTriggerApiArg = {
6668
6684
  /** Unique identifier for a space_id */
6669
6685
  spaceId: string;
@@ -6712,7 +6728,7 @@ to execute on events.
6712
6728
 
6713
6729
  Triggers can be either validating (checking configuration validity without modifying it)
6714
6730
  or mutating (making changes to the configuration). They can be disabled, and validating
6715
- triggers can be set to Warn mode to produce non-blocking ApplyWarnings instead of ApplyGates. */ TriggerRead;
6731
+ triggers can be set to Warn mode to produce non-blocking ValidationWarnings instead of ValidationErrors. */ TriggerRead;
6716
6732
  type PatchTriggerApiArg = {
6717
6733
  /** Unique identifier for a space_id */
6718
6734
  spaceId: string;
@@ -6773,7 +6789,7 @@ to execute on events.
6773
6789
 
6774
6790
  Triggers can be either validating (checking configuration validity without modifying it)
6775
6791
  or mutating (making changes to the configuration). They can be disabled, and validating
6776
- triggers can be set to Warn mode to produce non-blocking ApplyWarnings instead of ApplyGates. */ TriggerRead;
6792
+ triggers can be set to Warn mode to produce non-blocking ValidationWarnings instead of ValidationErrors. */ TriggerRead;
6777
6793
  type UpdateTriggerApiArg = {
6778
6794
  /** Unique identifier for a space_id */
6779
6795
  spaceId: string;
@@ -6819,7 +6835,7 @@ type ListUnitsApiArg = {
6819
6835
  An example conjunction is:
6820
6836
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
6821
6837
 
6822
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
6838
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
6823
6839
 
6824
6840
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
6825
6841
 
@@ -7582,7 +7598,7 @@ type ListExtendedRevisionsApiArg = {
7582
7598
  An example conjunction is:
7583
7599
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
7584
7600
 
7585
- Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
7601
+ Supported attributes for filtering on Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
7586
7602
 
7587
7603
  To list a tagged Revision use `Tags ? '<tag-id>'`.
7588
7604
 
@@ -7641,7 +7657,7 @@ type ListExtendedRevisionsApiArg = {
7641
7657
 
7642
7658
  Field names are case-sensitive and PascalCase, as in the JSON encoding. Sort direction defaults to ASC when the 'DIRECTION:' prefix is omitted.
7643
7659
 
7644
- Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
7660
+ Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
7645
7661
 
7646
7662
  Example: 'DESC:CreatedAt' or 'DisplayName,DESC:CreatedAt'.
7647
7663
 
@@ -7682,7 +7698,7 @@ type GetExtendedRevisionApiArg = {
7682
7698
 
7683
7699
  Field names are case-sensitive and PascalCase, as in the JSON encoding. Sort direction defaults to ASC when the 'DIRECTION:' prefix is omitted.
7684
7700
 
7685
- Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID.
7701
+ Supported attributes for ordering Revision: ApplyGates, ApplyWarnings, ApprovedBy, ChangeOrders, ChangeSetID, Conflicts, CreatedAt, DataHash, Description, OrganizationID, Releases, RevisionID, RevisionNum, Source, SpaceID, Tags, UnitID, UpdatedAt, UserAgent, UserID, ValidationErrors, ValidationWarnings.
7686
7702
 
7687
7703
  Example: 'DESC:CreatedAt' or 'DisplayName,DESC:CreatedAt'.
7688
7704
 
@@ -9294,7 +9310,7 @@ type BulkDeleteUnitsApiArg = {
9294
9310
  An example conjunction is:
9295
9311
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
9296
9312
 
9297
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
9313
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
9298
9314
 
9299
9315
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
9300
9316
 
@@ -9373,7 +9389,7 @@ type ListAllUnitsApiArg = {
9373
9389
  An example conjunction is:
9374
9390
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
9375
9391
 
9376
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
9392
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
9377
9393
 
9378
9394
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
9379
9395
 
@@ -9473,7 +9489,7 @@ type BulkPatchUnitsApiArg = {
9473
9489
  An example conjunction is:
9474
9490
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
9475
9491
 
9476
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
9492
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
9477
9493
 
9478
9494
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
9479
9495
 
@@ -9675,7 +9691,7 @@ type BulkCreateUnitsApiArg = {
9675
9691
  An example conjunction is:
9676
9692
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
9677
9693
 
9678
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
9694
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
9679
9695
 
9680
9696
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
9681
9697
 
@@ -9895,7 +9911,7 @@ type BulkApproveUnitsApiArg = {
9895
9911
  An example conjunction is:
9896
9912
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
9897
9913
 
9898
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
9914
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
9899
9915
 
9900
9916
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
9901
9917
 
@@ -9976,7 +9992,7 @@ type BulkCancelUnitsApiArg = {
9976
9992
  An example conjunction is:
9977
9993
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
9978
9994
 
9979
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
9995
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
9980
9996
 
9981
9997
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
9982
9998
 
@@ -10055,7 +10071,7 @@ type BulkTagUnitsApiArg = {
10055
10071
  An example conjunction is:
10056
10072
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
10057
10073
 
10058
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
10074
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
10059
10075
 
10060
10076
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
10061
10077
 
@@ -10204,7 +10220,7 @@ type SearchUnitDataApiArg = {
10204
10220
  An example conjunction is:
10205
10221
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
10206
10222
 
10207
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
10223
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
10208
10224
 
10209
10225
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
10210
10226
 
@@ -10398,7 +10414,7 @@ type SearchUnitMutationSourcesApiArg = {
10398
10414
  An example conjunction is:
10399
10415
  `CreatedAt >= '2025-01-07' AND Slug = 'test' AND Labels.mykey = 'myvalue'`.
10400
10416
 
10401
- Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, Values.
10417
+ Supported attributes for filtering on Unit: Annotations, ApplyGates, ApplyWarnings, ApprovedBy, BridgeWorkerID, ChangeSetID, Conflicts, CreatedAt, DataHash, DeleteGates, DestroyGates, DisplayName, FromLinkID, HeadRevisionNum, HeadUnitActionNum, HeadUnitEventNum, Labels, LastActionAt, LastChangeDescription, LastReleasedRevisionNum, NeededPaths, OrganizationID, ProvidedPaths, ProviderType, Slug, SpaceID, TargetID, TargetOptions, ToolchainType, UnitID, UpdatedAt, UpstreamRevisionNum, UpstreamSpaceID, UpstreamUnitID, ValidationErrors, ValidationWarnings, Values.
10402
10418
 
10403
10419
  Finding all units created by cloning can be done using the expression `UpstreamRevisionNum > 0`. Clones of a specific unit can be found by additionally filtering based on `UpstreamUnitID`. Unapplied units can be found using `LastReleasedRevisionNum = 0`. Units with unapplied changes can be found with `HeadRevisionNum > LastReleasedRevisionNum`.
10404
10420
 
@@ -11846,22 +11862,32 @@ type ChangeOrder = {
11846
11862
  DisplayName?: string;
11847
11863
  /** EndTagID is the identifier of the set of Revisions that end the ChangeOrder. The ChangeOrder always mints this Tag itself; supplying one at creation adopts its marks as the boundary, and the supplied Tag is recorded as AdoptedEndTagID and never written to. Without one the boundary is each Unit's head Revision. */
11848
11864
  EndTagID?: string;
11849
- /** InScopeSpaceIDs is where the ChangeOrder is headed: the Spaces it propagates into, supplied by the client rather than derived from a query. Empty names a change without saying where it is headed, in which case the Spaces the ChangeOrder's Links reach when its scope is derived are recorded instead. ResolvedSpaceIDs and ReleasedSpaceIDs are measured against it. Editing it re-derives what the ChangeOrder covers. */
11865
+ /** InScopeSpaceIDs is where the ChangeOrder is headed: the Spaces it propagates into, supplied by the client rather than derived from a query. Empty names a change without saying where it is headed, in which case the Spaces the ChangeOrder's Links reach when its scope is derived are recorded instead; an Invoke ChangeOrder has no Links to fall back on and requires a non-empty list. ResolvedSpaceIDs and ReleasedSpaceIDs are measured against it. Editing it re-derives what the ChangeOrder covers. */
11850
11866
  InScopeSpaceIDs?: Uuid[];
11867
+ /** InvocationID is the Invocation an Invoke ChangeOrder runs. Required for that UpdateType and refused for the others. Naming it here is what makes every Space in scope receive the same update: the invoke API takes what it runs from the ChangeOrder. Immutable. */
11868
+ InvocationID?: string;
11851
11869
  /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
11852
11870
  Labels?: {
11853
11871
  [key: string]: string;
11854
11872
  };
11855
11873
  /** Unique identifier for an organization. */
11856
11874
  OrganizationID?: string;
11875
+ /** Parameters supplies values for the declared Parameters of a parameterized Invocation, keyed by parameter name, validated against the declaration the way ParameterizedInvocations are on a direct call. One set for the whole ChangeOrder, not one per Space. Immutable. */
11876
+ Parameters?: {
11877
+ [key: string]: any;
11878
+ };
11857
11879
  /** Unique URL-safe identifier for the entity. */
11858
11880
  Slug: string;
11859
11881
  /** Unique identifier for a space. */
11860
11882
  SpaceID?: string;
11861
- /** UpdateType is the Link UpdateType this ChangeOrder follows when propagating. UpgradeUnit, the clone lineage, is the default; MergeUnits is the other supported value. */
11883
+ /** UnitFilterID references a Filter (with From=Unit) narrowing the same selection as WhereUnit, conjoined with it. Refused on the other UpdateTypes. Immutable. */
11884
+ UnitFilterID?: string;
11885
+ /** UpdateType is how this ChangeOrder propagates. UpgradeUnit, the clone lineage, is the default, and MergeUnits is the other Link type it follows; both take the change from Revisions the source Unit already has. Invoke is the third: the change is one Invocation run in each Space in scope, and the ChangeOrder is created before any of it has happened. */
11862
11886
  UpdateType?: string;
11863
11887
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
11864
11888
  Version?: number;
11889
+ /** WhereUnit narrows which Units of each Space in scope an Invoke ChangeOrder covers, and is refused on the other UpdateTypes. Empty covers every Unit. Unlike InScopeSpaceIDs it is asked again on every read, so a Unit added to a Space afterwards counts against that Space. Immutable. */
11890
+ WhereUnit?: string;
11865
11891
  };
11866
11892
  type ChangeOrderRead = {
11867
11893
  /** AbortedReason says why the ChangeOrder was given up on. Setting it is what aborts one: a ChangeOrder with a reason is Aborted whatever its Links say. */
@@ -11890,19 +11916,25 @@ type ChangeOrderRead = {
11890
11916
  EndTagID?: string;
11891
11917
  /** The type of entity. */
11892
11918
  EntityType?: string;
11893
- /** InScopeSpaceIDs is where the ChangeOrder is headed: the Spaces it propagates into, supplied by the client rather than derived from a query. Empty names a change without saying where it is headed, in which case the Spaces the ChangeOrder's Links reach when its scope is derived are recorded instead. ResolvedSpaceIDs and ReleasedSpaceIDs are measured against it. Editing it re-derives what the ChangeOrder covers. */
11919
+ /** InScopeSpaceIDs is where the ChangeOrder is headed: the Spaces it propagates into, supplied by the client rather than derived from a query. Empty names a change without saying where it is headed, in which case the Spaces the ChangeOrder's Links reach when its scope is derived are recorded instead; an Invoke ChangeOrder has no Links to fall back on and requires a non-empty list. ResolvedSpaceIDs and ReleasedSpaceIDs are measured against it. Editing it re-derives what the ChangeOrder covers. */
11894
11920
  InScopeSpaceIDs?: Uuid[];
11921
+ /** InvocationID is the Invocation an Invoke ChangeOrder runs. Required for that UpdateType and refused for the others. Naming it here is what makes every Space in scope receive the same update: the invoke API takes what it runs from the ChangeOrder. Immutable. */
11922
+ InvocationID?: string;
11895
11923
  /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
11896
11924
  Labels?: {
11897
11925
  [key: string]: string;
11898
11926
  };
11899
11927
  /** Unique identifier for an organization. */
11900
11928
  OrganizationID?: string;
11929
+ /** Parameters supplies values for the declared Parameters of a parameterized Invocation, keyed by parameter name, validated against the declaration the way ParameterizedInvocations are on a direct call. One set for the whole ChangeOrder, not one per Space. Immutable. */
11930
+ Parameters?: {
11931
+ [key: string]: any;
11932
+ };
11901
11933
  /** ReleasedRestoredSpaceIDs is where the undoing has been released: the Spaces in RestoredSpaceIDs whose Units are released at or past the Revision the restore Tag marks. Covering ReleasedSpaceIDs is what State reports as RestoreReleased. Derived when the ChangeOrder is read. */
11902
11934
  ReleasedRestoredSpaceIDs?: Uuid[];
11903
11935
  /** ReleasedSpaceIDs is where the ChangeOrder has been released: the Spaces in scope whose Units in the Space's release are applied at or past the Revision the end Tag marks. Derived when the ChangeOrder is read. */
11904
11936
  ReleasedSpaceIDs?: Uuid[];
11905
- /** ResolvedSpaceIDs is where the ChangeOrder has been fully propagated to: the Spaces in scope whose Links of its UpdateType have all merged it, plus the Space it resides in. Derived when the ChangeOrder is read. */
11937
+ /** ResolvedSpaceIDs is where the ChangeOrder has been fully propagated to: the Spaces in scope whose Links of its UpdateType have all merged it, plus the Space it resides in. For an Invoke ChangeOrder it is the Spaces in scope where every Unit WhereUnit selects carries the end Tag, and its own Space counts only if it is one of them. Derived when the ChangeOrder is read. */
11906
11938
  ResolvedSpaceIDs?: Uuid[];
11907
11939
  /** RestoreTagID is the Tag marking the Revisions that undid the ChangeOrder. The first restore mints it; every restore after that marks with the same Tag. Empty until something has been restored. */
11908
11940
  RestoreTagID?: string;
@@ -11922,12 +11954,16 @@ type ChangeOrderRead = {
11922
11954
  StartTagID?: string;
11923
11955
  /** State is how far the ChangeOrder has got: New until a Space other than its own has taken it, InProgress while some have and some have not, Resolved once every Space in scope has, Released once every Space in scope has released what it took, Aborted whenever AbortedReason is set, Restored once every Space that had taken it has been restored to the Revisions before it, and RestoreReleased once every Space that had released it has released the restored Revisions. Derived when the ChangeOrder is read. */
11924
11956
  State?: string;
11925
- /** UpdateType is the Link UpdateType this ChangeOrder follows when propagating. UpgradeUnit, the clone lineage, is the default; MergeUnits is the other supported value. */
11957
+ /** UnitFilterID references a Filter (with From=Unit) narrowing the same selection as WhereUnit, conjoined with it. Refused on the other UpdateTypes. Immutable. */
11958
+ UnitFilterID?: string;
11959
+ /** UpdateType is how this ChangeOrder propagates. UpgradeUnit, the clone lineage, is the default, and MergeUnits is the other Link type it follows; both take the change from Revisions the source Unit already has. Invoke is the third: the change is one Invocation run in each Space in scope, and the ChangeOrder is created before any of it has happened. */
11926
11960
  UpdateType?: string;
11927
11961
  /** The timestamp when the entity was last updated in "2023-01-01T12:00:00Z" format. */
11928
11962
  UpdatedAt?: string;
11929
11963
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
11930
11964
  Version?: number;
11965
+ /** WhereUnit narrows which Units of each Space in scope an Invoke ChangeOrder covers, and is refused on the other UpdateTypes. Empty covers every Unit. Unlike InScopeSpaceIDs it is asked again on every read, so a Unit added to a Space afterwards counts against that Space. Immutable. */
11966
+ WhereUnit?: string;
11931
11967
  };
11932
11968
  type Tag = {
11933
11969
  /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
@@ -11995,67 +12031,78 @@ type TagRead = {
11995
12031
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
11996
12032
  Version?: number;
11997
12033
  };
11998
- type ExtendedChangeOrder = {
11999
- ChangeOrder?: ChangeOrder;
12000
- EndTag?: Tag;
12001
- Error?: ResponseError;
12002
- Organization?: Organization;
12003
- RestoreTag?: Tag;
12004
- Space?: Space;
12005
- StartTag?: Tag;
12034
+ type FunctionArgument = {
12035
+ Evaluator?: string;
12036
+ ParameterName?: string;
12037
+ Value?: string | number | boolean;
12006
12038
  };
12007
- type ExtendedChangeOrderRead = {
12008
- ChangeOrder?: ChangeOrderRead;
12009
- EndTag?: TagRead;
12010
- Error?: ResponseError;
12011
- Organization?: OrganizationRead;
12012
- RestoreTag?: TagRead;
12013
- Space?: SpaceRead;
12014
- StartTag?: TagRead;
12039
+ type ClearanceRequirement = {
12040
+ /** The guard key this requirement is about */
12041
+ Key?: string;
12042
+ /** Exists, In, NotIn, or DoesNotExist */
12043
+ Operator?: string;
12044
+ /** The values In and NotIn compare against; unused by Exists and DoesNotExist */
12045
+ Values?: string[];
12015
12046
  };
12016
- type ChangeOrderCreateOrUpdateResponse = {
12017
- ChangeOrder?: ChangeOrder;
12018
- Error?: ResponseError;
12047
+ type Clearance = ClearanceRequirement[];
12048
+ type GuardStamp = {
12049
+ [key: string]: string;
12019
12050
  };
12020
- type ChangeOrderCreateOrUpdateResponseRead = {
12021
- ChangeOrder?: ChangeOrderRead;
12022
- Error?: ResponseError;
12051
+ type FunctionInvocation = {
12052
+ /** Function arguments */
12053
+ Arguments?: FunctionArgument[] | null;
12054
+ Clearance?: Clearance;
12055
+ /** Function name */
12056
+ FunctionName?: string;
12057
+ Guards?: GuardStamp;
12058
+ /** Caller-supplied parameter values for expanding templated argument Values; transient, not persisted */
12059
+ Params?: {
12060
+ [key: string]: any;
12061
+ };
12062
+ /** Per-invocation resource filter. AND-combined with the request-level WhereResource. Same path syntax as the request-level field (see ParseAndValidateWhereResource). */
12063
+ WhereResource?: string;
12023
12064
  };
12024
- type ChangeSet = {
12065
+ type FunctionInvocationList = FunctionInvocation[] | null;
12066
+ type Invocation = {
12025
12067
  /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
12026
12068
  Annotations?: {
12027
12069
  [key: string]: string;
12028
12070
  };
12029
- /** ChangeSetID uniquely identifies a changeset within the system. */
12030
- ChangeSetID?: string;
12071
+ /** Unique identifier for a Bridge Worker to execute the functions specified by the Invocation. If unspecified, use the builtin function executor. */
12072
+ BridgeWorkerID?: string;
12031
12073
  /** An optional set of gates that, if any is present, will block deletion. */
12032
12074
  DeleteGates?: {
12033
12075
  [key: string]: boolean;
12034
12076
  };
12035
- /** Description is a human-readable description of the change. */
12036
- Description?: string;
12037
12077
  /** Friendly name for the entity. */
12038
12078
  DisplayName?: string;
12079
+ FunctionInvocations: FunctionInvocationList;
12080
+ /** InvocationID uniquely identifies a invocation within the system. */
12081
+ InvocationID?: string;
12039
12082
  /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
12040
12083
  Labels?: {
12041
12084
  [key: string]: string;
12042
12085
  };
12043
12086
  /** Unique identifier for an organization. */
12044
12087
  OrganizationID?: string;
12088
+ Parameters?: FunctionParameter[];
12045
12089
  /** Unique URL-safe identifier for the entity. */
12046
12090
  Slug: string;
12047
12091
  /** Unique identifier for a space. */
12048
12092
  SpaceID?: string;
12093
+ /** ToolchainType specifies the type of toolchain this invocation works with.
12094
+ This determines which configuration formats the invocation can process. */
12095
+ ToolchainType: string;
12049
12096
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
12050
12097
  Version?: number;
12051
12098
  };
12052
- type ChangeSetRead = {
12099
+ type InvocationRead = {
12053
12100
  /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
12054
12101
  Annotations?: {
12055
12102
  [key: string]: string;
12056
12103
  };
12057
- /** ChangeSetID uniquely identifies a changeset within the system. */
12058
- ChangeSetID?: string;
12104
+ /** Unique identifier for a Bridge Worker to execute the functions specified by the Invocation. If unspecified, use the builtin function executor. */
12105
+ BridgeWorkerID?: string;
12059
12106
  /** The timestamp when the entity was created in "2023-01-01T12:00:00Z" format. */
12060
12107
  CreatedAt?: string;
12061
12108
  /** An auto-incrementing sequence number used for pagination. */
@@ -12064,61 +12111,36 @@ type ChangeSetRead = {
12064
12111
  DeleteGates?: {
12065
12112
  [key: string]: boolean;
12066
12113
  };
12067
- /** Description is a human-readable description of the change. */
12068
- Description?: string;
12069
12114
  /** Friendly name for the entity. */
12070
12115
  DisplayName?: string;
12071
- /** EndTagID is the identifier of the set of revisions that end the ChangeSet. */
12072
- EndTagID?: string;
12073
12116
  /** The type of entity. */
12074
12117
  EntityType?: string;
12118
+ FunctionInvocations: FunctionInvocationList;
12119
+ /** SHA256 hash of the functions and their arguments encoded as hexadecimal. */
12120
+ Hash?: string;
12121
+ /** InvocationID uniquely identifies a invocation within the system. */
12122
+ InvocationID?: string;
12075
12123
  /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
12076
12124
  Labels?: {
12077
12125
  [key: string]: string;
12078
12126
  };
12079
12127
  /** Unique identifier for an organization. */
12080
12128
  OrganizationID?: string;
12129
+ Parameters?: FunctionParameter[];
12081
12130
  /** Unique URL-safe identifier for the entity. */
12082
12131
  Slug: string;
12083
12132
  /** Unique identifier for a space. */
12084
12133
  SpaceID?: string;
12085
12134
  /** Slug of the Space this entity belongs to. (readonly) */
12086
12135
  SpaceSlug?: string;
12087
- /** StartTagID is the identifier of the set of revisions that begin the ChangeSet. */
12088
- StartTagID?: string;
12089
- /** StartTagIsPriorRevision reports whether the start Tag marks the Revision before the ChangeSet, making the ChangeSet the half-open interval (start, end]. False, the original meaning, means it marks the ChangeSet's first Revision. */
12090
- StartTagIsPriorRevision?: boolean;
12091
- /** State represents the current state of the ChangeSet. */
12092
- State?: string;
12136
+ /** ToolchainType specifies the type of toolchain this invocation works with.
12137
+ This determines which configuration formats the invocation can process. */
12138
+ ToolchainType: string;
12093
12139
  /** The timestamp when the entity was last updated in "2023-01-01T12:00:00Z" format. */
12094
12140
  UpdatedAt?: string;
12095
12141
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
12096
12142
  Version?: number;
12097
12143
  };
12098
- type ExtendedChangeSet = {
12099
- ChangeSet?: ChangeSet;
12100
- EndTag?: Tag;
12101
- Error?: ResponseError;
12102
- Organization?: Organization;
12103
- Space?: Space;
12104
- StartTag?: Tag;
12105
- };
12106
- type ExtendedChangeSetRead = {
12107
- ChangeSet?: ChangeSetRead;
12108
- EndTag?: TagRead;
12109
- Error?: ResponseError;
12110
- Organization?: OrganizationRead;
12111
- Space?: SpaceRead;
12112
- StartTag?: TagRead;
12113
- };
12114
- type ChangeSetCreateOrUpdateResponse = {
12115
- ChangeSet?: ChangeSet;
12116
- Error?: ResponseError;
12117
- };
12118
- type ChangeSetCreateOrUpdateResponseRead = {
12119
- ChangeSet?: ChangeSetRead;
12120
- Error?: ResponseError;
12121
- };
12122
12144
  type Filter = {
12123
12145
  /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
12124
12146
  Annotations?: {
@@ -12203,6 +12225,134 @@ type FilterRead = {
12203
12225
  /** WhereData specifies a filter expression for configuration data. Valid only for Units. (optional) */
12204
12226
  WhereData?: string;
12205
12227
  };
12228
+ type ExtendedChangeOrder = {
12229
+ ChangeOrder?: ChangeOrder;
12230
+ EndTag?: Tag;
12231
+ Error?: ResponseError;
12232
+ Invocation?: Invocation;
12233
+ Organization?: Organization;
12234
+ RestoreTag?: Tag;
12235
+ Space?: Space;
12236
+ StartTag?: Tag;
12237
+ UnitFilter?: Filter;
12238
+ };
12239
+ type ExtendedChangeOrderRead = {
12240
+ ChangeOrder?: ChangeOrderRead;
12241
+ EndTag?: TagRead;
12242
+ Error?: ResponseError;
12243
+ Invocation?: InvocationRead;
12244
+ Organization?: OrganizationRead;
12245
+ RestoreTag?: TagRead;
12246
+ Space?: SpaceRead;
12247
+ StartTag?: TagRead;
12248
+ UnitFilter?: FilterRead;
12249
+ };
12250
+ type ChangeOrderCreateOrUpdateResponse = {
12251
+ ChangeOrder?: ChangeOrder;
12252
+ Error?: ResponseError;
12253
+ };
12254
+ type ChangeOrderCreateOrUpdateResponseRead = {
12255
+ ChangeOrder?: ChangeOrderRead;
12256
+ Error?: ResponseError;
12257
+ };
12258
+ type ChangeSet = {
12259
+ /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
12260
+ Annotations?: {
12261
+ [key: string]: string;
12262
+ };
12263
+ /** ChangeSetID uniquely identifies a changeset within the system. */
12264
+ ChangeSetID?: string;
12265
+ /** An optional set of gates that, if any is present, will block deletion. */
12266
+ DeleteGates?: {
12267
+ [key: string]: boolean;
12268
+ };
12269
+ /** Description is a human-readable description of the change. */
12270
+ Description?: string;
12271
+ /** Friendly name for the entity. */
12272
+ DisplayName?: string;
12273
+ /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
12274
+ Labels?: {
12275
+ [key: string]: string;
12276
+ };
12277
+ /** Unique identifier for an organization. */
12278
+ OrganizationID?: string;
12279
+ /** Unique URL-safe identifier for the entity. */
12280
+ Slug: string;
12281
+ /** Unique identifier for a space. */
12282
+ SpaceID?: string;
12283
+ /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
12284
+ Version?: number;
12285
+ };
12286
+ type ChangeSetRead = {
12287
+ /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
12288
+ Annotations?: {
12289
+ [key: string]: string;
12290
+ };
12291
+ /** ChangeSetID uniquely identifies a changeset within the system. */
12292
+ ChangeSetID?: string;
12293
+ /** The timestamp when the entity was created in "2023-01-01T12:00:00Z" format. */
12294
+ CreatedAt?: string;
12295
+ /** An auto-incrementing sequence number used for pagination. */
12296
+ CursorID?: number;
12297
+ /** An optional set of gates that, if any is present, will block deletion. */
12298
+ DeleteGates?: {
12299
+ [key: string]: boolean;
12300
+ };
12301
+ /** Description is a human-readable description of the change. */
12302
+ Description?: string;
12303
+ /** Friendly name for the entity. */
12304
+ DisplayName?: string;
12305
+ /** EndTagID is the identifier of the set of revisions that end the ChangeSet. */
12306
+ EndTagID?: string;
12307
+ /** The type of entity. */
12308
+ EntityType?: string;
12309
+ /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
12310
+ Labels?: {
12311
+ [key: string]: string;
12312
+ };
12313
+ /** Unique identifier for an organization. */
12314
+ OrganizationID?: string;
12315
+ /** Unique URL-safe identifier for the entity. */
12316
+ Slug: string;
12317
+ /** Unique identifier for a space. */
12318
+ SpaceID?: string;
12319
+ /** Slug of the Space this entity belongs to. (readonly) */
12320
+ SpaceSlug?: string;
12321
+ /** StartTagID is the identifier of the set of revisions that begin the ChangeSet. */
12322
+ StartTagID?: string;
12323
+ /** StartTagIsPriorRevision reports whether the start Tag marks the Revision before the ChangeSet, making the ChangeSet the half-open interval (start, end]. False, the original meaning, means it marks the ChangeSet's first Revision. */
12324
+ StartTagIsPriorRevision?: boolean;
12325
+ /** State represents the current state of the ChangeSet. */
12326
+ State?: string;
12327
+ /** The timestamp when the entity was last updated in "2023-01-01T12:00:00Z" format. */
12328
+ UpdatedAt?: string;
12329
+ /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
12330
+ Version?: number;
12331
+ };
12332
+ type ExtendedChangeSet = {
12333
+ ChangeSet?: ChangeSet;
12334
+ EndTag?: Tag;
12335
+ Error?: ResponseError;
12336
+ Organization?: Organization;
12337
+ Space?: Space;
12338
+ StartTag?: Tag;
12339
+ };
12340
+ type ExtendedChangeSetRead = {
12341
+ ChangeSet?: ChangeSetRead;
12342
+ EndTag?: TagRead;
12343
+ Error?: ResponseError;
12344
+ Organization?: OrganizationRead;
12345
+ Space?: SpaceRead;
12346
+ StartTag?: TagRead;
12347
+ };
12348
+ type ChangeSetCreateOrUpdateResponse = {
12349
+ ChangeSet?: ChangeSet;
12350
+ Error?: ResponseError;
12351
+ };
12352
+ type ChangeSetCreateOrUpdateResponseRead = {
12353
+ ChangeSet?: ChangeSetRead;
12354
+ Error?: ResponseError;
12355
+ };
12206
12356
  type ExtendedFilter = {
12207
12357
  Error?: ResponseError;
12208
12358
  Filter?: Filter;
@@ -12343,38 +12493,6 @@ type FunctionInvocationsResponse = {
12343
12493
  /** Slug of the Unit */
12344
12494
  UnitSlug?: string;
12345
12495
  };
12346
- type FunctionArgument = {
12347
- Evaluator?: string;
12348
- ParameterName?: string;
12349
- Value?: string | number | boolean;
12350
- };
12351
- type ClearanceRequirement = {
12352
- /** The guard key this requirement is about */
12353
- Key?: string;
12354
- /** Exists, In, NotIn, or DoesNotExist */
12355
- Operator?: string;
12356
- /** The values In and NotIn compare against; unused by Exists and DoesNotExist */
12357
- Values?: string[];
12358
- };
12359
- type Clearance = ClearanceRequirement[];
12360
- type GuardStamp = {
12361
- [key: string]: string;
12362
- };
12363
- type FunctionInvocation = {
12364
- /** Function arguments */
12365
- Arguments?: FunctionArgument[] | null;
12366
- Clearance?: Clearance;
12367
- /** Function name */
12368
- FunctionName?: string;
12369
- Guards?: GuardStamp;
12370
- /** Caller-supplied parameter values for expanding templated argument Values; transient, not persisted */
12371
- Params?: {
12372
- [key: string]: any;
12373
- };
12374
- /** Per-invocation resource filter. AND-combined with the request-level WhereResource. Same path syntax as the request-level field (see ParseAndValidateWhereResource). */
12375
- WhereResource?: string;
12376
- };
12377
- type FunctionInvocationList = FunctionInvocation[] | null;
12378
12496
  type ParameterizedInvocationRef = {
12379
12497
  InvocationID?: string;
12380
12498
  Parameters?: {
@@ -12400,7 +12518,10 @@ type FunctionInvocationsRequest = {
12400
12518
  ToolchainType?: string;
12401
12519
  /** Triggers is a list of Trigger IDs to execute. The triggers must be within the same Organization. Triggers will be executed after the FunctionInvocations list. Functions are grouped by executor (built-in vs bridge worker) and executed in phases: general mutating functions first, then final mutating functions (like ensure-context), then validating functions. Functions that don't match the unit's toolchain type are ignored. */
12402
12520
  Triggers?: Uuid[];
12521
+ /** Deprecated: use UpdateValidationResults, which this means the same thing as. Setting either has the same effect. */
12403
12522
  UpdateApplyGates?: boolean;
12523
+ /** UpdateValidationResults indicates that the results of Trigger execution should be used to update ValidationErrors and ValidationWarnings on the affected Units. Requires Triggers to be specified. */
12524
+ UpdateValidationResults?: boolean;
12404
12525
  /** WhereResource restricts which resources functions operate on using ConfigHub metadata path expressions (ConfigHub.ResourceName, ConfigHub.ResourceNameWithoutScope, ConfigHub.ResourceType, ConfigHub.ResourceCategory). */
12405
12526
  WhereResource?: string;
12406
12527
  };
@@ -12428,84 +12549,6 @@ type ApiInfoRead = {
12428
12549
  /** Deprecated and always empty. Workers connect over long polling on the main API port; there is no separate worker port. */
12429
12550
  WorkerPort?: string;
12430
12551
  };
12431
- type Invocation = {
12432
- /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
12433
- Annotations?: {
12434
- [key: string]: string;
12435
- };
12436
- /** Unique identifier for a Bridge Worker to execute the functions specified by the Invocation. If unspecified, use the builtin function executor. */
12437
- BridgeWorkerID?: string;
12438
- /** An optional set of gates that, if any is present, will block deletion. */
12439
- DeleteGates?: {
12440
- [key: string]: boolean;
12441
- };
12442
- /** Friendly name for the entity. */
12443
- DisplayName?: string;
12444
- FunctionInvocations: FunctionInvocationList;
12445
- /** InvocationID uniquely identifies a invocation within the system. */
12446
- InvocationID?: string;
12447
- /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
12448
- Labels?: {
12449
- [key: string]: string;
12450
- };
12451
- /** Unique identifier for an organization. */
12452
- OrganizationID?: string;
12453
- Parameters?: FunctionParameter[];
12454
- /** Unique URL-safe identifier for the entity. */
12455
- Slug: string;
12456
- /** Unique identifier for a space. */
12457
- SpaceID?: string;
12458
- /** ToolchainType specifies the type of toolchain this invocation works with.
12459
- This determines which configuration formats the invocation can process. */
12460
- ToolchainType: string;
12461
- /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
12462
- Version?: number;
12463
- };
12464
- type InvocationRead = {
12465
- /** An optional map of Annotation key/value pairs for tools to attach information to entities. */
12466
- Annotations?: {
12467
- [key: string]: string;
12468
- };
12469
- /** Unique identifier for a Bridge Worker to execute the functions specified by the Invocation. If unspecified, use the builtin function executor. */
12470
- BridgeWorkerID?: string;
12471
- /** The timestamp when the entity was created in "2023-01-01T12:00:00Z" format. */
12472
- CreatedAt?: string;
12473
- /** An auto-incrementing sequence number used for pagination. */
12474
- CursorID?: number;
12475
- /** An optional set of gates that, if any is present, will block deletion. */
12476
- DeleteGates?: {
12477
- [key: string]: boolean;
12478
- };
12479
- /** Friendly name for the entity. */
12480
- DisplayName?: string;
12481
- /** The type of entity. */
12482
- EntityType?: string;
12483
- FunctionInvocations: FunctionInvocationList;
12484
- /** SHA256 hash of the functions and their arguments encoded as hexadecimal. */
12485
- Hash?: string;
12486
- /** InvocationID uniquely identifies a invocation within the system. */
12487
- InvocationID?: string;
12488
- /** An optional map of Label key/value pairs to specify identifying attributes of entities for the purpose of grouping and filtering them. */
12489
- Labels?: {
12490
- [key: string]: string;
12491
- };
12492
- /** Unique identifier for an organization. */
12493
- OrganizationID?: string;
12494
- Parameters?: FunctionParameter[];
12495
- /** Unique URL-safe identifier for the entity. */
12496
- Slug: string;
12497
- /** Unique identifier for a space. */
12498
- SpaceID?: string;
12499
- /** Slug of the Space this entity belongs to. (readonly) */
12500
- SpaceSlug?: string;
12501
- /** ToolchainType specifies the type of toolchain this invocation works with.
12502
- This determines which configuration formats the invocation can process. */
12503
- ToolchainType: string;
12504
- /** The timestamp when the entity was last updated in "2023-01-01T12:00:00Z" format. */
12505
- UpdatedAt?: string;
12506
- /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
12507
- Version?: number;
12508
- };
12509
12552
  type ExtendedInvocation = {
12510
12553
  BridgeWorker?: BridgeWorker;
12511
12554
  Error?: ResponseError;
@@ -12674,11 +12717,11 @@ type UnitRead = {
12674
12717
  Annotations?: {
12675
12718
  [key: string]: string;
12676
12719
  };
12677
- /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers invoking validating functions that did not pass on the latest configuration data. These block Apply operations. */
12720
+ /** Deprecated: use ValidationErrors, which this is a copy of. Returned for compatibility with clients written before the field was renamed; it cannot be set. */
12678
12721
  ApplyGates?: {
12679
12722
  [key: string]: boolean;
12680
12723
  };
12681
- /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers with Warn=true invoking validating functions that did not pass on the latest configuration data. These do not block Apply operations. */
12724
+ /** Deprecated: use ValidationWarnings, which this is a copy of. Returned for compatibility with clients written before the field was renamed; it cannot be set. */
12682
12725
  ApplyWarnings?: {
12683
12726
  [key: string]: boolean;
12684
12727
  };
@@ -12760,10 +12803,18 @@ type UnitRead = {
12760
12803
  UpstreamSpaceID?: string;
12761
12804
  /** Unique identifier for Unit this unit was cloned from, if any. To change or remove the upstream unit, change or delete the corresponding Link of UpdateType UpgradeUnit from this Unit to the upstream Unit. */
12762
12805
  UpstreamUnitID?: string;
12806
+ /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers invoking validating functions that did not pass on the latest configuration data. These block Release operations. */
12807
+ ValidationErrors?: {
12808
+ [key: string]: boolean;
12809
+ };
12763
12810
  /** A map from gate/warning name to the list of validation results that caused the gate or warning. */
12764
12811
  ValidationResults?: {
12765
12812
  [key: string]: ValidationResultList;
12766
12813
  };
12814
+ /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers with Warn=true invoking validating functions that did not pass on the latest configuration data. These do not block Release operations. */
12815
+ ValidationWarnings?: {
12816
+ [key: string]: boolean;
12817
+ };
12767
12818
  /** Map from "<trigger slug>/<attribute name>" to the first output Value with that attribute name of the function invocation specified by the Trigger. */
12768
12819
  Values?: {
12769
12820
  [key: string]: string;
@@ -13514,14 +13565,6 @@ type ExtendedResourceRead = {
13514
13565
  ViewColumns?: ViewColumn[];
13515
13566
  };
13516
13567
  type Revision = {
13517
- /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers invoking validating functions that did not pass on the configuration data at this Revision. These block Apply operations. */
13518
- ApplyGates?: {
13519
- [key: string]: boolean;
13520
- };
13521
- /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers with Warn=true invoking validating functions that did not pass on the configuration data at this Revision. These do not block Apply operations. */
13522
- ApplyWarnings?: {
13523
- [key: string]: boolean;
13524
- };
13525
13568
  /** the users that have approved the latest version of the config data for the Unit. */
13526
13569
  ApprovedBy?: Uuid[];
13527
13570
  /** Unique identifier for the ChangeSet to which this Revision belongs. Optional. Revisions are not required to belong to ChangeSets. */
@@ -13556,15 +13599,23 @@ type Revision = {
13556
13599
  UserAgent?: string;
13557
13600
  /** UserID if change was made by a user. Automated changes, such as by triggers and resolve, are currently made with the UserID "00000000-0000-0000-0000-000000000000". */
13558
13601
  UserID?: string;
13602
+ /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers invoking validating functions that did not pass on the configuration data at this Revision. These block Release operations. */
13603
+ ValidationErrors?: {
13604
+ [key: string]: boolean;
13605
+ };
13606
+ /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers with Warn=true invoking validating functions that did not pass on the configuration data at this Revision. These do not block Release operations. */
13607
+ ValidationWarnings?: {
13608
+ [key: string]: boolean;
13609
+ };
13559
13610
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
13560
13611
  Version?: number;
13561
13612
  };
13562
13613
  type RevisionRead = {
13563
- /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers invoking validating functions that did not pass on the configuration data at this Revision. These block Apply operations. */
13614
+ /** Deprecated: use ValidationErrors, which this is a copy of. Returned for compatibility with clients written before the field was renamed; it cannot be set. */
13564
13615
  ApplyGates?: {
13565
13616
  [key: string]: boolean;
13566
13617
  };
13567
- /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers with Warn=true invoking validating functions that did not pass on the configuration data at this Revision. These do not block Apply operations. */
13618
+ /** Deprecated: use ValidationWarnings, which this is a copy of. Returned for compatibility with clients written before the field was renamed; it cannot be set. */
13568
13619
  ApplyWarnings?: {
13569
13620
  [key: string]: boolean;
13570
13621
  };
@@ -13619,6 +13670,14 @@ type RevisionRead = {
13619
13670
  UserAgent?: string;
13620
13671
  /** UserID if change was made by a user. Automated changes, such as by triggers and resolve, are currently made with the UserID "00000000-0000-0000-0000-000000000000". */
13621
13672
  UserID?: string;
13673
+ /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers invoking validating functions that did not pass on the configuration data at this Revision. These block Release operations. */
13674
+ ValidationErrors?: {
13675
+ [key: string]: boolean;
13676
+ };
13677
+ /** A map of "<space slug>/<trigger slug>/<function name>" to true of Triggers with Warn=true invoking validating functions that did not pass on the configuration data at this Revision. These do not block Release operations. */
13678
+ ValidationWarnings?: {
13679
+ [key: string]: boolean;
13680
+ };
13622
13681
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
13623
13682
  Version?: number;
13624
13683
  };
@@ -13768,7 +13827,7 @@ type Trigger = {
13768
13827
  UnitFilterID?: string;
13769
13828
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
13770
13829
  Version?: number;
13771
- /** Warn indicates whether this trigger produces ApplyWarnings instead of ApplyGates when its validating function fails. ApplyWarnings are non-blocking. */
13830
+ /** Warn indicates whether this trigger produces ValidationWarnings instead of ValidationErrors when its validating function fails. ValidationWarnings are non-blocking. */
13772
13831
  Warn?: boolean;
13773
13832
  /** Restricts which resources within a Unit's configuration data the Trigger's function operates on, using ConfigHub metadata path expressions. */
13774
13833
  WhereResource?: string;
@@ -13849,7 +13908,7 @@ type TriggerRead = {
13849
13908
  Validating?: boolean;
13850
13909
  /** An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update. */
13851
13910
  Version?: number;
13852
- /** Warn indicates whether this trigger produces ApplyWarnings instead of ApplyGates when its validating function fails. ApplyWarnings are non-blocking. */
13911
+ /** Warn indicates whether this trigger produces ValidationWarnings instead of ValidationErrors when its validating function fails. ValidationWarnings are non-blocking. */
13853
13912
  Warn?: boolean;
13854
13913
  /** Restricts which resources within a Unit's configuration data the Trigger's function operates on, using ConfigHub metadata path expressions. */
13855
13914
  WhereResource?: string;