Raxol.Core.Runtime.Plugins.PluginValidator (Raxol Core v2.4.0)

@type plugin_metadata() :: %{
  name: String.t(),
  version: String.t(),
  author: String.t(),
  description: String.t(),
  dependencies: [String.t()],
  api_version: String.t()
}

validation_result()

@type validation_result() :: :ok | {:error, term()}

Functions

resolve_plugin_identity(id)

@spec resolve_plugin_identity(String.t() | module()) ::
  {:ok, {String.t(), module()}} | {:error, term()}

Resolves plugin identity from string or module.

validate_behaviour(plugin_module)

@spec validate_behaviour(module()) ::
  :ok
  | {:error,
     :module_not_found
     | :invalid_plugin_behaviour
     | {:missing_callbacks, [atom()]}}

Validates that a plugin module implements the required behaviour.

validate_compatibility(plugin_module)

@spec validate_compatibility(module()) ::
  :ok
  | {:error,
     {:elixir_version_too_old, String.t(), String.t()}
     | {:otp_version_too_old, String.t(), String.t()}}

Validates plugin compatibility with the current system.

validate_dependencies(plugin_module, loaded_plugins)

@spec validate_dependencies(module(), map()) :: validation_result()

Validates plugin dependencies.

validate_metadata(plugin_module)

@spec validate_metadata(module()) ::
  :ok
  | {:error,
     :missing_metadata
     | :invalid_metadata
     | {:missing_metadata_fields, [atom()]}
     | :invalid_version_format
     | {:unsupported_api_version, String.t()}
     | :invalid_plugin_name}

Validates plugin metadata and configuration.

validate_not_loaded(plugin_id, plugins)

@spec validate_not_loaded(String.t(), map()) :: :ok | {:error, :already_loaded}

Validates that a plugin is not already loaded.

validate_performance(plugin_module)

@spec validate_performance(module()) ::
  :ok
  | {:error,
     {:initialization_failed, term()}
     | {:initialization_too_slow, non_neg_integer()}
     | {:plugin_too_large, non_neg_integer(), non_neg_integer()}
     | {:size_check_failed, term()}}

Validates plugin performance characteristics.

validate_plugin(plugin_id, plugin_module, plugins, options \\ %{})

@spec validate_plugin(String.t(), module(), map(), map()) :: validation_result()

Performs comprehensive validation of a plugin.

validate_security(plugin_module, options \\ %{})

@spec validate_security(module(), map()) :: :ok | {:error, term()}

Validates plugin security aspects.