api

package

v0.1.13 Latest Latest Go to latest Published: Feb 12, 2026 License: GPL-3.0 Imports: 12 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

type ChannelCreator interface {
	CreateChannel(ctx context.Context, guildID, name string) (string, error)
}

ChannelCreator can create Discord channels.

type ChannelEnsurer interface {
	EnsureChannel(ctx context.Context, dirPath string) (string, error)
}

ChannelEnsurer resolves a directory path to a Discord channel ID, creating the channel if it does not yet exist.

func NewChannelService(store db.Store, creator ChannelCreator, guildID string) ChannelEnsurer

NewChannelService creates a new ChannelEnsurer.

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

Server exposes a lightweight HTTP API for task CRUD operations.

func NewServer(sched scheduler.Scheduler, channels ChannelEnsurer, threads ThreadEnsurer, logger *slog.Logger) *Server

NewServer creates a new API server. The channels and threads parameters may be nil if channel/thread creation is not configured.

func (s *Server) Start(addr string) error

Start starts the HTTP server on the given address.

func (s *Server) Stop(ctx context.Context) error

Stop gracefully shuts down the HTTP server.

type ThreadCreator interface {
	CreateThread(ctx context.Context, channelID, name, mentionUserID string) (string, error)
}

ThreadCreator can create Discord threads.

type ThreadEnsurer interface {
	CreateThread(ctx context.Context, channelID, name, authorID string) (string, error)
}

ThreadEnsurer creates a thread in a channel and registers it in the DB.

func NewThreadService(store db.Store, creator ThreadCreator) ThreadEnsurer

NewThreadService creates a new ThreadEnsurer.