elixir_wechat

defmodule WeChat.Adapter.Storage.Client do
  @moduledoc """
  The storage adapter specification for WeChat common application.

  Since we need to storage(cache) some key data(e.g. `access_token`) for invoking WeChat APIs, this module
  is used for customizing the persistence when use this library in a `:client` side of WeChat common application.

  Notice: In the `:client` scenario, we only need to implement the minimum functions to automatically append the
  required parameters from the persistence.

  ## Writing custom storage adapter

  #### Example for WeChat Official Account Platform application

      defmodule MyApp.Storage.Client do
        @behaviour WeChat.Adapter.Storage.Client

        @impl true
        def get_access_token(appid) do
          access_token = "Get access_token by appid from your persistence..."
          access_token
        end

        @impl true
        def delete_access_token(appid, access_token) do
          # Delete access_token by appid from your persistence
          :ok
        end

      end
  """

  @doc """
  Get access_token of WeChat common application.

  ## Example

      get_access_token(appid)
  """
  @callback get_access_token(appid :: String.t()) :: %WeChat.Token{} | nil | %WeChat.Error{}

  @doc """
  Delete access_token of WeChat common application.

  ## Example

      delete_access_token(appid, access_token)
  """
  @callback delete_access_token(appid :: String.t(), access_token :: String.t()) :: term()
end

defmodule WeChat.Adapter.Storage.ComponentClient do
  @moduledoc """
  The storage adapter specification for WeChat component application.

  Since we need to storage(cache) some key data(e.g. `access_token`/`component_access_token`) for invoking WeChat APIs, this module
  is used for customizing the persistence when use this library in a `:client` side of WeChat component application.

  ## Writing custom storage adapter

  #### Example for WeChat 3rd-party Platform application

      defmodule MyComponentApp.Storage.Client do
        @behaviour WeChat.Adapter.Storage.ComponentClient

        @impl true
        def get_access_token(appid, authorizer_appid) do
          access_token = "Get authorizer's access_token by appid and authorizer_appid from your persistence..."
          access_token
        end

        @impl ture
        def get_component_access_token(appid) do
          access_token = "Get component access_token by component appid from your persistence..."
          access_token
        end

        @impl true
        def delete_access_token(appid, authorizer_appid, access_token) do
          :ok
        end
      end
  """
  @doc """
  Get authorizer's access_token for WeChat component application.

  ## Example

      get_access_token(appid, authorizer_appid)
  """
  @callback get_access_token(
              appid :: String.t(),
              authorizer_appid :: String.t()
            ) :: %WeChat.Token{} | nil | %WeChat.Error{}

  @doc """
  Get access_token of WeChat component application.

  ## Example

      get_component_access_token(appid)
  """
  @callback get_component_access_token(appid :: String.t()) ::
              %WeChat.Token{} | nil | %WeChat.Error{}

  @doc """
  Delete authorizer's access_token for WeChat component application.

  ## Example

      delete_access_token(
        appid,
        authorizer_appid,
        access_token
      )
  """
  @callback delete_access_token(
              appid :: String.t(),
              authorizer_appid :: String.t(),
              access_token :: String.t()
            ) :: term()
end