All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
0.1.0 - 2026-11-16
Added
Malla.Service.get_all_local/0, the public name of the list of services running on the node (Malla.Service.Server is internal).Malla.Utilis documented:validate_app!/2,keyword_merge/2,map_merge/2,redact/1,redact_args/2andsecret_name?/1. Its other functions are internal.Malla.Plugins.Base.service_config/1is documented.
Fixed
Malla.Service.del_plugin/2with a plugin the service does not have returns:okinstead of crashing the service.- A service declared with
paused: truestarts with the:pauseadmin status (it was:paused, which is not a valid admin status). - When a plugin fails to start, the service stops exactly the plugins that
are running (their children supervisors included, top-level first) and goes
to
:failedwithout a:stoppednotification. Supervisors started in the failed round are no longer left running untracked, andplugin_stop/2is no longer called for plugins that never started. A plugin added at run-time that fails stops only the plugins started for it. - A
plugins:list that cannot be built no longer crashes the service:Malla.Service.reconfigure/2andMalla.Service.add_plugin/3(withconfig:) return{:error, reason}, andstart_linkfails with{:error, reason}instead of raising insideinit. - The internal
get_info_allof the service server returns[]when there are no global services (it raised) and a proper list of infos otherwise. - A plugin change whose config then fails (
Malla.Service.add_plugin/3withconfig:,Malla.Service.reconfigure/2orstart_linkwithplugins:) no longer leaves the dispatch module with the refused plugin chain, andadd_plugin/3no longer keeps the plugin in the service after replying with the error.
Changed
- Plugin groups (
use Malla.Plugin, group: ...) now follow the documented order: each plugin depends on the previous one of its group inplugins:, so[A, B, C]startsA -> B -> Cand callbacks runC -> B -> A. It was the reverse. Services that relied on the old order must reverse their list. - The plugin chain is deterministic: plugins that do not depend on each other
are called in the order of
plugins:(the first one first), each plugin'splugin_depsgo right below it, and a shared dependency goes below every plugin that needs it. Before, their order came from the tie-break of:digraph_utils.topsort/1and could change between Elixir/OTP versions. Malla.Cluster(node connected) andMalla.Plugins.Httpd.Lifecycle(drain errors) log throughLoggerinstead of printing withIO.puts.Malla.Service.get_config/1andMalla.Service.get_status/1each have their own doc (the status doc was onget_config/1).
Removed
- Malla.Node.precompile_stubs/0 and the malla_cb_in/3 callback of Malla.Service.Interface are no longer in the documentation: they are called by Malla itself.
Malla.Nodeno longer reads an unprefixed{:error, :service_not_available}reply (from nodes on 0.0.1-rc.2 or earlier) as:malla_service_not_available. A call that reaches such a node does not fail over to the next one: upgrade those nodes together with the rest of the cluster.
[0.0.1-rc.3] - 2026-11-13
Added
:priorityoption ofuse Malla.Service(default0).Malla.Service.drain_all_local/0drains the services of a node in that order, lowest first, andGET /stopofMalla.Plugins.Httpd.Lifecycleuses it.httpd_lifecycle_drain_start/0callback, called once byGET /stopbefore any service drains.Malla.Util.redact,redact_args/2andsecret_name?/1.Malla.Util.dynamic, to hide a compile-time value from the type checker.Malla.Util.validate_app!, withnimble_optionsas an optional dependency.config :malla, :remote_timeout: default timeout ofMalla.remote/4(15 000 ms when not set).
Changed
- The
REQlog lines ofMalla.RequestandMalla.Plugins.Requestlog the arguments throughMalla.Util.redact_args. - A remote exception (
{:malla_rpc_error, …}) no longer becomes a public status with the exception text asinfo: it goes tostatus_public/1(logged under a reference, answered asinternal_error). - A runtime config update that carries
:priorityis refused, like the otheruseoptions.
Deprecated
Malla.Nodereads an unprefixed{:error, :service_not_available}reply from a node on an older Malla as:malla_service_not_available, for clusters upgraded node by node. To be removed after 0.0.1.
Fixed
- A callback that raised left the calling process with the callee's service
id: it is now restored in an
after. - In chains of three or more modules,
{:cont, value}with a value that is not a list was taken as the argument list; it now becomes[value], as in two-module chains. Malla.Nodeno longer replaces the module of a local service with a proxy to a remote one when the local module exists but has not been loaded yet (interactive mode, as in development or:peernodes): the service then failed withmalla_cb_inundefined. The module is now loaded withCode.ensure_loaded?/1before deciding.