@ricsam/quickjs-crypto 0.2.13 → 0.2.14

package/README.md

@@ -0,0 +1,75 @@
+# @ricsam/quickjs-crypto
+
+Web Crypto API implementation providing cryptographic operations.
+
+```typescript
+import { setupCrypto } from "@ricsam/quickjs-crypto";
+
+const handle = setupCrypto(context);
+```
+
+**Injected Globals:**
+- `crypto.getRandomValues(array)` - Fill a TypedArray with random bytes
+- `crypto.randomUUID()` - Generate a random UUID v4
+- `crypto.subtle` - SubtleCrypto interface for cryptographic operations
+
+**Usage in QuickJS:**
+
+```javascript
+// Generate random bytes
+const bytes = new Uint8Array(16);
+crypto.getRandomValues(bytes);
+
+// Generate UUID
+const uuid = crypto.randomUUID();
+console.log(uuid); // "550e8400-e29b-41d4-a716-446655440000"
+
+// Hash data with SHA-256
+const data = new TextEncoder().encode("Hello, World!");
+const hash = await crypto.subtle.digest("SHA-256", data);
+
+// Generate encryption key
+const key = await crypto.subtle.generateKey(
+  { name: "AES-GCM", length: 256 },
+  true,
+  ["encrypt", "decrypt"]
+);
+
+// Encrypt data
+const iv = crypto.getRandomValues(new Uint8Array(12));
+const encrypted = await crypto.subtle.encrypt(
+  { name: "AES-GCM", iv },
+  key,
+  data
+);
+
+// Decrypt data
+const decrypted = await crypto.subtle.decrypt(
+  { name: "AES-GCM", iv },
+  key,
+  encrypted
+);
+```
+
+#### SubtleCrypto Methods
+
+| Method | Description |
+|--------|-------------|
+| `digest` | Generate hash (SHA-256, SHA-384, SHA-512) |
+| `generateKey` | Generate symmetric or asymmetric keys |
+| `sign` / `verify` | Sign and verify data (HMAC, ECDSA) |
+| `encrypt` / `decrypt` | Encrypt and decrypt data (AES-GCM, AES-CBC) |
+| `importKey` / `exportKey` | Import/export keys (raw, jwk, pkcs8, spki) |
+| `deriveBits` / `deriveKey` | Derive keys (PBKDF2, ECDH) |
+| `wrapKey` / `unwrapKey` | Wrap/unwrap keys for secure transport |
+
+**Supported Algorithms:**
+- **Encryption**: AES-GCM, AES-CBC
+- **Signing**: HMAC, ECDSA
+- **Hashing**: SHA-256, SHA-384, SHA-512
+- **Key Derivation**: PBKDF2, ECDH
+- **Asymmetric**: ECDSA (P-256, P-384, P-521), RSA-OAEP
+
+> **Note**: Cryptographic operations are delegated to the host's native `crypto.subtle` implementation, ensuring secure and performant cryptography.
+
+**See also:** [MDN Web Crypto API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API)

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-crypto",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "type": "commonjs"
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-crypto",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "type": "module"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/quickjs-crypto",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {
@@ -19,7 +19,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ricsam/quickjs-core": "^0.2.13",
+    "@ricsam/quickjs-core": "^0.2.14",
     "quickjs-emscripten": "^0.31.0"
   },
   "peerDependencies": {