Coffrify.Runtime.Idempotency behaviour (Coffrify v0.9.0)

Behaviour for Idempotency-Key persistence — survives crashes between retry attempts.

Bundled adapters:

Summary

delete(any, key)

get(any, key)

Deterministic key for the same logical request — beats random UUIDs for crash recovery.

get(state, key)

Dispatch helper used by Coffrify.Client. Accepts either a {module, state} tuple or a tagged struct whose first element is the module.

@callback delete(any(), key :: String.t()) :: :ok

@callback get(any(), key :: String.t()) :: {:ok, term()} | :miss

@callback put(any(), key :: String.t(), value :: term(), ttl_ms :: pos_integer()) :: :ok

@spec delete(any(), String.t()) :: :ok

@spec deterministic_key(String.t(), String.t(), term()) :: String.t()

Deterministic key for the same logical request — beats random UUIDs for crash recovery.

@spec get(any(), String.t()) :: {:ok, term()} | :miss

Dispatch helper used by Coffrify.Client. Accepts either a {module, state} tuple or a tagged struct whose first element is the module.

@spec put(any(), String.t(), term(), pos_integer()) :: :ok