common

type AnonKey struct {
	CreatedAt *time.Time         `json:"created_at,omitempty"`
	Id        openapi_types.UUID `json:"id"`

	// IsDefault Whether this is the project's configured default anon key. Only one key per project can be default.
	IsDefault *bool `json:"is_default,omitempty"`

	// KeyValue JWT token - use this in frontend Authorization header
	KeyValue string `json:"key_value"`
	Name     string `json:"name"`

	// Permissions Permissions granted to this anon key.
	// Auth permissions: auth.signup, auth.signin, auth.refresh, auth.logout, auth.password_reset, auth.confirm_email, auth.resend_confirmation
	// Storage permissions: storage.upload, storage.download, storage.list, storage.delete
	// Realtime permissions: realtime.connect, realtime.subscribe, realtime.publish
	// Functions permissions: functions.invoke
	Permissions *[]string           `json:"permissions,omitempty"`
	ProjectId   *openapi_types.UUID `json:"project_id,omitempty"`
}

type AuthConfig struct {
	// AccessTokenLifetime Access token lifetime in seconds
	AccessTokenLifetime *int `json:"access_token_lifetime,omitempty"`

	// AllowPasswordReset Enable forgot password flow
	AllowPasswordReset *bool `json:"allow_password_reset,omitempty"`

	// AllowedRedirectUrls Redirect allowlist used to validate post_auth_redirect_url and post_logout_redirect_url.
	AllowedRedirectUrls *[]string `json:"allowed_redirect_urls,omitempty"`

	// CorsAllowCredentials Allow credentials in CORS requests
	CorsAllowCredentials *bool     `json:"cors_allow_credentials,omitempty"`
	CorsAllowedOrigins   *[]string `json:"cors_allowed_origins,omitempty"`
	CorsEnabled          *bool     `json:"cors_enabled,omitempty"`

	// CorsMaxAge CORS preflight cache duration (seconds)
	CorsMaxAge *int `json:"cors_max_age,omitempty"`

	// DeviceVerificationUrl Optional override for the device-authorization verification page.
	// When set, POST /auth/device/authorize returns this URL (with the
	// user_code) as verification_uri/verification_uri_complete instead of
	// the built-in managed device page. Lets a CLI surface the project's
	// own RFC 8628 approval page. Empty falls back to the managed page.
	DeviceVerificationUrl    *string `json:"device_verification_url,omitempty"`
	EmailConfirmationSubject *string `json:"email_confirmation_subject,omitempty"`

	// EmailEnabled Enable transactional email sending (confirmation, reset, change notifications). Must be true when require_email_confirmation is true.
	EmailEnabled                *bool   `json:"email_enabled,omitempty"`
	EmailFromAddress            *string `json:"email_from_address,omitempty"`
	EmailFromName               *string `json:"email_from_name,omitempty"`
	EmailPasswordChangedSubject *string `json:"email_password_changed_subject,omitempty"`
	EmailPasswordResetSubject   *string `json:"email_password_reset_subject,omitempty"`

	// EnableAnonymousSignins Allow creating users without email/password
	EnableAnonymousSignins *bool `json:"enable_anonymous_signins,omitempty"`

	// EnableEmailPassword Enable email/password authentication as a provider
	EnableEmailPassword *bool `json:"enable_email_password,omitempty"`

	// EnableSignup Master switch - allow new user signups via ANY provider
	EnableSignup *bool `json:"enable_signup,omitempty"`

	// InactivityTimeout Force re-login after inactivity (seconds, 0=never)
	InactivityTimeout *int `json:"inactivity_timeout,omitempty"`

	// ManagedAuthEnabled Enables project-hosted managed auth pages.
	ManagedAuthEnabled *bool `json:"managed_auth_enabled,omitempty"`

	// MaxPasswordHistory Number of previous passwords to remember (0=disabled)
	MaxPasswordHistory *int `json:"max_password_history,omitempty"`

	// MaxSessionDuration Force re-login after duration (seconds, 0=never)
	MaxSessionDuration *int `json:"max_session_duration,omitempty"`
	MinPasswordLength  *int `json:"min_password_length,omitempty"`

	// PasswordResetTimeout Recovery token expiry in seconds
	PasswordResetTimeout *int `json:"password_reset_timeout,omitempty"`

	// PlatformTokenTtl TTL in seconds for platform tokens minted via `/auth/platform/exchange`
	PlatformTokenTtl *int `json:"platform_token_ttl,omitempty"`

	// PostAuthRedirectUrl Default redirect target after successful hosted auth.
	PostAuthRedirectUrl *string `json:"post_auth_redirect_url,omitempty"`

	// PostLogoutRedirectUrl Redirect target after logout from hosted pages.
	PostLogoutRedirectUrl *string             `json:"post_logout_redirect_url,omitempty"`
	ProjectId             *openapi_types.UUID `json:"project_id,omitempty"`

	// RateLimitSignin Signins per hour per IP
	RateLimitSignin *int `json:"rate_limit_signin,omitempty"`

	// RateLimitSignup Signups per hour per IP
	RateLimitSignup *int `json:"rate_limit_signup,omitempty"`

	// RateLimitTokenRefresh Refreshes per hour per IP
	RateLimitTokenRefresh *int `json:"rate_limit_token_refresh,omitempty"`

	// RefreshTokenLifetime Refresh token lifetime in seconds
	RefreshTokenLifetime *int    `json:"refresh_token_lifetime,omitempty"`
	RequireLowercase     *bool   `json:"require_lowercase,omitempty"`
	RequireNumbers       *bool   `json:"require_numbers,omitempty"`
	RequireSpecialChars  *bool   `json:"require_special_chars,omitempty"`
	RequireUppercase     *bool   `json:"require_uppercase,omitempty"`
	SmtpHost             *string `json:"smtp_host,omitempty"`

	// SmtpPassword SMTP password. Stored encrypted at rest (AES-256-GCM); returned decrypted only to the authenticated project owner.
	SmtpPassword *string `json:"smtp_password,omitempty"`
	SmtpPort     *int    `json:"smtp_port,omitempty"`
	SmtpUseTls   *bool   `json:"smtp_use_tls,omitempty"`
	SmtpUsername *string `json:"smtp_username,omitempty"`
}

type AuthHostedPage struct {
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Css CSS content for this page type.
	Css *string `json:"css,omitempty"`

	// Html HTML content for this page type.
	Html      *string             `json:"html,omitempty"`
	Id        *openapi_types.UUID `json:"id,omitempty"`
	PageType  *HostedAuthPageType `json:"page_type,omitempty"`
	ProjectId *openapi_types.UUID `json:"project_id,omitempty"`
	UpdatedAt *time.Time          `json:"updated_at,omitempty"`
}

type AuthHostedPageResponse struct {
	Page *AuthHostedPage `json:"page,omitempty"`
}

type AuthSession struct {
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// ExpiresAt When this session expires
	ExpiresAt time.Time `json:"expires_at"`

	// Id Unique session identifier
	Id openapi_types.UUID `json:"id"`

	// IpAddress IP address of the client when the session was created
	IpAddress *string `json:"ip_address,omitempty"`

	// IsActive Whether the session is currently active (not expired)
	IsActive *bool `json:"is_active,omitempty"`

	// IsCurrent Whether this is the session making the current request
	IsCurrent *bool `json:"is_current,omitempty"`

	// LastActivityAt Last activity timestamp
	LastActivityAt *time.Time `json:"last_activity_at,omitempty"`

	// LastIpAddress IP address of the most recent activity (token refresh)
	LastIpAddress *string `json:"last_ip_address,omitempty"`

	// Provider Authentication provider used to create this session
	Provider AuthSessionProvider `json:"provider"`

	// SessionStartedAt When the session was created
	SessionStartedAt *time.Time `json:"session_started_at,omitempty"`
	UpdatedAt        *time.Time `json:"updated_at,omitempty"`

	// UserAgent Browser/device user agent string
	UserAgent *string `json:"user_agent,omitempty"`

	// UserId The user this session belongs to
	UserId openapi_types.UUID `json:"user_id"`
}

type AuthSessionProvider string

type AuthTokenResponse struct {
	// AccessToken JWT access token (expires after configured lifetime)
	AccessToken string `json:"access_token"`

	// ExpiresIn Access token lifetime in seconds
	ExpiresIn int `json:"expires_in"`

	// RefreshToken Long-lived token for getting new access tokens
	RefreshToken string   `json:"refresh_token"`
	TokenType    string   `json:"token_type"`
	User         AuthUser `json:"user"`
}

type AuthUser struct {
	// AppMetadata Application-controlled metadata (read-only for users)
	AppMetadata *map[string]interface{} `json:"app_metadata,omitempty"`

	// AvatarUrl User avatar URL (from OAuth provider or manually set)
	AvatarUrl *string `json:"avatar_url,omitempty"`

	// BannedUntil When temporary ban expires (null if not banned or permanent)
	BannedUntil    *time.Time          `json:"banned_until,omitempty"`
	CreatedAt      *time.Time          `json:"created_at,omitempty"`
	Email          openapi_types.Email `json:"email"`
	EmailConfirmed *bool               `json:"email_confirmed,omitempty"`
	Id             openapi_types.UUID  `json:"id"`
	LastSignInAt   *time.Time          `json:"last_sign_in_at,omitempty"`
	ProjectId      *openapi_types.UUID `json:"project_id,omitempty"`
	Status         AuthUserStatus      `json:"status"`
	UpdatedAt      *time.Time          `json:"updated_at,omitempty"`

	// UserMetadata User-editable metadata
	UserMetadata *map[string]interface{} `json:"user_metadata,omitempty"`
}

type AuthUserStatus string

type BanUserResponse struct {
	// BannedUntil When the ban expires (null for permanent ban)
	BannedUntil *time.Time            `json:"banned_until,omitempty"`
	Email       openapi_types.Email   `json:"email"`
	Message     string                `json:"message"`
	Status      BanUserResponseStatus `json:"status"`
	UserId      openapi_types.UUID    `json:"user_id"`
}

type BanUserResponseStatus string

type BatchFunctionDeployFailure struct {
	Error      string                               `json:"error"`
	FunctionId *openapi_types.UUID                  `json:"function_id,omitempty"`
	Name       string                               `json:"name"`
	Operation  *BatchFunctionDeployFailureOperation `json:"operation,omitempty"`
}

type BatchFunctionDeployFailureOperation string

type BatchFunctionDeployResponse struct {
	BatchId openapi_types.UUID `json:"batch_id"`

	// Data Functions whose deployment workflows were started successfully
	Data []Function `json:"data"`

	// Failed Functions that failed before their workflow started. Successful functions are left running; failed new functions are deleted and failed updates are rolled back where possible.
	Failed *[]BatchFunctionDeployFailure `json:"failed,omitempty"`
}

type CompleteUploadSessionResponse struct {
	Object *StorageObject `json:"object,omitempty"`
}

type CreateDatabaseRequest struct {
	// DatabaseType Compute size tier (optional, defaults to volcano-db-xs).
	// Determines autoscaling limits for the database.
	DatabaseType *CreateDatabaseRequestDatabaseType `json:"database_type,omitempty"`

	// Name Database name (must be unique within project)
	Name string `json:"name"`

	// PgVersion PostgreSQL major version
	PgVersion CreateDatabaseRequestPgVersion `json:"pg_version"`

	// Region AWS region for database hosting
	Region CreateDatabaseRequestRegion `json:"region"`
}

type CreateDatabaseRequestDatabaseType string

type CreateDatabaseRequestPgVersion string

type CreateDatabaseRequestRegion string

type CreateEmailTemplateRequest struct {
	// HtmlBody HTML template body. Available placeholders:
	// - {{.Token}} - The confirmation/reset token
	// - {{.ProjectName}} - The project name
	// - {{.Email}} - User's email address
	HtmlBody string `json:"html_body"`

	// Subject Email subject line
	Subject string `json:"subject"`

	// TemplateType Type of email template
	TemplateType CreateEmailTemplateRequestTemplateType `json:"template_type"`

	// TextBody Plain text template body (same placeholders as HTML)
	TextBody string `json:"text_body"`
}

type CreateEmailTemplateRequestTemplateType string

type CreateFrontendCustomDomainRequest struct {
	// Domain Fully-qualified domain name (hostname only, no scheme/path)
	Domain string                        `json:"domain"`
	Tls    FrontendCustomDomainTLSConfig `json:"tls"`
}

type CreateFunctionSchedulerRequest struct {
	Enabled *bool                   `json:"enabled,omitempty"`
	Name    string                  `json:"name"`
	Payload *map[string]interface{} `json:"payload,omitempty"`

	// Regions Optional single explicit deployed region. If omitted, the scheduler chooses one deployed region and invokes according to the cron expression.
	Regions  *[]string       `json:"regions,omitempty"`
	Schedule ScheduleRequest `json:"schedule"`
}

type CreateOAuthConfigRequest struct {
	// ClientId Required for non-device providers. Must not be provided for `provider=device`; server always auto-generates it.
	ClientId *string `json:"client_id,omitempty"`

	// ClientSecret Required for non-device providers. Must not be provided for `provider=device`; server always auto-generates it.
	ClientSecret *string                          `json:"client_secret,omitempty"`
	Provider     CreateOAuthConfigRequestProvider `json:"provider"`

	// RedirectUrl Required for non-device providers. Not used for `provider=device`.
	RedirectUrl *string `json:"redirect_url,omitempty"`

	// Scopes Optional for non-device providers, uses provider defaults if omitted. Not used for `provider=device`.
	Scopes *[]string `json:"scopes,omitempty"`
}

type CreateOAuthConfigRequestProvider string

type CreateProjectRequest struct {
	// AllRegions Optional region policy.
	// - `true` (default): project functions deploy to all configured regions
	// - `false`: project deploys only to `selected_regions`
	AllRegions *bool `json:"all_regions,omitempty"`

	// Name Project name (must be unique).
	// Can only contain letters, numbers, underscores, and hyphens.
	Name string `json:"name"`

	// SelectedRegions Optional region subset. Requires `all_regions=false`.
	// Region names must be a subset of platform `AWS_REGIONS`.
	SelectedRegions *[]string `json:"selected_regions,omitempty"`
}

type CreateStorageBucketRequest struct {
	// AllowedMimeTypes Allowed MIME types (e.g., ["image/png", "image/jpeg"])
	AllowedMimeTypes *[]string `json:"allowed_mime_types,omitempty"`

	// FileSizeLimit Maximum file size in bytes
	FileSizeLimit *int64 `json:"file_size_limit,omitempty"`

	// Name Bucket name (alphanumeric, dashes, underscores)
	Name string `json:"name"`
}

type CreateStoragePolicyRequest struct {
	// Definition Policy expression
	Definition string `json:"definition"`

	// Name Policy name
	Name string `json:"name"`

	// Operation Operation this policy applies to
	Operation CreateStoragePolicyRequestOperation `json:"operation"`
}

type CreateStoragePolicyRequestOperation string

type CreateUploadSessionRequest struct {
	// ContentType MIME type of the file
	ContentType string `json:"content_type"`

	// ObjectPath Target file path within the bucket
	ObjectPath string `json:"object_path"`

	// PartSize Part size in bytes (default: 25MB, min: 5MB, max: 25MB)
	PartSize *int64 `json:"part_size,omitempty"`

	// TotalSize Total file size in bytes (max 5TB)
	TotalSize int64 `json:"total_size"`
}

type CreateUploadSessionResponse struct {
	// ExpiresAt When the session expires (7 days from creation)
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// PartSize Actual part size to use
	PartSize *int64 `json:"part_size,omitempty"`

	// SessionId Upload session ID
	SessionId *string `json:"session_id,omitempty"`

	// TotalParts Number of parts to upload
	TotalParts *int `json:"total_parts,omitempty"`
}

type CreateVariableRequest struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

type Database struct {
	// ConnectionString Secure PostgreSQL connection URI for your database.
	//
	// **Connection Modes via application_name parameter:**
	// - `volcano_full_access:{database_name}` — Full admin access (DDL, migrations)
	// - `volcano_user_access:{database_name}:{user_id}` — User impersonation (RLS enforced)
	// - `volcano_user_access:{database_name}` — Anonymous access (anon role, RLS enforced)
	ConnectionString *string   `json:"connection_string,omitempty"`
	CreatedAt        time.Time `json:"created_at"`

	// DatabaseType Database size tier that determines available RAM and scaling limits.
	DatabaseType *DatabaseDatabaseType `json:"database_type,omitempty"`
	Id           openapi_types.UUID    `json:"id"`

	// LastInvokedAt Most recent request timestamp for this database
	LastInvokedAt *time.Time `json:"last_invoked_at,omitempty"`

	// Name Database name
	Name string `json:"name"`

	// PgVersion PostgreSQL major version
	PgVersion *string            `json:"pg_version,omitempty"`
	ProjectId openapi_types.UUID `json:"project_id"`

	// ProvisioningStartedAt Timestamp when the current provisioning phase started
	ProvisioningStartedAt *time.Time `json:"provisioning_started_at,omitempty"`

	// Region AWS region where database is hosted
	Region *string `json:"region,omitempty"`

	// Status Database provisioning status
	Status    DatabaseStatus `json:"status"`
	UpdatedAt time.Time      `json:"updated_at"`
}

type DatabaseDatabaseType string

type DatabaseStats struct {
	// ActiveTimeSeconds Total active compute time in seconds
	ActiveTimeSeconds float64 `json:"active_time_seconds"`

	// ComputeTimeSeconds Total CPU seconds consumed
	ComputeTimeSeconds float64 `json:"compute_time_seconds"`

	// DataTransferBytes Total data transferred in bytes
	DataTransferBytes int64 `json:"data_transfer_bytes"`

	// DataWrittenBytes Total data written in bytes
	DataWrittenBytes int64 `json:"data_written_bytes"`

	// Granularity Granularity of the aggregated metrics
	Granularity *DatabaseStatsGranularity `json:"granularity,omitempty"`

	// StorageBytes Total storage used in bytes (data + WAL)
	StorageBytes int64 `json:"storage_bytes"`

	// TimeRange Time range of the metrics (e.g., "2024-01-01T00:00:00Z to 2024-01-02T00:00:00Z")
	TimeRange *string `json:"time_range,omitempty"`
}

type DatabaseStatsGranularity string

type DatabaseStatus string

type DeviceAuthorizationResponse struct {
	DeviceCode string `json:"device_code"`
	ExpiresIn  int    `json:"expires_in"`
	Interval   int    `json:"interval"`
	UserCode   string `json:"user_code"`

	// VerificationUri Browser verification URL. Points at the project's managed device
	// approval page served by this API:
	// `/projects/{projectId}/auth/hosted?action=device&anon_key=...`.
	// Requires the project to have managed auth enabled and a default anon
	// key. A custom CLI may ignore this and direct users to its own
	// RFC 8628-compatible page instead (see the device-auth guide).
	VerificationUri string `json:"verification_uri"`

	// VerificationUriComplete Same as `verification_uri` but with the `user_code` prefilled
	// (`&user_code=...`). This is the URL most device clients open.
	VerificationUriComplete string `json:"verification_uri_complete"`
}

type EmailTemplate struct {
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// HtmlBody HTML template with placeholders
	HtmlBody     string                    `json:"html_body"`
	Id           *openapi_types.UUID       `json:"id,omitempty"`
	ProjectId    *openapi_types.UUID       `json:"project_id,omitempty"`
	Subject      string                    `json:"subject"`
	TemplateType EmailTemplateTemplateType `json:"template_type"`

	// TextBody Plain text template with placeholders
	TextBody  string     `json:"text_body"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type EmailTemplateTemplateType string

type Error struct {
	Error string `json:"error"`
}

type Frontend struct {
	// AppRoot Optional relative POSIX path from the uploaded archive root to the Next.js app that is deployed.
	AppRoot   *string   `json:"app_root,omitempty"`
	CreatedAt time.Time `json:"created_at"`

	// CurrentDeploymentId Identifier of the latest frontend deployment operation
	CurrentDeploymentId *openapi_types.UUID `json:"current_deployment_id,omitempty"`

	// CustomDomain Active custom domain hostname when configured
	CustomDomain *string `json:"custom_domain,omitempty"`

	// CustomDomainStatus Current custom domain lifecycle status
	CustomDomainStatus *FrontendCustomDomainStatus `json:"custom_domain_status,omitempty"`
	DeployedRegions    []string                    `json:"deployed_regions"`
	Framework          FrontendFramework           `json:"framework"`
	Id                 openapi_types.UUID          `json:"id"`
	LastInvokedAt      *time.Time                  `json:"last_invoked_at,omitempty"`
	Name               string                      `json:"name"`
	ProjectId          openapi_types.UUID          `json:"project_id"`

	// ProvisioningStartedAt Timestamp when the current provisioning phase started
	ProvisioningStartedAt *time.Time     `json:"provisioning_started_at,omitempty"`
	SiteUrl               *string        `json:"site_url,omitempty"`
	Status                FrontendStatus `json:"status"`
	UpdatedAt             time.Time      `json:"updated_at"`
}

type FrontendCustomDomainResponse struct {
	CreatedAt             time.Time                                      `json:"created_at"`
	Domain                string                                         `json:"domain"`
	DomainStatus          FrontendCustomDomainResponseDomainStatus       `json:"domain_status"`
	EffectiveUrls         []string                                       `json:"effective_urls"`
	RequiredRoutingRecord *FrontendDomainRoutingRecord                   `json:"required_routing_record,omitempty"`
	TlsMode               FrontendCustomDomainResponseTlsMode            `json:"tls_mode"`
	UpdatedAt             time.Time                                      `json:"updated_at"`
	VerificationRecords   *[]FrontendDomainVerificationRecord            `json:"verification_records,omitempty"`
	VerificationStatus    FrontendCustomDomainResponseVerificationStatus `json:"verification_status"`
}

type FrontendCustomDomainResponseDomainStatus string

type FrontendCustomDomainResponseTlsMode string

type FrontendCustomDomainResponseVerificationStatus string

type FrontendCustomDomainStatus string

type FrontendCustomDomainTLSConfig struct {
	// CertificateChainPem Optional PEM-encoded certificate chain.
	CertificateChainPem *string `json:"certificate_chain_pem,omitempty"`

	// CertificatePem Required. PEM-encoded certificate.
	CertificatePem string `json:"certificate_pem"`

	// Mode BYOC is mandatory for custom domain creation.
	Mode FrontendCustomDomainTLSConfigMode `json:"mode"`

	// PrivateKeyPem Required. PEM-encoded private key.
	PrivateKeyPem string `json:"private_key_pem"`
}

type FrontendCustomDomainTLSConfigMode string

type FrontendDeployment struct {
	ArtifactBucket         *string `json:"artifact_bucket,omitempty"`
	ArtifactKey            *string `json:"artifact_key,omitempty"`
	ArtifactVersion        *string `json:"artifact_version,omitempty"`
	CloudformationStackId  *string `json:"cloudformation_stack_id,omitempty"`
	CloudformationStackUrl *string `json:"cloudformation_stack_url,omitempty"`
	CloudwatchLogGroup     *string `json:"cloudwatch_log_group,omitempty"`

	// CodebuildBuildCount Number of completed CodeBuild builds included in codebuild_duration_seconds.
	CodebuildBuildCount         *int       `json:"codebuild_build_count,omitempty"`
	CodebuildDurationRecordedAt *time.Time `json:"codebuild_duration_recorded_at,omitempty"`

	// CodebuildDurationSeconds Total CodeBuild build duration recorded for this deployment, in seconds.
	CodebuildDurationSeconds *int64                      `json:"codebuild_duration_seconds,omitempty"`
	CreatedAt                time.Time                   `json:"created_at"`
	ErrorMessage             *string                     `json:"error_message,omitempty"`
	FrontendId               openapi_types.UUID          `json:"frontend_id"`
	Id                       openapi_types.UUID          `json:"id"`
	Operation                FrontendDeploymentOperation `json:"operation"`
	ProjectId                openapi_types.UUID          `json:"project_id"`
	SiteUrl                  *string                     `json:"site_url,omitempty"`
	Status                   FrontendDeploymentStatus    `json:"status"`
	UpdatedAt                time.Time                   `json:"updated_at"`
}

type FrontendDeploymentOperation string

type FrontendDeploymentStatus string

type FrontendDomainRoutingRecord struct {
	Name       string                                `json:"name"`
	RecordType FrontendDomainRoutingRecordRecordType `json:"record_type"`
	Value      string                                `json:"value"`
}

type FrontendDomainRoutingRecordRecordType string

type FrontendDomainVerificationRecord struct {
	Name  string `json:"name"`
	Type  string `json:"type"`
	Value string `json:"value"`
}

type FrontendFramework string

type FrontendStatus string

type FrontendUsageDailyEntry struct {
	// Day UTC date (YYYY-MM-DD) the counts cover.
	Day openapi_types.Date `json:"day"`

	// Errors 5xx responses served on this day.
	Errors int64 `json:"errors"`

	// PageViews Navigable-document responses served on this day (text/html or Sec-Fetch-Dest=document) — strict subset of `requests`.
	PageViews int64 `json:"page_views"`

	// Requests Total requests served on this day.
	Requests int64 `json:"requests"`
}

type FrontendUsageData struct {
	// FrontendId Frontend ID
	FrontendId openapi_types.UUID `json:"frontend_id"`

	// FrontendName Frontend name at the time usage was fetched
	FrontendName *string `json:"frontend_name,omitempty"`

	// Requests Total requests for this frontend in the current usage month
	Requests int64 `json:"requests"`
}

type FrontendUsageHistoryResponse struct {
	Daily []FrontendUsageDailyEntry `json:"daily"`

	// Days Number of daily entries returned (always equal to the `days` query param after clamping).
	Days           int                `json:"days"`
	FrontendId     openapi_types.UUID `json:"frontend_id"`
	TotalErrors    int64              `json:"total_errors"`
	TotalPageViews int64              `json:"total_page_views"`
	TotalRequests  int64              `json:"total_requests"`
}

type Function struct {
	AwsFunctionArn *string   `json:"aws_function_arn,omitempty"`
	CreatedAt      time.Time `json:"created_at"`

	// CurrentDeploymentId Identifier of the latest function deployment operation
	CurrentDeploymentId *openapi_types.UUID `json:"current_deployment_id,omitempty"`

	// DeployedRegions Regions where this function is currently deployed
	DeployedRegions []string           `json:"deployed_regions"`
	Handler         *string            `json:"handler,omitempty"`
	Id              openapi_types.UUID `json:"id"`

	// InvokeUrl Canonical GeoDNS endpoint URL for invoking this function (always HTTPS)
	InvokeUrl *string `json:"invoke_url,omitempty"`

	// IsPublic Function visibility for anon-key invocation.
	// - `false` (default): only auth user tokens and service keys can invoke
	// - `true`: anon keys with `functions.invoke` can invoke
	IsPublic bool `json:"is_public"`

	// LastInvokedAt Most recent successful invocation timestamp
	LastInvokedAt *time.Time         `json:"last_invoked_at,omitempty"`
	Name          string             `json:"name"`
	ProjectId     openapi_types.UUID `json:"project_id"`

	// ProvisioningStartedAt Timestamp when the current provisioning phase started
	ProvisioningStartedAt *time.Time     `json:"provisioning_started_at,omitempty"`
	Runtime               *string        `json:"runtime,omitempty"`
	Status                FunctionStatus `json:"status"`
	UpdatedAt             time.Time      `json:"updated_at"`
}

type FunctionDeployment struct {
	ArtifactBucket  *string             `json:"artifact_bucket,omitempty"`
	ArtifactKey     *string             `json:"artifact_key,omitempty"`
	ArtifactVersion *string             `json:"artifact_version,omitempty"`
	BatchId         *openapi_types.UUID `json:"batch_id,omitempty"`

	// CodebuildBuildCount Number of completed CodeBuild builds included in codebuild_duration_seconds.
	CodebuildBuildCount         *int       `json:"codebuild_build_count,omitempty"`
	CodebuildDurationRecordedAt *time.Time `json:"codebuild_duration_recorded_at,omitempty"`

	// CodebuildDurationSeconds Total CodeBuild build duration recorded for this deployment, in seconds.
	CodebuildDurationSeconds *int64                      `json:"codebuild_duration_seconds,omitempty"`
	CompileLogGroup          *string                     `json:"compile_log_group,omitempty"`
	CompileLogStream         *string                     `json:"compile_log_stream,omitempty"`
	CompletedAt              *time.Time                  `json:"completed_at,omitempty"`
	CreatedAt                time.Time                   `json:"created_at"`
	ErrorMessage             *string                     `json:"error_message,omitempty"`
	FunctionId               openapi_types.UUID          `json:"function_id"`
	Id                       openapi_types.UUID          `json:"id"`
	Operation                FunctionDeploymentOperation `json:"operation"`
	ProjectId                openapi_types.UUID          `json:"project_id"`
	PublishLogGroup          *string                     `json:"publish_log_group,omitempty"`
	PublishLogStream         *string                     `json:"publish_log_stream,omitempty"`
	Status                   FunctionDeploymentStatus    `json:"status"`
	UpdatedAt                time.Time                   `json:"updated_at"`
}

type FunctionDeploymentOperation string

type FunctionDeploymentStatus string

type FunctionInvocationRequest struct {
	// Payload Payload to send to the Lambda function.
	//
	// If invoked with auth user token, Volcano automatically injects `__volcano_auth` context:
	// “`javascript
	// {
	//   ...yourPayload,
	//   __volcano_auth: {
	//     user_id: "uuid",
	//     email: "user@example.com",
	//     project_id: "uuid",
	//     role: "authenticated" | "anonymous"
	//   }
	// }
	// “`
	Payload *map[string]interface{} `json:"payload,omitempty"`
}

type FunctionInvocationResponse map[string]interface{}

type FunctionRegion struct {
	// Code AWS region identifier accepted by function APIs.
	Code string `json:"code"`

	// Flag Country flag emoji associated with the region's geography.
	Flag string `json:"flag"`

	// Label Human-readable region label suitable for display in pickers.
	Label string `json:"label"`
}

type FunctionRuntimeDeployment struct {
	// DependencyManifests Dependency manifest files the CLI should include for hosted builds.
	DependencyManifests []string `json:"dependency_manifests"`

	// Entrypoint Archive path the CLI should use for a single-file function source.
	Entrypoint string `json:"entrypoint"`

	// FileExtensions Source file extensions the CLI can use to detect this runtime.
	FileExtensions []string `json:"file_extensions"`

	// Handler Handler symbol the CLI should submit when deploying this runtime.
	Handler string `json:"handler"`
}

type FunctionRuntimeOption struct {
	// Default Whether this runtime is the CLI default for its language.
	Default    bool                      `json:"default"`
	Deployment FunctionRuntimeDeployment `json:"deployment"`

	// Language Runtime language family used by the CLI to choose defaults from source files.
	Language string `json:"language"`

	// Name Runtime identifier accepted by function APIs.
	Name string `json:"name"`
}

type FunctionRuntimesResponse struct {
	Runtimes []FunctionRuntimeOption `json:"runtimes"`
}

type FunctionScheduler struct {
	CreatedAt       *time.Time                     `json:"created_at,omitempty"`
	CronExpression  *string                        `json:"cron_expression,omitempty"`
	Enabled         *bool                          `json:"enabled,omitempty"`
	FunctionId      *openapi_types.UUID            `json:"function_id,omitempty"`
	Id              *openapi_types.UUID            `json:"id,omitempty"`
	LastCompletedAt *time.Time                     `json:"last_completed_at,omitempty"`
	LastError       *string                        `json:"last_error,omitempty"`
	LastStartedAt   *time.Time                     `json:"last_started_at,omitempty"`
	Name            *string                        `json:"name,omitempty"`
	NextRunAt       *time.Time                     `json:"next_run_at,omitempty"`
	Payload         *map[string]interface{}        `json:"payload,omitempty"`
	ProjectId       *openapi_types.UUID            `json:"project_id,omitempty"`
	Regions         *[]string                      `json:"regions,omitempty"`
	RegionsExplicit *bool                          `json:"regions_explicit,omitempty"`
	ScheduleKind    *FunctionSchedulerScheduleKind `json:"schedule_kind,omitempty"`
	UpdatedAt       *time.Time                     `json:"updated_at,omitempty"`
}

type FunctionSchedulerListResponse struct {
	Data    []FunctionScheduler `json:"data"`
	HasMore bool                `json:"has_more"`
	Limit   int                 `json:"limit"`
	Page    int                 `json:"page"`
	Total   int                 `json:"total"`
}

type FunctionSchedulerScheduleKind string

type FunctionStatus string

type HostedAuthPageType string

type HostedLoginEmailCheckRequest struct {
	Email openapi_types.Email `json:"email"`
}

type HostedLoginEmailCheckResponse struct {
	Exists *bool `json:"exists,omitempty"`
}

type HostedLoginOptionsResponse struct {
	EmailPasswordEnabled     *bool     `json:"email_password_enabled,omitempty"`
	EnableSignup             *bool     `json:"enable_signup,omitempty"`
	OauthProviders           *[]string `json:"oauth_providers,omitempty"`
	PostAuthRedirectUrl      *string   `json:"post_auth_redirect_url,omitempty"`
	RequireEmailConfirmation *bool     `json:"require_email_confirmation,omitempty"`
}

type HostedRenderablePageType string

type LiveLogLevel string

type LogActivityBucket struct {
	// Counts Counts grouped by activity dimension.
	Counts struct {
		// Levels Counts by normalized log level.
		Levels map[string]int `json:"levels"`

		// Regions Counts by event region.
		Regions map[string]int `json:"regions"`

		// ResourceIds Counts by resource ID.
		ResourceIds map[string]int `json:"resource_ids"`
	} `json:"counts"`

	// EndTime Bucket end time in milliseconds since epoch.
	EndTime int64 `json:"end_time"`

	// StartTime Bucket start time in milliseconds since epoch.
	StartTime int64 `json:"start_time"`

	// Total Total events in this bucket.
	Total int `json:"total"`
}

type LogActivityRequest struct {
	// BucketCount Number of activity buckets to return.
	BucketCount *int `json:"bucket_count,omitempty"`

	// EndTime End time in milliseconds since epoch.
	EndTime *int64 `json:"end_time,omitempty"`

	// Levels Normalized log levels to filter by. If omitted, empty, or all levels are selected, no level filter is applied.
	Levels *[]LiveLogLevel `json:"levels,omitempty"`

	// Q Optional free-text search query for log messages.
	Q *string `json:"q,omitempty"`

	// Regions Regions to filter by, for example `["us-east-1", "eu-west-1"]`. If omitted or empty, aggregate all deployed regions.
	Regions *[]string `json:"regions,omitempty"`

	// Resource Resource selectors for project log reads.
	Resource LogRequestResource `json:"resource"`

	// StartTime Start time in milliseconds since epoch.
	StartTime *int64 `json:"start_time,omitempty"`
}

type LogActivityResponse struct {
	Data []LogActivityBucket `json:"data"`

	// Total Total events counted across all buckets.
	Total int `json:"total"`
}

type LogDatabaseRequestResource struct {
	// Ids Optional database identifiers. Omit or send an empty array to include every database in the project.
	Ids *[]openapi_types.UUID `json:"ids,omitempty"`

	// Type Resource type to read logs for.
	Type LogDatabaseRequestResourceType `json:"type"`
}

type LogDatabaseRequestResourceType string

type LogDeployment struct {
	// Id Deployment ID associated with the log event.
	Id openapi_types.UUID `json:"id"`

	// Stage Deployment stage that produced the log event, when available.
	Stage *LogDeploymentStage `json:"stage,omitempty"`
}

type LogDeploymentRequestSelector struct {
	// Ids Optional deployment identifiers. Omit or send an empty array to include every deployment for the selected resources.
	Ids *[]openapi_types.UUID `json:"ids,omitempty"`
}

type LogDeploymentStage string

type LogEvent struct {
	// Deployment Deployment context associated with a historical deployment log event.
	Deployment *LogDeployment `json:"deployment,omitempty"`

	// Id Opaque stable log event ID for pagination, deduplication, and display.
	Id *string `json:"id,omitempty"`

	// InvocationId Function invocation ID associated with this log event, when available.
	InvocationId *string `json:"invocation_id,omitempty"`

	// Level Normalized function runtime log level.
	Level *LiveLogLevel `json:"level,omitempty"`

	// Message Display log message.
	Message string `json:"message"`

	// Metadata Parsed JSON fields and other indexed metadata, when available.
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// RawMessage Original log line/message after platform sanitization.
	RawMessage *string `json:"raw_message,omitempty"`

	// Region Region where this log event originated.
	Region *string `json:"region,omitempty"`

	// Resource Resource that owns a historical log event.
	Resource *LogResource `json:"resource,omitempty"`

	// Timestamp Unix timestamp in milliseconds.
	Timestamp int64 `json:"timestamp"`
}

type LogFrontendRequestResource struct {
	// Deployments Deployment log selector for deployable resources.
	Deployments *LogDeploymentRequestSelector `json:"deployments,omitempty"`

	// Ids Optional frontend identifiers. Omit or send an empty array to include every frontend in the project.
	Ids *[]openapi_types.UUID `json:"ids,omitempty"`

	// Type Resource type to read logs for.
	Type LogFrontendRequestResourceType `json:"type"`
}

type LogFrontendRequestResourceType string

type LogFunctionRequestResource struct {
	// Deployments Deployment log selector for deployable resources.
	Deployments *LogDeploymentRequestSelector `json:"deployments,omitempty"`

	// Ids Optional function identifiers. Omit or send an empty array to include every function in the project.
	Ids *[]openapi_types.UUID `json:"ids,omitempty"`

	// Type Resource type to read logs for.
	Type LogFunctionRequestResourceType `json:"type"`
}

type LogFunctionRequestResourceType string

type LogRequestResource struct {
	// contains filtered or unexported fields
}

type LogResource struct {
	// Id Resource ID that owns the log event.
	Id openapi_types.UUID `json:"id"`

	// Name Resource name associated with the log event, when available.
	Name *string `json:"name,omitempty"`

	// Type Resource type that owns the log event.
	Type LogResourceType `json:"type"`
}

type LogResourceType string

type LogSearchEvent struct {
	// Deployment Deployment context associated with a historical deployment log event.
	Deployment *LogDeployment `json:"deployment,omitempty"`

	// Id Opaque stable log event ID for pagination, deduplication, and display.
	Id string `json:"id"`

	// InvocationId Function invocation ID associated with this log event, when available.
	InvocationId *string `json:"invocation_id,omitempty"`

	// Level Normalized function runtime log level.
	Level *LiveLogLevel `json:"level,omitempty"`

	// Message Display log message.
	Message string `json:"message"`

	// Metadata Parsed JSON fields and other indexed metadata, when available.
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// RawMessage Original log line/message after platform sanitization.
	RawMessage *string `json:"raw_message,omitempty"`

	// Region Region where this log event originated.
	Region *string `json:"region,omitempty"`

	// Resource Resource that owns a historical log event.
	Resource LogResource `json:"resource"`

	// Timestamp Unix timestamp in milliseconds.
	Timestamp int64 `json:"timestamp"`
}

type LogSearchRequest struct {
	// Cursor Opaque pagination cursor from the previous response's `next_cursor`.
	Cursor *string `json:"cursor,omitempty"`

	// EndTime End time in milliseconds since epoch.
	EndTime *int64 `json:"end_time,omitempty"`

	// Levels Normalized log levels to filter by. If omitted, empty, or all levels are selected, no level filter is applied.
	Levels *[]LiveLogLevel `json:"levels,omitempty"`

	// Limit Maximum number of records to return.
	Limit *int `json:"limit,omitempty"`

	// Q Optional free-text search query for log messages.
	Q *string `json:"q,omitempty"`

	// Regions Regions to filter by, for example `["us-east-1", "eu-west-1"]`. If omitted or empty, search all deployed regions.
	Regions *[]string `json:"regions,omitempty"`

	// Resource Resource selectors for project log reads.
	Resource LogRequestResource `json:"resource"`

	// StartTime Start time in milliseconds since epoch.
	StartTime *int64 `json:"start_time,omitempty"`
}

type LogSearchResponse struct {
	// Data Array of log events sorted by timestamp, newest first.
	Data []LogSearchEvent `json:"data"`

	// HasMore Whether there are more log events available.
	HasMore bool `json:"has_more"`

	// Limit Number of items requested per page.
	Limit int `json:"limit"`

	// NextCursor Opaque cursor for the next page. Send this value as `cursor` on the next request.
	NextCursor *string `json:"next_cursor,omitempty"`
}

type LogStreamRequest struct {
	// Levels Normalized log levels to filter by. If omitted, empty, or all levels are selected, no level filter is applied.
	Levels *[]LiveLogLevel `json:"levels,omitempty"`

	// Limit Maximum number of records to deliver on connect or reconnect before following new events.
	Limit *int `json:"limit,omitempty"`

	// Regions Regions to filter by, for example `["us-east-1", "eu-west-1"]`. If omitted or empty, stream all deployed regions.
	Regions *[]string `json:"regions,omitempty"`

	// Resource Resource selectors for project log reads.
	Resource LogRequestResource `json:"resource"`

	// StartTime Start time in milliseconds since epoch.
	StartTime *int64 `json:"start_time,omitempty"`
}

type MetricUsageData struct {
	// AllTime Lifetime cumulative usage across every month for this metric
	AllTime int64 `json:"all_time"`

	// Daily Last 30 days of daily usage points
	Daily []UsageDataPoint `json:"daily"`

	// Hourly Last 24 hours of hourly usage points
	Hourly []UsageDataPoint `json:"hourly"`

	// Metric Metric name (for example, "Function & Frontend Invocations", "Frontend Requests",
	// "CodeBuild Build Seconds", "Bandwidth Ingress (Bytes)", "Bandwidth Egress (Bytes)",
	// "Bandwidth Total (Bytes)", or "Database Storage (Bytes)"). Byte-based metrics are
	// reported in bytes. "Bandwidth Total (Bytes)" is derived (ingress + egress) and
	// is not billed separately. "Database Storage (Bytes)" is a current observed gauge,
	// not a cumulative counter.
	Metric string `json:"metric"`

	// Total Total usage for the current usage month
	Total int64 `json:"total"`
}

type OAuthConfig struct {
	ClientId *string `json:"client_id,omitempty"`

	// ClientSecret Masked in responses (shows only first/last 4 chars)
	ClientSecret *string              `json:"client_secret,omitempty"`
	CreatedAt    *time.Time           `json:"created_at,omitempty"`
	Enabled      *bool                `json:"enabled,omitempty"`
	Id           *openapi_types.UUID  `json:"id,omitempty"`
	Provider     *OAuthConfigProvider `json:"provider,omitempty"`
	RedirectUrl  *string              `json:"redirect_url,omitempty"`
	Scopes       *[]string            `json:"scopes,omitempty"`
	UpdatedAt    *time.Time           `json:"updated_at,omitempty"`
}

type OAuthConfigProvider string

type OAuthErrorResponse struct {
	Error            string  `json:"error"`
	ErrorDescription *string `json:"error_description,omitempty"`
}

type PaginatedAuthUsers struct {
	Data []AuthUser `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedDatabases struct {
	Data []Database `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedFrontendDeployments struct {
	Data []FrontendDeployment `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedFrontends struct {
	Data []Frontend `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedFunctionDeployments struct {
	Data []FunctionDeployment `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedFunctions struct {
	Data []Function `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedProjectCustomDomains struct {
	Data []ProjectFrontendCustomDomain `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedProjectDeployments struct {
	Data []ProjectFrontendDeployment `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedProjects struct {
	// CurrentSyncId Identifier of the latest variable propagation sync.
	CurrentSyncId *openapi_types.UUID `json:"current_sync_id,omitempty"`
	Data          []Project           `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// ProvisioningStartedAt Timestamp when the current variable propagation phase started.
	ProvisioningStartedAt *time.Time `json:"provisioning_started_at,omitempty"`

	// Status Latest project variable propagation status.
	Status *PaginatedProjectsStatus `json:"status,omitempty"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedProjectsStatus string

type PaginatedServiceKeys struct {
	Data []ServiceKey `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PaginatedVariables struct {
	Data []Variable `json:"data"`

	// HasMore Whether there are more pages available
	HasMore bool `json:"has_more"`

	// Limit Number of items per page
	Limit int `json:"limit"`

	// Next URL path to next page (only present if has_more is true)
	Next *string `json:"next,omitempty"`

	// Page Current page number (1-indexed)
	Page int `json:"page"`

	// Total Total number of items across all pages
	Total int `json:"total"`
}

type PlatformExchangeResponse struct {
	ExpiresAt time.Time          `json:"expires_at"`
	Token     string             `json:"token"`
	TokenId   openapi_types.UUID `json:"token_id"`
	UserId    string             `json:"user_id"`
}

type Project struct {
	// AllRegions Region policy for function deployment.
	// - `true`: deploy functions to all configured platform regions
	// - `false`: deploy only to `selected_regions`
	AllRegions         bool               `json:"all_regions"`
	AwsApplicationName *string            `json:"aws_application_name,omitempty"`
	CreatedAt          time.Time          `json:"created_at"`
	Id                 openapi_types.UUID `json:"id"`

	// LastInvokedAt Most recent activity timestamp across project resources
	LastInvokedAt *time.Time `json:"last_invoked_at,omitempty"`

	// LogoUrl Relative API path that serves the project logo when one has been
	// uploaded. The path is versioned with a `?v=` cache-busting query
	// param that changes on each upload. Absent when the project has no
	// logo. The logo image is stored in the project's S3 folder.
	LogoUrl *string `json:"logo_url,omitempty"`
	Name    string  `json:"name"`

	// Plan Platform plan applied to the project when available
	Plan *ProjectPlan `json:"plan,omitempty"`

	// SelectedRegions Effective region set for this project (normalized and deduplicated)
	SelectedRegions []string      `json:"selected_regions"`
	Status          ProjectStatus `json:"status"`
	UpdatedAt       time.Time     `json:"updated_at"`
}

type ProjectFrontendCustomDomain struct {
	CreatedAt     time.Time                               `json:"created_at"`
	Domain        string                                  `json:"domain"`
	DomainStatus  ProjectFrontendCustomDomainDomainStatus `json:"domain_status"`
	EffectiveUrls []string                                `json:"effective_urls"`

	// Frontend The frontend this custom domain is attached to. Inlined to
	// avoid a second fetch from the project-scoped feed.
	Frontend struct {
		Id   openapi_types.UUID `json:"id"`
		Name string             `json:"name"`
	} `json:"frontend"`
	RequiredRoutingRecord *FrontendDomainRoutingRecord                  `json:"required_routing_record,omitempty"`
	TlsMode               ProjectFrontendCustomDomainTlsMode            `json:"tls_mode"`
	UpdatedAt             time.Time                                     `json:"updated_at"`
	VerificationRecords   *[]FrontendDomainVerificationRecord           `json:"verification_records,omitempty"`
	VerificationStatus    ProjectFrontendCustomDomainVerificationStatus `json:"verification_status"`
}

type ProjectFrontendCustomDomainDomainStatus string

type ProjectFrontendCustomDomainTlsMode string

type ProjectFrontendCustomDomainVerificationStatus string

type ProjectFrontendDeployment struct {
	ArtifactBucket         *string `json:"artifact_bucket,omitempty"`
	ArtifactKey            *string `json:"artifact_key,omitempty"`
	ArtifactVersion        *string `json:"artifact_version,omitempty"`
	CloudformationStackId  *string `json:"cloudformation_stack_id,omitempty"`
	CloudformationStackUrl *string `json:"cloudformation_stack_url,omitempty"`
	CloudwatchLogGroup     *string `json:"cloudwatch_log_group,omitempty"`

	// CodebuildBuildCount Number of completed CodeBuild builds included in codebuild_duration_seconds.
	CodebuildBuildCount         *int       `json:"codebuild_build_count,omitempty"`
	CodebuildDurationRecordedAt *time.Time `json:"codebuild_duration_recorded_at,omitempty"`

	// CodebuildDurationSeconds Total CodeBuild build duration recorded for this deployment, in seconds.
	CodebuildDurationSeconds *int64    `json:"codebuild_duration_seconds,omitempty"`
	CreatedAt                time.Time `json:"created_at"`
	ErrorMessage             *string   `json:"error_message,omitempty"`

	// Frontend The frontend this deployment belongs to. Inlined to avoid a
	// second fetch from the project-scoped feed.
	Frontend struct {
		Id   openapi_types.UUID `json:"id"`
		Name string             `json:"name"`
	} `json:"frontend"`
	FrontendId openapi_types.UUID                 `json:"frontend_id"`
	Id         openapi_types.UUID                 `json:"id"`
	Operation  ProjectFrontendDeploymentOperation `json:"operation"`
	ProjectId  openapi_types.UUID                 `json:"project_id"`
	SiteUrl    *string                            `json:"site_url,omitempty"`
	Status     ProjectFrontendDeploymentStatus    `json:"status"`
	UpdatedAt  time.Time                          `json:"updated_at"`
}

type ProjectFrontendDeploymentOperation string

type ProjectFrontendDeploymentStatus string

type ProjectPlan string

type ProjectStatus string

type ProjectUsageResponse struct {
	// Frontends Per-frontend request totals for the current usage month
	Frontends *[]FrontendUsageData `json:"frontends,omitempty"`

	// Metrics Usage metrics for the project
	Metrics []MetricUsageData `json:"metrics"`

	// Month Usage month in YYYY-MM format
	Month string `json:"month"`

	// ProjectId Project ID
	ProjectId openapi_types.UUID `json:"project_id"`
}

type RealtimeConfig struct {
	// BroadcastEnabled Whether broadcast channels are enabled
	BroadcastEnabled *bool `json:"broadcast_enabled,omitempty"`

	// CreatedAt When the configuration was created
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Enabled Whether realtime is enabled for this project
	Enabled *bool `json:"enabled,omitempty"`

	// PostgresChangesEnabled Whether Postgres change notifications are enabled
	PostgresChangesEnabled *bool `json:"postgres_changes_enabled,omitempty"`

	// PresenceEnabled Whether presence tracking is enabled
	PresenceEnabled *bool `json:"presence_enabled,omitempty"`

	// ProjectId Project ID
	ProjectId *openapi_types.UUID `json:"project_id,omitempty"`

	// UpdatedAt When the configuration was last updated
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type RealtimePlanLimits struct {
	// ChannelsPerConn Maximum channels per connection
	ChannelsPerConn *int `json:"channels_per_conn,omitempty"`

	// MaxConnections Maximum concurrent connections allowed
	MaxConnections *int `json:"max_connections,omitempty"`

	// MessageSizeKb Maximum message size in KB
	MessageSizeKb *int `json:"message_size_kb,omitempty"`

	// MessagesPerMonth Maximum messages per month
	MessagesPerMonth *int `json:"messages_per_month,omitempty"`

	// Plan Plan name (FREE or PRO)
	Plan *string `json:"plan,omitempty"`
}

type RealtimeStats struct {
	// LastInvokedAt Most recent realtime activity timestamp across channels
	LastInvokedAt *time.Time `json:"last_invoked_at,omitempty"`

	// Limits Plan-based limits for realtime features
	Limits *RealtimePlanLimits `json:"limits,omitempty"`

	// NumConnections Current number of active connections
	NumConnections *int `json:"num_connections,omitempty"`

	// PeakConnections Peak concurrent connections this usage period
	PeakConnections *int `json:"peak_connections,omitempty"`
}

type ResolveFunctionResponse struct {
	// CacheTtlSeconds Suggested SDK cache TTL for this name-to-ID mapping
	CacheTtlSeconds int `json:"cache_ttl_seconds"`

	// FunctionId Canonical function ID used for invocation routing
	FunctionId openapi_types.UUID `json:"function_id"`

	// Name DNS-safe function name
	Name string `json:"name"`
}

type ScheduleRequest struct {
	// CronExpression Standard 5-field cron expression evaluated in UTC. Seconds fields, descriptors, and Quartz syntax are not supported.
	CronExpression string               `json:"cron_expression"`
	Kind           *ScheduleRequestKind `json:"kind,omitempty"`
}

type ScheduleRequestKind string

type ServiceKey struct {
	CreatedAt *time.Time         `json:"created_at,omitempty"`
	Id        openapi_types.UUID `json:"id"`

	// KeyPrefix First 12 characters of the key for display/identification
	KeyPrefix string `json:"key_prefix"`

	// KeyValue Full JWT token for Authorization header.
	// Returned on create, get, and list (decrypted from storage).
	// **Store securely - NEVER expose in frontend code!**
	KeyValue *string `json:"key_value,omitempty"`

	// Name Descriptive name for the key
	Name string `json:"name"`

	// Permissions Operations this key may perform. ["*"] grants full admin access
	// (default for keys created without an explicit scope). Scoped keys
	// list specific permissions, e.g. ["functions.invoke"].
	Permissions []string            `json:"permissions"`
	ProjectId   *openapi_types.UUID `json:"project_id,omitempty"`
	UpdatedAt   *time.Time          `json:"updated_at,omitempty"`
}

type StorageBucket struct {
	// AllowedMimeTypes Allowed MIME types (null for all types)
	AllowedMimeTypes *[]string  `json:"allowed_mime_types,omitempty"`
	CreatedAt        *time.Time `json:"created_at,omitempty"`

	// FileSizeLimit Maximum file size in bytes (null for no limit)
	FileSizeLimit *int64             `json:"file_size_limit,omitempty"`
	Id            openapi_types.UUID `json:"id"`

	// LastInvokedAt Most recent bucket operation timestamp
	LastInvokedAt *time.Time `json:"last_invoked_at,omitempty"`

	// Name Bucket name (unique within project)
	Name      string              `json:"name"`
	ProjectId *openapi_types.UUID `json:"project_id,omitempty"`
	UpdatedAt *time.Time          `json:"updated_at,omitempty"`
}

type StorageCopyRequest struct {
	// From Source path
	From string `json:"from"`

	// To Destination path
	To string `json:"to"`
}

type StorageListResponse struct {
	// NextCursor Cursor for next page (empty if no more results)
	NextCursor *string          `json:"next_cursor,omitempty"`
	Objects    *[]StorageObject `json:"objects,omitempty"`
}

type StorageMoveRequest struct {
	// From Source path
	From string `json:"from"`

	// To Destination path
	To string `json:"to"`
}

type StorageObject struct {
	BucketId  openapi_types.UUID `json:"bucket_id"`
	CreatedAt *time.Time         `json:"created_at,omitempty"`

	// Etag S3 ETag for cache validation
	Etag *string            `json:"etag,omitempty"`
	Id   openapi_types.UUID `json:"id"`

	// IsPublic If true, the file can be downloaded with just an anon key (no user authentication).
	// Files are private by default. Only the owner or a service key can change visibility.
	IsPublic bool `json:"is_public"`

	// Metadata Custom user metadata (key-value pairs).
	// Limits: Maximum 50 keys, maximum 10KB total serialized size.
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// MimeType MIME type
	MimeType string `json:"mime_type"`

	// Name Full path within bucket (e.g., "users/abc123/avatar.png")
	Name string `json:"name"`

	// OwnerId Auth user who uploaded (null for anonymous/service)
	OwnerId *openapi_types.UUID `json:"owner_id,omitempty"`

	// PublicUrl Shareable public URL for this file (only set for public files with is_public=true).
	// This URL requires NO authentication and can be embedded in HTML, shared via email, etc.
	// The URL is properly URL-encoded by the server - use it as-is without additional encoding.
	PublicUrl *string `json:"public_url,omitempty"`

	// Size File size in bytes
	Size      int64      `json:"size"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type StorageObjectWithBucket struct {
	BucketId openapi_types.UUID `json:"bucket_id"`

	// BucketName Name of the bucket containing this object
	BucketName string                  `json:"bucket_name"`
	CreatedAt  *time.Time              `json:"created_at,omitempty"`
	Etag       *string                 `json:"etag,omitempty"`
	Id         openapi_types.UUID      `json:"id"`
	IsPublic   bool                    `json:"is_public"`
	Metadata   *map[string]interface{} `json:"metadata,omitempty"`
	MimeType   string                  `json:"mime_type"`

	// Name Full path within bucket
	Name string `json:"name"`

	// OwnerId Auth user who uploaded (null for anonymous/service)
	OwnerId *openapi_types.UUID `json:"owner_id,omitempty"`

	// PublicUrl Shareable public URL for this file (only set for public files with is_public=true).
	// This URL requires NO authentication and can be embedded in HTML, shared via email, etc.
	PublicUrl *string `json:"public_url,omitempty"`

	// Size File size in bytes
	Size      int64      `json:"size"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`
}

type StoragePolicy struct {
	BucketId  openapi_types.UUID `json:"bucket_id"`
	CreatedAt *time.Time         `json:"created_at,omitempty"`

	// Definition Policy expression evaluated at request time.
	// Examples:
	// - "true" - Allow all
	// - "auth.uid() = owner_id" - Owner only
	// - "auth.role() = 'authenticated'" - Authenticated users
	// - "(storage.foldername(name))[1] = auth.uid()::text" - User's folder
	Definition string             `json:"definition"`
	Id         openapi_types.UUID `json:"id"`

	// Name Policy name (unique within bucket)
	Name string `json:"name"`

	// Operation Operation this policy applies to
	Operation StoragePolicyOperation `json:"operation"`
	UpdatedAt *time.Time             `json:"updated_at,omitempty"`
}

type StoragePolicyOperation string

type StorageStats struct {
	// BucketCount Number of storage buckets
	BucketCount int `json:"bucket_count"`

	// ObjectCount Total number of stored files
	ObjectCount int `json:"object_count"`

	// TotalSize Total storage used in bytes
	TotalSize int64 `json:"total_size"`
}

type StorageVisibilityRequest struct {
	// IsPublic Whether the file should be publicly accessible
	IsPublic bool `json:"is_public"`
}

type TestEmailRequest struct {
	// HtmlBody Optional HTML body override. Rendered as an html/template. Max 256 KiB.
	HtmlBody *string `json:"html_body,omitempty"`

	// Subject Optional subject override, rendered as a text/template. Only
	// applied on the override path — requires `html_body` or
	// `text_body` to also be set, otherwise the request is
	// rejected with 400.
	Subject *string `json:"subject,omitempty"`

	// TextBody Optional plain-text body override. Rendered as a text/template. Max 256 KiB.
	TextBody *string `json:"text_body,omitempty"`

	// ToEmail Recipient address for the diagnostic email.
	ToEmail openapi_types.Email `json:"to_email"`
}

type TestEmailResponse struct {
	Success bool `json:"success"`
}

type UnbanUserResponse struct {
	Email   openapi_types.Email     `json:"email"`
	Message string                  `json:"message"`
	Status  UnbanUserResponseStatus `json:"status"`
	UserId  openapi_types.UUID      `json:"user_id"`
}

type UnbanUserResponseStatus string

type UpdateAuthConfigRequest struct {
	AccessTokenLifetime *int  `json:"access_token_lifetime,omitempty"`
	AllowPasswordReset  *bool `json:"allow_password_reset,omitempty"`

	// AllowedRedirectUrls Redirect allowlist. Every entry must be a valid http/https URL.
	AllowedRedirectUrls  *[]string `json:"allowed_redirect_urls,omitempty"`
	CorsAllowCredentials *bool     `json:"cors_allow_credentials,omitempty"`
	CorsMaxAge           *int      `json:"cors_max_age,omitempty"`

	// DeviceVerificationUrl Optional custom device-authorization verification page. Must be a
	// valid http/https URL (not tied to allowed_redirect_urls). When set,
	// device-code logins return this URL (with user_code) instead of the
	// managed device page. Send an empty string to clear the override.
	DeviceVerificationUrl    *string `json:"device_verification_url,omitempty"`
	EmailConfirmationSubject *string `json:"email_confirmation_subject,omitempty"`

	// EmailConfirmationTimeout Email confirmation token expiry in seconds.
	EmailConfirmationTimeout *int `json:"email_confirmation_timeout,omitempty"`

	// EmailEnabled Enable transactional email sending. Cannot be false while require_email_confirmation is true.
	EmailEnabled                *bool   `json:"email_enabled,omitempty"`
	EmailFromAddress            *string `json:"email_from_address,omitempty"`
	EmailFromName               *string `json:"email_from_name,omitempty"`
	EmailPasswordChangedSubject *string `json:"email_password_changed_subject,omitempty"`
	EmailPasswordResetSubject   *string `json:"email_password_reset_subject,omitempty"`
	EnableAnonymousSignins      *bool   `json:"enable_anonymous_signins,omitempty"`

	// EnableEmailPassword Enable/disable email/password provider
	EnableEmailPassword *bool `json:"enable_email_password,omitempty"`

	// EnableSignup Master switch for signups across ALL providers
	EnableSignup      *bool `json:"enable_signup,omitempty"`
	InactivityTimeout *int  `json:"inactivity_timeout,omitempty"`

	// ManagedAuthEnabled Enable or disable managed auth hosted pages for the project.
	ManagedAuthEnabled   *bool `json:"managed_auth_enabled,omitempty"`
	MaxPasswordHistory   *int  `json:"max_password_history,omitempty"`
	MaxSessionDuration   *int  `json:"max_session_duration,omitempty"`
	MinPasswordLength    *int  `json:"min_password_length,omitempty"`
	PasswordResetTimeout *int  `json:"password_reset_timeout,omitempty"`

	// PostAuthRedirectUrl Must be included in allowed_redirect_urls when set.
	PostAuthRedirectUrl *string `json:"post_auth_redirect_url,omitempty"`

	// PostLogoutRedirectUrl Must be included in allowed_redirect_urls when set.
	PostLogoutRedirectUrl *string `json:"post_logout_redirect_url,omitempty"`
	RateLimitSignin       *int    `json:"rate_limit_signin,omitempty"`
	RateLimitSignup       *int    `json:"rate_limit_signup,omitempty"`
	RateLimitTokenRefresh *int    `json:"rate_limit_token_refresh,omitempty"`
	RefreshTokenLifetime  *int    `json:"refresh_token_lifetime,omitempty"`

	// RequireEmailConfirmation Require users to confirm email before sign-in. Can only be true when email_enabled is true.
	RequireEmailConfirmation *bool   `json:"require_email_confirmation,omitempty"`
	RequireLowercase         *bool   `json:"require_lowercase,omitempty"`
	RequireNumbers           *bool   `json:"require_numbers,omitempty"`
	RequireSpecialChars      *bool   `json:"require_special_chars,omitempty"`
	RequireUppercase         *bool   `json:"require_uppercase,omitempty"`
	SmtpHost                 *string `json:"smtp_host,omitempty"`

	// SmtpPassword SMTP password (sensitive). Encrypted at rest (AES-256-GCM) when stored.
	SmtpPassword *string `json:"smtp_password,omitempty"`
	SmtpPort     *int    `json:"smtp_port,omitempty"`
	SmtpUseTls   *bool   `json:"smtp_use_tls,omitempty"`
	SmtpUsername *string `json:"smtp_username,omitempty"`
}

type UpdateAuthHostedPageRequest struct {
	// Css Optional CSS injected at render time. Max 256 KiB.
	Css *string `json:"css,omitempty"`

	// Html Raw HTML markup for the page. Max 256 KiB.
	Html string `json:"html"`
}

type UpdateDatabaseTypeRequest struct {
	// DatabaseType New compute size tier
	DatabaseType UpdateDatabaseTypeRequestDatabaseType `json:"database_type"`
}

type UpdateDatabaseTypeRequestDatabaseType string

type UpdateEmailTemplateRequest struct {
	HtmlBody *string `json:"html_body,omitempty"`
	Subject  *string `json:"subject,omitempty"`
	TextBody *string `json:"text_body,omitempty"`
}

type UpdateFunctionRequest struct {
	// IsPublic Function visibility for anon-key invocation.
	// - `false` (default): private function
	// - `true`: public function (anon keys with `functions.invoke` can invoke)
	IsPublic bool `json:"is_public"`
}

type UpdateFunctionSchedulerRequest struct {
	Enabled  *bool                   `json:"enabled,omitempty"`
	Name     *string                 `json:"name,omitempty"`
	Payload  *map[string]interface{} `json:"payload,omitempty"`
	Regions  *[]string               `json:"regions,omitempty"`
	Schedule *ScheduleRequest        `json:"schedule,omitempty"`
}

type UpdateOAuthConfigRequest struct {
	// ClientId Supported for non-device providers. Not supported for `provider=device`.
	ClientId *string `json:"client_id,omitempty"`

	// ClientSecret Supported for non-device providers. Not supported for `provider=device`.
	ClientSecret *string   `json:"client_secret,omitempty"`
	Enabled      *bool     `json:"enabled,omitempty"`
	RedirectUrl  *string   `json:"redirect_url,omitempty"`
	Scopes       *[]string `json:"scopes,omitempty"`
}

type UpdateProjectRequest struct {
	// AllRegions If omitted and `selected_regions` is also omitted, existing region policy is preserved.
	// If `selected_regions` is provided without `all_regions`, it is treated as subset mode.
	AllRegions *bool   `json:"all_regions,omitempty"`
	Name       *string `json:"name,omitempty"`

	// SelectedRegions Region subset for project deployments.
	// Provide with `all_regions=false`.
	SelectedRegions *[]string `json:"selected_regions,omitempty"`
}

type UpdateRealtimeConfigRequest struct {
	// BroadcastEnabled Whether broadcast channels are enabled
	BroadcastEnabled *bool `json:"broadcast_enabled,omitempty"`

	// Enabled Whether realtime is enabled for this project
	Enabled *bool `json:"enabled,omitempty"`

	// PostgresChangesEnabled Whether Postgres change notifications are enabled
	PostgresChangesEnabled *bool `json:"postgres_changes_enabled,omitempty"`

	// PresenceEnabled Whether presence tracking is enabled
	PresenceEnabled *bool `json:"presence_enabled,omitempty"`
}

type UpdateStorageBucketRequest struct {
	AllowedMimeTypes *[]string `json:"allowed_mime_types,omitempty"`
	FileSizeLimit    *int64    `json:"file_size_limit,omitempty"`
}

type UpdateVariableRequest struct {
	Value string `json:"value"`
}

type UploadSessionPart struct {
	// Etag ETag of the uploaded part
	Etag *string `json:"etag,omitempty"`

	// PartNumber Part number (1-10000)
	PartNumber *int `json:"part_number,omitempty"`

	// Size Size of the part in bytes
	Size *int64 `json:"size,omitempty"`
}

type UploadSessionStatusResponse struct {
	// BytesUploaded Total bytes uploaded so far
	BytesUploaded *int64 `json:"bytes_uploaded,omitempty"`

	// ContentType MIME type
	ContentType *string `json:"content_type,omitempty"`

	// CreatedAt Session creation time
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// ExpiresAt Session expiry time
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// PartSize Size of each part (except last)
	PartSize *int64 `json:"part_size,omitempty"`

	// Parts List of uploaded parts (for resume)
	Parts *[]UploadSessionPart `json:"parts,omitempty"`

	// PartsUploaded Number of parts uploaded
	PartsUploaded *int `json:"parts_uploaded,omitempty"`

	// Path Target file path
	Path *string `json:"path,omitempty"`

	// SessionId Upload session ID
	SessionId *string `json:"session_id,omitempty"`

	// Status Current status of the upload
	Status *UploadSessionStatusResponseStatus `json:"status,omitempty"`

	// TotalParts Total number of parts
	TotalParts *int `json:"total_parts,omitempty"`

	// TotalSize Total file size in bytes
	TotalSize *int64 `json:"total_size,omitempty"`
}

type UploadSessionStatusResponseStatus string

type UsageDataPoint struct {
	// Timestamp UTC timestamp for the data point
	Timestamp time.Time `json:"timestamp"`

	// Value Usage value at the timestamp
	Value int64 `json:"value"`
}

type Variable struct {
	CreatedAt time.Time `json:"created_at"`

	// CurrentSyncId Identifier of the latest variable propagation sync.
	CurrentSyncId *openapi_types.UUID `json:"current_sync_id,omitempty"`
	Id            openapi_types.UUID  `json:"id"`
	Name          string              `json:"name"`
	ProjectId     openapi_types.UUID  `json:"project_id"`

	// ProvisioningStartedAt Timestamp when the current variable propagation phase started.
	ProvisioningStartedAt *time.Time `json:"provisioning_started_at,omitempty"`

	// Status Latest project variable propagation status, when a sync has run.
	Status    *VariableStatus `json:"status,omitempty"`
	UpdatedAt time.Time       `json:"updated_at"`
	Value     string          `json:"value"`
}

type VariableStatus string