# `Issho.Store`
[🔗](https://github.com/hattoriai/issho/blob/v0.1.0/lib/issho/store.ex#L1)

Where documents last. Your app implements it on its database;
`Issho.Store.Memory` is for development and tests.

`c:load/2` gives the document as last saved, or `nil` for one that has
never been saved. `c:save/5` must compare the stored `{epoch, revision}`
with `expected` and save the document and its content together, in one
atomic write, and answer `{:error, :conflict}` to a stale writer. The
authority confirms an edit to its author only after `save/5` answers
`:ok`, so answering before the write is durable breaks that promise.

The document is a map of JSON values (save it as a JSON or map column).
The content is what the engine's `c:Issho.Engine.validate/2` gave: keep
it beside the document for your app to read and publish.

The context is your app's, given with the store: a repo, an options map.

    {Issho, name: MyApp.Issho, store: {MyApp.CollabStore, MyApp.Repo}, ...}

# `document`

```elixir
@type document() :: map()
```

# `expected`

```elixir
@type expected() :: {epoch :: String.t(), revision :: non_neg_integer()} | nil
```

# `load`

```elixir
@callback load(context :: term(), document_id :: String.t()) ::
  {:ok, document() | nil} | {:error, term()}
```

The document as last saved, or `nil`.

# `save`

```elixir
@callback save(
  context :: term(),
  document_id :: String.t(),
  expected(),
  document(),
  content :: term()
) ::
  :ok | {:error, :conflict} | {:error, term()}
```

Saves the document and its content, if the stored version is `expected`.

---

*Consult [api-reference.md](api-reference.md) for complete listing*