aboutsummaryrefslogtreecommitdiff
path: root/packages/taler-util/src/http-client/bank-wire.ts
blob: 0d312704efdd7b778f4af4e2bce1beb0a3758619 (plain)
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
import { HttpRequestLibrary, makeBasicAuthHeader } from "../http-common.js";
import { HttpStatusCode } from "../http-status-codes.js";
import { createPlatformHttpLib } from "../http.js";
import { FailCasesByMethod, ResultByMethod, opFixedSuccess, opKnownFailure, opSuccess, opUnknownFailure } from "../operation.js";
import { PaginationParams, TalerWireGatewayApi, codecForAddIncomingResponse, codecForIncomingHistory, codecForOutgoingHistory, codecForTransferResponse } from "./types.js";
import { addPaginationParams } from "./utils.js";

export type TalerWireGatewayResultByMethod<prop extends keyof TalerWireGatewayHttpClient> = ResultByMethod<TalerWireGatewayHttpClient, prop>
export type TalerWireGatewayErrorsByMethod<prop extends keyof TalerWireGatewayHttpClient> = FailCasesByMethod<TalerWireGatewayHttpClient, prop>

/**
 * The API is used by the exchange to trigger transactions and query 
 * incoming transactions, as well as by the auditor to query incoming 
 * and outgoing transactions.
 * 
 * https://docs.taler.net/core/api-bank-wire.html
 */
export class TalerWireGatewayHttpClient {
  httpLib: HttpRequestLibrary;

  constructor(
    readonly baseUrl: string,
    readonly username: string,
    httpClient?: HttpRequestLibrary,
  ) {
    this.httpLib = httpClient ?? createPlatformHttpLib();
  }

  /**
   * https://docs.taler.net/core/api-bank-wire.html#post-$BASE_URL-transfer
   * 
   */
  async transfer(
    auth: string,
    body: TalerWireGatewayApi.TransferRequest,
  ) {
    const url = new URL(`transfer`, this.baseUrl);
    const resp = await this.httpLib.fetch(url.href, {
      method: "POST",
      headers: {
        Authorization: makeBasicAuthHeader(this.username, auth),
      },
      body
    });
    switch (resp.status) {
      case HttpStatusCode.Ok: return opSuccess(resp, codecForTransferResponse())
      case HttpStatusCode.BadRequest: return opKnownFailure("invalid-input", resp);
      case HttpStatusCode.Unauthorized: return opKnownFailure("unauthorized", resp);
      case HttpStatusCode.NotFound: return opKnownFailure("not-found", resp);
      case HttpStatusCode.Conflict: return opKnownFailure("request-uid-already-used", resp);
      default: return opUnknownFailure(resp, await resp.text())
    }
  }

  /**
   * https://docs.taler.net/core/api-bank-wire.html#get-$BASE_URL-history-incoming
   * 
   */
  async getHistoryIncoming(auth: string, pagination?: PaginationParams) {
    const url = new URL(`history/incoming`, this.baseUrl);
    addPaginationParams(url, pagination)
    const resp = await this.httpLib.fetch(url.href, {
      method: "GET",
      headers: {
        Authorization: makeBasicAuthHeader(this.username, auth),
      }
    });
    switch (resp.status) {
      case HttpStatusCode.Ok: return opSuccess(resp, codecForIncomingHistory())
      case HttpStatusCode.NoContent: return opFixedSuccess({ incoming_transactions: [], credit_account: "" })
      case HttpStatusCode.BadRequest: return opKnownFailure("invalid-input", resp);
      case HttpStatusCode.Unauthorized: return opKnownFailure("unauthorized", resp);
      case HttpStatusCode.NotFound: return opKnownFailure("not-found", resp);
      default: return opUnknownFailure(resp, await resp.text())
    }
    // return readSuccessResponseJsonOrThrow(resp, codecForIncomingHistory());
  }
  /**
   * https://docs.taler.net/core/api-bank-wire.html#get-$BASE_URL-history-outgoing
   * 
   */
  async getHistoryOutgoing(auth: string, pagination?: PaginationParams) {
    const url = new URL(`history/outgoing`, this.baseUrl);
    addPaginationParams(url, pagination)
    const resp = await this.httpLib.fetch(url.href, {
      method: "GET",
      headers: {
        Authorization: makeBasicAuthHeader(this.username, auth),
      }
    });
    switch (resp.status) {
      case HttpStatusCode.Ok: return opSuccess(resp, codecForOutgoingHistory())
      case HttpStatusCode.NoContent: return opFixedSuccess({ outgoing_transactions: [], debit_account: "" })
      case HttpStatusCode.BadRequest: return opKnownFailure("invalid-input", resp);
      case HttpStatusCode.Unauthorized: return opKnownFailure("unauthorized", resp);
      case HttpStatusCode.NotFound: return opKnownFailure("not-found", resp);
      default: return opUnknownFailure(resp, await resp.text())
    }
  }
  /**
   * https://docs.taler.net/core/api-bank-wire.html#post-$BASE_URL-admin-add-incoming
   * 
   */
  async addIncoming(auth: string, body: TalerWireGatewayApi.AddIncomingRequest,) {
    const url = new URL(`admin/add-incoming`, this.baseUrl);
    const resp = await this.httpLib.fetch(url.href, {
      method: "POST",
      headers: {
        Authorization: makeBasicAuthHeader(this.username, auth),
      },
      body
    });
    switch (resp.status) {
      case HttpStatusCode.Ok: return opSuccess(resp, codecForAddIncomingResponse())
      case HttpStatusCode.NoContent: return opFixedSuccess({ outgoing_transactions: [], debit_account: "" })
      case HttpStatusCode.BadRequest: return opKnownFailure("invalid-input", resp);
      case HttpStatusCode.Unauthorized: return opKnownFailure("unauthorized", resp);
      case HttpStatusCode.NotFound: return opKnownFailure("not-found", resp);
      case HttpStatusCode.Conflict: return opKnownFailure("reserve-id-already-used", resp);
      default: return opUnknownFailure(resp, await resp.text())
    }
  }
}