@irfanshadikrishad/cipher 1.1.0 → 1.2.1

package/README.md

@@ -43,17 +43,18 @@ console.log(caesar.encrypt("hello world")) // Output: "nkrru cuxrj"
 
 This library provides implementations of various classical and modern ciphers:
 
-| Cipher                                              | Type                                     | Key required? | Strength | Used In/Notes                                       |
-| --------------------------------------------------- | ---------------------------------------- | ------------- | -------- | --------------------------------------------------- |
-| [Caesar Cipher](/docs/en/ciphers/CAESAR.md)         | Substitution                             | No            | Low      | Ancient Rome, Simple Obsfuscation                   |
-| [Atbash Cipher](/docs/en/ciphers/ATBASH.md)         | Substitution                             | No            | Low      | Hebrew Cipher, Basic Encryption                     |
-| [Playfair Cipher](/docs/en/ciphers/PLAYFAIR.md)     | Diagraph-based                           | Yes           | Medium   | Used in WWI & WWII                                  |
-| [Vigenère Cipher](/docs/en/ciphers/VIGENERE.md)     | Polyalphabetic                           | Yes           | Medium   | Used in Historical Documents                        |
-| [The Alphabet Cipher](/docs/en/ciphers/ALPHABET.md) | Polyalphabetic                           | Yes           | Medium   | Inspired by Vigenere, Cryptography Puzzles          |
-| [Salsa20](/docs/en/ciphers/SALSA20.md)              | Stream Cipher                            | Yes           | High     | Modern Cryptography, Secure Communications          |
-| [ADFGVX](/docs/en/ciphers/ADFGVX.md)                | Polybius Square + Columnar Transposition | Yes           | Medium   | Used in WWI, Known for 6x6 polybius square          |
-| [AES](/docs/en/ciphers/AES.md)                      | Symmetric Block Cipher                   | Yes           | High     | Also known as, Rijndael                             |
-| [DES](/docs/en/ciphers/DES.md)                      | Symmetric Block Cipher                   | Yes           | Medium   | 56-bit key, Used in legacy systems, replaced by AES |
+| Cipher                                              | Type                                     | Key required? | Strength  | Used In/Notes                                       |
+| --------------------------------------------------- | ---------------------------------------- | ------------- | --------- | --------------------------------------------------- |
+| [Caesar Cipher](/docs/en/ciphers/CAESAR.md)         | Substitution                             | No            | Low       | Ancient Rome, Simple Obsfuscation                   |
+| [Atbash Cipher](/docs/en/ciphers/ATBASH.md)         | Substitution                             | No            | Low       | Hebrew Cipher, Basic Encryption                     |
+| [Playfair Cipher](/docs/en/ciphers/PLAYFAIR.md)     | Diagraph-based                           | Yes           | Medium    | Used in WWI & WWII                                  |
+| [Vigenère Cipher](/docs/en/ciphers/VIGENERE.md)     | Polyalphabetic                           | Yes           | Medium    | Used in Historical Documents                        |
+| [The Alphabet Cipher](/docs/en/ciphers/ALPHABET.md) | Polyalphabetic                           | Yes           | Medium    | Inspired by Vigenere, Cryptography Puzzles          |
+| [Salsa20](/docs/en/ciphers/SALSA20.md)              | Stream Cipher                            | Yes           | High      | Modern Cryptography, Secure Communications          |
+| [ADFGVX](/docs/en/ciphers/ADFGVX.md)                | Polybius Square + Columnar Transposition | Yes           | Medium    | Used in WWI, Known for 6x6 polybius square          |
+| [AES](/docs/en/ciphers/AES.md)                      | Symmetric Block Cipher                   | Yes           | High      | Also known as, Rijndael                             |
+| [DES](/docs/en/ciphers/DES.md)                      | Symmetric Block Cipher                   | Yes           | Medium    | 56-bit key, Used in legacy systems, replaced by AES |
+| [ECC](/docs/en/ciphers/ECC.md)                      | Asymmetric (Public-Key Cryptography)     | Yes           | Very High | Used in modern systems like Bitcoin, TLS, JWT, etc. |
 
 More ciphers coming soon...
 

package/dist/Cipher.d.ts

@@ -7,6 +7,7 @@ import { Salsa20 } from "./ciphers/Salsa20.js";
 import { ADFGVX } from "./ciphers/ADFGVX.js";
 import { AES } from "./ciphers/AES.js";
 import { DES } from "./ciphers/DES.js";
+import { ECC } from "./ciphers/ECC.js";
 export declare abstract class Cipher {
     /**
      * Caesar cipher is a substitution cipher where each letter in the plaintext is shifted a certain number of places down the alphabet.
@@ -58,6 +59,10 @@ export declare abstract class Cipher {
      * @param iv 8 characters long
      */
     static DES: typeof DES;
-    abstract encrypt(text: string): string;
-    abstract decrypt(text: string): string;
+    /**
+     * Elliptic-curve cryptography (ECC) is an approach to public-key cryptography based on the algebraic structure of elliptic curves over finite fields.
+     */
+    static ECC: typeof ECC;
+    abstract encrypt(text: string): string | Promise<string>;
+    abstract decrypt(text: string): string | Promise<string>;
 }

package/dist/ciphers/ADFGVX.js

@@ -78,12 +78,11 @@ export class ADFGVX extends Cipher {
         return this.columnarTranspose(polybiusText);
     }
     decrypt(text) {
-        var _a;
         const encrypted = text.replace(/[^A-Za-z0-9]/g, "").toUpperCase();
         const intermediate = this.columnarTranspose(encrypted, true);
-        const polybiusText = ((_a = intermediate.match(/.{1,2}/g)) === null || _a === void 0 ? void 0 : _a.map((char) => {
+        const polybiusText = intermediate.match(/.{1,2}/g)?.map((char) => {
             return this.reverseSquare.get(char) || "";
-        })) || [];
+        }) || [];
         return polybiusText.join("");
     }
 }

package/dist/ciphers/ECC.d.ts

@@ -0,0 +1,15 @@
+import { Cipher } from "../Cipher.js";
+export declare class ECC extends Cipher {
+    private recipientPublicKey?;
+    private ownPrivateKey?;
+    static recipientPublicKey: string;
+    static ownPrivateKey: string;
+    constructor(recipientPublicKey?: CryptoKey, ownPrivateKey?: CryptoKey);
+    static generate(): Promise<ECC>;
+    encrypt(plaintext: string): Promise<string>;
+    decrypt(data: string): Promise<string>;
+    exportPublicKey(): Promise<string>;
+    static importPublicKey(hex: string): Promise<CryptoKey>;
+    static bufToHex(buf: Uint8Array): string;
+    static hexToBuf(hex: string): Uint8Array;
+}

package/dist/ciphers/ECC.js

@@ -0,0 +1,55 @@
+import crypto from "crypto";
+import { Cipher } from "../Cipher.js";
+export class ECC extends Cipher {
+    constructor(recipientPublicKey, ownPrivateKey) {
+        super();
+        this.recipientPublicKey = recipientPublicKey;
+        this.ownPrivateKey = ownPrivateKey;
+    }
+    static async generate() {
+        const { publicKey, privateKey } = await crypto.subtle.generateKey({ name: "ECDH", namedCurve: "P-256" }, true, ["deriveKey", "deriveBits"]);
+        return new ECC(publicKey, privateKey);
+    }
+    async encrypt(plaintext) {
+        if (!this.recipientPublicKey)
+            throw new Error("Recipient public key not set");
+        const ephemeral = await ECC.generate();
+        const sharedKey = await crypto.subtle.deriveKey({ name: "ECDH", public: this.recipientPublicKey }, ephemeral.ownPrivateKey, { name: "AES-GCM", length: 256 }, false, ["encrypt"]);
+        const iv = crypto.getRandomValues(new Uint8Array(12));
+        const encrypted = await crypto.subtle.encrypt({ name: "AES-GCM", iv }, sharedKey, new TextEncoder().encode(plaintext));
+        const payload = {
+            iv: ECC.bufToHex(iv),
+            ciphertext: ECC.bufToHex(new Uint8Array(encrypted)),
+            ephemeralPublicHex: await ephemeral.exportPublicKey(),
+        };
+        return JSON.stringify(payload);
+    }
+    async decrypt(data) {
+        if (!this.ownPrivateKey)
+            throw new Error("Own private key not set");
+        const { iv, ciphertext, ephemeralPublicHex } = JSON.parse(data);
+        const ephemeralPubKey = await ECC.importPublicKey(ephemeralPublicHex);
+        const sharedKey = await crypto.subtle.deriveKey({ name: "ECDH", public: ephemeralPubKey }, this.ownPrivateKey, { name: "AES-GCM", length: 256 }, false, ["decrypt"]);
+        const decrypted = await crypto.subtle.decrypt({ name: "AES-GCM", iv: ECC.hexToBuf(iv) }, sharedKey, ECC.hexToBuf(ciphertext));
+        return new TextDecoder().decode(decrypted);
+    }
+    async exportPublicKey() {
+        const raw = await crypto.subtle.exportKey("raw", this.recipientPublicKey || this.ownPrivateKey);
+        return ECC.bufToHex(new Uint8Array(raw));
+    }
+    static async importPublicKey(hex) {
+        const raw = ECC.hexToBuf(hex);
+        return crypto.subtle.importKey("raw", raw, { name: "ECDH", namedCurve: "P-256" }, true, []);
+    }
+    // Helpers
+    static bufToHex(buf) {
+        return [...buf].map((b) => b.toString(16).padStart(2, "0")).join("");
+    }
+    static hexToBuf(hex) {
+        const bytes = new Uint8Array(hex.length / 2);
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = parseInt(hex.substr(i * 2, 2), 16);
+        }
+        return bytes;
+    }
+}

package/dist/index.js

@@ -8,6 +8,7 @@ import { Salsa20 } from "./ciphers/Salsa20.js";
 import { ADFGVX } from "./ciphers/ADFGVX.js";
 import { AES } from "./ciphers/AES.js";
 import { DES } from "./ciphers/DES.js";
+import { ECC } from "./ciphers/ECC.js";
 Cipher.Caesar = Caesar;
 Cipher.Atbash = Atbash;
 Cipher.Playfair = Playfair;
@@ -17,4 +18,5 @@ Cipher.Salsa20 = Salsa20;
 Cipher.ADFGVX = ADFGVX;
 Cipher.AES = AES;
 Cipher.DES = DES;
+Cipher.ECC = ECC;
 export { Cipher };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@irfanshadikrishad/cipher",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "A versatile and secure cryptographic library for implementing various cipher algorithms in Node.js applications with zero/0 dependencies.",
   "homepage": "https://github.com/irfanshadikrishad/cipher#readme",
   "bugs": {
@@ -40,18 +40,18 @@
     "all": "npm run build && npm run format && npm run lint && npm run test"
   },
   "devDependencies": {
-    "@eslint/js": "^9.25.1",
-    "@types/jest": "^29.5.14",
-    "@typescript-eslint/eslint-plugin": "^8.31.1",
-    "@typescript-eslint/parser": "^8.31.1",
-    "eslint": "^9.25.1",
-    "globals": "^16.0.0",
+    "@eslint/js": "^9.29.0",
+    "@types/jest": "^30.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.34.0",
+    "@typescript-eslint/parser": "^8.34.0",
+    "eslint": "^9.29.0",
+    "globals": "^16.2.0",
     "husky": "^9.1.7",
-    "jest": "^29.7.0",
+    "jest": "^30.0.2",
     "prettier": "^3.5.3",
-    "ts-jest": "^29.3.2",
+    "ts-jest": "^29.4.0",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.31.1"
+    "typescript-eslint": "^8.34.0"
   },
   "keywords": [
     "security",