session.go RawHistoryFolder

1package entity
2
3import (
4	"errors"
5	"time"
6)
7
8// SessionID uniquely identifies an application session.
9// For now it matches the log session ID format (YYYYMMDD_HHMMSS_xxxx).
10type SessionID string
11
12// SessionType distinguishes long-running browser sessions from ephemeral CLI invocations.
13type SessionType string
14
15const (
16	SessionTypeBrowser SessionType = "browser"
17	SessionTypeCLI     SessionType = "cli"
18)
19
20// Session captures metadata about a dumber run.
21// A browser session is expected to have a corresponding log file.
22type Session struct {
23	ID        SessionID
24	Type      SessionType
25	StartedAt time.Time
26	EndedAt   *time.Time
27}
28
29func (s *Session) ShortID() string {
30	id := string(s.ID)
31	if len(id) < 4 {
32		return id
33	}
34	return id[len(id)-4:]
35}
36
37func (s *Session) IsActive() bool {
38	return s != nil && s.EndedAt == nil
39}
40
41func (s *Session) End(endedAt time.Time) {
42	endedAt = endedAt.UTC()
43	s.EndedAt = &endedAt
44}
45
46func (s *Session) Validate() error {
47	if s == nil {
48		return ErrInvalidSession
49	}
50	if s.ID == "" {
51		return ErrInvalidSession
52	}
53	if s.Type != SessionTypeBrowser && s.Type != SessionTypeCLI {
54		return ErrInvalidSession
55	}
56	if s.StartedAt.IsZero() {
57		return ErrInvalidSession
58	}
59	return nil
60}
61
62var ErrInvalidSession = errors.New("invalid session")