@cyberadityacode/simple-aes-gcm 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,17 @@
+name: Publish to NPM
+on:
+  release:
+    types: [created] # Runs when you create a "Release" on GitHub
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm install
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aditya Dubey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# AES-GCM Crypto Library
+
+A simple, lightweight wrapper for the Web Crypto API. Intended for Browser/Web Crypto API environments
+
+## Installation
+
+```bash
+npm install simple-aes-gcm
+```
+
+## Usage
+
+```javascript
+import { deriveKey, encrypt, decrypt } from "simple-aes-gcm";
+
+const key = await deriveKey("my-password", "unique-salt");
+const encrypted = await encrypt("Hello World", key);
+const originalText = await decrypt(encrypted, key);
+```
+
+## Author
+
+Aditya Dubey
+(cyberadityacode)

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@cyberadityacode/simple-aes-gcm",
+  "version": "1.0.0",
+  "description": "A lightweight AES-GCM encryption library for the browser.",
+  "main": "src/index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": ["crypto", "aes-gcm", "encryption"],
+  "author": "Aditya Dubey",
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,65 @@
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+
+/**
+ * Derives a key from a password and salt.
+ * @param {string} password 
+ * @param {string} salt 
+ */
+export async function deriveKey(password, salt = "default-salt") {
+  const baseKey = await crypto.subtle.importKey(
+    "raw",
+    encoder.encode(password),
+    { name: "PBKDF2" },
+    false,
+    ["deriveKey"]
+  );
+
+  return crypto.subtle.deriveKey(
+    {
+      name: "PBKDF2",
+      salt: encoder.encode(salt),
+      iterations: 100000,
+      hash: "SHA-256",
+    },
+    baseKey,
+    { name: "AES-GCM", length: 128 },
+    false,
+    ["encrypt", "decrypt"]
+  );
+}
+
+/**
+ * Encrypts a string using a CryptoKey object.
+ */
+export async function encrypt(text, key) {
+  const iv = crypto.getRandomValues(new Uint8Array(12));
+  const encrypted = await crypto.subtle.encrypt(
+    { name: "AES-GCM", iv },
+    key,
+    encoder.encode(text)
+  );
+
+  const combined = new Uint8Array(iv.length + encrypted.byteLength);
+  combined.set(iv);
+  combined.set(new Uint8Array(encrypted), iv.length);
+  
+  return btoa(String.fromCharCode(...combined));
+}
+
+/**
+ * Decrypts a base64 string using a CryptoKey object.
+ */
+export async function decrypt(cipherText, key) {
+  const data = Uint8Array.from(atob(cipherText), (c) => c.charCodeAt(0));
+  const iv = data.slice(0, 12);
+  const encrypted = data.slice(12);
+
+  const decrypted = await crypto.subtle.decrypt(
+    { name: "AES-GCM", iv },
+    key,
+    encrypted
+  );
+
+  return decoder.decode(decrypted);
+}