httpapi

type ChiServerOptions struct {
	BaseURL          string
	BaseRouter       chi.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type CreateProject struct {
	// Cloud The installation the project lives in, os-prod-eu1 for example. A virtual project carries its platform here, and no real project carries `meta` or `partner`.
	Cloud string `json:"cloud"`

	// ExternalId The project as its cloud names it.
	ExternalId string `json:"external_id"`

	// Metadata Whatever else is worth keeping about the project. A registration that leaves it out stores the empty object.
	// The stored document is bounded at 65536 bytes as the database normalizes it: a number a body spells as an exponent is stored, and answered, spelled out. A write whose document is past the bound is answered 422 and stores nothing.
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// Name What the project is called.
	Name *string `json:"name,omitempty"`

	// Platform The platform the project lives on, openstack for example. `meta` and `partner` are reserved for the two kinds of virtual project that own no resources: the meta-project and the partner.
	Platform string `json:"platform"`
}

type CreateProjectJSONRequestBody = CreateProject

type CreateProjectRelationJSONRequestBody = CreateRelation

type CreateRelation struct {
	// Metadata Whatever else is worth keeping about the relation. A creation that leaves it out stores the empty object.
	// The member `pricing_adjustments` is accepted as a non-empty array of at most 64 objects with `type` (one of `discount`, `kickback`, `surcharge`, `project_discount`), `rate` (a decimal string from `0` to `1` with at most six fractional digits, never a number), `scope` (`all`, a platform, or `platform.resource_type`, in lower-case letters, digits and underscores) and an optional `description` of at most 500 characters, and no other members. The rule enforced is the schema `internal/core/adjustment/adjustments_schema.json`, which the rating engine reads the array by. An array the schema refuses is answered 422 with one field error per violation, located as `body.metadata.pricing_adjustments.<index>.<member>`.
	// The stored document is bounded at 65536 bytes as the database normalizes it: a number a body spells as an exponent is stored, and answered, spelled out. A write whose document is past the bound is answered 422 and stores nothing.
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// RelationType What the relation means. `infrastructure_tenant` attributes the cost of the target to the source and is the default attributing type. `member_of` groups the source under a meta-project (platform `meta`), and `managed_by` places the source under a partner (platform `partner`); neither of the two ever attributes cost. The field is a free string, so any other type is stored as it arrives.
	RelationType string `json:"relation_type"`

	// TargetId The project the relation reaches. It has to be registered, and it cannot be the project the relation leaves.
	TargetId openapi_types.UUID `json:"target_id"`

	// ValidFrom When the relation starts being valid. It defaults to the instant the relation is written.
	ValidFrom *time.Time `json:"valid_from,omitempty"`
}

type Cursor = string

type DB interface {
	// Ping reports whether the database answers.
	Ping(ctx context.Context) error
	// Ready reports whether the database can serve this build's queries.
	Ready(ctx context.Context) error
}

type DeadLetterList struct {
	// Items The refused items of this page, ordered by received_at and id.
	Items []DeadLetteredEvent `json:"items"`

	// NextCursor Where the next page starts, passed back as `cursor`. It is null on the last page.
	NextCursor *string `json:"next_cursor"`
}

type DeadLetteredEvent struct {
	// Id The dead-letter row. A refused item has no event id this API can trust, so the row's own id is what names it.
	Id openapi_types.UUID `json:"id"`

	// Raw The item as it was submitted, with NUL characters scrubbed at ingest. Nothing is constrained here: what a collector sent need not be a JSON object, and this member carries whatever it was.
	Raw interface{} `json:"raw"`

	// Reason Why ingestion refused the item, a schema violation for example, prefixed the way the ingest response reports it.
	Reason string `json:"reason"`

	// ReceivedAt When this API refused the item.
	ReceivedAt time.Time `json:"received_at"`
}

type EventInput struct {
	// Cloud The installation the resource lives in, os-prod-eu1 for example. `meta` and `partner` are the clouds of the virtual projects, so an item carrying either refuses the item as well.
	Cloud interface{} `json:"cloud,omitempty"`

	// EventId Globally unique idempotency key of 1 to 256 characters. An event id resubmitted with the same timestamp counts as a duplicate.
	EventId interface{} `json:"event_id,omitempty"`

	// EventType What happened, written resource.action with an optional phase, for example compute.instance.create.end.
	EventType interface{} `json:"event_type,omitempty"`

	// Payload The normalized payload envelope: the state at or after the event, the full replacement size when it changed, and optional raw provider data.
	Payload interface{} `json:"payload,omitempty"`

	// Platform The platform the resource lives on, openstack for example. `meta` and `partner` name the two kinds of virtual project, which own no resources; an item carrying either refuses the item.
	Platform interface{} `json:"platform,omitempty"`

	// ProjectId The project owning the resource at or after this event.
	ProjectId interface{} `json:"project_id,omitempty"`

	// ResourceId The resource this event is about.
	ResourceId interface{} `json:"resource_id,omitempty"`

	// ResourceType The kind of resource, instance or volume for example.
	ResourceType interface{} `json:"resource_type,omitempty"`

	// Source Where the event came from. The stored event always reports the pipeline that ingested it, so a collector cannot mark its events as reconciliation output. The member may be left out; a value outside `collector` and `reconciliation` refuses the item.
	Source interface{} `json:"source,omitempty"`

	// Timestamp When the event happened, ISO 8601 with a timezone.
	Timestamp            interface{}            `json:"timestamp,omitempty"`
	AdditionalProperties map[string]interface{} `json:"-"`
}

type EventList struct {
	// Items The events of this page, ordered by timestamp and event id.
	Items []StoredEvent `json:"items"`

	// NextCursor Where the next page starts, passed back as `cursor`. It is null on the last page.
	NextCursor *string `json:"next_cursor"`
}

type EventStatsItem struct {
	// Bucket When the bucket starts, in UTC. A bucket covers `interval` from there on, the start inclusive and the end exclusive.
	Bucket time.Time `json:"bucket"`

	// Cloud The installation the counted events came from.
	Cloud string `json:"cloud"`

	// Count How many events the group holds.
	Count int64 `json:"count"`

	// EventType The type the counted events carry.
	EventType string `json:"event_type"`

	// Source Which pipeline produced the counted events, collector or reconciliation. The member is there exactly when `group_by` names `source`.
	Source *string `json:"source,omitempty"`
}

type EventStatsList struct {
	// Items The groups, ordered by bucket, cloud, event type, and source. It is the empty array when the window holds no event.
	Items []EventStatsItem `json:"items"`
}

type GetEventStatsParams struct {
	// GroupBy Which dimensions the counts are grouped by, as a comma-separated list. The parameter is given once: a request that repeats it, such as `group_by=cloud&group_by=event_type`, is answered 400. `cloud` and `event_type` have to be among them, because they are what an item is read by; a grouping that leaves either out is answered 400. The rule spans the members of one list, which this schema cannot express, so the handler is what enforces it.
	GroupBy []GetEventStatsParamsGroupBy `form:"group_by" json:"group_by"`

	// From Count only the events at or after this instant, the inclusive bound of the window.
	From time.Time `form:"from" json:"from"`

	// To Count only the events before this instant, the exclusive bound of the window.
	To time.Time `form:"to" json:"to"`

	// Interval How wide one bucket is.
	Interval GetEventStatsParamsInterval `form:"interval" json:"interval"`
}

type GetEventStatsParamsGroupBy string

type GetEventStatsParamsInterval string

type GetProjectSummaryParams struct {
	// From When the window starts, the inclusive bound.
	From time.Time `form:"from" json:"from"`

	// To When the window ends, the exclusive bound.
	To time.Time `form:"to" json:"to"`
}

type GetResourceStatsParams struct {
	// GroupBy Which dimensions the counts are grouped by, as a comma-separated list. The parameter is given once: a request that repeats it, such as `group_by=cloud&group_by=resource_type`, is answered 400. `cloud` and `resource_type` have to be among them, because they are what an item is read by; a grouping that leaves either out is answered 400. The rule spans the members of one list, which this schema cannot express, so the handler is what enforces it.
	GroupBy []GetResourceStatsParamsGroupBy `form:"group_by" json:"group_by"`

	// Status Which part of the fleet to count. `active` counts the rows whose state is not deleted, `deleted` counts those alone, and `all` counts both.
	Status *GetResourceStatsParamsStatus `form:"status,omitempty" json:"status,omitempty"`

	// At The instant the counts describe. Leaving it out asks for the current counts, which is what the projection holds.
	// Any value at all is answered 501 (`urn:tally:error:not_implemented`): counting a past instant means replaying the histories, and the Phase 3 usage records are what answer that. A value meaning "now" cannot be told from a historic one, because the two differ by however long the request took, so omitting the parameter rather than sending a timestamp is how the current counts are asked for.
	At *time.Time `form:"at,omitempty" json:"at,omitempty"`
}

type GetResourceStatsParamsGroupBy string

type GetResourceStatsParamsStatus string

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

type IngestEventsJSONBody1 = []EventInput

type IngestEventsJSONRequestBody IngestEventsJSONBody

type IngestResult struct {
	// Accepted How many events the call stored.
	Accepted int `json:"accepted"`

	// Duplicates How many items the database already held.
	Duplicates int `json:"duplicates"`

	// Rejected The items the call refused, one entry each.
	Rejected []RejectedEvent `json:"rejected"`
}

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type Lifecycle struct {
	// Events The full history the fold ran on, ordered by `(timestamp, received_at, event_id)`.
	Events []StoredEvent `json:"events"`

	// Intervals The billable intervals the history implies, oldest first. Two billable changes at the same instant leave no interval between them, so a resource created and deleted at one instant has none at all.
	Intervals []LifecycleInterval `json:"intervals"`

	// Resource One resource as the projection holds it: what its event history says it is right now.
	Resource Resource `json:"resource"`

	// Warnings What the fold could not trust, one entry each. A history whose first event is not a create carries history_starts_without_create.
	Warnings []string `json:"warnings"`
}

type LifecycleInterval struct {
	// From When the interval starts, the inclusive bound.
	From time.Time `json:"from"`

	// ProjectId The project owning the resource over the interval.
	ProjectId string `json:"project_id"`

	// Size The size the resource had over the interval.
	Size map[string]interface{} `json:"size"`

	// State The state the resource was in over the interval.
	State string `json:"state"`

	// To When the interval ends, the exclusive bound. It is null while the interval is open, which the last interval of a living resource is.
	To *time.Time `json:"to"`
}

type ListEventsParams struct {
	// Cloud Serve only the events of this cloud.
	Cloud *string `form:"cloud,omitempty" json:"cloud,omitempty"`

	// Platform Serve only the events of this platform.
	Platform *string `form:"platform,omitempty" json:"platform,omitempty"`

	// ProjectId Serve only the events of this project, named the way its cloud names it. A token asking for a project outside its scope is answered 403.
	ProjectId *string `form:"project_id,omitempty" json:"project_id,omitempty"`

	// ResourceType Serve only the events about resources of this type.
	ResourceType *string `form:"resource_type,omitempty" json:"resource_type,omitempty"`

	// EventType Serve only the events of this type, volume.create for example.
	EventType *string `form:"event_type,omitempty" json:"event_type,omitempty"`

	// Source Serve only the events the named pipeline produced.
	Source *ListEventsParamsSource `form:"source,omitempty" json:"source,omitempty"`

	// From Serve only the events at or after this instant, the inclusive bound of the window.
	From *time.Time `form:"from,omitempty" json:"from,omitempty"`

	// To Serve only the events before this instant, the exclusive bound of the window.
	To *time.Time `form:"to,omitempty" json:"to,omitempty"`

	// Limit How many events one page carries at most.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor The `next_cursor` of the page before this one. It is opaque: a client passes it back as it received it and reads nothing out of it.
	Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListEventsParamsSource string

type ListProjectRelationsParams struct {
	// Direction Which relations to serve: `outgoing` the ones leaving the project, `incoming` the ones reaching it, `both` either.
	Direction *ListProjectRelationsParamsDirection `form:"direction,omitempty" json:"direction,omitempty"`

	// RelationType Serve only the relations of this type.
	RelationType *string `form:"relation_type,omitempty" json:"relation_type,omitempty"`

	// At The instant the answer describes. It defaults to now.
	At *time.Time `form:"at,omitempty" json:"at,omitempty"`
}

type ListProjectRelationsParamsDirection string

type ListProjectsParams struct {
	// Platform Serve only the projects of this platform.
	Platform *string `form:"platform,omitempty" json:"platform,omitempty"`

	// Cloud Serve only the projects of this cloud.
	Cloud *string `form:"cloud,omitempty" json:"cloud,omitempty"`

	// ExternalId Serve only the projects their cloud names this way. It is not a key on its own, so two clouds using the same external id are both served unless `cloud` narrows the answer.
	ExternalId *string `form:"external_id,omitempty" json:"external_id,omitempty"`

	// Limit How many projects one page carries at most.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor The `next_cursor` of the page before this one. It is opaque: a client passes it back as it received it and reads nothing out of it.
	Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListRejectedEventsParams struct {
	// From Serve only the items refused at or after this instant, the inclusive bound of the window.
	From *time.Time `form:"from,omitempty" json:"from,omitempty"`

	// To Serve only the items refused before this instant, the exclusive bound of the window.
	To *time.Time `form:"to,omitempty" json:"to,omitempty"`

	// Limit How many items one page carries at most.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor The `next_cursor` of the page before this one. It is opaque: a client passes it back as it received it and reads nothing out of it.
	Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListRelatedProjectsParams struct {
	// Depth How many relations out the walk goes.
	Depth *int `form:"depth,omitempty" json:"depth,omitempty"`

	// RelationType Walk only the relations of this type.
	RelationType *string `form:"relation_type,omitempty" json:"relation_type,omitempty"`

	// At The instant the answer describes. It defaults to now.
	At *time.Time `form:"at,omitempty" json:"at,omitempty"`
}

type ListResourcesParams struct {
	// Cloud Serve only the resources of this cloud.
	Cloud *string `form:"cloud,omitempty" json:"cloud,omitempty"`

	// Platform Serve only the resources of this platform.
	Platform *string `form:"platform,omitempty" json:"platform,omitempty"`

	// ProjectId Serve only the resources of this project, named the way its cloud names it. A token asking for a project outside its scope is answered 403.
	ProjectId *string `form:"project_id,omitempty" json:"project_id,omitempty"`

	// ResourceType Serve only the resources of this type.
	ResourceType *string `form:"resource_type,omitempty" json:"resource_type,omitempty"`

	// State Serve only the resources whose current state is exactly this, shutoff for example.
	State *string `form:"state,omitempty" json:"state,omitempty"`

	// Status Which part of the fleet to serve. `active` serves the rows whose state is not deleted, `deleted` serves those alone, and `all` serves both. `state` and `status` are independent filters, so a contradictory pair such as `state=active&status=deleted` yields the empty page.
	Status *ListResourcesParamsStatus `form:"status,omitempty" json:"status,omitempty"`

	// Limit How many resources one page carries at most.
	Limit *int `form:"limit,omitempty" json:"limit,omitempty"`

	// Cursor The `next_cursor` of the page before this one. It is opaque: a client passes it back as it received it and reads nothing out of it.
	Cursor *Cursor `form:"cursor,omitempty" json:"cursor,omitempty"`
}

type ListResourcesParamsStatus string

type MiddlewareFunc func(http.Handler) http.Handler

type Options struct {
	// Logger is the base logger every request logger derives from. It defaults
	// to the process-wide default logger.
	Logger *slog.Logger
	// DB is what the probes check. It is required.
	DB DB
	// UnhealthyThreshold is how long the database may stay unreachable before
	// liveness fails and Kubernetes restarts the pod.
	UnhealthyThreshold time.Duration
	// Now is the clock the liveness threshold is measured on. It defaults to
	// time.Now and exists so tests can control the threshold.
	Now func() time.Time
	// Queries is the sqlc handle the read endpoints and the ingest guard work
	// through. It is bound to the pool, so the writes that need a transaction
	// build their own handle instead.
	Queries *sqlcgen.Queries
	// Store is the database the handlers that write run their transactions on.
	Store *store.Store
	// AuthMode says whether the authentication middlewares check a credential
	// at all.
	AuthMode auth.Mode
	// InternalToken is the shared secret the /internal routes are guarded with.
	InternalToken string
	// Authenticator resolves the bearer token of a query request into the
	// principal it stands for.
	Authenticator auth.Authenticator
	// Pipeline ingests the batches POST /api/v1/events submits. The
	// resource-type registry and the strict-mode flag travel inside it.
	Pipeline *ingest.Pipeline
	// AttributingRelationTypes are the relation types that attribute cost,
	// which is what the cycle guard of a relation creation walks. It comes from
	// TALLY_REPORTING_ATTRIBUTING_RELATION_TYPES, and an empty list disables
	// the guard.
	AttributingRelationTypes []string
	// Syncer is the orchestrator behind POST /internal/sync/{cloud}. It is
	// required: a deployment that configured no clouds passes a Syncer built
	// over the empty configuration, which answers every cloud 404, so the
	// handler behind the route needs no nil check.
	Syncer *reconciliation.Syncer
	// SyncAllowAt comes from TALLY_REPORTING_SYNC_ALLOW_AT and lets
	// POST /internal/sync/{cloud} accept a request body naming the instant the
	// run is at. It is off everywhere but a development deployment, where the
	// cloud a sync reconciles is a simulated one.
	SyncAllowAt bool
	// SyncBudget comes from TALLY_REPORTING_SYNC_BUDGET_S and is how long one
	// run of POST /internal/sync/{cloud} may take. A zero or negative value
	// selects defaultSyncBudget.
	SyncBudget time.Duration
	// Metrics holds the instruments GET /metrics serves. A nil value leaves the
	// route answering 404, the way a disabled scrape route does.
	Metrics *metrics.Metrics
	// MetricsEnabled is whether GET /metrics serves the instruments. It comes
	// from the deployment's configuration, so an operator can take the scrape
	// route offline without rebuilding.
	MetricsEnabled bool
}

type Problem struct {
	// Detail Human-readable explanation specific to this occurrence.
	Detail *string `json:"detail,omitempty"`

	// Errors Per-field details, set when the problem is a validation failure.
	Errors *[]struct {
		// Loc Location of the offending value, e.g. body.resource_id.
		Loc string `json:"loc"`

		// Msg What is wrong with the value at that location.
		Msg string `json:"msg"`
	} `json:"errors,omitempty"`

	// Status The HTTP status code of this response.
	//
	// Example: 400
	Status int `json:"status"`

	// Title Short human-readable summary of the problem type.
	//
	// Example: Validation failed
	Title string `json:"title"`

	// Type URI reference identifying the problem type.
	//
	// Example: urn:tally:error:validation
	Type string `json:"type"`
}

type Project struct {
	// Cloud The installation the project lives in, os-prod-eu1 for example. A virtual project carries its platform here, and no real project carries `meta` or `partner`.
	Cloud string `json:"cloud"`

	// CreatedAt When the project was registered.
	CreatedAt time.Time `json:"created_at"`

	// ExternalId The project as its cloud names it, which is the id an event carries.
	ExternalId string `json:"external_id"`

	// Id The project, as this API names it.
	Id openapi_types.UUID `json:"id"`

	// Metadata Whatever else was stored about the project. It is the empty object for a project registered without any.
	Metadata map[string]interface{} `json:"metadata"`

	// Name What the project is called, null for a project registered without a name.
	Name *string `json:"name"`

	// Platform The platform the project lives on, openstack for example. `meta` and `partner` are reserved for the two kinds of virtual project that own no resources: the meta-project and the partner.
	Platform string `json:"platform"`
}

type ProjectActivity struct {
	// ActiveNow How many resources of the type the project holds right now, counted off the projection rows that are not deleted. It describes the present rather than the window, so a type the window saw nothing of still reports what the project runs of it today.
	ActiveNow int `json:"active_now"`

	// Created How many resources of the type began their life inside the window.
	Created int `json:"created"`

	// Deleted How many resources of the type ended their life inside the window.
	Deleted int `json:"deleted"`

	// ResourceType The kind of resource this row is about.
	ResourceType string `json:"resource_type"`

	// TotalMinutes How long the resources of the type ran inside the window, in whole minutes, truncated. An interval still open is counted up to the instant of the request, so a window reaching into the future carries no time that has not been served yet.
	TotalMinutes int64 `json:"total_minutes"`
}

type ProjectList struct {
	// Items The projects of this page, ordered by cloud and external id.
	Items []Project `json:"items"`

	// NextCursor Where the next page starts, passed back as `cursor`. It is null on the last page.
	NextCursor *string `json:"next_cursor"`
}

type ProjectRef struct {
	// Cloud The installation the project lives in, os-prod-eu1 for example.
	Cloud string `json:"cloud"`

	// ExternalId The project as its cloud names it, which is the id an event carries.
	ExternalId string `json:"external_id"`

	// Id The project, as this API names it.
	Id openapi_types.UUID `json:"id"`
}

type ProjectSummary struct {
	// Project Which project an answer is about, as much of it as a project-scoped read carries. The registry row itself — the name, the operator-set metadata, the platform, and when it was registered — is what `getProject` serves, and reading that takes `read_all`.
	Project ProjectRef `json:"project"`

	// ResourceTypes One row per resource type the project has events or resources of, ordered by resource type. It is the empty array for a project with neither.
	ResourceTypes []ProjectActivity `json:"resource_types"`
}

type PutResourceTypeJSONRequestBody = RegisterResourceType

type RebuildProjectionJSONRequestBody = RebuildRequest

type RebuildRequest struct {
	// Cloud Replay only the resources of this cloud.
	Cloud *string `json:"cloud,omitempty"`

	// ResourceType Replay only the resources of this type.
	ResourceType *string `json:"resource_type,omitempty"`
}

type RebuildResult struct {
	// Rebuilt How many resources were replayed.
	Rebuilt int `json:"rebuilt"`
}

type RegisterResourceType struct {
	// SizeSchema A JSON Schema draft 2020-12 document. It is compiled before it is stored, so the document a registration accepts is exactly the one ingestion can apply later.
	SizeSchema map[string]interface{} `json:"size_schema"`
}

type RejectedEvent struct {
	// EventId The event id the item carried. It is the empty string for an item that carried none, which is why the index is what identifies the item.
	EventId string `json:"event_id"`

	// Index The item's position in the submitted batch, counted from zero.
	Index int `json:"index"`

	// Reason Why the item was refused, for example "size_schema: 'vcpus' is a required property" or 'schema: platform: "meta" is a virtual platform, which never carries resources'.
	Reason string `json:"reason"`
}

type RelatedProject struct {
	// Depth How many relations lie between the project the walk started from and this one.
	Depth int `json:"depth"`

	// Path The relation ids from the start to this project in walk order, so it holds `depth` of them.
	Path []openapi_types.UUID `json:"path"`

	// Project One registered project. The registry is keyed by `(cloud, external_id)`, and `id` is what the other operations address the project by.
	Project Project `json:"project"`

	// RelationType The type of the relation the walk arrived on.
	RelationType string `json:"relation_type"`
}

type RelatedProjectList struct {
	// Items The projects the walk reached, in the order it visited them.
	Items []RelatedProject `json:"items"`
}

type Relation struct {
	// CreatedAt When the relation was written.
	CreatedAt time.Time `json:"created_at"`

	// Id The relation, as this API names it.
	Id openapi_types.UUID `json:"id"`

	// Metadata Whatever else was stored about the relation. It is the empty object for a relation created without any.
	// The member `pricing_adjustments`, when present, holds a non-empty array of at most 64 objects with `type` (one of `discount`, `kickback`, `surcharge`, `project_discount`), `rate` (a decimal string from `0` to `1` with at most six fractional digits, never a number), `scope` (`all`, a platform, or `platform.resource_type`, in lower-case letters, digits and underscores) and an optional `description` of at most 500 characters, and no other members. The schema `internal/core/adjustment/adjustments_schema.json` decided the array at the write, and the rating engine reads it by that same schema.
	Metadata map[string]interface{} `json:"metadata"`

	// RelationType What the relation means. `infrastructure_tenant` attributes the cost of the target to the source and is the default attributing type. `member_of` groups the source under a meta-project (platform `meta`), and `managed_by` places the source under a partner (platform `partner`); neither of the two ever attributes cost. The field is a free string, so any other type is stored as it arrives.
	RelationType string `json:"relation_type"`

	// SourceId The project the relation leaves.
	SourceId openapi_types.UUID `json:"source_id"`

	// TargetId The project the relation reaches.
	TargetId openapi_types.UUID `json:"target_id"`

	// ValidFrom When the relation starts being valid, the inclusive bound.
	ValidFrom time.Time `json:"valid_from"`

	// ValidTo When the relation stops being valid, the exclusive bound. It is null while the relation is open.
	ValidTo *time.Time `json:"valid_to"`
}

type RelationList struct {
	// Items The relations valid at that instant, ordered by created_at and id.
	Items []Relation `json:"items"`
}

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type Resource struct {
	// Cloud The installation the resource lives in.
	Cloud string `json:"cloud"`

	// CreatedAt When the resource was created, as the projection folded it from the resource's whole history. It is null for a history that never showed a create. The projection is not scoped to the reading token, so on a resource that changed projects this is the create of the project it came from and predates the reader's ownership: what a project is billed for is the lifecycle's `intervals`, never `created_at` paired with `deleted_at`.
	CreatedAt *time.Time `json:"created_at"`

	// DeletedAt When the resource was deleted, null while it lives.
	DeletedAt *time.Time `json:"deleted_at"`

	// FirstEventAt When the earliest event folded into this row happened. Every row carries it, so it answers for a resource whose history opens with something other than a create and leaves `created_at` null; where the history does open with a create the two hold the same instant. It is unscoped the way `created_at` is, so on a resource that changed projects it is the first event of the project it came from and predates the reader's ownership. It says when the resource entered the record, not what anyone owes: what a project is billed for is the lifecycle's `intervals`.
	FirstEventAt time.Time `json:"first_event_at"`

	// LastEventAt When that event happened.
	LastEventAt time.Time `json:"last_event_at"`

	// LastEventType The type of the newest event folded into this row. It is a `sync.create`, `sync.update`, or `sync.delete` when the newest thing that happened to the resource was a correction by the reconciliation framework rather than a report by a collector.
	LastEventType string `json:"last_event_type"`

	// LastPayload The payload envelope of that event, member for member as it was stored, and null for a row that holds none.
	LastPayload *map[string]interface{} `json:"last_payload"`

	// Platform The platform the resource lives on.
	Platform string `json:"platform"`

	// ProjectId The project owning the resource now.
	ProjectId string `json:"project_id"`

	// ResourceId The resource itself, as its cloud names it.
	ResourceId string `json:"resource_id"`

	// ResourceType The kind of resource.
	ResourceType string `json:"resource_type"`

	// Size The size the resource has now, member for member as its events reported it. It is the empty object for a history that reported no size.
	Size map[string]interface{} `json:"size"`

	// State The state the resource is in now. A deleted resource carries deleted, which the server sets itself rather than reading it off the delete event.
	State string `json:"state"`
}

type ResourceList struct {
	// Items The resources of this page, ordered by cloud, resource type, and resource id.
	Items []Resource `json:"items"`

	// NextCursor Where the next page starts, passed back as `cursor`. It is null on the last page.
	NextCursor *string `json:"next_cursor"`
}

type ResourceStatsItem struct {
	// Cloud The installation the counted resources live in.
	Cloud string `json:"cloud"`

	// Count How many resources the group holds.
	Count int64 `json:"count"`

	// Platform The platform the counted resources live on. The member is there exactly when `group_by` names `platform`.
	Platform *string `json:"platform,omitempty"`

	// ProjectId The project owning the counted resources, named the way its cloud names it. The member is there exactly when `group_by` names `project_id`.
	ProjectId *string `json:"project_id,omitempty"`

	// ResourceType The kind of resource that was counted.
	ResourceType string `json:"resource_type"`

	// State The state the counted resources are in. The member is there exactly when `group_by` names `state`.
	State *string `json:"state,omitempty"`
}

type ResourceStatsList struct {
	// Items The groups, ordered by cloud, resource type, state, platform, and project id. It is the empty array when the grouping counts no resource at all.
	Items []ResourceStatsItem `json:"items"`
}

type ResourceType struct {
	// Platform The platform the resource type belongs to.
	Platform string `json:"platform"`

	// ResourceType The resource type within that platform.
	ResourceType string `json:"resource_type"`

	// SizeSchema The registered JSON Schema draft 2020-12 document.
	SizeSchema map[string]interface{} `json:"size_schema"`

	// UpdatedAt When the schema was last written.
	UpdatedAt time.Time `json:"updated_at"`
}

type ResourceTypeList struct {
	// Items The resource types, ordered by platform and resource type.
	Items []ResourceType `json:"items"`

	// NextCursor Where the next page starts. It is always null today: the registry holds one row per resource type, so every registration fits into one answer. The registry list stays a single page, while the query lists page with cursors.
	NextCursor *string `json:"next_cursor"`
}

type ServerInterface interface {
	// ListEvents List stored events
	// (GET /api/v1/events)
	ListEvents(w http.ResponseWriter, r *http.Request, params ListEventsParams)
	// IngestEvents Ingest events
	// (POST /api/v1/events)
	IngestEvents(w http.ResponseWriter, r *http.Request)
	// ListProjects List the registered projects
	// (GET /api/v1/projects)
	ListProjects(w http.ResponseWriter, r *http.Request, params ListProjectsParams)
	// CreateProject Register a project
	// (POST /api/v1/projects)
	CreateProject(w http.ResponseWriter, r *http.Request)
	// GetProject Read one registered project
	// (GET /api/v1/projects/{id})
	GetProject(w http.ResponseWriter, r *http.Request, id Uuid)
	// UpdateProject Update one registered project
	// (PATCH /api/v1/projects/{id})
	UpdateProject(w http.ResponseWriter, r *http.Request, id Uuid)
	// ListRelatedProjects List the projects one project reaches
	// (GET /api/v1/projects/{id}/related)
	ListRelatedProjects(w http.ResponseWriter, r *http.Request, id Uuid, params ListRelatedProjectsParams)
	// ListProjectRelations List the relations of one project
	// (GET /api/v1/projects/{id}/relations)
	ListProjectRelations(w http.ResponseWriter, r *http.Request, id Uuid, params ListProjectRelationsParams)
	// CreateProjectRelation Relate one project to another
	// (POST /api/v1/projects/{id}/relations)
	CreateProjectRelation(w http.ResponseWriter, r *http.Request, id Uuid)
	// DeleteProjectRelation Close one relation
	// (DELETE /api/v1/projects/{id}/relations/{relation_id})
	DeleteProjectRelation(w http.ResponseWriter, r *http.Request, id Uuid, relationId Uuid)
	// UpdateProjectRelation Update one relation
	// (PATCH /api/v1/projects/{id}/relations/{relation_id})
	UpdateProjectRelation(w http.ResponseWriter, r *http.Request, id Uuid, relationId Uuid)
	// GetProjectSummary Summarize what one project ran inside a window
	// (GET /api/v1/projects/{id}/summary)
	GetProjectSummary(w http.ResponseWriter, r *http.Request, id Uuid, params GetProjectSummaryParams)
	// ListRejectedEvents List the dead-lettered events
	// (GET /api/v1/rejected-events)
	ListRejectedEvents(w http.ResponseWriter, r *http.Request, params ListRejectedEventsParams)
	// ListResourceTypes List the registered resource types
	// (GET /api/v1/resource-types)
	ListResourceTypes(w http.ResponseWriter, r *http.Request)
	// GetResourceType Read one registered resource type
	// (GET /api/v1/resource-types/{platform}/{resource_type})
	GetResourceType(w http.ResponseWriter, r *http.Request, platform string, resourceType string)
	// PutResourceType Register a resource type
	// (PUT /api/v1/resource-types/{platform}/{resource_type})
	PutResourceType(w http.ResponseWriter, r *http.Request, platform string, resourceType string)
	// ListResources List the current resources
	// (GET /api/v1/resources)
	ListResources(w http.ResponseWriter, r *http.Request, params ListResourcesParams)
	// ListResourceEvents Read the event history of one resource
	// (GET /api/v1/resources/{cloud}/{resource_type}/{resource_id}/events)
	ListResourceEvents(w http.ResponseWriter, r *http.Request, cloud string, resourceType string, resourceId string)
	// GetResourceLifecycle Read the folded lifecycle of one resource
	// (GET /api/v1/resources/{cloud}/{resource_type}/{resource_id}/lifecycle)
	GetResourceLifecycle(w http.ResponseWriter, r *http.Request, cloud string, resourceType string, resourceId string)
	// GetEventStats Count the stored events per time bucket
	// (GET /api/v1/stats/events)
	GetEventStats(w http.ResponseWriter, r *http.Request, params GetEventStatsParams)
	// GetResourceStats Count the current resources per group
	// (GET /api/v1/stats/resources)
	GetResourceStats(w http.ResponseWriter, r *http.Request, params GetResourceStatsParams)
	// Healthz Liveness probe
	// (GET /healthz)
	Healthz(w http.ResponseWriter, r *http.Request)
	// RebuildProjection Rebuild the projection
	// (POST /internal/projection/rebuild)
	RebuildProjection(w http.ResponseWriter, r *http.Request)
	// SyncCloud Reconcile one cloud
	// (POST /internal/sync/{cloud})
	SyncCloud(w http.ResponseWriter, r *http.Request, cloud string)
	// Metrics Service metrics
	// (GET /metrics)
	Metrics(w http.ResponseWriter, r *http.Request)
	// Readyz Readiness probe
	// (GET /readyz)
	Readyz(w http.ResponseWriter, r *http.Request)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type StoredEvent struct {
	// Cloud The installation the resource lives in.
	Cloud string `json:"cloud"`

	// EventId The idempotency key the event was submitted under.
	EventId string `json:"event_id"`

	// EventType What happened, written resource.action with an optional phase, for example compute.instance.create.end. The reconciliation framework writes the second family, `sync.create`, `sync.update`, and `sync.delete`: a correction is about no one service, so it names none. `source` is the member to branch on rather than the prefix — it is `reconciliation` for exactly those events.
	EventType string `json:"event_type"`

	// Payload The normalized payload envelope, member for member as it was stored. It is null for an event stored without one, which a delete event may be. The members are not constrained here: an envelope keeps the fields a provider sent beyond the ones this API names.
	Payload *map[string]interface{} `json:"payload"`

	// Platform The platform the resource lives on.
	Platform string `json:"platform"`

	// ProjectId The project owning the resource at or after this event.
	ProjectId string `json:"project_id"`

	// ReceivedAt When this API stored the event.
	ReceivedAt time.Time `json:"received_at"`

	// ResourceId The resource the event is about.
	ResourceId string `json:"resource_id"`

	// ResourceType The kind of resource the event is about.
	ResourceType string `json:"resource_type"`

	// Source Which pipeline produced the event, collector or reconciliation. It is what the server recorded rather than what the submitter claimed.
	Source string `json:"source"`

	// Timestamp When the event happened.
	Timestamp time.Time `json:"timestamp"`
}

type SyncCloudJSONRequestBody = SyncRequest

type SyncRequest struct {
	// At Run the sync at this instant instead of at wall time: the run's `sync_runs` row starts here, and every correction the run books carries this timestamp. The deployment has to set `TALLY_REPORTING_SYNC_ALLOW_AT` for the member to be accepted. It exists for a development deployment reconciling a simulated cloud, whose clock is not the wall clock.
	At *time.Time `json:"at,omitempty"`
}

type SyncResult struct {
	// Stats The tally of one sync run, which is one that finished clean.
	Stats SyncStats `json:"stats"`

	// SyncRunId The id of the `sync_runs` row this run wrote. It is what an operator reads the run back by, and what the synthetic event ids of the run are derived from.
	SyncRunId string `json:"sync_run_id"`
}

type SyncStats struct {
	// Created How many resources the run reported to the projection as new, one synthetic event each.
	Created int `json:"created"`

	// Deleted How many it reported as gone.
	Deleted int `json:"deleted"`

	// Updated How many it corrected the state, size, or owner of.
	Updated int `json:"updated"`
}

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type Unimplemented struct{}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type UpdateProject struct {
	// Metadata The metadata the project carries from now on. It replaces the stored object wholesale rather than being merged into it, so a request carrying it carries every member the project keeps.
	// The stored document is bounded at 65536 bytes as the database normalizes it: a number a body spells as an exponent is stored, and answered, spelled out. A write whose document is past the bound is answered 422 and stores nothing.
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// Name What the project is called from now on.
	Name *string `json:"name,omitempty"`
}

type UpdateProjectJSONRequestBody = UpdateProject

type UpdateProjectRelationJSONRequestBody = UpdateRelation

type UpdateRelation struct {
	// Metadata The metadata the relation carries from now on. It replaces the stored object wholesale rather than being merged into it, so a request carrying it carries every member the relation keeps.
	// The `pricing_adjustments` of a relation are fixed for its lifetime. A document whose member differs from the stored one, by being added, dropped, reordered or changed in any value, is answered 409. To change the other members, send the member back exactly as the relation answers it; to change the adjustments, close the relation and create a successor.
	// The stored document is bounded at 65536 bytes as the database normalizes it: a number a body spells as an exponent is stored, and answered, spelled out. A write whose document is past the bound is answered 422 and stores nothing.
	Metadata *map[string]interface{} `json:"metadata,omitempty"`

	// ValidTo When the relation stops being valid. It has to be after `valid_from`. The member is not nullable: an open relation is closed here and a closed one gets its close instant corrected, while reopening a closed relation is not supported.
	ValidTo *time.Time `json:"valid_to,omitempty"`
}

type Uuid = openapi_types.UUID