summaryrefslogtreecommitdiff
path: root/packages/taler-util/src/twrpc.ts
blob: d221630d01a9ff85ea0ef32e2db568524444c6e0 (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
/*
 This file is part of GNU Taler
 (C) 2023 Taler Systems S.A.

 GNU Taler is free software; you can redistribute it and/or modify it under the
 terms of the GNU General Public License as published by the Free Software
 Foundation; either version 3, or (at your option) any later version.

 GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY
 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
 A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

 You should have received a copy of the GNU General Public License along with
 GNU Taler; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
 */

import { CoreApiResponse } from "./wallet-types.js";

/**
 * Implementation for the wallet-core IPC protocol.
 *
 * Currently the protocol is completely unstable and only used internally
 * by the wallet for testing purposes.
 */

// Platform-specific implementation
export { connectRpc, runRpcServer } from "#twrpc-impl";

export type JsonMessage =
  | string
  | number
  | boolean
  | null
  | JsonMessage[]
  | { [key: string]: JsonMessage };

export interface RpcServerClientHandlers {
  onMessage(msg: JsonMessage): void;
  onDisconnect(): void;
}

export interface RpcServerClient {
  sendResponse(message: JsonMessage): void;
}

export interface RpcServerArgs {
  socketFilename: string;
  onConnect(client: RpcServerClient): RpcServerClientHandlers;
}

export interface RpcClientServerConnection {
  sendMessage(m: JsonMessage): void;
  close(): void;
}

export interface RpcConnectArgs<T> {
  socketFilename: string;
  onEstablished(connection: RpcClientServerConnection): {
    result: T;
    onDisconnect(): void;
    onMessage(m: JsonMessage): void;
  };
}