\n\n\n## Table of Contents\n\n* [Getting Started](#getting-started)\n * [Prerequisites](#prerequisites)\n * [Installation](#installation)\n* [Usage](#usage)\n* [License](#license)\n\n## Getting Started\n\nLeague Connect is a NodeJs module for consuming the League of Legends Client APIs\n\n- [Official League Client API Documentation][1]\n- [Unofficial League Client API Documentation (HextechDocs)][2]\n\n**If you're migrating from v5, please check out the [migration guide](./MIGRATION-V5.md)**\n\n### Prerequisites\n\nTo start using League Connect, ensure the following packages are installed:\n\n- Node (any recent version should run ([download][3]))\n- Yarn or NPM\n- League of Legends ([download][4])\n\nYou should also check out the [examples](examples) directory for code examples.\n\n### Installation\n\nLeague Connect ships as an NPM module, installable through Yarn or NPM. To add the\npackage to your project, install it through your package manager of choice.\n\n```sh\n$ yarn add league-connect\n# Or ...\n$ npm install league-connect\n```\n\n## Usage\n\nLeague Connect ships 4 primary APIs:\n\n- [`authenticate`: Fetch credentials to the Client APIs](#authenticate)\n- [`LeagueWebSocket`: Subscribe to Client API endpoints](#leaguewebsocket)\n- [`createHttp1/2Request`: Send HTTP requests to Client API endpoints](#requests)\n- [`LeagueClient`: Listen for League Client shutdown/startups](#leagueclient)\n\n### Authenticate\n\nCredentials are passed around as an object containing a port and a password [(see source)][credentials].\nThese credentials are pulled from the LeagueClientUx process and will be used to authenticate any\nrequests or connections to the APIs.\n\n**Code Example**\n\n```js\nimport { authenticate } from 'league-connect'\n\nconst credentials = await authenticate()\nconsole.log(credentials) // { password: '37dn2gsxH3ns', port: 37241 }\n```\n\nBy default, the `authenticate` function will return a rejected promise if it failed to locate a running\nLeagueClientUx process. If you wish to await until a client is found, you can use the optional options:\n\n| Option | Default Value | Description |\n|--------|---------------|-------------|\n| name | `LeagueClientUx` | League Client name, set to RiotClientUx if you would like to authenticate with the Riot Client\n| awaitConnection | `false` | Await until a LeagueClientUx process is found |\n| pollInterval | `2500` | Duration in milliseconds between each poll. No-op if awaitConnection is false. |\n| certificate | `undefined` | A plain-text self-signed certificate to authenticate to the LCU API with. This option should only be used if you're self-signing with a certificate which is not the one Riot Games provides on their developer page. League Connect will default to using Riot's own self-signed certificate for authentication. If you're of what this option does, you should probably not use it. |\n| unsafe | `false` | If you do not wish to authenticate safely using a self-signed certificate you can authorize while ignoring any certificate rejections. To authenticate this way, set unsafe to `true`. The custom certificate option will take precedence over this, meaning this option is meaningless if a custom certificate is provided. |\n| useDeprecatedWmic | `false` | Use deprecated Windows WMIC command line over Get-CimInstance. Does nothing if the system is not running on Windows. |\n| windowsShell | `powershell` | Set the Windows shell to use. Either powershell or cmd. |\n\n```js\nimport { authenticate } from 'league-connect'\n\nconst credentials = await authenticate({\n awaitConnection: true,\n pollInterval: 5000,\n // certificate: \"-----BEGIN CERTIFICATE-----\\nSowhdnAMyCertificate\\n-----ENDCERTIFICATE-----\",\n // unsafe: true\n})\n```\n\n###### [See source for available options][credentials]\n\n### LeagueWebSocket\n\nThe League Client runs a WebSocket for an event bus which anything using the client may connect to. Developers\nmay also connect to this socket over wss. LeagueConnect provides a function to retrieve a WebSocket connection.\n\n```js\nimport { createWebSocketConnection } from 'league-connect'\n\nconst ws = await createWebSocketConnection()\n```\n\nLeague Connect uses its own extended WebSocket class which allows subscriptions to certain API endpoints.\n\nThe socket instance automatically subscribes to Json events from the API which will be ran on the `message` event.\n\n**Code Example**\n\n```js\nimport { createWebSocketConnection } from 'league-connect'\n\nconst ws = await createWebSocketConnection({\n authenticationOptions: {\n // any options that can also be called to authenticate()\n awaitConnection: true\n }\n})\n\nws.on('message', message => {\n // Subscribe to any websocket event\n})\n```\n\nThe `createWebSocketConnection` function will retry connecting to the WebSocket 10 times by default. A rejected promise will be returned if the function is unable to connect. If you wish to change some of this behavior, you can pass in the following options to the function:\n| Option | Default Value | Description |\n|--------|---------------|-------------|\n| authenticationOptions | `undefined` | The same options that can be passed to the authenticate function |\n| pollInterval | `1000` | The amount of time in ms to wait between WS connection attempts |\n| maxRetries | `10` | The maximum amount of times to retry connecting to the WS. `-1` to keep retrying until connected |\n\n```js\nimport { createWebSocketConnection } from 'league-connect'\n\nconst ws = await createWebSocketConnection({\n authenticationOptions: {\n awaitConnection: true\n },\n pollInterval: 1000,\n maxRetries: 10\n})\n\nws.subscribe('/lol-chat/v1/conversations/active', (data, event) => {\n // data: deseralized json object from the event payload\n // event: the entire event (see EventResponse)\n})\n```\n\n###### [See source for available options][websocket]\n\n### Requests\n\nLeagueConnect supports both HTTP/1.1 and HTTP/2.0. Use the corresponding APIs as necessary.\n\nLeagueConnect supports sending HTTP requests to any of the League Client API endpoints\n(endpoints can be discovered and viewed with [LCU Explorer][lcuexplorer])\n\nIf you're looking to use HTTP/2.0, you first need to create a session.\n\n```js\nimport { authenticate, createHttpSession, createHttp2Request } from 'league-connect'\n\nconst credentials = await authenticate()\nconst session = await createHttpSession(credentials)\nconst response = await createHttp2Request({\n method: 'GET',\n url: '/lol-summoner/v1/current-summoner'\n}, session, credentials)\n\n// Remember to close the session when done\nsession.close()\n```\n\nFor HTTP/1.0, you can simply use the `createHttp1Request` function.\n\n```js\nimport { authenticate, createHttp1Request } from 'league-connect'\n\nconst credentials = await authenticate()\nconst response = await createHttp1Request({\n method: 'GET',\n url: '/lol-summoner/v1/current-summoner'\n}, credentials)\n```\n\nBoth `createHttp1Request` and `createHttp2Request` take the same options.\n\n| Option | Description |\n|--------|-------------|\n| url | Relative URI to send the http request to |\n| method | HTTP verb to use |\n| body | Optional post body (for non GET requests) as object literal. (library serializes it) |\n\n###### [See source for available options][request]\n\n### LeagueClient\n\nThe LeagueClient class is an EventEmitter which will listen for the LeagueClientUx process,\nreporting shutdown/startup of the application. The emitter has two listeners: `connect` and\n`disconnect`.\n\n**Code Example**\n\n```js\nimport { authenticate, LeagueClient } from 'league-connect'\n\nconst credentials = await authenticate()\nconst client = new LeagueClient(credentials)\n\nclient.on('connect', (newCredentials) => {\n // newCredentials: Each time the Client is started, new credentials are made\n // this variable contains the new credentials.\n})\n\nclient.on('disconnect', () => {\n\n})\n\nclient.start() // Start listening for process updates\nclient.stop() // Stop listening for process updates\n```\n\nBy default, the LeagueClient class will check for a client connection/disconnection\nevery 2.5 seconds. This can be changed by passing an options object into the\nconstructor.\n\n| Option | Default Value | Description |\n|--------|---------------|-------------|\n| pollInterval | `2500` | Duration in milliseconds between process existence check |\n\n```js\nimport { authenticate, LeagueClient } from 'league-connect'\n\nconst credentials = await authenticate()\nconst client = new LeagueClient(credentials, {\n pollInterval: 1000 // Check every second\n})\n```\n\n###### [See source for available options][leagueclient]\n\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n[1]: https://developer.riotgames.com/docs/lol#league-client-api\n[2]: https://www.hextechdocs.dev/lol/lcuapi\n[3]: https://nodejs.org/en/download/\n[4]: https://signup.na.leagueoflegends.com/en/signup/redownload\n\n[credentials]: https://github.com/matsjla/league-connect/blob/master/src/authentication.ts\n[websocket]: https://github.com/matsjla/league-connect/blob/master/src/websocket.ts\n[lcuexplorer]: https://github.com/HextechDocs/lcu-explorer\n[request]: https://github.com/matsjla/league-connect/blob/master/src/http.ts\n[leagueclient]: https://github.com/matsjla/league-connect/blob/master/src/client.ts\n","readmeFilename":"README.md"}