operation

type Actor struct {
	ID         ID
	Collection schema.CollectionSlug
	Data       View
}

type Change[T any] struct {
	// contains filtered or unexported fields
}

type Context struct {
	// Context carries the operation's cancellation and deadline. Pass it to Local.
	Context context.Context
	// Operation is the enclosing document operation, such as Create or Update,
	// rather than the hook phase currently running.
	Operation Kind
	// CollectionID identifies the collection; it is empty for a global.
	// This is a framework resource identifier, not its authored slug.
	CollectionID schema.StableID
	// GlobalID identifies the global; it is empty for a collection.
	// This is a framework resource identifier, not its authored slug.
	GlobalID schema.StableID
	// OccurrenceID correlates this field value, including its enclosing stable
	// row keys and exact locale where localized. It is not a document ID.
	OccurrenceID OccurrenceID
	// SchemaOccurrenceID groups callbacks for the same configured field across
	// repeated rows and locales. Most application callbacks need neither token.
	SchemaOccurrenceID OccurrenceID
	// ID identifies the document involved in this phase. It can be empty before
	// a newly created document has been assigned an ID.
	ID ID
	// Actor identifies the authenticated document and owning auth collection.
	// Actor.ID is empty for an anonymous operation.
	Actor Actor
	// Locale is the selected content locale, or the exact translation when an
	// all-locales operation visits a localized value. It is empty without localization.
	// On ordinary reads it does not identify a fallback value's source locale.
	Locale schema.LocaleCode
	// AllLocales reports whether Root retains locale-keyed values. A callback
	// visiting one exact translation receives false even during an all-locales read.
	AllLocales bool
	// Root contains root field values at this phase: input during raw hooks,
	// the completed candidate during typed writes and validation, or response
	// values during reads. Read values may include requested population and fallback.
	Root View
	// Siblings contains the current enclosing object or repeated row, including
	// this field. For a root title it is the root; for seo.title it is seo;
	// for variants[_key=A].sku it is row A, regardless of that row's current index.
	Siblings View
	// Prior contains the previous persisted enclosing object or row, including
	// this field. Prior.String("title") reads the previous title, not the whole
	// previous document. Retained rows match by stable key rather than array index.
	// It is empty when no previous enclosing object exists, including create,
	// new rows and standalone reads. Localized writes use the exact prior locale;
	// fallback text never becomes a previously stored translation.
	Prior View
	// Local reads a known document under this callback's actor and exact locale,
	// reusing an active transaction. It does not grant nested write capabilities.
	Local Reader
}

type ID string

type Issue struct {
	Code    string
	Message string
	Target  IssueTarget
}

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

type IssueTargetSegment struct {
	Field     string
	RowKey    string
	BlockType string
	Locale    schema.LocaleCode
}

type Kind string

type LiveValidationContext struct {
	// Context carries the original request deadline and cancellation.
	Context context.Context
	// Operation is Create for a new collection document, or Update for document
	// edits and globals (including a global's first save).
	Operation Kind
	// CollectionID or GlobalID identifies the owning resource, not its document.
	CollectionID schema.StableID
	GlobalID     schema.StableID
	// ID is the saved document ID, or empty for a new collection document.
	ID ID
	// Actor is the authenticated document and its auth collection.
	Actor Actor
	// Locale selects one exact translation. Live checks never use fallback values
	// as persisted or submitted data and do not accept all-locales requests.
	Locale schema.LocaleCode
	// Root contains readable unsaved document values with omitted update data
	// retained from storage. In a detached embedded editor it is the parent
	// document before Apply; the detached payload is available through Siblings.
	Root View
	// Siblings contains the readable current enclosing object or repeated row.
	// Retained update fields are included, without defaults or write hooks.
	Siblings View
	// Prior is the readable persisted enclosing object or row in this exact
	// locale. Repeated rows match by stable key and Block case, never by index.
	// It is empty for new objects, rows, embedded items and translations.
	Prior View
	// Input contains the submitted enclosing object before retention. Lookup
	// distinguishes omitted properties from explicitly submitted null values.
	// The separate typed Value argument describes the current value after retention.
	Input View
	// Local reads an authorized document in the same read-only transaction, actor
	// and exact locale. It runs no document lifecycle hooks, defaults or computed
	// outputs, and grants no writes. Original cancellation cannot be replaced.
	Local Reader
}

type OccurrenceID string

type Reader interface {
	FindByID(context.Context, schema.CollectionSlug, ID) (store.Document, error)
}

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

type Value[T any] struct {
	// contains filtered or unexported fields
}

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