Event and command declarations for @entityseven/fivem-rpc. With nothing declared, every rpc method accepts any event name, any arguments and any result. Declare your events once and every on* and emit* call gets checked names, arguments and results

Installation

See the main readme. The declaration file below imports this package, so it must resolve from that file (in a workspace: install it in the root)

Usage

Create one declaration file shared by server, client and webview code, e.g. shared/rpc.d.ts:

import '@entityseven/fivem-rpc-shared-types'

declare module '@entityseven/fivem-rpc-shared-types' {
    interface RPCEvents_ClientServer {
        // event name(arguments): value returned by the listener
        buyItem(item: string, amount: number): boolean
    }
    interface RPCCommands_Server {
        ban: true
    }
}

The import line makes the file a module, so declare module adds to the package's interfaces instead of replacing them

Add the file to include in the tsconfig.json of every environment:
```
{
    "include": ["src", "../shared/rpc.d.ts"]
}
```

Calls are checked from now on:

// server
rpc.onClient('buyItem', (player, item, amount) => {
    // item: string, amount: number, must return boolean
    return true
})

// client
const bought = await rpc.emitServer('buyItem', 'water', 2) // boolean
await rpc.emitServer('buyItem', 'water') // error: missing `amount`
await rpc.emitServer('buyItme', 'water', 2) // error: unknown event

Interfaces

Each interface is one direction. An interface you leave empty stays loose (any name, arguments and result), so you can declare them one at a time

Interface	Direction	Caller	Listener
`RPCEvents_Client`	client -> client	`emitSelf` (client)	`onSelf` (client)
`RPCEvents_ClientServer`	client -> server	`emitServer` (client)	`onClient` (server)
`RPCEvents_ClientWebview`	client -> webview	`emitWebview` (client)	`onClient` (webview)
`RPCEvents_Server`	server -> server	`emitSelf` (server)	`onSelf` (server)
`RPCEvents_ServerClient`	server -> client	`emitClient`, `emitClientEveryone` (server)	`onServer` (client)
`RPCEvents_ServerWebview`	server -> webview	`emitWebview` (server)	`onServer` (webview)
`RPCEvents_Webview`	webview -> webview	`emitSelf` (webview)	`onSelf` (webview)
`RPCEvents_WebviewClient`	webview -> client	`emitClient` (webview)	`onWebview` (client)
`RPCEvents_WebviewServer`	webview -> server	`emitServer` (webview)	`onWebview` (server)
`RPCCommands_Client`	-	-	`onCommand` (client)
`RPCCommands_Server`	-	-	`onCommand` (server)

events: the member name is the event name, its parameters are the arguments, its return type is what emit* resolves with. Server onClient and onWebview listeners get the player id before the declared arguments. Names that are not identifiers work too: 'buy-item'(item: string): boolean
commands: the key is the command name, the value is not used (true)

License

Licensed under the Custom Attribution-NoDerivs Software License