licensing

type CapacityDescriptor interface {
	// MaxNodes returns the maximum allowable active nodes, or -1 if unlimited.
	MaxNodes() int

	// MaxDatasources returns the maximum number of connected databases, or -1 if unlimited.
	MaxDatasources() int

	// MaxTenants returns the maximum number of managed organizational tenants.
	MaxTenants() int

	// MetricLimit returns the licensed limit for a custom named metric.
	MetricLimit(metric string) (int64, bool)
}

type CatalogSyncRequest struct {
	NodeID       string
	ProjectID    string
	LocalVersion string
	Checksum     string
}

type CatalogSyncResponse struct {
	UpToDate     bool
	LatestCommit string
	DownloadURL  string
}

type CommunityCapacity struct{}

type CommunityVerifier struct{}

type CoordinatorContract interface {
	// RegisterNode registers a running DataTug instance with the centralized coordinator.
	RegisterNode(ctx context.Context, info NodeInfo) error

	// Heartbeat sends periodic telemetry and health pings to the coordinator.
	Heartbeat(ctx context.Context, nodeID string, stats NodeStats) error

	// FetchEntitlement retrieves the latest authoritative entitlement status from the coordinator.
	FetchEntitlement(ctx context.Context) (*EntitlementStatus, error)

	// SyncCatalog coordinates catalog synchronization with the centralized enterprise registry.
	SyncCatalog(ctx context.Context, req CatalogSyncRequest) (*CatalogSyncResponse, error)
}

type EntitlementStatus struct {
	Tier         LicenseTier
	CustomerName string
	IssuedAt     time.Time
	ExpiresAt    time.Time
	Features     []Feature
	Capacity     CapacityDescriptor
	Signature    string
}

type EntitlementVerifier interface {
	// VerifyEntitlement inspects and validates a raw license token.
	VerifyEntitlement(ctx context.Context, token string) (*EntitlementStatus, error)

	// HasFeature verifies whether a specific enterprise capability is authorized.
	HasFeature(ctx context.Context, feature Feature) (bool, error)

	// CheckCapacity verifies that current usage of a metric does not violate limits.
	CheckCapacity(ctx context.Context, metric string, currentUsage int64) error
}

type Feature string

type LicenseTier string

type NodeInfo struct {
	NodeID      string
	Hostname    string
	Version     string
	StartedAt   time.Time
	Environment string
	Labels      map[string]string
}

type NodeStats struct {
	NodeID          string
	ReportedAt      time.Time
	ActiveQueries   int
	ConnectedStores int
	MemoryBytes     uint64
}