feat: add Campaign CRUD methods and input/payload types

Adds GetCampaign, CreateCampaign, UpdateCampaign, DeleteCampaign,
ScheduleCampaign, and UnscheduleCampaign client methods along with
their corresponding input and payload types. These are needed by
the terraform-provider-opslevel campaign resource.

Made-with: Cursor

Author: jamescarr

campaign.go

@@ -25,6 +25,76 @@ func (v *ListCampaignsVariables) AsPayloadVariables() *PayloadVariables {
 	return &variables
 }
 
+func (client *Client) CreateCampaign(input CampaignCreateInput) (*Campaign, error) {
+	var m struct {
+		Payload CampaignCreatePayload `graphql:"campaignCreate(input: $input)"`
+	}
+	v := PayloadVariables{
+		"input": input,
+	}
+	err := client.Mutate(&m, v, WithName("CampaignCreate"))
+	return &m.Payload.Campaign, HandleErrors(err, m.Payload.Errors)
+}
+
+func (client *Client) GetCampaign(id ID) (*Campaign, error) {
+	var q struct {
+		Account struct {
+			Campaign Campaign `graphql:"campaign(id: $id)"`
+		}
+	}
+	v := PayloadVariables{
+		"id": id,
+	}
+	err := client.Query(&q, v, WithName("CampaignGet"))
+	return &q.Account.Campaign, HandleErrors(err, nil)
+}
+
+func (client *Client) UpdateCampaign(input CampaignUpdateInput) (*Campaign, error) {
+	var m struct {
+		Payload CampaignUpdatePayload `graphql:"campaignUpdate(input: $input)"`
+	}
+	v := PayloadVariables{
+		"input": input,
+	}
+	err := client.Mutate(&m, v, WithName("CampaignUpdate"))
+	return &m.Payload.Campaign, HandleErrors(err, m.Payload.Errors)
+}
+
+func (client *Client) DeleteCampaign(id ID) error {
+	var m struct {
+		Payload CampaignDeletePayload `graphql:"campaignDelete(input: $input)"`
+	}
+	v := PayloadVariables{
+		"input": CampaignDeleteInput{Id: id},
+	}
+	err := client.Mutate(&m, v, WithName("CampaignDelete"))
+	return HandleErrors(err, m.Payload.Errors)
+}
+
+func (client *Client) ScheduleCampaign(input CampaignScheduleUpdateInput) (*Campaign, error) {
+	var m struct {
+		Payload CampaignSchedulePayload `graphql:"campaignSchedule(input: $input)"`
+	}
+	v := PayloadVariables{
+		"input": input,
+	}
+	err := client.Mutate(&m, v, WithName("CampaignSchedule"))
+	return &m.Payload.Campaign, HandleErrors(err, m.Payload.Errors)
+}
+
+func (client *Client) UnscheduleCampaign(id ID) (*Campaign, error) {
+	var m struct {
+		Payload CampaignUnschedulePayload `graphql:"campaignUnschedule(input: $input)"`
+	}
+	v := PayloadVariables{
+		"input": struct {
+			Id ID `json:"id"`
+		}{Id: id},
+	}
+	err := client.Mutate(&m, v, WithName("CampaignUnschedule"))
+	return &m.Payload.Campaign, HandleErrors(err, m.Payload.Errors)
+}
+
 func (client *Client) ListCampaigns(campaignVariables *ListCampaignsVariables) (*CampaignConnection, error) {
 	if campaignVariables == nil {
 		campaignVariables = &ListCampaignsVariables{}

input.go

@@ -93,6 +93,35 @@ type CategoryUpdateInput struct {
 	Name        *Nullable[string] `json:"name,omitempty" yaml:"name,omitempty" example:"example_value"`               // The display name of the category (Optional)
 }
 
+// CampaignCreateInput Specifies the input fields used to create a campaign
+type CampaignCreateInput struct {
+	Name         string           `json:"name" yaml:"name" example:"example_value"`                                                    // The name of the campaign (Required)
+	OwnerId      ID               `json:"ownerId" yaml:"ownerId" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"`                           // The id of the team that owns the campaign (Required)
+	FilterId     *Nullable[ID]    `json:"filterId,omitempty" yaml:"filterId,omitempty" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"`      // The id of the filter applied to the campaign (Optional)
+	ProjectBrief *string          `json:"projectBrief,omitempty" yaml:"projectBrief,omitempty" example:"example_value"`                 // The project brief of the campaign in Markdown (Optional)
+}
+
+// CampaignDeleteInput Specifies the input fields used to delete a campaign
+type CampaignDeleteInput struct {
+	Id ID `json:"id" yaml:"id" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"` // The id of the campaign to be deleted (Required)
+}
+
+// CampaignScheduleUpdateInput Specifies the input fields used to schedule a campaign
+type CampaignScheduleUpdateInput struct {
+	Id         ID           `json:"id" yaml:"id" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"`                    // The id of the campaign to be scheduled (Required)
+	StartDate  iso8601.Time `json:"startDate" yaml:"startDate" example:"2025-01-01T00:00:00Z"`                  // The start date of the campaign (Required)
+	TargetDate iso8601.Time `json:"targetDate" yaml:"targetDate" example:"2025-06-01T00:00:00Z"`                // The target end date of the campaign (Required)
+}
+
+// CampaignUpdateInput Specifies the input fields used to update a campaign
+type CampaignUpdateInput struct {
+	Id           ID               `json:"id" yaml:"id" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"`                                      // The id of the campaign to be updated (Required)
+	Name         *string          `json:"name,omitempty" yaml:"name,omitempty" example:"example_value"`                                  // The name of the campaign (Optional)
+	OwnerId      *Nullable[ID]    `json:"ownerId,omitempty" yaml:"ownerId,omitempty" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"`         // The id of the team that owns the campaign (Optional)
+	FilterId     *Nullable[ID]    `json:"filterId,omitempty" yaml:"filterId,omitempty" example:"Z2lkOi8vc2VydmljZS8xMjM0NTY3ODk"`       // The id of the filter applied to the campaign (Optional)
+	ProjectBrief *string          `json:"projectBrief,omitempty" yaml:"projectBrief,omitempty" example:"example_value"`                  // The project brief of the campaign in Markdown (Optional)
+}
+
 // CheckAlertSourceUsageCreateInput Specifies the input fields used to create an alert source usage check
 type CheckAlertSourceUsageCreateInput struct {
 	AlertSourceNamePredicate *PredicateInput         `json:"alertSourceNamePredicate,omitempty" yaml:"alertSourceNamePredicate,omitempty"`           // The condition that the alert source name should satisfy to be evaluated (Optional)

payload.go

@@ -30,6 +30,36 @@ type CategoryUpdatePayload struct {
 	BasePayload
 }
 
+// CampaignCreatePayload The return type of the `campaignCreate` mutation
+type CampaignCreatePayload struct {
+	Campaign Campaign // The created campaign (Optional)
+	BasePayload
+}
+
+// CampaignUpdatePayload The return type of the `campaignUpdate` mutation
+type CampaignUpdatePayload struct {
+	Campaign Campaign // The updated campaign (Optional)
+	BasePayload
+}
+
+// CampaignSchedulePayload The return type of the `campaignSchedule` mutation
+type CampaignSchedulePayload struct {
+	Campaign Campaign // The scheduled campaign (Optional)
+	BasePayload
+}
+
+// CampaignUnschedulePayload The return type of the `campaignUnschedule` mutation
+type CampaignUnschedulePayload struct {
+	Campaign Campaign // The unscheduled campaign (Optional)
+	BasePayload
+}
+
+// CampaignDeletePayload The return type of the `campaignDelete` mutation
+type CampaignDeletePayload struct {
+	Id ID `graphql:"deletedCampaignId"` // The id of the deleted campaign
+	BasePayload
+}
+
 // CheckCopyPayload The result of a check copying operation
 type CheckCopyPayload struct {
 	TargetCategory Category // The category to which the checks have been copied (Optional)