@guanghechen/byte 1.0.0-alpha.4 → 1.0.0-alpha.6

package/CHANGELOG.md

@@ -1,44 +1,58 @@
 # Change Log
 
-All notable changes to this project will be documented in this file.
-See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
-
-# [1.0.0-alpha.4](https://github.com/guanghechen/sora/compare/@guanghechen/byte@1.0.0-alpha.3...@guanghechen/byte@1.0.0-alpha.4) (2023-11-29)
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.6](https://github.com/guanghechen/sora/compare/@guanghechen/byte@1.0.0-alpha.5...@guanghechen/byte@1.0.0-alpha.6) (2024-02-03)
 
 ### Performance Improvements
 
-* 🔧 no longer to require node engine version in packages ([6dc2014](https://github.com/guanghechen/sora/commit/6dc2014122dd44bcadc893e2ee98697265e7d61e))
+- 💄 fix lint
+  ([2d5bb6f](https://github.com/guanghechen/sora/commit/2d5bb6f03d0312a42c1117d95181df8b69de827a))
+- 🔧 fix nx scripts
+  ([47bc4e6](https://github.com/guanghechen/sora/commit/47bc4e66df825cb37127219bccf60dc81d6a9b48))
+- 🔧 update tsconfig
+  ([98855bc](https://github.com/guanghechen/sora/commit/98855bcc245d98c61217c5bafc6a1b2506b7824d))
 
+# Change Log
 
+All notable changes to this project will be documented in this file. See
+[Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.5](https://github.com/guanghechen/sora/compare/@guanghechen/byte@1.0.0-alpha.4...@guanghechen/byte@1.0.0-alpha.5) (2024-01-02)
 
+### Performance Improvements
 
-# [1.0.0-alpha.3](https://github.com/guanghechen/sora/compare/@guanghechen/byte@1.0.0-alpha.2...@guanghechen/byte@1.0.0-alpha.3) (2023-11-18)
+- :art: prefer randomBytes from 'crypto' cause it returns true-random numbers
+  ([7d0e7fd](https://github.com/guanghechen/sora/commit/7d0e7fd06b991b2121c01b639cf6d5d36eec4ea6))
+- 🎨 add 'areSameBytes'
+  ([fc0f163](https://github.com/guanghechen/sora/commit/fc0f163b9b78cf382e6e8b601ed53f95e2a14449))
 
+# [1.0.0-alpha.4](https://github.com/guanghechen/sora/compare/@guanghechen/byte@1.0.0-alpha.3...@guanghechen/byte@1.0.0-alpha.4) (2023-11-29)
 
 ### Performance Improvements
 
-* 🔧 upgrade engine version requirement from '>= 16.0.0' to '>= 18.0.0' ([ddb9521](https://github.com/guanghechen/sora/commit/ddb9521b529b2ca838554794339b9e27ac80b8aa))
-
+- 🔧 no longer to require node engine version in packages
+  ([6dc2014](https://github.com/guanghechen/sora/commit/6dc2014122dd44bcadc893e2ee98697265e7d61e))
 
+# [1.0.0-alpha.3](https://github.com/guanghechen/sora/compare/@guanghechen/byte@1.0.0-alpha.2...@guanghechen/byte@1.0.0-alpha.3) (2023-11-18)
 
+### Performance Improvements
 
+- 🔧 upgrade engine version requirement from '>= 16.0.0' to '>= 18.0.0'
+  ([ddb9521](https://github.com/guanghechen/sora/commit/ddb9521b529b2ca838554794339b9e27ac80b8aa))
 
 # [1.0.0-alpha.2](https://github.com/guanghechen/sora/compare/@guanghechen/byte@1.0.0-alpha.1...@guanghechen/byte@1.0.0-alpha.2) (2023-10-25)
 
-
 ### Features
 
-* ✨ support to encode/decode in base64 format (forked from [@algorithm](https://github.com/algorithm).ts/base64) ([e30e234](https://github.com/guanghechen/sora/commit/e30e234494251f6ce79ce9b697c49179022b96a3))
-
-
-
-
+- ✨ support to encode/decode in base64 format (forked from
+  [@algorithm](https://github.com/algorithm).ts/base64)
+  ([e30e234](https://github.com/guanghechen/sora/commit/e30e234494251f6ce79ce9b697c49179022b96a3))
 
 # 1.0.0-alpha.1 (2023-10-22)
 
-
 ### Features
 
-* ✨ add @guanghechen/byte ([23c4579](https://github.com/guanghechen/sora/commit/23c4579b3c82a710c026c3e1ffa5df27e240ef83))
+- ✨ add @guanghechen/byte
+  ([23c4579](https://github.com/guanghechen/sora/commit/23c4579b3c82a710c026c3e1ffa5df27e240ef83))

package/README.md

@@ -1,6 +1,6 @@
 <header>
   <h1 align="center">
-    <a href="https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.4/packages/byte#readme">@guanghechen/byte</a>
+    <a href="https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.6/packages/byte#readme">@guanghechen/byte</a>
   </h1>
   <div align="center">
     <a href="https://www.npmjs.com/package/@guanghechen/byte">
@@ -51,16 +51,15 @@
 
 Utility functions for bytes (Uint8Array).
 
-
 ## Install
 
-* npm
+- npm
 
   ```bash
   npm install --save @guanghechen/byte
   ```
 
-* yarn
+- yarn
 
   ```bash
   yarn add @guanghechen/byte
@@ -68,4 +67,5 @@ Utility functions for bytes (Uint8Array).
 
 ## Usage
 
-[homepage]: https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.4/packages/byte#readme
+[homepage]:
+  https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.6/packages/byte#readme

package/lib/cjs/index.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var crypto = require('crypto');
+
 const CODES = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
 const CODE_PADDING = '=';
 const CODE_LIST = CODES.split('');
@@ -194,6 +196,22 @@ function destroyBytesList(bytesList) {
         destroyBytes(bytes);
 }
 
+function areSameBytes(bytes1, bytes2) {
+    if (bytes1 === bytes2)
+        return true;
+    if (bytes1 === undefined)
+        return false;
+    if (bytes2 === undefined)
+        return false;
+    if (bytes1.length !== bytes2.length)
+        return false;
+    for (let i = 0; i < bytes1.length; ++i) {
+        if (bytes1.at(i) !== bytes2.at(i))
+            return false;
+    }
+    return true;
+}
+
 function mergeBytes(bytesList) {
     const bytesSize = bytesList.reduce((acc, cur) => acc + cur.length, 0);
     const result = new Uint8Array(bytesSize);
@@ -207,14 +225,11 @@ function mergeBytes(bytesList) {
 }
 
 function randomBytes(size) {
-    const bytes = new Uint8Array(size);
-    for (let i = 0; i < size; i++) {
-        const v = Math.random() * 256;
-        bytes[i] = v >>> 0;
-    }
-    return bytes;
+    const bytes = crypto.randomBytes(size);
+    return Uint8Array.from(bytes);
 }
 
+exports.areSameBytes = areSameBytes;
 exports.base64Text2bytes = base64Text2bytes;
 exports.bytes2base64Text = bytes2base64Text;
 exports.bytes2hexText = bytes2hexText;

package/lib/esm/index.mjs

@@ -1,3 +1,5 @@
+import { randomBytes as randomBytes$1 } from 'crypto';
+
 const CODES = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
 const CODE_PADDING = '=';
 const CODE_LIST = CODES.split('');
@@ -192,6 +194,22 @@ function destroyBytesList(bytesList) {
         destroyBytes(bytes);
 }
 
+function areSameBytes(bytes1, bytes2) {
+    if (bytes1 === bytes2)
+        return true;
+    if (bytes1 === undefined)
+        return false;
+    if (bytes2 === undefined)
+        return false;
+    if (bytes1.length !== bytes2.length)
+        return false;
+    for (let i = 0; i < bytes1.length; ++i) {
+        if (bytes1.at(i) !== bytes2.at(i))
+            return false;
+    }
+    return true;
+}
+
 function mergeBytes(bytesList) {
     const bytesSize = bytesList.reduce((acc, cur) => acc + cur.length, 0);
     const result = new Uint8Array(bytesSize);
@@ -205,12 +223,8 @@ function mergeBytes(bytesList) {
 }
 
 function randomBytes(size) {
-    const bytes = new Uint8Array(size);
-    for (let i = 0; i < size; i++) {
-        const v = Math.random() * 256;
-        bytes[i] = v >>> 0;
-    }
-    return bytes;
+    const bytes = randomBytes$1(size);
+    return Uint8Array.from(bytes);
 }
 
-export { base64Text2bytes, bytes2base64Text, bytes2hexText, bytes2text, bytes2utf8Text, destroyBytes, destroyBytesList, hexText2bytes, mergeBytes, randomBytes, text2bytes, utf8Text2bytes, validateBase64Text };
+export { areSameBytes, base64Text2bytes, bytes2base64Text, bytes2hexText, bytes2text, bytes2utf8Text, destroyBytes, destroyBytesList, hexText2bytes, mergeBytes, randomBytes, text2bytes, utf8Text2bytes, validateBase64Text };

package/lib/types/index.d.ts

@@ -30,13 +30,24 @@ declare function destroyBytes(bytes: Uint8Array): void;
  */
 declare function destroyBytesList(bytesList: Uint8Array[]): void;
 
+/**
+ * Check if two Uint8Array are same.
+ * @param bytes1
+ * @param bytes2
+ * @returns
+ */
+declare function areSameBytes(bytes1: Readonly<Uint8Array> | undefined, bytes2: Readonly<Uint8Array> | undefined): boolean;
+
 declare function mergeBytes(bytesList: ReadonlyArray<Uint8Array>): Uint8Array;
 
 /**
  * Generate a random bytes with the given size.
+ *
+ * Use randomBytes from 'crypto' cause it returns true random numbers.
+ *
  * @param size
  * @returns
  */
 declare function randomBytes(size: number): Uint8Array;
 
-export { type IByteEncoding, base64Text2bytes, bytes2base64Text, bytes2hexText, bytes2text, bytes2utf8Text, destroyBytes, destroyBytesList, hexText2bytes, mergeBytes, randomBytes, text2bytes, utf8Text2bytes, validateBase64Text };
+export { type IByteEncoding, areSameBytes, base64Text2bytes, bytes2base64Text, bytes2hexText, bytes2text, bytes2utf8Text, destroyBytes, destroyBytesList, hexText2bytes, mergeBytes, randomBytes, text2bytes, utf8Text2bytes, validateBase64Text };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanghechen/byte",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.6",
   "description": "Utility functions for bytes (Uint8Array).",
   "author": {
     "name": "guanghechen",
@@ -8,10 +8,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.3",
+    "url": "https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.5",
     "directory": "packages/byte"
   },
-  "homepage": "https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.3/packages/byte#readme",
+  "homepage": "https://github.com/guanghechen/sora/tree/@guanghechen/byte@1.0.0-alpha.5/packages/byte#readme",
   "keywords": [
     "Uint8Array"
   ],
@@ -37,10 +37,5 @@
     "LICENSE",
     "README.md"
   ],
-  "scripts": {
-    "build": "../../node_modules/.bin/rimraf lib/ && ../../node_modules/.bin/cross-env NODE_ENV=production ../../node_modules/.bin/rollup -c ../../rollup.config.mjs",
-    "prepublishOnly": "yarn build",
-    "test": "node --experimental-vm-modules ../../node_modules/.bin/jest --config ../../jest.config.mjs --rootDir ."
-  },
-  "gitHead": "eca17030162daa875cb8e1fd92087257932e6e41"
+  "gitHead": "9c051a66df3f4dbd8eddd709046af0a975fdc702"
 }