model

type AttributeView struct {
	Type        string `json:"type,omitempty"`
	Cardinality string `json:"cardinality,omitempty"`
	Unique      string `json:"unique,omitempty"`
	ElementType string `json:"element_type,omitempty"`
	Doc         string `json:"doc,omitempty"`
	Indexed     bool   `json:"indexed,omitempty"`
	Session     bool   `json:"session,omitempty"`
}

type Document struct {
	Id       string `json:"id"`
	ShortId  string `json:"short_id,omitempty"`
	Revision int64  `json:"revision,omitempty"`

	CreatedAt *time.Time `json:"created_at,omitempty"`
	UpdatedAt *time.Time `json:"updated_at,omitempty"`

	// Kinds lists every facet the entity carries. Kinds compose: a scheduled
	// sandbox holds compute/kind.sandbox, compute/kind.schedule and
	// core/kind.metadata at once, and which facets are present is often the
	// thing you are debugging.
	Kinds []string `json:"kinds,omitempty"`

	// Facets holds one entry per kind whose schema resolved, in Kinds order.
	Facets []Facet `json:"facets,omitempty"`

	// Unclaimed holds attributes that no facet's schema accounts for. Each
	// facet only describes its own fields, so without this an attribute outside
	// every schema would be invisible.
	Unclaimed []Field `json:"unclaimed,omitempty"`

	// Attribute is set for the kindless entities that make up the schema
	// itself, where the db/* attributes are the content rather than bookkeeping.
	Attribute *AttributeView `json:"attribute,omitempty"`

	// Problems records facets and values that could not be rendered. A single
	// broken facet costs you that facet, not the entity.
	Problems []string `json:"problems,omitempty"`
}

type Facet struct {
	// Kind is the full entity kind id, e.g. dev.miren.compute/kind.sandbox.
	Kind string `json:"kind"`

	// Label is the short form used for display, e.g. compute/sandbox.
	Label string `json:"label"`

	Version string  `json:"version,omitempty"`
	Fields  []Field `json:"fields"`
}

type Field struct {
	Name string `json:"name"`

	// Type is the schema's name for this field ("string", "bytes", "component",
	// ...), or empty for an attribute no schema describes. It lets a consumer
	// tell a base64 blob from a short string without guessing at the value.
	Type string `json:"type,omitempty"`

	// Value is the natural representation: a scalar for simple fields, a slice
	// for multi-valued ones, a map for components.
	Value any `json:"value"`

	// Truncated marks a value the builder shortened, and Size carries the real
	// length in bytes so the elision is never ambiguous.
	Truncated bool `json:"truncated,omitempty"`
	Size      int  `json:"size,omitempty"`
}

type Options struct {
	// MaxValueLen elides rendered byte and string values longer than this many
	// bytes, backing off to a rune boundary so the result stays valid UTF-8.
	// Zero means no limit, which is what the JSON path uses.
	MaxValueLen int
}

type ParsedFile struct {
	Format   string
	Entities []*entity.Entity
}

type RenderOptions struct {
	// Expand renders multi-valued and component fields in full instead of
	// collapsing them to a count. A sandbox carries its networks, ports,
	// routes, volumes and containers as repeated components, so a listing is
	// unreadable without this defaulting to off.
	Expand bool

	// Now is the clock used for relative timestamps. Zero means time.Now.
	Now time.Time
}

type SchemaValue struct {
	Id       string         `json:"id,omitempty" yaml:"id,omitempty" cbor:"id,omitempty"`
	Kind     string         `json:"kind" yaml:"kind" cbor:"kind"`
	Version  string         `json:"version" yaml:"version" cbor:"version"`
	Metadata map[string]any `json:"metadata,omitempty" yaml:"metadata,omitempty" cbor:"metadata,omitempty"`
	Spec     map[string]any `json:"spec" yaml:"spec" cbor:"spec"`
}

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