Refactor Node.js API to use Uint8Array for data handling (#45)

* Refactor Node.js API to use Uint8Array for data handling

- Updated method signatures in the `Keys` and `Transport` classes to replace `Buffer` with `Uint8Array`, enhancing consistency in data types across the API.
- Modified encryption and decryption methods to utilize `Uint8Array`, improving performance and compatibility with modern JavaScript practices.
- Adjusted TypeScript definitions to reflect the changes in method signatures, ensuring alignment with the updated Rust implementation.
- Enhanced overall code clarity and maintainability by streamlining data handling processes in the API.

* Refactor tests to utilize Uint8Array for data validation

- Updated comprehensive API, lifecycle, cross-platform, and basic tests to replace Buffer checks with Uint8Array validations, enhancing consistency in data type handling.
- Introduced a new utility function, `uint8ArrayEquals`, for comparing Uint8Array instances, improving code clarity and maintainability.
- Adjusted assertions across multiple test files to ensure proper validation of cryptographic keys and encrypted data, aligning with recent API changes.
- Enhanced overall test coverage and robustness by ensuring all relevant tests reflect the updated data handling practices.

Author: pentateu

runar-nodejs-api/index.d.ts

@@ -1,13 +1,13 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
 export declare class Discovery {
-  constructor(keys: Keys, optionsCbor: Buffer)
-  init(optionsCbor: Buffer): Promise<void>
+  constructor(keys: Keys, optionsCbor: Uint8Array)
+  init(optionsCbor: Uint8Array): Promise<void>
   bindEventsToTransport(transport: Transport): Promise<void>
   startAnnouncing(): Promise<void>
   stopAnnouncing(): Promise<void>
   shutdown(): Promise<void>
-  updateLocalPeerInfo(peerInfoCbor: Buffer): Promise<void>
+  updateLocalPeerInfo(peerInfoCbor: Uint8Array): Promise<void>
 }
 
 export declare class Keys {
@@ -30,65 +30,65 @@ export declare class Keys {
    * This function encrypts data for a specific network and profile public keys
    * using the mobile key manager's envelope encryption.
    */
-  mobileEncryptWithEnvelope(data: Buffer, networkPublicKey: Buffer | undefined | null, profilePublicKeys: Array<Buffer>): Buffer
+  mobileEncryptWithEnvelope(data: Uint8Array, networkPublicKey: Uint8Array | undefined | null, profilePublicKeys: Array<Uint8Array>): Uint8Array
   /**
    * Encrypt data using envelope encryption with node manager
    *
    * This function encrypts data for a specific network and profile public keys
    * using the node key manager's envelope encryption.
    */
-  nodeEncryptWithEnvelope(data: Buffer, networkPublicKey: Buffer | undefined | null, profilePublicKeys: Array<Buffer>): Buffer
+  nodeEncryptWithEnvelope(data: Uint8Array, networkPublicKey: Uint8Array | undefined | null, profilePublicKeys: Array<Uint8Array>): Uint8Array
   nodeGetNodeId(): string
-  nodeGetPublicKey(): Buffer
+  nodeGetPublicKey(): Uint8Array
   enableAutoPersist(enabled: boolean): void
   wipePersistence(): Promise<void>
   flushState(): Promise<void>
   nodeGetKeystoreState(): number
   mobileGetKeystoreState(): number
   getKeystoreCaps(): DeviceKeystoreCaps
-  encryptLocalData(data: Buffer): Buffer
-  decryptLocalData(data: Buffer): Buffer
-  mobileDecryptEnvelope(eedCbor: Buffer): Buffer
-  nodeDecryptEnvelope(eedCbor: Buffer): Buffer
-  nodeGenerateCsr(): Buffer
-  mobileProcessSetupToken(stCbor: Buffer): Buffer
-  nodeInstallCertificate(ncmCbor: Buffer): void
+  encryptLocalData(data: Uint8Array): Uint8Array
+  decryptLocalData(data: Uint8Array): Uint8Array
+  mobileDecryptEnvelope(eedCbor: Uint8Array): Uint8Array
+  nodeDecryptEnvelope(eedCbor: Uint8Array): Uint8Array
+  nodeGenerateCsr(): Uint8Array
+  mobileProcessSetupToken(stCbor: Uint8Array): Uint8Array
+  nodeInstallCertificate(ncmCbor: Uint8Array): void
   mobileGenerateNetworkDataKey(): string
-  mobileInstallNetworkPublicKey(networkPk: Buffer): void
-  nodeInstallNetworkKey(nkmCbor: Buffer): void
-  setLocalNodeInfo(nodeInfoCbor: Buffer): void
-  encryptForPublicKey(data: Buffer, recipientPk: Buffer): Buffer
-  encryptForNetwork(data: Buffer, networkId: string): Buffer
-  decryptNetworkData(eedCbor: Buffer): Buffer
-  encryptMessageForMobile(message: Buffer, mobilePk: Buffer): Buffer
-  decryptMessageFromMobile(encrypted: Buffer): Buffer
-  mobileDeriveUserProfileKey(label: string): Buffer
-  mobileGetNetworkPublicKey(networkId: string): Buffer
-  mobileCreateNetworkKeyMessage(networkId: string, nodeAgreementPk: Buffer): Buffer
-  ensureSymmetricKey(keyName: string): Buffer
+  mobileInstallNetworkPublicKey(networkPk: Uint8Array): void
+  nodeInstallNetworkKey(nkmCbor: Uint8Array): void
+  setLocalNodeInfo(nodeInfoCbor: Uint8Array): void
+  encryptForPublicKey(data: Uint8Array, recipientPk: Uint8Array): Uint8Array
+  encryptForNetwork(data: Uint8Array, networkId: string): Uint8Array
+  decryptNetworkData(eedCbor: Uint8Array): Uint8Array
+  encryptMessageForMobile(message: Uint8Array, mobilePk: Uint8Array): Uint8Array
+  decryptMessageFromMobile(encrypted: Uint8Array): Uint8Array
+  mobileDeriveUserProfileKey(label: string): Uint8Array
+  mobileGetNetworkPublicKey(networkId: string): Uint8Array
+  mobileCreateNetworkKeyMessage(networkId: string, nodeAgreementPk: Uint8Array): Uint8Array
+  ensureSymmetricKey(keyName: string): Uint8Array
   /**
    * Get the user public key after mobile initialization
    * This is essential for encrypting setup tokens to the mobile
    */
-  mobileGetUserPublicKey(): Buffer
+  mobileGetUserPublicKey(): Uint8Array
   /**
    * Get the node agreement public key
    * This is used for verifying agreement keys in CSR flow
    */
-  nodeGetAgreementPublicKey(): Buffer
+  nodeGetAgreementPublicKey(): Uint8Array
 }
 
 export declare class Transport {
-  constructor(keys: Keys, optionsCbor: Buffer)
-  completeRequest(requestId: string, responsePayload: Buffer, profilePublicKeys: Array<Buffer>): Promise<void>
+  constructor(keys: Keys, optionsCbor: Uint8Array)
+  completeRequest(requestId: string, responsePayload: Uint8Array, profilePublicKeys: Array<Uint8Array>): Promise<void>
   start(): Promise<void>
   stop(): Promise<void>
-  connectPeer(peerInfoCbor: Buffer): Promise<void>
+  connectPeer(peerInfoCbor: Uint8Array): Promise<void>
   isConnected(peerId: string): Promise<boolean>
-  isConnectedToPublicKey(peerPublicKey: Buffer): Promise<boolean>
-  request(path: string, correlationId: string, payload: Buffer, destPeerId: string, networkPublicKey?: Buffer | undefined | null, profilePublicKeys?: Array<Buffer> | undefined | null): Promise<Buffer>
-  publish(path: string, correlationId: string, payload: Buffer, destPeerId: string, networkPublicKey?: Buffer | undefined | null): Promise<void>
-  updatePeers(nodeInfoCbor: Buffer): Promise<void>
+  isConnectedToPublicKey(peerPublicKey: Uint8Array): Promise<boolean>
+  request(path: string, correlationId: string, payload: Uint8Array, destPeerId: string, networkPublicKey?: Uint8Array | undefined | null, profilePublicKeys?: Array<Uint8Array> | undefined | null): Promise<Uint8Array>
+  publish(path: string, correlationId: string, payload: Uint8Array, destPeerId: string, networkPublicKey?: Uint8Array | undefined | null): Promise<void>
+  updatePeers(nodeInfoCbor: Uint8Array): Promise<void>
 }
 
 export interface DeviceKeystoreCaps {