@spec create_contact(String.t(), map()) ::
  {:ok, Aurinko.Types.Contact.t()} | {:error, Aurinko.Error.t()}

Create a new contact.

Parameters

• :given_name, :surname, :display_name
• :email_addresses — list of %{address: "...", name: "..."}
• :phone_numbers — list of %{number: "...", type: "..."}
• :company, :job_title

@spec delete_contact(String.t(), String.t()) :: :ok | {:error, Aurinko.Error.t()}

Delete a contact by ID.

@spec get_contact(String.t(), String.t()) ::
  {:ok, Aurinko.Types.Contact.t()} | {:error, Aurinko.Error.t()}

Get a contact by ID.

@spec list_contacts(
  String.t(),
  keyword()
) :: {:ok, Aurinko.Types.Pagination.t()} | {:error, Aurinko.Error.t()}

List contacts.

Options

• :limit — Number of results (default: 20)
• :page_token — Pagination token
• :q — Search query

@spec start_sync(
  String.t(),
  keyword()
) :: {:ok, Aurinko.Types.SyncResult.t()} | {:error, Aurinko.Error.t()}

Start incremental sync for contacts.

@spec sync_updated(String.t(), String.t(), keyword()) ::
  {:ok, Aurinko.Types.Pagination.t()} | {:error, Aurinko.Error.t()}

Fetch updated contacts since last sync.

@spec update_contact(String.t(), String.t(), map()) ::
  {:ok, Aurinko.Types.Contact.t()} | {:error, Aurinko.Error.t()}

Update an existing contact.