All files / lib/resources customers.js

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/**
 * @name Customers
 * @description This module exposes functions
 *              related to the `/customers` path.
 *
 * @module customers
 **/
 
import { cond, has, T, curry } from 'ramda'
 
import routes from '../routes'
import request from '../request'
 
 
const findOne = curry((opts, body) =>
  request.get(opts, routes.customers.details(body.id), {})
)
 
const findAll = curry((opts, pagination) =>
  request.get(opts, routes.customers.base, pagination || {})
)

/**
 * `GET /customers`
 * Makes a request to /customers or to /customers/:id
 *
 * @param {Object} opts An options params which
 *                      is usually already bound
 *                      by `connect` functions.
 *
 * @param {Object} body The payload for the request
 * {@link https://pagarme.readme.io/v1/reference#retornando-dados-do-cliente|API Reference for this payload}
 * @param {Number} [body.id] The customer ID. If not sent, a
 *                           customer list will be returned instead.
 * @param {Number} [body.count] Pagination option for customer list.
 *                              Number of customers in a page
 * @param {Number} [body.page] Pagination option for customer list.
 *                             The page index.
 */
const find = (opts, body) =>
  cond([
    [has('id'), findOne(opts)],
    [T, findAll(opts)],
  ])(body)
 
/**
 * `GET /customers`
 * Returns company's customers
 *
 * @param {Object} opts An options params which
 *                      is usually already bound
 *                      by `connect` functions.
 *
 * @param {Object} body The payload for the request.
 * {@link https://pagarme.readme.io/v1/reference#retornando-clientes|API Reference for this payload}
 * @param {Number} [body.count] Pagination option to get a list of customers.
 *                              Number of customers in a page
 * @param {Number} [body.page] Pagination option for a list of customers.
 *                             The page index.
*/
const all = (opts, body) =>
  findAll(opts, body)
 
/**
 * `POST /customers`
 * Creates a customer from the given payload
 *
 * @param {Object} opts An options params which
 *                      is usually already bound
 *                      by `connect` functions.
 * @param {Object} body The payload for the request
 * {@link https://pagarme.readme.io/v1/reference#criando-um-cliente|API Reference for this payload}
 *
 * @returns {Promise} Resolves to the result of
 *                    the request or to an error.
 */
const create = (opts, body) =>
  request.post(opts, routes.customers.base, body)
 
export default {
  find,
  all,
  create,
}