v1alpha1

type AlreadyExists = Error

type BadRequest = Error

type CreatePolicyJSONRequestBody = Policy

type CreatePolicyParams struct {
	// Id Optional client-specified ID for the policy. If not provided, the
	// server will generate a UUID.
	//
	// Requirements (per AEP-122):
	// - 1-63 characters long
	// - Start with lowercase letter
	// - Contain only lowercase letters, numbers, and hyphens
	// - End with letter or number
	Id *string `form:"id,omitempty" json:"id,omitempty"`
}

type Error struct {
	// Detail Human-readable explanation specific to this occurrence of the problem.
	// Should provide actionable information for developers.
	Detail *string `json:"detail,omitempty"`

	// Instance Unique identifier for this specific error occurrence. Useful for
	// tracking and debugging.
	Instance *string `json:"instance,omitempty"`

	// Status HTTP status code
	Status int32 `json:"status"`

	// Title Human-readable summary of the problem type
	Title string `json:"title"`

	// Type URI reference identifying the problem type. This is the canonical
	// error code.
	Type ErrorType `json:"type"`
}

type ErrorType string

type Forbidden = Error

type Health struct {
	// Path Canonical path of the resource
	Path *string `json:"path,omitempty"`

	// Status Health status
	Status string `json:"status"`
}

type InternalServerError = Error

type ListPoliciesParams struct {
	// PageToken Token for retrieving the next page of results. Leave empty for
	// the first page. Use the `next_page_token` from the previous
	// response to get the next page.
	PageToken *string `form:"page_token,omitempty" json:"page_token,omitempty"`

	// MaxPageSize Maximum number of policies to return per page. Server may return
	// fewer results. If unspecified, defaults to 50. Maximum value is 1000.
	MaxPageSize *int32 `form:"max_page_size,omitempty" json:"max_page_size,omitempty"`

	// Filter Filter expression to apply to the list. Supports filtering by:
	// - `policy_type`: GLOBAL or USER
	// - `enabled`: true or false
	//
	// Examples:
	// - `policy_type='GLOBAL'`
	// - `enabled=true`
	// - `policy_type='GLOBAL' AND enabled=true`
	Filter *string `form:"filter,omitempty" json:"filter,omitempty"`

	// OrderBy Comma-separated list of fields to order by. Each field can be
	// followed by 'asc' or 'desc'. Defaults to 'priority asc'.
	//
	// Supported fields:
	// - priority
	// - display_name
	// - create_time
	//
	// Examples:
	// - `priority asc`
	// - `display_name desc`
	// - `create_time desc,priority asc`
	OrderBy *string `form:"order_by,omitempty" json:"order_by,omitempty"`
}

type NotFound = Error

type Policy struct {
	// CreateTime Timestamp when the policy was created. This field is output-only
	// and automatically set by the server.
	//
	// Uses ISO 8601 format with timezone per AEP-140.
	CreateTime *time.Time `json:"create_time,omitempty"`

	// Description Optional detailed description of the policy's purpose and behavior.
	// Supports markdown formatting.
	Description *string `json:"description,omitempty"`

	// DisplayName Human-readable name for the policy. This is typically shown in
	// user interfaces and should be descriptive.
	DisplayName *string `json:"display_name,omitempty"`

	// Enabled Whether the policy is currently active. Disabled policies are not
	// evaluated during authorization decisions.
	Enabled *bool `json:"enabled,omitempty"`

	// Id Unique identifier for the policy. This field is output-only and
	// immutable after creation. The ID can be optionally specified via
	// query parameter on creation; if not provided, the server generates a UUID.
	//
	// Follows AEP-122 resource ID conventions.
	Id *string `json:"id,omitempty"`

	// LabelSelector Key-value pairs used to match this policy against incoming requests.
	// The policy is evaluated only if all labels match the request context.
	// If no label selector is provided, the policy is evaluated for all requests.
	//
	// Common label keys:
	// - environment: production, staging, development
	// - user_id: user identifier
	// - service: service name
	// - region: geographical region
	// - tier: service tier (critical, standard, etc.)
	LabelSelector *map[string]string `json:"label_selector,omitempty"`

	// Path Resource path in the format "policies/{policyId}".
	// This field is output-only and set by the server.
	//
	// Follows AEP-122 resource path conventions.
	Path *string `json:"path,omitempty"`

	// PolicyType Scope of the policy application. This field is immutable after creation.
	//
	// - GLOBAL: Applies to all requests across the system
	// - USER: Applies to requests for a specific user
	//
	// Policies are evaluated in hierarchical order: Global -> User
	PolicyType *PolicyPolicyType `json:"policy_type,omitempty"`

	// Priority Priority value for policy evaluation order. Lower numbers have
	// higher priority and are evaluated first.
	//
	// Valid range: 1-1000
	// - 1-100: Critical/system policies
	// - 101-500: Standard policies
	// - 501-1000: Low-priority policies
	Priority *int32 `json:"priority,omitempty"`

	// RegoCode The OPA Rego policy code. This code is executed when the policy
	// is evaluated. Must be valid Rego syntax.
	//
	// The code should define a package and decision rules. Common patterns:
	// - Define a default allow/deny
	// - Implement conditional logic based on input
	// - Reference data from the policy engine
	//
	// The Rego code is validated on create and update operations.
	RegoCode *string `json:"rego_code,omitempty"`

	// UpdateTime Timestamp when the policy was last updated. This field is output-only
	// and automatically updated by the server on any modification.
	//
	// Uses ISO 8601 format with timezone per AEP-140.
	UpdateTime *time.Time `json:"update_time,omitempty"`
}

type PolicyIdPath = string

type PolicyList struct {
	// NextPageToken Token for retrieving the next page of results. If empty or not
	// present, there are no more results.
	//
	// This token is opaque and should not be parsed by clients.
	NextPageToken *string `json:"next_page_token,omitempty"`

	// Policies List of policy resources matching the request criteria
	Policies []Policy `json:"policies"`
}

type PolicyPolicyType string

type Unauthorized = Error

type UpdatePolicyApplicationMergePatchPlusJSONRequestBody = Policy

type ValidationError = Error