plugins

type APIRoutesPlugin interface {
	Plugin

	// RegisterAPIRoutes adds routes to the API router
	// The router is a *web.Router from the gitcaddy server
	RegisterAPIRoutes(m any)
}

type DatabasePlugin interface {
	Plugin

	// RegisterModels returns the models to be registered with the database
	RegisterModels() []any

	// Migrate runs any database migrations for this plugin
	Migrate(ctx context.Context, x *xorm.Engine) error
}

type LicenseInfo struct {
	Valid       bool
	Tier        string // e.g., "solo", "pro", "team", "enterprise"
	CustomerID  string
	ExpiresAt   int64
	GracePeriod bool // true if in grace period after expiry
}

type LicenseLimits struct {
	Users              int  // Max users with vault access (-1 = unlimited)
	SecretsPerRepo     int  // Max secrets per repo (-1 = unlimited)
	AuditRetentionDays int  // Days to keep audit logs
	VersioningEnabled  bool // Can use secret versioning/rollback
	MaxVersions        int  // Max versions to keep per secret (-1 = unlimited, 0 = disabled)
	CICDTokensEnabled  bool // Can create CI/CD tokens
	MaxTokens          int  // Max CI/CD tokens per repo (-1 = unlimited, 0 = disabled)
	MaxTokenTTLHours   int  // Max token TTL in hours (-1 = unlimited)
	TokensReadOnly     bool // If true, tokens can only read secrets (not write)
	SSOEnabled         bool // Can use SSO/SAML
}

type LicensedPlugin interface {
	Plugin

	// ValidateLicense checks if the plugin is properly licensed
	ValidateLicense(ctx context.Context) error

	// LicenseInfo returns information about the current license
	LicenseInfo() *LicenseInfo
}

type Plugin interface {
	// Name returns the unique identifier for this plugin
	Name() string

	// Version returns the plugin version
	Version() string

	// Description returns a human-readable description
	Description() string

	// Init is called when the plugin is loaded
	Init(ctx context.Context) error

	// Shutdown is called when the server is shutting down
	Shutdown(ctx context.Context) error
}

type RepoRoutesPlugin interface {
	Plugin

	// RegisterRepoWebRoutes adds routes under /{owner}/{repo}/
	// The router is a *web.Router from the gitcaddy server
	RegisterRepoWebRoutes(m any)

	// RegisterRepoAPIRoutes adds routes under /api/v1/repos/{owner}/{repo}/
	// The router is a *web.Router from the gitcaddy server
	RegisterRepoAPIRoutes(m any)
}

type WebRoutesPlugin interface {
	Plugin

	// RegisterWebRoutes adds routes to the web UI router
	// The router is a *web.Router from the gitcaddy server
	RegisterWebRoutes(m any)
}