chore(docs): more docs and examples

README.md

@@ -9,6 +9,20 @@ Checkout the [jsr page](https://jsr.io/@c43721/rcon) for more details.
 
 ### Examples
 
+A simple example that connects to a server and executes the `status` command and logs to console
+
+```ts
+using rcon = new Rcon({ host: "game.example.com", port: 27015 });
+
+const didAuthenticate = await rcon.authenticate("myrconpassword");
+
+console.log(didAuthenticate ? "Authenticated to the server" : "Could not authenticate");
+
+const result = await rcon.execute("status");
+
+console.log(result);
+```
+
 For more examples, see the [documentation on jsr](https://jsr.io/@c43721/rcon/doc).
 
 ## Contributing

deno.json

@@ -5,6 +5,6 @@
     "@std/cli": "jsr:@std/cli@^1.0.6",
     "@std/io": "jsr:@std/io@^0.225.0"
   },
-  "version": "0.0.1",
+  "version": "0.0.2",
   "exports": "./mod.ts"
 }

src/errors.ts

@@ -1,38 +1,56 @@
+/**
+ * The socket was already authenticated
+ */
 export class AlreadyAuthenicatedException extends Error {
   constructor() {
     super();
     this.message = "Already authenticated";
   }
 }
 
+/**
+ * Unable to authenticate the socket
+ */
 export class UnableToAuthenicateException extends Error {
   constructor() {
     super();
     this.message = "Unable to authenticate";
   }
 }
 
-export class NotAuthorizedException extends Error {
+/**
+ * Not authenticated to the socket and the user tried to send a command
+ */
+export class NotAuthenticatedException extends Error {
   constructor() {
     super();
     this.message = "Not authenticated";
   }
 }
 
+/**
+ * The socket was never connected or disconnected too early
+ */
 export class NotConnectedException extends Error {
   constructor() {
     super();
     this.message = "Not connected";
   }
 }
 
+/**
+ * The packet was unable to be parsed into the expected value
+ */
 export class UnableToParseResponseException extends Error {
   constructor() {
     super();
     this.message = "Unable to parse response";
   }
 }
 
+/**
+ * The packet being sent is too large to send to the server
+ */
 export class PacketSizeTooBigException extends Error {
   constructor() {
     super();

src/rcon.ts

@@ -3,7 +3,7 @@ import { iterateReader } from "@std/io";
 import { concat } from "@std/bytes";
 import { encode, decode } from "./packet.ts";
 import {
-  NotAuthorizedException,
+  NotAuthenticatedException,
   NotConnectedException,
   PacketSizeTooBigException,
   UnableToAuthenicateException,
@@ -102,7 +102,7 @@ export default class Rcon {
     }
 
     if (!this.#authenticated) {
-      throw new NotAuthorizedException();
+      throw new NotAuthenticatedException();
     }
 
     const packetId = Math.floor(Math.random() * (256 - 1) + 1);