package kspec

import (
	"context"
)

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

// ILocalCtx -- локальный контекст.
type ILocalCtx interface {
	IRWMutex
	// Get -- извлекает значение из контекста
	Get(key string) 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
}