@sswroom/sswr 1.6.12 → 1.6.13

package/Changelog

@@ -1,3 +1,6 @@
+1.6.13
+-Added crypto.ICrypto, crypto.AES256GCM
+
 1.6.12
 -Added dummy/i18next.js
 -Added web.getButtonElement, getDivElement, getSpanElement

package/crypto.d.ts

@@ -0,0 +1,27 @@
+export abstract class ICrypto
+{
+	abstract encrypt(inBuff: ArrayBuffer): Promise<ArrayBuffer | null>;
+	abstract decrypt(inBuff: ArrayBuffer): Promise<ArrayBuffer | null>;
+	
+	abstract getEncBlockSize(): number;
+	abstract getDecBlockSize(): number;
+
+	static keyToBuffer(key: string, nBytes: number): ArrayBuffer;
+}
+
+export class AES256GCM extends ICrypto
+{
+	constructor(key: ArrayBuffer, iv: ArrayBuffer);
+
+	encrypt(inBuff: ArrayBuffer): Promise<ArrayBuffer | null>;
+	decrypt(inBuff: ArrayBuffer): Promise<ArrayBuffer | null>;
+
+	getEncBlockSize(): number;
+	getDecBlockSize(): number;
+
+	/**
+	 * 12 byte length
+	 * @param iv Initial Vector
+	 */
+	setIV(iv: ArrayBuffer): void;
+}

package/crypto.js

@@ -0,0 +1,149 @@
+export class ICrypto
+{
+	/**
+	 * @param {ArrayBuffer} inBuff
+	 * @returns {Promise<ArrayBuffer|null>}
+	 */
+	async encrypt(inBuff)
+	{
+		throw new Error("ICrypto.encrypt must be inherited");
+	}
+
+	/**
+	 * @param {ArrayBuffer} inBuff
+	 * @returns {Promise<ArrayBuffer|null>}
+	 */
+	async decrypt(inBuff)
+	{
+		throw new Error("ICrypto.decrypt must be inherited");
+	}
+	
+	/**
+	 * @returns {number}
+	 */
+	getEncBlockSize()	/**
+	* @returns {number}
+	*/
+
+	{
+		throw new Error("ICrypto.getEncBlockSize must be inherited");
+	}
+
+	/**
+	 * @returns {number}
+	 */
+	getDecBlockSize()
+	{
+		throw new Error("ICrypto.getDecBlockSize must be inherited");
+	}
+
+	
+	/**
+	 * @param {string} key
+	 * @param {number} nBytes
+	 * @returns {Uint8Array}
+	 */
+	static keyToBuffer(key, nBytes)
+	{
+		let enc = new TextEncoder();
+		let arr = enc.encode(key);
+		if (arr.length >= nBytes)
+		{
+			return arr.subarray(0, nBytes);
+		}
+		else
+		{
+			let ret = new Uint8Array(nBytes);
+			let i = 0;
+			let j = arr.length;
+			let k = 0;
+			while (i < nBytes)
+			{
+				if (k >= j)
+				{
+					ret[i] = 0x7f;
+					k = 0;
+				}
+				else
+				{
+					ret[i] = arr[k];
+					k++;
+				}
+				i++;
+			}
+			return ret;
+		}
+	}
+}
+
+export class AES256GCM extends ICrypto
+{
+	/**
+	 * @param {ArrayBuffer} key
+	 * @param {ArrayBuffer} iv
+	 */
+	constructor(key, iv)
+	{
+		super();
+		if (key.byteLength != 32)
+		{
+			throw new Error("key must be 32 bytes long");
+		}
+		this.key = key;
+		this.setIV(iv);
+	}
+
+	/**
+	 * @param {ArrayBuffer} inBuff
+	 */
+	async encrypt(inBuff)
+	{
+		if (window.crypto.subtle == null)
+		{
+			return null;
+		}
+		let key = await window.crypto.subtle.importKey("raw", this.key, {name: "AES-GCM"}, false, ["encrypt", "decrypt"]);
+		return await window.crypto.subtle.encrypt( {
+			name: "AES-GCM",
+			iv: this.iv
+		  }, key, inBuff);
+	}
+
+	/**
+	 * @param {ArrayBuffer} inBuff
+	 */
+	async decrypt(inBuff)
+	{
+		if (window.crypto.subtle == null)
+		{
+			return null;
+		}
+		let key = await window.crypto.subtle.importKey("raw", this.key, {name: "AES-GCM"}, false, ["encrypt", "decrypt"]);
+		return await window.crypto.subtle.decrypt( {
+			name: "AES-GCM",
+			iv: this.iv
+		  }, key, inBuff);
+	}
+
+	getEncBlockSize()
+	{
+		return 16;
+	}
+
+	getDecBlockSize()
+	{
+		return 16;
+	}
+
+	/**
+	 * @param {ArrayBuffer} iv
+	 */
+	setIV(iv)
+	{
+		if (iv.byteLength != 12)
+		{
+			throw new Error("iv must be 12 bytes long");
+		}
+		this.iv = iv;
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sswroom/sswr",
-  "version": "1.6.12",
+  "version": "1.6.13",
   "description": "Libraries made by sswroom",
   "main": "sswr.js",
   "scripts": {

package/text.js

@@ -625,12 +625,20 @@ export class UTF8TextBinEnc extends TextBinEnc
 		super("UTF-8 Text");
 	}
 
+	/**
+	 * @param {Uint8Array} buff
+	 * @returns {string}
+	 */
 	encodeBin(buff)
 	{
 		let enc = new TextDecoder();
 		return enc.decode(buff);
 	}
 
+	/**
+	 * @param {string} str 
+	 * @returns {Uint8Array}
+	 */
 	decodeBin(str)
 	{
 		let enc = new TextEncoder();