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	ProcessID *int
28}
29
30func (s *Session) ShortID() string {
31	id := string(s.ID)
32	if len(id) < 4 {
33		return id
34	}
35	return id[len(id)-4:]
36}
37
38func (s *Session) IsActive() bool {
39	return s != nil && s.EndedAt == nil
40}
41
42func (s *Session) End(endedAt time.Time) {
43	endedAt = endedAt.UTC()
44	s.EndedAt = &endedAt
45}
46
47func (s *Session) Validate() error {
48	if s == nil {
49		return ErrInvalidSession
50	}
51	if s.ID == "" {
52		return ErrInvalidSession
53	}
54	if s.Type != SessionTypeBrowser && s.Type != SessionTypeCLI {
55		return ErrInvalidSession
56	}
57	if s.StartedAt.IsZero() {
58		return ErrInvalidSession
59	}
60	return nil
61}
62
63var ErrInvalidSession = errors.New("invalid session")