Behaviour and HTTP helpers for Pipedrive resource modules.

Core v2 modules (ExPipedrive.Products, ExPipedrive.Stages, …) implement this behaviour and delegate CRUD / list / stream to the helpers below. Host apps can do the same for endpoints without a first-class module. Prefer ExPipedrive.Raw for one-off untyped calls.

Callbacks

• path/0 — collection segment (e.g. "products"); versioned via Request
• decode/1 — map API data item into a struct or map
• encode/1 — map/struct write attrs into a JSON body (usually WriteAttrs.take/2)
• list_query_keys/0 — optional filter keys for list_page/3 / stream/3

Custom resource example

defmodule MyApp.Pipedrive.LeadLabels do
  @behaviour ExPipedrive.Resource

  alias ExPipedrive.Resource
  alias ExPipedrive.WriteAttrs

  @impl true
  def path, do: "leadLabels"

  @impl true
  def decode(data) when is_map(data), do: data

  @impl true
  def encode(attrs), do: WriteAttrs.take(attrs, ~w(name color))

  @impl true
  def list_query_keys, do: [:ids]

  def get(client, id), do: Resource.get(__MODULE__, client, id)
  def create(client, attrs), do: Resource.create(__MODULE__, client, attrs)
  def update(client, id, attrs), do: Resource.update(__MODULE__, client, id, attrs)
  def delete(client, id), do: Resource.delete(__MODULE__, client, id)
  def list_page(client, opts \ []), do: Resource.list_page(__MODULE__, client, opts)
  def stream(client, opts \ []), do: Resource.stream(__MODULE__, client, opts)
end