grafana/pkg/plugins/pluginassets/loadingstrategy.go

package pluginassets

import (
	"github.com/Masterminds/semver/v3"

	"github.com/grafana/grafana/pkg/plugins"
	"github.com/grafana/grafana/pkg/plugins/config"
	"github.com/grafana/grafana/pkg/plugins/pluginscdn"
)

const (
	CreatePluginVersionCfgKey               = "create_plugin_version"
	CreatePluginVersionScriptSupportEnabled = "4.15.0"
)

var (
	scriptLoadingMinSupportedVersion = semver.MustParse(CreatePluginVersionScriptSupportEnabled)
)

// CalculateLoadingStrategy calculates the loading strategy for a plugin.
// If a plugin has plugin setting `create_plugin_version` >= 4.15.0, set loadingStrategy to "script".
// If a plugin is not loaded via the CDN and is not Angular, set loadingStrategy to "script".
// Otherwise, set loadingStrategy to "fetch".
func CalculateLoadingStrategy(p *plugins.Plugin, cfg *config.PluginManagementCfg, cdn *pluginscdn.Service) plugins.LoadingStrategy {
	if cfg != nil && cfg.PluginSettings != nil {
		if pCfg, ok := cfg.PluginSettings[p.ID]; ok {
			if compatibleCreatePluginVersion(pCfg) {
				return plugins.LoadingStrategyScript
			}
		}

		// If the plugin has a parent
		if p.Parent != nil {
			// Check the parent's create_plugin_version setting
			if pCfg, ok := cfg.PluginSettings[p.Parent.ID]; ok {
				if compatibleCreatePluginVersion(pCfg) {
					return plugins.LoadingStrategyScript
				}
			}

			// Since the parent plugin is not explicitly configured as script loading compatible,
			// If the plugin is either loaded from the CDN (via its parent) or contains Angular, we should use fetch
			if cdnEnabled(p.Parent, cdn) || p.Angular.Detected {
				return plugins.LoadingStrategyFetch
			}
		}
	}

	if !cdnEnabled(p, cdn) && !p.Angular.Detected {
		return plugins.LoadingStrategyScript
	}

	return plugins.LoadingStrategyFetch
}

// ScriptLoadingCompatible determines script loading compatibility by checking if a createPluginVersion string is >= 4.15.0.
func ScriptLoadingCompatible(createPluginVersion string) bool {
	if createPluginVersion == "" {
		return false
	}
	createPluginVer, err := semver.NewVersion(createPluginVersion)
	if err != nil {
		// Invalid semver, treat as incompatible
		return false
	}
	return !createPluginVer.LessThan(scriptLoadingMinSupportedVersion)
}

// compatibleCreatePluginVersion checks if the create_plugin_version setting is >= 4.15.0
func compatibleCreatePluginVersion(ps map[string]string) bool {
	if cpv, ok := ps[CreatePluginVersionCfgKey]; ok {
		return ScriptLoadingCompatible(cpv)
	}
	return false
}

func cdnEnabled(p *plugins.Plugin, cdn *pluginscdn.Service) bool {
	return cdn.PluginSupported(p.ID) || p.FS.Type().CDN()
}