Behaviour for lifecycle hooks around SCIM operations.

Implement this behaviour to run custom logic before or after SCIM operations. All callbacks are optional. Unimplemented callbacks are no-ops.

Configuration

config :ex_scim, lifecycle_adapter: MyApp.ScimLifecycle

Before hooks

Fire after validation/mapping/metadata, immediately before storage. Can modify domain data or reject the operation by returning {:error, term()}.

After hooks

Fire after successful storage + SCIM response mapping. Observe-only (return :ok).

Error hook

Fires when an operation fails. Observe-only.

Example

defmodule MyApp.ScimLifecycle do
  use ExScim.Lifecycle.Adapter

  @impl true
  def before_create(:user, data, _caller) do
    if some_business_rule_violated?(data) do
      {:error, {:forbidden, "Business rule violated"}}
    else
      {:ok, data}
    end
  end

  @impl true
  def after_create(:user, scim_response, _caller) do
    MyApp.Notifications.send_welcome(scim_response["id"])
    :ok
  end
end