package comp_spec

import (
	"context"

	"gitp78su.ipnodns.ru/svi/kern/v4/lev0/core_spec"
)

// ICtxValue -- интерфейс к значению локального контекста.
type ICtxValue interface {
	core_spec.IRWMutex
	// Key -- возвращает ключ значения
	Key() string
	// Val -- возвращает хранимое значение
	Val() any
	// CreateAt -- возвращает метку времени создания
	CreateAt() core_spec.ITime
	// UpdateAt -- возвращает метку времени обновления
	UpdateAt() core_spec.ITimeMut
	// Comment -- возвращает комментарий значения
	Comment() string
}

// ILocalCtx -- локальный контекст.
type ILocalCtx interface {
	core_spec.IRWMutex
	// Get -- извлекает значение из контекста
	Get(key string) core_spec.IOption[ICtxValue]
	// Del -- удаляет значение из контекста
	Del(key string)
	// Set -- добавляет значение в контекст
	Set(key string, val any, comment string)
	// Size -- возвращает размер словаря контекста
	Size() int
	// SortedList -- возвращает сортированный список объектов контекста
	SortedList() []ICtxValue
	// Cancel -- отменяет контекст
	Cancel()
	// Wait -- ожидает отмены контекста
	Wait()
	// Log -- возвращает буфер сообщений
	Log() ILogBuf
	// Ctx -- возвращает хранимый контекст
	Ctx() context.Context
}