feat: add ciphers

.cursorrules

@@ -0,0 +1 @@
+.rules

.gitignore

@@ -186,4 +186,3 @@ tsconfig.tsbuildinfo
 
 # development stuffs
 *scratch*
-

.rules

@@ -0,0 +1,55 @@
+# React Native Quick Crypto
+
+Every time you choose to apply a rule(s), explicitly state the rule(s) in the output. You can abbreviate the rule description to a single word or phrase.
+
+## Project Context
+
+- This is a React Native project that offers cryptographic operations in native code.
+- It uses Nitro Modules to bridge JS & C++.
+- Use the documentation of Nitro Modules if you have access locally to its `llms.txt` file.
+- Part of the API strives to be a polyfill of the Node.js `{crypto}` module.
+- The goal is to migrate 0.x of this library that uses OpenSSL 1.1.1 to now use OpenSSL 3.3 and modern C++ with Nitro Modules.
+
+## Tech Stack
+
+- React Native
+- TypeScript
+- Nitro Modules
+- C++ 20 and higher, modern
+- OpenSSL 3.3 and higher
+- TypeScript package manager is `bun` 1.2 or higher
+- Don't ask to run tests. They have to be run in an example React Native app.
+
+## Rules
+
+- For C++ includes, do not try to add absolute or relative paths. They have to be resolved by the build system.
+- Use smart pointers in C++.
+- Use modern C++ features.
+- Attempt to reduce the amount of code rather than add more.
+- Prefer iteration and modularization over code duplication.
+
+## TypeScript Best Practices
+
+- Use TypeScript for all code; prefer interfaces over types.
+- Use lowercase with dashes for directories (e.g., `components/auth-wizard`).
+- Favor named exports for components.
+- Avoid `any` and enums; use explicit types and maps instead.
+- Use functional components with TypeScript interfaces.
+- Enable strict mode in TypeScript for better type safety.
+- Suggest the optimal implementation considering:
+  - Performance impact
+  - Maintenance overhead
+  - Testing strategy
+- Code examples should follow TypeScript best practices.
+
+## React Best Practices
+
+- Minimize the use of `useEffect`. They should be a last resort.
+- Use named functions for `useEffect`s with a meaningful function name. Avoid adding unnecessary comments on effect behavior.
+
+## Syntax & Formatting
+
+- Use the `function` keyword for pure functions.
+- Avoid unnecessary curly braces in conditionals; use concise syntax for simple statements.
+- Use declarative JSX.
+- Use Prettier for consistent code formatting.

.windsurfrules

@@ -0,0 +1 @@
+.rules

CPPLINT.cfg

@@ -1 +1 @@
-filter=-build/namespaces,-legal/copyright,-build/header_guard,-readability/casting,-runtime/references,-whitespace/newline,-build/c++11,-build/include_subdir,-whitespace/comments,-runtime/int,-runtime/printf
+filter=-build/namespaces,-legal/copyright,-build/header_guard,-readability/casting,-runtime/references,-whitespace/newline,-build/c++11,-build/include_subdir,-whitespace/comments,-runtime/int,-runtime/printf,-whitespace/blank_line

README.md

@@ -26,7 +26,7 @@ QuickCrypto can be used as a drop-in replacement for your Web3/Crypto apps to sp
 
 | Version | RN Architecture | Modules |
 | ------- | ------ | ------- |
-| `1.x`     | new [->](https://github.com/reactwg/react-native-new-architecture/blob/main/docs/enable-apps.md)  | Nitro Modules [->](https://github.com/margelo/react-native-nitro) |
+| `1.x`     | new [->](https://github.com/reactwg/react-native-new-architecture/blob/main/docs/enable-apps.md)  | Nitro Modules [->](https://github.com/mrousavy/nitro) |
 | `0.x`     | old  | Bridge & JSI |
 
 ## Benchmarks

bun.lock

@@ -10,7 +10,7 @@
     },
     "example": {
       "name": "react-native-quick-crypto-example",
-      "version": "1.0.0-beta.12",
+      "version": "1.0.0-beta.13",
       "dependencies": {
         "@craftzdog/react-native-buffer": "6.0.5",
         "@noble/curves": "^1.7.0",
@@ -25,10 +25,10 @@
         "events": "3.3.0",
         "react": "18.3.1",
         "react-native": "0.76.1",
-        "react-native-bouncy-checkbox": "4.0.1",
-        "react-native-nitro-modules": "0.21.0",
+        "react-native-bouncy-checkbox": "4.1.2",
+        "react-native-nitro-modules": "0.25.2",
         "react-native-quick-base64": "2.1.2",
-        "react-native-quick-crypto": "1.0.0-beta.12",
+        "react-native-quick-crypto": "workspace:*",
         "react-native-safe-area-context": "5.1.0",
         "react-native-screens": "3.35.0",
         "react-native-vector-icons": "^10.1.0",
@@ -69,13 +69,12 @@
     },
     "packages/react-native-quick-crypto": {
       "name": "react-native-quick-crypto",
-      "version": "1.0.0-beta.12",
+      "version": "1.0.0-beta.13",
       "dependencies": {
         "@craftzdog/react-native-buffer": "6.0.5",
         "events": "3.3.0",
         "react-native-quick-base64": "2.1.2",
         "readable-stream": "4.5.2",
-        "string_decoder": "1.3.0",
         "util": "0.12.5",
       },
       "devDependencies": {
@@ -90,10 +89,10 @@
         "eslint": "9.9.0",
         "eslint-plugin-react-native": "5.0.0",
         "jest": "29.7.0",
-        "nitro-codegen": "0.21.0",
+        "nitro-codegen": "0.25.2",
         "prettier": "3.3.3",
         "react-native-builder-bob": "0.35.2",
-        "react-native-nitro-modules": "0.21.0",
+        "react-native-nitro-modules": "0.25.2",
         "release-it": "18.1.1",
         "typescript": "5.1.6",
         "typescript-eslint": "^8.1.0",
@@ -1683,7 +1682,7 @@
 
     "new-github-release-url": ["[email protected]", "", { "dependencies": { "type-fest": "^2.5.1" } }, "sha512-NHDDGYudnvRutt/VhKFlX26IotXe1w0cmkDm6JGquh5bz/bDTw0LufSmH/GxTjEdpHEO+bVKFTwdrcGa/9XlKQ=="],
 
-    "nitro-codegen": ["nitro-codegen@0.21.0", "", { "dependencies": { "chalk": "^5.3.0", "react-native-nitro-modules": "^0.21.0", "ts-morph": "^25.0.0", "yargs": "^17.7.2", "zod": "^3.23.8" }, "bin": { "nitro-codegen": "lib/index.js" } }, "sha512-tp0hUKHN9a0IDCro9CKejQbcPDLKzYqF3U2lMPO/EVbcVlSqWLoO5dKdJ8+dzvIrbx32jIP/gK4fm4VXKIgbmg=="],
+    "nitro-codegen": ["nitro-codegen@0.25.2", "", { "dependencies": { "chalk": "^5.3.0", "react-native-nitro-modules": "^0.25.2", "ts-morph": "^25.0.0", "yargs": "^17.7.2", "zod": "^3.23.8" }, "bin": { "nitro-codegen": "lib/index.js" } }, "sha512-i0pGujdtmUaSmsawU6bmyFfW6MQbq+PZCWDT10QQg1EQbdPRvYAB5773R9GZtYoGNMGJ5qZVZUWnPBJRPOe61A=="],
 
     "nocache": ["[email protected]", "", {}, "sha512-WDD0bdg9mbq6F4mRxEYcPWwfA1vxd0mrvKOyxI7Xj/atfRHVeutzuWByG//jfm4uPzp0y4Kj051EORCBSQMycw=="],
 
@@ -1871,11 +1870,11 @@
 
     "react-native": ["[email protected]", "", { "dependencies": { "@jest/create-cache-key-function": "^29.6.3", "@react-native/assets-registry": "0.76.1", "@react-native/codegen": "0.76.1", "@react-native/community-cli-plugin": "0.76.1", "@react-native/gradle-plugin": "0.76.1", "@react-native/js-polyfills": "0.76.1", "@react-native/normalize-colors": "0.76.1", "@react-native/virtualized-lists": "0.76.1", "abort-controller": "^3.0.0", "anser": "^1.4.9", "ansi-regex": "^5.0.0", "babel-jest": "^29.7.0", "babel-plugin-syntax-hermes-parser": "^0.23.1", "base64-js": "^1.5.1", "chalk": "^4.0.0", "commander": "^12.0.0", "event-target-shim": "^5.0.1", "flow-enums-runtime": "^0.0.6", "glob": "^7.1.1", "invariant": "^2.2.4", "jest-environment-node": "^29.6.3", "jsc-android": "^250231.0.0", "memoize-one": "^5.0.0", "metro-runtime": "^0.81.0", "metro-source-map": "^0.81.0", "mkdirp": "^0.5.1", "nullthrows": "^1.1.1", "pretty-format": "^29.7.0", "promise": "^8.3.0", "react-devtools-core": "^5.3.1", "react-refresh": "^0.14.0", "regenerator-runtime": "^0.13.2", "scheduler": "0.24.0-canary-efb381bbf-20230505", "semver": "^7.1.3", "stacktrace-parser": "^0.1.10", "whatwg-fetch": "^3.0.0", "ws": "^6.2.3", "yargs": "^17.6.2" }, "peerDependencies": { "@types/react": "^18.2.6", "react": "^18.2.0" }, "optionalPeers": ["@types/react"], "bin": { "react-native": "cli.js" } }, "sha512-z4KnbrnnAvloRs9NGnah3u6/LK3IbtNMrvByxa3ifigbMlsMY4WPRYV9lvt/hH4Mzt8bfuI+utnOxFyJTTq3lg=="],
 
-    "react-native-bouncy-checkbox": ["react-native-bouncy-checkbox@4.0.1", "", { "dependencies": { "@freakycoder/react-native-bounceable": "^1.0.3" } }, "sha512-dlywsd3PWF47tkZKWFtnArtGM66Hkk1iUvlQhxSbnI56eo8BaQ4VnGFsrGxA3Jc/B7KDuzS9RCtaEflJJT5gYA=="],
+    "react-native-bouncy-checkbox": ["react-native-bouncy-checkbox@4.1.2", "", { "dependencies": { "@freakycoder/react-native-bounceable": "^1.0.3" } }, "sha512-hB7YwCGTNoMpTPOPiP+RWyQH35S6vxUbc7IGEW/Rqyp7GonEyhtqtthmxiphneRXnywMh8CZwND7OnvppJZscg=="],
 
     "react-native-builder-bob": ["[email protected]", "", { "dependencies": { "@babel/core": "^7.25.2", "@babel/plugin-transform-strict-mode": "^7.24.7", "@babel/preset-env": "^7.25.2", "@babel/preset-flow": "^7.24.7", "@babel/preset-react": "^7.24.7", "@babel/preset-typescript": "^7.24.7", "babel-plugin-module-resolver": "^5.0.2", "browserslist": "^4.20.4", "cosmiconfig": "^9.0.0", "cross-spawn": "^7.0.3", "dedent": "^0.7.0", "del": "^6.1.1", "escape-string-regexp": "^4.0.0", "fs-extra": "^10.1.0", "glob": "^8.0.3", "is-git-dirty": "^2.0.1", "json5": "^2.2.1", "kleur": "^4.1.4", "metro-config": "^0.80.9", "prompts": "^2.4.2", "which": "^2.0.2", "yargs": "^17.5.1" }, "bin": { "bob": "bin/bob" } }, "sha512-/ehbjzO2GhDd8/noZiZVEGAVDkyZuWJ+zOrKcrNpqpoLOWhCO4y10FGIRkl5bfLvy7/2kXTwI6YnwiGIOODSGQ=="],
 
-    "react-native-nitro-modules": ["react-native-nitro-modules@0.21.0", "", { "peerDependencies": { "react": "*", "react-native": "*" } }, "sha512-7OQsFiApHnBmTmZj5Ge6A1FZb63v3BjI4p2Y0s6zff35Tq9LJemjB2tHdv5F/0tbjHBV4AYcZf5DMop3NdzOog=="],
+    "react-native-nitro-modules": ["react-native-nitro-modules@0.25.2", "", { "peerDependencies": { "react": "*", "react-native": "*" } }, "sha512-rL+X0LzB8BXvpdrUE/+oZ5v4qS/1nZIq0M8Uctbvqq2q53sVCHX4995ffT8+lGIJe/f0QcBvvrEeXtBPl86iwQ=="],
 
     "react-native-quick-base64": ["[email protected]", "", { "dependencies": { "base64-js": "^1.5.1" }, "peerDependencies": { "react": "*", "react-native": "*" } }, "sha512-xghaXpWdB0ji8OwYyo0fWezRroNxiNFCNFpGUIyE7+qc4gA/IGWnysIG5L0MbdoORv8FkTKUvfd6yCUN5R2VFA=="],
 

docs/implementation-coverage.md

@@ -12,18 +12,18 @@ This document attempts to describe the implementation status of Crypto APIs/Inte
    * ❌ Static method: `Certificate.exportChallenge(spkac[, encoding])`
    * ❌ Static method: `Certificate.exportPublicKey(spkac[, encoding])`
    * ❌ Static method: `Certificate.verifySpkac(spkac[, encoding])`
-* ❌ Class: `Cipher`
-  * ❌ `cipher.final([outputEncoding])`
-  * ❌ `cipher.getAuthTag()`
-  * ❌ `cipher.setAAD(buffer[, options])`
-  * ❌ `cipher.setAutoPadding([autoPadding])`
-  * ❌ `cipher.update(data[, inputEncoding][, outputEncoding])`
-* ❌ Class: `Decipher`
-  * ❌ `decipher.final([outputEncoding])`
-  * ❌ `decipher.setAAD(buffer[, options])`
-  * ❌ `decipher.setAuthTag(buffer[, encoding])`
-  * ❌ `decipher.setAutoPadding([autoPadding])`
-  * ❌ `decipher.update(data[, inputEncoding][, outputEncoding])`
+* ✅ Class: `Cipher`
+  * ✅ `cipher.final([outputEncoding])`
+  * ✅ `cipher.getAuthTag()`
+  * ✅ `cipher.setAAD(buffer[, options])`
+  * ✅ `cipher.setAutoPadding([autoPadding])`
+  * ✅ `cipher.update(data[, inputEncoding][, outputEncoding])`
+* ✅ Class: `Decipher`
+  * ✅ `decipher.final([outputEncoding])`
+  * ✅ `decipher.setAAD(buffer[, options])`
+  * ✅ `decipher.setAuthTag(buffer[, encoding])`
+  * ✅ `decipher.setAutoPadding([autoPadding])`
+  * ✅ `decipher.update(data[, inputEncoding][, outputEncoding])`
 * ❌ Class: `DiffieHellman`
   * ❌ `diffieHellman.computeSecret(otherPublicKey[, inputEncoding][, outputEncoding])`
   * ❌ `diffieHellman.generateKeys([encoding])`
@@ -95,8 +95,8 @@ This document attempts to describe the implementation status of Crypto APIs/Inte
   * ❌ `crypto.fips`
   * ❌ `crypto.checkPrime(candidate[, options], callback)`
   * ❌ `crypto.checkPrimeSync(candidate[, options])`
-  * ❌ `crypto.createCipheriv(algorithm, key, iv[, options])`
-  * ❌ `crypto.createDecipheriv(algorithm, key, iv[, options])`
+  * ✅ `crypto.createCipheriv(algorithm, key, iv[, options])`
+  * ✅ `crypto.createDecipheriv(algorithm, key, iv[, options])`
   * ❌ `crypto.createDiffieHellman(prime[, primeEncoding][, generator][, generatorEncoding])`
   * ❌ `crypto.createDiffieHellman(primeLength[, generator])`
   * ❌ `crypto.createDiffieHellmanGroup(name)`
@@ -117,7 +117,7 @@ This document attempts to describe the implementation status of Crypto APIs/Inte
   * ❌ `crypto.generatePrime(size[, options[, callback]])`
   * ❌ `crypto.generatePrimeSync(size[, options])`
   * ❌ `crypto.getCipherInfo(nameOrNid[, options])`
-  * ❌ `crypto.getCiphers()`
+  * ✅ `crypto.getCiphers()`
   * ❌ `crypto.getCurves()`
   * ❌ `crypto.getDiffieHellman(groupName)`
   * ❌ `crypto.getFips()`

example/ios/Podfile.lock

@@ -7,7 +7,7 @@ PODS:
   - hermes-engine (0.76.1):
     - hermes-engine/Pre-built (= 0.76.1)
   - hermes-engine/Pre-built (0.76.1)
-  - NitroModules (0.21.0):
+  - NitroModules (0.25.2):
     - DoubleConversion
     - glog
     - hermes-engine
@@ -1940,9 +1940,9 @@ SPEC CHECKSUMS:
   fmt: 10c6e61f4be25dc963c36bd73fc7b1705fe975be
   glog: 08b301085f15bcbb6ff8632a8ebaf239aae04e6a
   hermes-engine: 46f1ffbf0297f4298862068dd4c274d4ac17a1fd
-  NitroModules: 3a58d9bc70815a0d5de4476ed6a36eff05a6a0ae
+  NitroModules: 3a9c88afc1ca3dba01759ed410e8c2902a5d3dbb
   OpenSSL-Universal: b60a3702c9fea8b3145549d421fdb018e53ab7b4
-  QuickCrypto: 8b714710db7acd4299e22db704ba85ea6e38c072
+  QuickCrypto: d56c13c2a864ef4400d7aca6631d57989d05a0a3
   RCT-Folly: 84578c8756030547307e4572ab1947de1685c599
   RCTDeprecation: fde92935b3caa6cb65cbff9fbb7d3a9867ffb259
   RCTRequired: 75c6cee42d21c1530a6f204ba32ff57335d19007

example/package.json

@@ -33,10 +33,10 @@
     "events": "3.3.0",
     "react": "18.3.1",
     "react-native": "0.76.1",
-    "react-native-bouncy-checkbox": "4.0.1",
-    "react-native-nitro-modules": "0.21.0",
+    "react-native-bouncy-checkbox": "4.1.2",
+    "react-native-nitro-modules": "0.25.2",
     "react-native-quick-base64": "2.1.2",
-    "react-native-quick-crypto": "1.0.0-beta.13",
+    "react-native-quick-crypto": "workspace:*",
     "react-native-safe-area-context": "5.1.0",
     "react-native-screens": "3.35.0",
     "react-native-vector-icons": "^10.1.0",

example/src/hooks/useTestsList.ts

@@ -2,28 +2,12 @@ import { useState, useCallback } from 'react';
 import type { TestSuites } from '../types/tests';
 import { TestsContext } from '../tests/util';
 
-import '../tests/hmac/hmac_tests';
-import '../tests/hash/hash_tests';
+import '../tests/cipher/cipher_tests';
 import '../tests/ed25519/ed25519_tests';
+import '../tests/hash/hash_tests';
+import '../tests/hmac/hmac_tests';
 import '../tests/pbkdf2/pbkdf2_tests';
 import '../tests/random/random_tests';
-// import '../tests/HmacTests/HmacTests';
-// import '../tests/HashTests/HashTests';
-// import '../tests/CipherTests/CipherTestFirst';
-// import '../tests/CipherTests/CipherTestSecond';
-// import '../tests/CipherTests/PublicCipherTests';
-// import '../tests/CipherTests/test398';
-// import '../tests/CipherTests/generateKey';
-// import '../tests/CipherTests/GenerateKeyPairTests';
-// import '../tests/ConstantsTests/ConstantsTests';
-// import '../tests/SignTests/SignTests';
-// import '../tests/SmokeTests/bundlerTests';
-// import '../tests/webcryptoTests/deriveBits';
-// import '../tests/webcryptoTests/digest';
-// import '../tests/webcryptoTests/generateKey';
-// import '../tests/webcryptoTests/encrypt_decrypt';
-// import '../tests/webcryptoTests/import_export';
-// import '../tests/webcryptoTests/sign_verify';
 
 export const useTestsList = (): [
   TestSuites,

example/src/hooks/useTestsRun.ts

@@ -84,96 +84,3 @@ const run = (
   stats.duration = stats.end.valueOf() - stats.start.valueOf();
   return stats;
 };
-
-// const run = (
-//   addTestResult: (testResult: TestResult) => void,
-//   tests: Suites = {},
-// ) => {
-//   const {
-//     EVENT_RUN_BEGIN,
-//     EVENT_RUN_END,
-//     EVENT_TEST_FAIL,
-//     EVENT_TEST_PASS,
-//     EVENT_TEST_PENDING,
-//     EVENT_TEST_END,
-//     EVENT_SUITE_BEGIN,
-//     EVENT_SUITE_END,
-//   } = Mocha.Runner.constants;
-
-//   const stats: Stats = { ...defaultStats };
-
-//   const runner = new Mocha.Runner(rootSuite);
-//   runner.stats = stats;
-
-//   // enable/disable tests based on checkbox value
-//   runner.suite.suites.map(s => {
-//     const suiteName = s.title;
-//     if (!tests[suiteName]?.value) {
-//       // console.log(`skipping '${suiteName}' suite`);
-//       s.tests.map(t => {
-//         t.skip();
-//       });
-//     } else {
-//       // console.log(`will run '${suiteName}' suite`);
-//       s.tests.map(t => {
-//         // @ts-expect-error - not sure why this is erroring
-//         t.reset();
-//       });
-//     }
-//   });
-
-//   let indents = -1;
-//   const indent = () => Array(indents).join('  ');
-//   runner
-//     .once(EVENT_RUN_BEGIN, () => {
-//       stats.start = new Date();
-//     })
-//     .on(EVENT_SUITE_BEGIN, (suite: MochaTypes.Suite) => {
-//       if (!suite.root) stats.suites++;
-//       indents++;
-//     })
-//     .on(EVENT_SUITE_END, () => {
-//       indents--;
-//     })
-//     .on(EVENT_TEST_PASS, (test: MochaTypes.Runnable) => {
-//       const name = test.parent?.title || '';
-//       stats.passes++;
-//       addTestResult({
-//         indentation: indents,
-//         description: test.title,
-//         suiteName: name,
-//         type: 'correct',
-//       });
-//       console.log(`${indent()}pass: ${test.title}`);
-//     })
-//     .on(EVENT_TEST_FAIL, (test: MochaTypes.Runnable, err: Error) => {
-//       const name = test.parent?.title || '';
-//       stats.failures++;
-//       addTestResult({
-//         indentation: indents,
-//         description: test.title,
-//         suiteName: name,
-//         type: 'incorrect',
-//         errorMsg: err.message,
-//       });
-//       console.log(`${indent()}fail: ${test.title} - error: ${err.message}`);
-//     })
-//     .on(EVENT_TEST_PENDING, function () {
-//       stats.pending++;
-//     })
-//     .on(EVENT_TEST_END, function () {
-//       stats.tests++;
-//     })
-//     .once(EVENT_RUN_END, () => {
-//       stats.end = new Date();
-//       stats.duration = stats.end.valueOf() - stats.start.valueOf();
-//       console.log(JSON.stringify(runner.stats, null, 2));
-//     });
-
-//   runner.run();
-
-//   return () => {
-//     console.log('aborting');
-//     runner.abort();
-//   };
-// };