schedule

type ActionHandler func(pageID, actionName string, args []string, message string) error

type Cron struct {
	// contains filtered or unexported fields
}

type ErrorHandler func(job *Job, err error)

type Imperative struct {
	Type         ImperativeType
	Token        *Token   // The primary schedule token (e.g., @daily:9am)
	FilterTokens []*Token // Filter tokens (e.g., @weekdays, @weekends)
	Message      string   // For Notify: inline message, or blockquote content
	ActionName   string   // For RunAction: the action name
	Args         []string // For RunAction: optional arguments
	Line         int      // Source line number
	Raw          string   // Original line text
}

type ImperativeType int

type Job struct {
	ID      string
	PageID  string
	Line    string // The imperative line (e.g., "Notify @daily:9am Check email")
	Token   *Token
	Filters []*Token // Filter tokens (e.g., @weekdays, @weekends) that constrain when job runs
	NextRun time.Time
	LastRun *time.Time
	Enabled bool
	Handler JobHandler
}

type JobHandler func(job *Job) error

type NotificationHandler func(pageID, message string) error

type OffsetSpec struct {
	Duration time.Duration
}

type ParseWarning struct {
	Message string
	Line    int
	Column  int
	Token   string
}

type Parser struct {
	Location *time.Location
	Warnings []ParseWarning
}

type RecurSpec struct {
	Days       []time.Weekday // For weekly: specific days
	DayOfMonth int            // For monthly: day number (1-31)
	Month      time.Month     // For yearly: month
	Day        int            // For yearly: day of month
	Time       *TimeSpec      // Time to trigger
}

type Runner struct {
	// contains filtered or unexported fields
}

type RunnerConfig struct {
	Location *time.Location
	StateDir string // Directory for state persistence (optional)
}

type TimeSpec struct {
	Hour   int
	Minute int
}

type Token struct {
	Raw       string      // Original token text (e.g., "@daily:9am")
	Type      TokenType   // Type of schedule
	Time      *TimeSpec   // Specific time (if applicable)
	Recurring *RecurSpec  // Recurrence pattern (if applicable)
	Offset    *OffsetSpec // Relative offset (if applicable)
	Date      *time.Time  // Specific date (if applicable)
	Line      int         // Source line number
	Column    int         // Source column number
}

type TokenType int