add Cipher

Author: Srabutdotcom

deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@tls/enum",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "exports": "./src/mod.ts",
   "publish": {
     "exclude": ["dist/"]

src/cipher.js

@@ -0,0 +1,18 @@
+// @ts-self-types="../type/cipher.d.ts"
+
+import { Enum } from "./enum.js";
+
+export class Cipher extends Enum {
+   static AES_128_GCM_SHA256 = new Cipher('AES_128_GCM_SHA256', 0x01);
+   static AES_256_GCM_SHA384 = new Cipher('AES_256_GCM_SHA384', 0x02);
+   static CHACHA20_POLY1305_SHA256 = new Cipher('CHACHA20_POLY1305_SHA256', 0x03);
+   
+   static from(array){
+      const copy = Uint8Array.from(array);
+      if(copy.at(0)!==0x13)throw TypeError(`Expected 0x13 at index 0`)
+      return Cipher.fromValue(copy.at(1))
+   }
+
+   get Uint16(){return Uint8Array.of(0x13, +this)}
+}
+

test/cipher_test.js

@@ -0,0 +1,8 @@
+import { assertEquals } from "jsr:@std/assert";
+import { Cipher } from "../src/cipher.js";
+
+Deno.test("Cipher", () => {
+   const test = Cipher.AES_128_GCM_SHA256.Uint16;
+   const back = Cipher.from(test).Uint16;
+   assertEquals(test, back)
+})

type/cipher.d.ts

@@ -0,0 +1,36 @@
+import { Enum } from "../src/enum.js";
+
+/**
+ * Represents a cipher suite used in TLS 1.3.
+ * The cipher suite includes the encryption algorithm, mode, and hash function.
+ */
+export class Cipher extends Enum {
+    /**
+     * Cipher suite using AES 128 GCM with SHA256 for authentication.
+     */
+    static AES_128_GCM_SHA256: Cipher;
+
+    /**
+     * Cipher suite using AES 256 GCM with SHA384 for authentication.
+     */
+    static AES_256_GCM_SHA384: Cipher;
+
+    /**
+     * Cipher suite using ChaCha20 Poly1305 with SHA256 for authentication.
+     */
+    static CHACHA20_POLY1305_SHA256: Cipher;
+
+    /**
+     * Creates a `Cipher` instance from a binary representation.
+     * @param array The binary representation of the cipher suite.
+     * @returns The corresponding `Cipher` instance.
+     * @throws {TypeError} If the first byte of the input is not `0x13`.
+     */
+    static from(array: Uint8Array | Array<number>): Cipher;
+
+    /**
+     * Gets the 2-byte identifier of the cipher suite.
+     * @returns A `Uint8Array` containing the cipher suite identifier.
+     */
+    get Uint16(): Uint8Array;
+}