package domain

import (
	"errors"
	"time"
)

// EntityID is the canonical Home Assistant entity identifier, for example
// "light.living_room".
type EntityID string

// EntityState is the normalized entity snapshot returned by the gateway.
type EntityState struct {
	// EntityID is the Home Assistant entity identifier.
	EntityID EntityID
	// State is the current raw Home Assistant state string.
	State string
	// Attributes contains stringified Home Assistant attributes for transport.
	Attributes map[string]string
	// LastChanged is when the state last changed in Home Assistant.
	LastChanged time.Time
	// LastUpdated is when any part of the entity state last updated.
	LastUpdated time.Time
}

// ErrNotImplemented marks domain operations that are intentionally stubbed.
var ErrNotImplemented = errors.New("not implemented")