npm - react-native-ble-mesh - Versions diffs - 1.0.1 - Mend

react-native-ble-mesh 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (465) hide show

package/CHANGELOG.md +151 -0
package/LICENSE +21 -0
package/README.md +706 -0
package/docs/API.md +462 -0
package/docs/ARCHITECTURE.md +384 -0
package/docs/CONTRIBUTING.md +244 -0
package/docs/NODE_QUICKSTART.md +259 -0
package/docs/PROTOCOL.md +195 -0
package/docs/REACT_NATIVE.md +315 -0
package/docs/SECURITY.md +152 -0
package/docs/api/constants_audio.js.html +184 -0
package/docs/api/constants_ble.js.html +165 -0
package/docs/api/constants_crypto.js.html +107 -0
package/docs/api/constants_errors.js.html +256 -0
package/docs/api/constants_events.js.html +148 -0
package/docs/api/constants_index.js.html +76 -0
package/docs/api/constants_protocol.js.html +205 -0
package/docs/api/crypto_aead.js.html +243 -0
package/docs/api/crypto_chacha20.js.html +235 -0
package/docs/api/crypto_hkdf.js.html +241 -0
package/docs/api/crypto_hmac.js.html +197 -0
package/docs/api/crypto_index.js.html +126 -0
package/docs/api/crypto_keys_KeyManager.js.html +325 -0
package/docs/api/crypto_keys_KeyPair.js.html +270 -0
package/docs/api/crypto_keys_SecureStorage.js.html +273 -0
package/docs/api/crypto_keys_index.js.html +86 -0
package/docs/api/crypto_noise_handshake.js.html +464 -0
package/docs/api/crypto_noise_index.js.html +81 -0
package/docs/api/crypto_noise_session.js.html +307 -0
package/docs/api/crypto_noise_state.js.html +322 -0
package/docs/api/crypto_poly1305.js.html +167 -0
package/docs/api/crypto_sha256.js.html +294 -0
package/docs/api/crypto_x25519.js.html +208 -0
package/docs/api/errors_AudioError.js.html +218 -0
package/docs/api/errors_ConnectionError.js.html +163 -0
package/docs/api/errors_CryptoError.js.html +157 -0
package/docs/api/errors_HandshakeError.js.html +176 -0
package/docs/api/errors_MeshError.js.html +154 -0
package/docs/api/errors_MessageError.js.html +183 -0
package/docs/api/errors_ValidationError.js.html +204 -0
package/docs/api/errors_index.js.html +78 -0
package/docs/api/fonts/OpenSans-Bold-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Bold-webfont.svg +1830 -0
package/docs/api/fonts/OpenSans-Bold-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-BoldItalic-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-BoldItalic-webfont.svg +1830 -0
package/docs/api/fonts/OpenSans-BoldItalic-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-Italic-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Italic-webfont.svg +1830 -0
package/docs/api/fonts/OpenSans-Italic-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-Light-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Light-webfont.svg +1831 -0
package/docs/api/fonts/OpenSans-Light-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-LightItalic-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-LightItalic-webfont.svg +1835 -0
package/docs/api/fonts/OpenSans-LightItalic-webfont.woff +0 -0
package/docs/api/fonts/OpenSans-Regular-webfont.eot +0 -0
package/docs/api/fonts/OpenSans-Regular-webfont.svg +1831 -0
package/docs/api/fonts/OpenSans-Regular-webfont.woff +0 -0
package/docs/api/hooks_AppStateManager.js.html +233 -0
package/docs/api/hooks_index.js.html +87 -0
package/docs/api/hooks_useMesh.js.html +213 -0
package/docs/api/hooks_useMessages.js.html +263 -0
package/docs/api/hooks_usePeers.js.html +165 -0
package/docs/api/index.html +868 -0
package/docs/api/index.js.html +236 -0
package/docs/api/mesh_dedup_BloomFilter.js.html +261 -0
package/docs/api/mesh_dedup_DedupManager.js.html +266 -0
package/docs/api/mesh_dedup_MessageCache.js.html +273 -0
package/docs/api/mesh_dedup_index.js.html +70 -0
package/docs/api/mesh_fragment_Assembler.js.html +335 -0
package/docs/api/mesh_fragment_Fragmenter.js.html +230 -0
package/docs/api/mesh_fragment_index.js.html +75 -0
package/docs/api/mesh_index.js.html +72 -0
package/docs/api/mesh_peer_Peer.js.html +296 -0
package/docs/api/mesh_peer_PeerDiscovery.js.html +334 -0
package/docs/api/mesh_peer_PeerManager.js.html +320 -0
package/docs/api/mesh_peer_index.js.html +70 -0
package/docs/api/mesh_router_MessageRouter.js.html +411 -0
package/docs/api/mesh_router_PathFinder.js.html +386 -0
package/docs/api/mesh_router_RouteTable.js.html +346 -0
package/docs/api/mesh_router_index.js.html +70 -0
package/docs/api/module-audio_buffer.html +168 -0
package/docs/api/module-audio_buffer_FrameBuffer-FrameBuffer.html +2971 -0
package/docs/api/module-audio_buffer_FrameBuffer.html +178 -0
package/docs/api/module-audio_buffer_JitterBuffer-JitterBuffer.html +2761 -0
package/docs/api/module-audio_buffer_JitterBuffer.html +178 -0
package/docs/api/module-audio_codec.html +168 -0
package/docs/api/module-audio_codec_LC3Codec-LC3Codec.html +2876 -0
package/docs/api/module-audio_codec_LC3Codec.html +178 -0
package/docs/api/module-audio_codec_LC3Decoder-LC3Decoder.html +1788 -0
package/docs/api/module-audio_codec_LC3Decoder.html +178 -0
package/docs/api/module-audio_codec_LC3Encoder-LC3Encoder.html +1512 -0
package/docs/api/module-audio_codec_LC3Encoder.html +178 -0
package/docs/api/module-audio_session.html +168 -0
package/docs/api/module-audio_session_AudioSession-AudioSession.html +3922 -0
package/docs/api/module-audio_session_AudioSession.html +178 -0
package/docs/api/module-audio_session_VoiceMessage-VoiceMessage.html +3690 -0
package/docs/api/module-audio_session_VoiceMessage-VoiceMessageRecorder.html +1780 -0
package/docs/api/module-audio_session_VoiceMessage.html +332 -0
package/docs/api/module-audio_transport.html +168 -0
package/docs/api/module-audio_transport_AudioFragmenter-AudioAssembler.html +1545 -0
package/docs/api/module-audio_transport_AudioFragmenter-AudioFragmenter.html +658 -0
package/docs/api/module-audio_transport_AudioFragmenter.html +181 -0
package/docs/api/module-audio_transport_AudioFramer.html +1414 -0
package/docs/api/module-constants.html +168 -0
package/docs/api/module-constants_audio.html +1782 -0
package/docs/api/module-constants_ble.html +940 -0
package/docs/api/module-constants_crypto.html +823 -0
package/docs/api/module-constants_errors.html +316 -0
package/docs/api/module-constants_events.html +244 -0
package/docs/api/module-constants_protocol.html +1534 -0
package/docs/api/module-crypto.html +169 -0
package/docs/api/module-crypto_aead.html +1625 -0
package/docs/api/module-crypto_chacha20.html +1440 -0
package/docs/api/module-crypto_hkdf.html +1421 -0
package/docs/api/module-crypto_hmac.html +828 -0
package/docs/api/module-crypto_keys.html +169 -0
package/docs/api/module-crypto_keys_KeyManager-KeyManager.html +2364 -0
package/docs/api/module-crypto_keys_KeyManager.html +252 -0
package/docs/api/module-crypto_keys_KeyPair.html +245 -0
package/docs/api/module-crypto_keys_SecureStorage-MemorySecureStorage.html +923 -0
package/docs/api/module-crypto_keys_SecureStorage-SecureStorage.html +942 -0
package/docs/api/module-crypto_keys_SecureStorage.html +516 -0
package/docs/api/module-crypto_noise.html +169 -0
package/docs/api/module-crypto_noise_handshake-NoiseHandshake.html +2240 -0
package/docs/api/module-crypto_noise_handshake.html +782 -0
package/docs/api/module-crypto_noise_session-NoiseSession.html +1804 -0
package/docs/api/module-crypto_noise_session.html +325 -0
package/docs/api/module-crypto_noise_state-SymmetricState.html +1387 -0
package/docs/api/module-crypto_noise_state.html +324 -0
package/docs/api/module-crypto_poly1305.html +884 -0
package/docs/api/module-crypto_sha256-HashContext.html +447 -0
package/docs/api/module-crypto_sha256.html +942 -0
package/docs/api/module-crypto_x25519.html +1503 -0
package/docs/api/module-errors.html +168 -0
package/docs/api/module-errors_AudioError-AudioError.html +4711 -0
package/docs/api/module-errors_AudioError.html +178 -0
package/docs/api/module-errors_ConnectionError-ConnectionError.html +3649 -0
package/docs/api/module-errors_ConnectionError.html +178 -0
package/docs/api/module-errors_CryptoError-CryptoError.html +3453 -0
package/docs/api/module-errors_CryptoError.html +178 -0
package/docs/api/module-errors_HandshakeError-HandshakeError.html +4261 -0
package/docs/api/module-errors_HandshakeError.html +178 -0
package/docs/api/module-errors_MeshError-MeshError.html +2155 -0
package/docs/api/module-errors_MeshError.html +178 -0
package/docs/api/module-errors_MessageError-MessageError.html +4545 -0
package/docs/api/module-errors_MessageError.html +178 -0
package/docs/api/module-errors_ValidationError-ValidationError.html +3432 -0
package/docs/api/module-errors_ValidationError.html +178 -0
package/docs/api/module-hooks.html +182 -0
package/docs/api/module-hooks_AppStateManager-AppStateManager.html +1620 -0
package/docs/api/module-hooks_AppStateManager.html +178 -0
package/docs/api/module-hooks_useMesh.html +457 -0
package/docs/api/module-hooks_useMessages.html +466 -0
package/docs/api/module-hooks_usePeers.html +348 -0
package/docs/api/module-mesh.html +168 -0
package/docs/api/module-mesh_dedup.html +168 -0
package/docs/api/module-mesh_dedup_BloomFilter-BloomFilter.html +2158 -0
package/docs/api/module-mesh_dedup_BloomFilter.html +178 -0
package/docs/api/module-mesh_dedup_DedupManager-DedupManager.html +2880 -0
package/docs/api/module-mesh_dedup_DedupManager.html +178 -0
package/docs/api/module-mesh_dedup_MessageCache-CacheNode.html +246 -0
package/docs/api/module-mesh_dedup_MessageCache-MessageCache.html +2314 -0
package/docs/api/module-mesh_dedup_MessageCache.html +181 -0
package/docs/api/module-mesh_fragment.html +168 -0
package/docs/api/module-mesh_fragment_Assembler-Assembler.html +2869 -0
package/docs/api/module-mesh_fragment_Assembler-PendingFragmentSet.html +895 -0
package/docs/api/module-mesh_fragment_Assembler.html +181 -0
package/docs/api/module-mesh_fragment_Fragmenter.html +1084 -0
package/docs/api/module-mesh_peer.html +168 -0
package/docs/api/module-mesh_peer_Peer-Peer.html +4986 -0
package/docs/api/module-mesh_peer_Peer.html +178 -0
package/docs/api/module-mesh_peer_PeerDiscovery-PeerDiscovery.html +3423 -0
package/docs/api/module-mesh_peer_PeerDiscovery.html +438 -0
package/docs/api/module-mesh_peer_PeerManager-PeerManager.html +5258 -0
package/docs/api/module-mesh_peer_PeerManager.html +178 -0
package/docs/api/module-mesh_router.html +168 -0
package/docs/api/module-mesh_router_MessageRouter-MessageRouter.html +3285 -0
package/docs/api/module-mesh_router_MessageRouter.html +178 -0
package/docs/api/module-mesh_router_PathFinder-PathFinder.html +3323 -0
package/docs/api/module-mesh_router_PathFinder.html +421 -0
package/docs/api/module-mesh_router_RouteTable-RouteTable.html +4115 -0
package/docs/api/module-mesh_router_RouteTable.html +421 -0
package/docs/api/module-protocol.html +169 -0
package/docs/api/module-protocol_crc32.html +815 -0
package/docs/api/module-protocol_deserializer.html +1393 -0
package/docs/api/module-protocol_header-MessageHeader.html +2879 -0
package/docs/api/module-protocol_header.html +892 -0
package/docs/api/module-protocol_message-Message.html +4682 -0
package/docs/api/module-protocol_message.html +178 -0
package/docs/api/module-protocol_serializer.html +911 -0
package/docs/api/module-protocol_validator.html +1396 -0
package/docs/api/module-rn-ble-mesh.html +866 -0
package/docs/api/module-service.html +168 -0
package/docs/api/module-service_HandshakeManager-HandshakeManager.html +185 -0
package/docs/api/module-service_HandshakeManager.html +175 -0
package/docs/api/module-service_MeshService-MeshService.html +185 -0
package/docs/api/module-service_MeshService.html +175 -0
package/docs/api/module-service_SessionManager-SessionManager.html +174 -0
package/docs/api/module-service_SessionManager.html +175 -0
package/docs/api/module-service_audio.html +168 -0
package/docs/api/module-service_audio_AudioManager-AudioManager.html +4653 -0
package/docs/api/module-service_audio_AudioManager.html +254 -0
package/docs/api/module-service_text.html +168 -0
package/docs/api/module-service_text_TextManager-TextManager.html +6104 -0
package/docs/api/module-service_text_TextManager.html +254 -0
package/docs/api/module-service_text_broadcast.html +168 -0
package/docs/api/module-service_text_broadcast_BroadcastManager-BroadcastManager.html +2434 -0
package/docs/api/module-service_text_broadcast_BroadcastManager.html +254 -0
package/docs/api/module-service_text_channel.html +168 -0
package/docs/api/module-service_text_channel_Channel-Channel.html +4337 -0
package/docs/api/module-service_text_channel_Channel.html +178 -0
package/docs/api/module-service_text_channel_ChannelManager-ChannelManager.html +1927 -0
package/docs/api/module-service_text_channel_ChannelManager.html +175 -0
package/docs/api/module-service_text_message.html +168 -0
package/docs/api/module-service_text_message_TextMessage-TextMessage.html +4162 -0
package/docs/api/module-service_text_message_TextMessage.html +178 -0
package/docs/api/module-service_text_message_TextSerializer.html +1725 -0
package/docs/api/module-storage.html +168 -0
package/docs/api/module-storage_AsyncStorageAdapter-AsyncStorageAdapter.html +4159 -0
package/docs/api/module-storage_AsyncStorageAdapter.html +178 -0
package/docs/api/module-storage_MemoryStorage-MemoryStorage.html +3154 -0
package/docs/api/module-storage_MemoryStorage.html +178 -0
package/docs/api/module-storage_MessageStore-MessageStore.html +5299 -0
package/docs/api/module-storage_MessageStore.html +178 -0
package/docs/api/module-storage_Storage-Storage.html +4169 -0
package/docs/api/module-storage_Storage.html +178 -0
package/docs/api/module-transport.html +168 -0
package/docs/api/module-transport_BLEAdapter-BLEAdapter.html +4724 -0
package/docs/api/module-transport_BLEAdapter.html +178 -0
package/docs/api/module-transport_BLETransport-BLETransport.html +3263 -0
package/docs/api/module-transport_BLETransport.html +178 -0
package/docs/api/module-transport_MockTransport-MockTransport.html +3947 -0
package/docs/api/module-transport_MockTransport.html +178 -0
package/docs/api/module-transport_NodeBLEAdapter-NodeBLEAdapter.html +3216 -0
package/docs/api/module-transport_NodeBLEAdapter.html +178 -0
package/docs/api/module-transport_RNBLEAdapter-RNBLEAdapter.html +3216 -0
package/docs/api/module-transport_RNBLEAdapter.html +178 -0
package/docs/api/module-transport_Transport-Transport.html +4071 -0
package/docs/api/module-transport_Transport.html +254 -0
package/docs/api/module-transport_adapters.html +168 -0
package/docs/api/module-transport_adapters_BLEAdapter-BLEAdapter.html +4724 -0
package/docs/api/module-transport_adapters_BLEAdapter.html +178 -0
package/docs/api/module-transport_adapters_NodeBLEAdapter-NodeBLEAdapter.html +3216 -0
package/docs/api/module-transport_adapters_NodeBLEAdapter.html +178 -0
package/docs/api/module-transport_adapters_RNBLEAdapter-RNBLEAdapter.html +3216 -0
package/docs/api/module-transport_adapters_RNBLEAdapter.html +178 -0
package/docs/api/module-utils.html +168 -0
package/docs/api/module-utils_BoundedMap-BoundedMap.html +3301 -0
package/docs/api/module-utils_BoundedMap.html +178 -0
package/docs/api/module-utils_EventEmitter-EventEmitter.html +3358 -0
package/docs/api/module-utils_EventEmitter.html +178 -0
package/docs/api/module-utils_LRUCache-LRUCache.html +4134 -0
package/docs/api/module-utils_LRUCache.html +178 -0
package/docs/api/module-utils_RateLimiter-RateLimiter.html +2176 -0
package/docs/api/module-utils_RateLimiter.html +500 -0
package/docs/api/module-utils_TimeoutManager-TimeoutManager.html +1781 -0
package/docs/api/module-utils_TimeoutManager.html +175 -0
package/docs/api/module-utils_bytes.html +1789 -0
package/docs/api/module-utils_debug.html +837 -0
package/docs/api/module-utils_encoding.html +1184 -0
package/docs/api/module-utils_retry.html +1457 -0
package/docs/api/module-utils_time.html +1665 -0
package/docs/api/module-utils_uuid.html +1269 -0
package/docs/api/module-utils_validation.html +2176 -0
package/docs/api/protocol_crc32.js.html +147 -0
package/docs/api/protocol_deserializer.js.html +295 -0
package/docs/api/protocol_header.js.html +276 -0
package/docs/api/protocol_index.js.html +120 -0
package/docs/api/protocol_message.js.html +287 -0
package/docs/api/protocol_serializer.js.html +240 -0
package/docs/api/protocol_validator.js.html +330 -0
package/docs/api/scripts/linenumber.js +25 -0
package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -0
package/docs/api/scripts/prettify/lang-css.js +2 -0
package/docs/api/scripts/prettify/prettify.js +28 -0
package/docs/api/service_HandshakeManager.js.html +232 -0
package/docs/api/service_MeshService.js.html +371 -0
package/docs/api/service_SessionManager.js.html +153 -0
package/docs/api/service_audio_AudioManager.js.html +541 -0
package/docs/api/service_audio_buffer_FrameBuffer.js.html +223 -0
package/docs/api/service_audio_buffer_JitterBuffer.js.html +244 -0
package/docs/api/service_audio_buffer_index.js.html +68 -0
package/docs/api/service_audio_codec_LC3Codec.js.html +345 -0
package/docs/api/service_audio_codec_LC3Decoder.js.html +185 -0
package/docs/api/service_audio_codec_LC3Encoder.js.html +194 -0
package/docs/api/service_audio_codec_index.js.html +70 -0
package/docs/api/service_audio_index.js.html +96 -0
package/docs/api/service_audio_session_AudioSession.js.html +348 -0
package/docs/api/service_audio_session_VoiceMessage.js.html +432 -0
package/docs/api/service_audio_session_index.js.html +70 -0
package/docs/api/service_audio_transport_AudioFragmenter.js.html +314 -0
package/docs/api/service_audio_transport_AudioFramer.js.html +236 -0
package/docs/api/service_audio_transport_index.js.html +69 -0
package/docs/api/service_index.js.html +93 -0
package/docs/api/service_text_TextManager.js.html +578 -0
package/docs/api/service_text_broadcast_BroadcastManager.js.html +276 -0
package/docs/api/service_text_broadcast_index.js.html +66 -0
package/docs/api/service_text_channel_Channel.js.html +280 -0
package/docs/api/service_text_channel_ChannelManager.js.html +225 -0
package/docs/api/service_text_channel_index.js.html +68 -0
package/docs/api/service_text_index.js.html +85 -0
package/docs/api/service_text_message_TextMessage.js.html +350 -0
package/docs/api/service_text_message_TextSerializer.js.html +218 -0
package/docs/api/service_text_message_index.js.html +68 -0
package/docs/api/storage_AsyncStorageAdapter.js.html +357 -0
package/docs/api/storage_MemoryStorage.js.html +279 -0
package/docs/api/storage_MessageStore.js.html +369 -0
package/docs/api/storage_Storage.js.html +214 -0
package/docs/api/storage_index.js.html +72 -0
package/docs/api/styles/jsdoc-default.css +358 -0
package/docs/api/styles/prettify-jsdoc.css +111 -0
package/docs/api/styles/prettify-tomorrow.css +132 -0
package/docs/api/transport_BLEAdapter.js.html +231 -0
package/docs/api/transport_BLETransport.js.html +411 -0
package/docs/api/transport_MockTransport.js.html +339 -0
package/docs/api/transport_NodeBLEAdapter.js.html +479 -0
package/docs/api/transport_RNBLEAdapter.js.html +382 -0
package/docs/api/transport_Transport.js.html +242 -0
package/docs/api/transport_adapters_BLEAdapter.js.html +231 -0
package/docs/api/transport_adapters_NodeBLEAdapter.js.html +479 -0
package/docs/api/transport_adapters_RNBLEAdapter.js.html +382 -0
package/docs/api/transport_adapters_index.js.html +70 -0
package/docs/api/transport_index.js.html +87 -0
package/docs/api/utils_BoundedMap.js.html +205 -0
package/docs/api/utils_EventEmitter.js.html +259 -0
package/docs/api/utils_LRUCache.js.html +256 -0
package/docs/api/utils_RateLimiter.js.html +256 -0
package/docs/api/utils_TimeoutManager.js.html +218 -0
package/docs/api/utils_base64%0A%0AThis%20implementation%20avoids%20string%20concatenation%20in%20loops%20which%20is%20O(n%C2%B2).%0AUses%20array%20building%20which%20is%20O(n)%20-%20critical%20for%20React%20Native%20performance.module_.html +717 -0
package/docs/api/utils_base64.js.html +205 -0
package/docs/api/utils_bytes.js.html +241 -0
package/docs/api/utils_debug.js.html +205 -0
package/docs/api/utils_encoding.js.html +302 -0
package/docs/api/utils_index.js.html +160 -0
package/docs/api/utils_retry.js.html +200 -0
package/docs/api/utils_time.js.html +220 -0
package/docs/api/utils_uuid.js.html +199 -0
package/docs/api/utils_validation.js.html +259 -0
package/examples/node-chat/chat.js +220 -0
package/examples/node-quickstart/index.js +94 -0
package/examples/testing/test-helper.js +182 -0
package/package.json +111 -0
package/src/constants/audio.js +130 -0
package/src/constants/ble.js +111 -0
package/src/constants/crypto.js +53 -0
package/src/constants/errors.js +202 -0
package/src/constants/events.js +94 -0
package/src/constants/index.js +22 -0
package/src/constants/protocol.js +151 -0
package/src/crypto/aead.js +189 -0
package/src/crypto/chacha20.js +181 -0
package/src/crypto/hkdf.js +187 -0
package/src/crypto/hmac.js +143 -0
package/src/crypto/index.js +72 -0
package/src/crypto/keys/KeyManager.js +271 -0
package/src/crypto/keys/KeyPair.js +216 -0
package/src/crypto/keys/SecureStorage.js +219 -0
package/src/crypto/keys/index.js +32 -0
package/src/crypto/noise/handshake.js +410 -0
package/src/crypto/noise/index.js +27 -0
package/src/crypto/noise/session.js +253 -0
package/src/crypto/noise/state.js +268 -0
package/src/crypto/poly1305.js +113 -0
package/src/crypto/sha256.js +240 -0
package/src/crypto/x25519.js +154 -0
package/src/errors/AudioError.js +164 -0
package/src/errors/ConnectionError.js +109 -0
package/src/errors/CryptoError.js +103 -0
package/src/errors/HandshakeError.js +122 -0
package/src/errors/MeshError.js +100 -0
package/src/errors/MessageError.js +129 -0
package/src/errors/ValidationError.js +150 -0
package/src/errors/index.js +24 -0
package/src/hooks/AppStateManager.js +179 -0
package/src/hooks/index.js +33 -0
package/src/hooks/useMesh.js +159 -0
package/src/hooks/useMessages.js +209 -0
package/src/hooks/usePeers.js +111 -0
package/src/index.d.ts +494 -0
package/src/index.js +182 -0
package/src/index.mjs +62 -0
package/src/mesh/dedup/BloomFilter.js +207 -0
package/src/mesh/dedup/DedupManager.js +212 -0
package/src/mesh/dedup/MessageCache.js +219 -0
package/src/mesh/dedup/index.js +16 -0
package/src/mesh/fragment/Assembler.js +281 -0
package/src/mesh/fragment/Fragmenter.js +176 -0
package/src/mesh/fragment/index.js +21 -0
package/src/mesh/index.js +18 -0
package/src/mesh/peer/Peer.js +242 -0
package/src/mesh/peer/PeerDiscovery.js +280 -0
package/src/mesh/peer/PeerManager.js +266 -0
package/src/mesh/peer/index.js +16 -0
package/src/mesh/router/MessageRouter.js +357 -0
package/src/mesh/router/PathFinder.js +332 -0
package/src/mesh/router/RouteTable.js +292 -0
package/src/mesh/router/index.js +16 -0
package/src/protocol/crc32.js +93 -0
package/src/protocol/deserializer.js +241 -0
package/src/protocol/header.js +222 -0
package/src/protocol/index.js +66 -0
package/src/protocol/message.js +233 -0
package/src/protocol/serializer.js +186 -0
package/src/protocol/validator.js +276 -0
package/src/service/HandshakeManager.js +178 -0
package/src/service/MeshService.js +317 -0
package/src/service/SessionManager.js +99 -0
package/src/service/audio/AudioManager.js +487 -0
package/src/service/audio/buffer/FrameBuffer.js +169 -0
package/src/service/audio/buffer/JitterBuffer.js +190 -0
package/src/service/audio/buffer/index.js +14 -0
package/src/service/audio/codec/LC3Codec.js +291 -0
package/src/service/audio/codec/LC3Decoder.js +131 -0
package/src/service/audio/codec/LC3Encoder.js +140 -0
package/src/service/audio/codec/index.js +16 -0
package/src/service/audio/index.js +42 -0
package/src/service/audio/session/AudioSession.js +294 -0
package/src/service/audio/session/VoiceMessage.js +378 -0
package/src/service/audio/session/index.js +16 -0
package/src/service/audio/transport/AudioFragmenter.js +260 -0
package/src/service/audio/transport/AudioFramer.js +182 -0
package/src/service/audio/transport/index.js +15 -0
package/src/service/index.js +39 -0
package/src/service/text/TextManager.js +524 -0
package/src/service/text/broadcast/BroadcastManager.js +222 -0
package/src/service/text/broadcast/index.js +12 -0
package/src/service/text/channel/Channel.js +226 -0
package/src/service/text/channel/ChannelManager.js +171 -0
package/src/service/text/channel/index.js +14 -0
package/src/service/text/index.js +31 -0
package/src/service/text/message/TextMessage.js +296 -0
package/src/service/text/message/TextSerializer.js +164 -0
package/src/service/text/message/index.js +14 -0
package/src/storage/AsyncStorageAdapter.js +303 -0
package/src/storage/MemoryStorage.js +225 -0
package/src/storage/MessageStore.js +315 -0
package/src/storage/Storage.js +160 -0
package/src/storage/index.js +18 -0
package/src/transport/BLEAdapter.js +177 -0
package/src/transport/BLETransport.js +357 -0
package/src/transport/MockTransport.js +285 -0
package/src/transport/NodeBLEAdapter.js +425 -0
package/src/transport/RNBLEAdapter.js +328 -0
package/src/transport/Transport.js +188 -0
package/src/transport/adapters/BLEAdapter.js +177 -0
package/src/transport/adapters/NodeBLEAdapter.js +425 -0
package/src/transport/adapters/RNBLEAdapter.js +328 -0
package/src/transport/adapters/index.js +16 -0
package/src/transport/index.js +33 -0
package/src/utils/BoundedMap.js +151 -0
package/src/utils/EventEmitter.js +205 -0
package/src/utils/LRUCache.js +202 -0
package/src/utils/RateLimiter.js +202 -0
package/src/utils/TimeoutManager.js +164 -0
package/src/utils/base64.js +151 -0
package/src/utils/bytes.js +187 -0
package/src/utils/debug.js +151 -0
package/src/utils/encoding.js +248 -0
package/src/utils/index.js +106 -0
package/src/utils/retry.js +146 -0
package/src/utils/time.js +166 -0
package/src/utils/uuid.js +145 -0
package/src/utils/validation.js +205 -0

package/docs/api/service_audio_buffer_FrameBuffer.js.html ADDED Viewed

@@ -0,0 +1,223 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>JSDoc: Source: service/audio/buffer/FrameBuffer.js</title>
+    <script src="scripts/prettify/prettify.js"> </script>
+    <script src="scripts/prettify/lang-css.js"> </script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+<body>
+<div id="main">
+    <h1 class="page-title">Source: service/audio/buffer/FrameBuffer.js</h1>
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>'use strict';
+/**
+ * @fileoverview LC3 frame buffer for voice message storage
+ * @module audio/buffer/FrameBuffer
+ */
+const { VOICE_MESSAGE_CONFIG } = require('../../../constants/audio');
+/**
+ * Buffer for storing LC3 encoded frames
+ * @class FrameBuffer
+ */
+class FrameBuffer {
+  /**
+   * Creates a new FrameBuffer
+   * @param {Object} [options] - Buffer options
+   * @param {number} [options.maxFrames=30000] - Maximum frames to store
+   * @param {number} [options.maxBytes] - Maximum bytes to store
+   */
+  constructor(options = {}) {
+    /** @private */
+    this._maxFrames = options.maxFrames || 30000;
+    /** @private */
+    this._maxBytes = options.maxBytes || VOICE_MESSAGE_CONFIG.MAX_SIZE_BYTES;
+    /** @private */
+    this._frames = [];
+    /** @private */
+    this._totalBytes = 0;
+  }
+  /**
+   * Adds a frame to the buffer
+   * @param {Uint8Array} frame - LC3 encoded frame
+   * @returns {boolean} True if frame was added
+   */
+  push(frame) {
+    if (this._frames.length >= this._maxFrames) {
+      return false;
+    }
+    if (this._totalBytes + frame.length > this._maxBytes) {
+      return false;
+    }
+    this._frames.push(new Uint8Array(frame));
+    this._totalBytes += frame.length;
+    return true;
+  }
+  /**
+   * Gets a frame by index
+   * @param {number} index - Frame index
+   * @returns {Uint8Array|null}
+   */
+  getFrame(index) {
+    if (index &lt; 0 || index >= this._frames.length) {
+      return null;
+    }
+    return this._frames[index];
+  }
+  /**
+   * Returns the number of frames
+   * @returns {number}
+   */
+  getFrameCount() {
+    return this._frames.length;
+  }
+  /**
+   * Returns total bytes stored
+   * @returns {number}
+   */
+  getTotalBytes() {
+    return this._totalBytes;
+  }
+  /**
+   * Returns duration in milliseconds
+   * @param {number} frameMs - Frame duration in ms
+   * @returns {number}
+   */
+  getDurationMs(frameMs) {
+    return this._frames.length * frameMs;
+  }
+  /**
+   * Returns all frames as array
+   * @returns {Uint8Array[]}
+   */
+  toArray() {
+    return this._frames.slice();
+  }
+  /**
+   * Serializes buffer to single Uint8Array
+   * @returns {Uint8Array}
+   */
+  serialize() {
+    // Format: [frameCount(4)] + [frameLen(2) + frameData]...
+    const parts = [];
+    const countBytes = new Uint8Array(4);
+    new DataView(countBytes.buffer).setUint32(0, this._frames.length, false);
+    parts.push(countBytes);
+    for (const frame of this._frames) {
+      const lenBytes = new Uint8Array(2);
+      new DataView(lenBytes.buffer).setUint16(0, frame.length, false);
+      parts.push(lenBytes);
+      parts.push(frame);
+    }
+    const totalLen = parts.reduce((sum, p) => sum + p.length, 0);
+    const result = new Uint8Array(totalLen);
+    let offset = 0;
+    for (const part of parts) {
+      result.set(part, offset);
+      offset += part.length;
+    }
+    return result;
+  }
+  /**
+   * Deserializes buffer from Uint8Array
+   * @param {Uint8Array} data - Serialized data
+   * @returns {FrameBuffer}
+   */
+  static deserialize(data) {
+    const buffer = new FrameBuffer();
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const frameCount = view.getUint32(0, false);
+    let offset = 4;
+    for (let i = 0; i &lt; frameCount &amp;&amp; offset &lt; data.length; i++) {
+      const frameLen = view.getUint16(offset, false);
+      offset += 2;
+      if (offset + frameLen &lt;= data.length) {
+        const frame = data.slice(offset, offset + frameLen);
+        buffer.push(frame);
+        offset += frameLen;
+      }
+    }
+    return buffer;
+  }
+  /**
+   * Creates an iterator for frames
+   * @returns {Iterator&lt;Uint8Array>}
+   */
+  [Symbol.iterator]() {
+    return this._frames[Symbol.iterator]();
+  }
+  /**
+   * Clears the buffer
+   */
+  clear() {
+    this._frames = [];
+    this._totalBytes = 0;
+  }
+}
+module.exports = FrameBuffer;
+</code></pre>
+        </article>
+    </section>
+</div>
+<nav>
+    <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-audio_buffer.html">audio/buffer</a></li><li><a href="module-audio_buffer_FrameBuffer.html">audio/buffer/FrameBuffer</a></li><li><a href="module-audio_buffer_JitterBuffer.html">audio/buffer/JitterBuffer</a></li><li><a href="module-audio_codec.html">audio/codec</a></li><li><a href="module-audio_codec_LC3Codec.html">audio/codec/LC3Codec</a></li><li><a href="module-audio_codec_LC3Decoder.html">audio/codec/LC3Decoder</a></li><li><a href="module-audio_codec_LC3Encoder.html">audio/codec/LC3Encoder</a></li><li><a href="module-audio_session.html">audio/session</a></li><li><a href="module-audio_session_AudioSession.html">audio/session/AudioSession</a></li><li><a href="module-audio_session_VoiceMessage.html">audio/session/VoiceMessage</a></li><li><a href="module-audio_transport.html">audio/transport</a></li><li><a href="module-audio_transport_AudioFragmenter.html">audio/transport/AudioFragmenter</a></li><li><a href="module-audio_transport_AudioFramer.html">audio/transport/AudioFramer</a></li><li><a href="module-constants.html">constants</a></li><li><a href="module-constants_audio.html">constants/audio</a></li><li><a href="module-constants_ble.html">constants/ble</a></li><li><a href="module-constants_crypto.html">constants/crypto</a></li><li><a href="module-constants_errors.html">constants/errors</a></li><li><a href="module-constants_events.html">constants/events</a></li><li><a href="module-constants_protocol.html">constants/protocol</a></li><li><a href="module-crypto.html">crypto</a></li><li><a href="module-crypto_aead.html">crypto/aead</a></li><li><a href="module-crypto_chacha20.html">crypto/chacha20</a></li><li><a href="module-crypto_hkdf.html">crypto/hkdf</a></li><li><a href="module-crypto_hmac.html">crypto/hmac</a></li><li><a href="module-crypto_keys.html">crypto/keys</a></li><li><a href="module-crypto_keys_KeyManager.html">crypto/keys/KeyManager</a></li><li><a href="module-crypto_keys_KeyPair.html">crypto/keys/KeyPair</a></li><li><a href="module-crypto_keys_SecureStorage.html">crypto/keys/SecureStorage</a></li><li><a href="module-crypto_noise.html">crypto/noise</a></li><li><a href="module-crypto_noise_handshake.html">crypto/noise/handshake</a></li><li><a href="module-crypto_noise_session.html">crypto/noise/session</a></li><li><a href="module-crypto_noise_state.html">crypto/noise/state</a></li><li><a href="module-crypto_poly1305.html">crypto/poly1305</a></li><li><a href="module-crypto_sha256.html">crypto/sha256</a></li><li><a href="module-crypto_x25519.html">crypto/x25519</a></li><li><a href="module-errors.html">errors</a></li><li><a href="module-errors_AudioError.html">errors/AudioError</a></li><li><a href="module-errors_ConnectionError.html">errors/ConnectionError</a></li><li><a href="module-errors_CryptoError.html">errors/CryptoError</a></li><li><a href="module-errors_HandshakeError.html">errors/HandshakeError</a></li><li><a href="module-errors_MeshError.html">errors/MeshError</a></li><li><a href="module-errors_MessageError.html">errors/MessageError</a></li><li><a href="module-errors_ValidationError.html">errors/ValidationError</a></li><li><a href="module-hooks.html">hooks</a></li><li><a href="module-hooks_AppStateManager.html">hooks/AppStateManager</a></li><li><a href="module-hooks_useMesh.html">hooks/useMesh</a></li><li><a href="module-hooks_useMessages.html">hooks/useMessages</a></li><li><a href="module-hooks_usePeers.html">hooks/usePeers</a></li><li><a href="module-mesh.html">mesh</a></li><li><a href="module-mesh_dedup.html">mesh/dedup</a></li><li><a href="module-mesh_dedup_BloomFilter.html">mesh/dedup/BloomFilter</a></li><li><a href="module-mesh_dedup_DedupManager.html">mesh/dedup/DedupManager</a></li><li><a href="module-mesh_dedup_MessageCache.html">mesh/dedup/MessageCache</a></li><li><a href="module-mesh_fragment.html">mesh/fragment</a></li><li><a href="module-mesh_fragment_Assembler.html">mesh/fragment/Assembler</a></li><li><a href="module-mesh_fragment_Fragmenter.html">mesh/fragment/Fragmenter</a></li><li><a href="module-mesh_peer.html">mesh/peer</a></li><li><a href="module-mesh_peer_Peer.html">mesh/peer/Peer</a></li><li><a href="module-mesh_peer_PeerDiscovery.html">mesh/peer/PeerDiscovery</a></li><li><a href="module-mesh_peer_PeerManager.html">mesh/peer/PeerManager</a></li><li><a href="module-mesh_router.html">mesh/router</a></li><li><a href="module-mesh_router_MessageRouter.html">mesh/router/MessageRouter</a></li><li><a href="module-mesh_router_PathFinder.html">mesh/router/PathFinder</a></li><li><a href="module-mesh_router_RouteTable.html">mesh/router/RouteTable</a></li><li><a href="module-protocol.html">protocol</a></li><li><a href="module-protocol_crc32.html">protocol/crc32</a></li><li><a href="module-protocol_deserializer.html">protocol/deserializer</a></li><li><a href="module-protocol_header.html">protocol/header</a></li><li><a href="module-protocol_message.html">protocol/message</a></li><li><a href="module-protocol_serializer.html">protocol/serializer</a></li><li><a href="module-protocol_validator.html">protocol/validator</a></li><li><a href="module-rn-ble-mesh.html">rn-ble-mesh</a></li><li><a href="module-service.html">service</a></li><li><a href="module-service_HandshakeManager.html">service/HandshakeManager</a></li><li><a href="module-service_MeshService.html">service/MeshService</a></li><li><a href="module-service_SessionManager.html">service/SessionManager</a></li><li><a href="module-service_audio.html">service/audio</a></li><li><a href="module-service_audio_AudioManager.html">service/audio/AudioManager</a></li><li><a href="module-service_text.html">service/text</a></li><li><a href="module-service_text_TextManager.html">service/text/TextManager</a></li><li><a href="module-service_text_broadcast.html">service/text/broadcast</a></li><li><a href="module-service_text_broadcast_BroadcastManager.html">service/text/broadcast/BroadcastManager</a></li><li><a href="module-service_text_channel.html">service/text/channel</a></li><li><a href="module-service_text_channel_Channel.html">service/text/channel/Channel</a></li><li><a href="module-service_text_channel_ChannelManager.html">service/text/channel/ChannelManager</a></li><li><a href="module-service_text_message.html">service/text/message</a></li><li><a href="module-service_text_message_TextMessage.html">service/text/message/TextMessage</a></li><li><a href="module-service_text_message_TextSerializer.html">service/text/message/TextSerializer</a></li><li><a href="module-storage.html">storage</a></li><li><a href="module-storage_AsyncStorageAdapter.html">storage/AsyncStorageAdapter</a></li><li><a href="module-storage_MemoryStorage.html">storage/MemoryStorage</a></li><li><a href="module-storage_MessageStore.html">storage/MessageStore</a></li><li><a href="module-storage_Storage.html">storage/Storage</a></li><li><a href="module-transport.html">transport</a></li><li><a href="module-transport_BLEAdapter.html">transport/BLEAdapter</a></li><li><a href="module-transport_BLETransport.html">transport/BLETransport</a></li><li><a href="module-transport_MockTransport.html">transport/MockTransport</a></li><li><a href="module-transport_NodeBLEAdapter.html">transport/NodeBLEAdapter</a></li><li><a href="module-transport_RNBLEAdapter.html">transport/RNBLEAdapter</a></li><li><a href="module-transport_Transport.html">transport/Transport</a></li><li><a href="module-transport_adapters.html">transport/adapters</a></li><li><a href="module-transport_adapters_BLEAdapter.html">transport/adapters/BLEAdapter</a></li><li><a href="module-transport_adapters_NodeBLEAdapter.html">transport/adapters/NodeBLEAdapter</a></li><li><a href="module-transport_adapters_RNBLEAdapter.html">transport/adapters/RNBLEAdapter</a></li><li><a href="module-utils.html">utils</a></li><li><a href="module-utils_BoundedMap.html">utils/BoundedMap</a></li><li><a href="module-utils_EventEmitter.html">utils/EventEmitter</a></li><li><a href="module-utils_LRUCache.html">utils/LRUCache</a></li><li><a href="module-utils_RateLimiter.html">utils/RateLimiter</a></li><li><a href="module-utils_TimeoutManager.html">utils/TimeoutManager</a></li><li><a href="module-utils_bytes.html">utils/bytes</a></li><li><a href="module-utils_debug.html">utils/debug</a></li><li><a href="module-utils_encoding.html">utils/encoding</a></li><li><a href="module-utils_retry.html">utils/retry</a></li><li><a href="module-utils_time.html">utils/time</a></li><li><a href="module-utils_uuid.html">utils/uuid</a></li><li><a href="module-utils_validation.html">utils/validation</a></li><li><a href="utils_base64%250A%250AThis%2520implementation%2520avoids%2520string%2520concatenation%2520in%2520loops%2520which%2520is%2520O(n%25C2%25B2).%250AUses%2520array%2520building%2520which%2520is%2520O(n)%2520-%2520critical%2520for%2520React%2520Native%2520performance.module_.html">utils/base64
+This implementation avoids string concatenation in loops which is O(n²).
+Uses array building which is O(n) - critical for React Native performance.</a></li></ul><h3>Classes</h3><ul><li><a href="module-audio_buffer_FrameBuffer-FrameBuffer.html">FrameBuffer</a></li><li><a href="module-audio_buffer_JitterBuffer-JitterBuffer.html">JitterBuffer</a></li><li><a href="module-audio_codec_LC3Codec-LC3Codec.html">LC3Codec</a></li><li><a href="module-audio_codec_LC3Decoder-LC3Decoder.html">LC3Decoder</a></li><li><a href="module-audio_codec_LC3Encoder-LC3Encoder.html">LC3Encoder</a></li><li><a href="module-audio_session_AudioSession-AudioSession.html">AudioSession</a></li><li><a href="module-audio_session_VoiceMessage-VoiceMessage.html">VoiceMessage</a></li><li><a href="module-audio_session_VoiceMessage-VoiceMessageRecorder.html">VoiceMessageRecorder</a></li><li><a href="module-audio_transport_AudioFragmenter-AudioAssembler.html">AudioAssembler</a></li><li><a href="module-audio_transport_AudioFragmenter-AudioFragmenter.html">AudioFragmenter</a></li><li><a href="module-crypto_keys_KeyManager-KeyManager.html">KeyManager</a></li><li><a href="module-crypto_keys_SecureStorage-MemorySecureStorage.html">MemorySecureStorage</a></li><li><a href="module-crypto_keys_SecureStorage-SecureStorage.html">SecureStorage</a></li><li><a href="module-crypto_noise_handshake-NoiseHandshake.html">NoiseHandshake</a></li><li><a href="module-crypto_noise_session-NoiseSession.html">NoiseSession</a></li><li><a href="module-crypto_noise_state-SymmetricState.html">SymmetricState</a></li><li><a href="module-crypto_sha256-HashContext.html">HashContext</a></li><li><a href="module-errors_AudioError-AudioError.html">AudioError</a></li><li><a href="module-errors_ConnectionError-ConnectionError.html">ConnectionError</a></li><li><a href="module-errors_CryptoError-CryptoError.html">CryptoError</a></li><li><a href="module-errors_HandshakeError-HandshakeError.html">HandshakeError</a></li><li><a href="module-errors_MeshError-MeshError.html">MeshError</a></li><li><a href="module-errors_MessageError-MessageError.html">MessageError</a></li><li><a href="module-errors_ValidationError-ValidationError.html">ValidationError</a></li><li><a href="module-hooks_AppStateManager-AppStateManager.html">AppStateManager</a></li><li><a href="module-mesh_dedup_BloomFilter-BloomFilter.html">BloomFilter</a></li><li><a href="module-mesh_dedup_DedupManager-DedupManager.html">DedupManager</a></li><li><a href="module-mesh_dedup_MessageCache-CacheNode.html">CacheNode</a></li><li><a href="module-mesh_dedup_MessageCache-MessageCache.html">MessageCache</a></li><li><a href="module-mesh_fragment_Assembler-Assembler.html">Assembler</a></li><li><a href="module-mesh_fragment_Assembler-PendingFragmentSet.html">PendingFragmentSet</a></li><li><a href="module-mesh_peer_PeerDiscovery-PeerDiscovery.html">PeerDiscovery</a></li><li><a href="module-mesh_peer_PeerManager-PeerManager.html">PeerManager</a></li><li><a href="module-mesh_peer_Peer-Peer.html">Peer</a></li><li><a href="module-mesh_router_MessageRouter-MessageRouter.html">MessageRouter</a></li><li><a href="module-mesh_router_PathFinder-PathFinder.html">PathFinder</a></li><li><a href="module-mesh_router_RouteTable-RouteTable.html">RouteTable</a></li><li><a href="module-protocol_header-MessageHeader.html">MessageHeader</a></li><li><a href="module-protocol_message-Message.html">Message</a></li><li><a href="module-service_HandshakeManager-HandshakeManager.html">HandshakeManager</a></li><li><a href="module-service_MeshService-MeshService.html">MeshService</a></li><li><a href="module-service_SessionManager-SessionManager.html">SessionManager</a></li><li><a href="module-service_audio_AudioManager-AudioManager.html">AudioManager</a></li><li><a href="module-service_text_TextManager-TextManager.html">TextManager</a></li><li><a href="module-service_text_broadcast_BroadcastManager-BroadcastManager.html">BroadcastManager</a></li><li><a href="module-service_text_channel_ChannelManager-ChannelManager.html">ChannelManager</a></li><li><a href="module-service_text_channel_Channel-Channel.html">Channel</a></li><li><a href="module-service_text_message_TextMessage-TextMessage.html">TextMessage</a></li><li><a href="module-storage_AsyncStorageAdapter-AsyncStorageAdapter.html">AsyncStorageAdapter</a></li><li><a href="module-storage_MemoryStorage-MemoryStorage.html">MemoryStorage</a></li><li><a href="module-storage_MessageStore-MessageStore.html">MessageStore</a></li><li><a href="module-storage_Storage-Storage.html">Storage</a></li><li><a href="module-transport_BLEAdapter-BLEAdapter.html">BLEAdapter</a></li><li><a href="module-transport_BLETransport-BLETransport.html">BLETransport</a></li><li><a href="module-transport_MockTransport-MockTransport.html">MockTransport</a></li><li><a href="module-transport_NodeBLEAdapter-NodeBLEAdapter.html">NodeBLEAdapter</a></li><li><a href="module-transport_RNBLEAdapter-RNBLEAdapter.html">RNBLEAdapter</a></li><li><a href="module-transport_Transport-Transport.html">Transport</a></li><li><a href="module-transport_adapters_BLEAdapter-BLEAdapter.html">BLEAdapter</a></li><li><a href="module-transport_adapters_NodeBLEAdapter-NodeBLEAdapter.html">NodeBLEAdapter</a></li><li><a href="module-transport_adapters_RNBLEAdapter-RNBLEAdapter.html">RNBLEAdapter</a></li><li><a href="module-utils_BoundedMap-BoundedMap.html">BoundedMap</a></li><li><a href="module-utils_EventEmitter-EventEmitter.html">EventEmitter</a></li><li><a href="module-utils_LRUCache-LRUCache.html">LRUCache</a></li><li><a href="module-utils_RateLimiter-RateLimiter.html">RateLimiter</a></li><li><a href="module-utils_TimeoutManager-TimeoutManager.html">TimeoutManager</a></li></ul>
+</nav>
+<br class="clear">
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.5</a>
+</footer>
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>

package/docs/api/service_audio_buffer_JitterBuffer.js.html ADDED Viewed

@@ -0,0 +1,244 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>JSDoc: Source: service/audio/buffer/JitterBuffer.js</title>
+    <script src="scripts/prettify/prettify.js"> </script>
+    <script src="scripts/prettify/lang-css.js"> </script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
+</head>
+<body>
+<div id="main">
+    <h1 class="page-title">Source: service/audio/buffer/JitterBuffer.js</h1>
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>'use strict';
+/**
+ * @fileoverview Jitter buffer for real-time audio streaming
+ * @module audio/buffer/JitterBuffer
+ */
+const EventEmitter = require('../../../utils/EventEmitter');
+const { AUDIO_STREAM_CONFIG } = require('../../../constants/audio');
+/**
+ * Jitter buffer for smoothing network jitter in audio streams
+ * @class JitterBuffer
+ * @extends EventEmitter
+ */
+class JitterBuffer extends EventEmitter {
+  /**
+   * Creates a new JitterBuffer
+   * @param {Object} [options] - Buffer options
+   * @param {number} [options.depth=5] - Target buffer depth in frames
+   * @param {number} [options.maxDepth=20] - Maximum buffer depth
+   * @param {number} [options.frameMs=10] - Frame duration in ms
+   */
+  constructor(options = {}) {
+    super();
+    /** @private */
+    this._targetDepth = options.depth || AUDIO_STREAM_CONFIG.JITTER_BUFFER_FRAMES;
+    /** @private */
+    this._maxDepth = options.maxDepth || AUDIO_STREAM_CONFIG.MAX_JITTER_BUFFER_FRAMES;
+    /** @private */
+    this._frameMs = options.frameMs || 10;
+    /** @private */
+    this._buffer = new Map(); // sequenceNumber -> { frame, timestamp }
+    /** @private */
+    this._nextPlaySeq = 0;
+    /** @private */
+    this._initialized = false;
+    /** @private */
+    this._stats = {
+      framesReceived: 0,
+      framesPlayed: 0,
+      framesDropped: 0,
+      plcFrames: 0,
+      underruns: 0,
+      overflows: 0
+    };
+  }
+  /**
+   * Pushes a frame into the buffer
+   * @param {Uint8Array} frame - Audio frame data
+   * @param {number} sequenceNumber - Frame sequence number
+   * @param {number} [timestamp] - Frame timestamp
+   */
+  push(frame, sequenceNumber, timestamp = Date.now()) {
+    this._stats.framesReceived++;
+    // Initialize on first frame
+    if (!this._initialized) {
+      this._nextPlaySeq = sequenceNumber;
+      this._initialized = true;
+    }
+    // Drop if too old
+    if (sequenceNumber &lt; this._nextPlaySeq) {
+      this._stats.framesDropped++;
+      return;
+    }
+    // Check for overflow
+    if (this._buffer.size >= this._maxDepth) {
+      this._stats.overflows++;
+      this.emit('overflow', { bufferSize: this._buffer.size });
+      // Drop oldest frame
+      const oldestSeq = Math.min(...this._buffer.keys());
+      this._buffer.delete(oldestSeq);
+    }
+    this._buffer.set(sequenceNumber, { frame: new Uint8Array(frame), timestamp });
+    // Emit ready when we have enough frames
+    if (this._buffer.size >= this._targetDepth) {
+      this.emit('ready', { bufferSize: this._buffer.size });
+    }
+  }
+  /**
+   * Pops the next frame from the buffer
+   * @returns {{frame: Uint8Array|null, isPLC: boolean, sequenceNumber: number}}
+   */
+  pop() {
+    const seq = this._nextPlaySeq;
+    this._nextPlaySeq++;
+    if (this._buffer.has(seq)) {
+      const { frame } = this._buffer.get(seq);
+      this._buffer.delete(seq);
+      this._stats.framesPlayed++;
+      return { frame, isPLC: false, sequenceNumber: seq };
+    }
+    // Frame missing - generate PLC marker
+    this._stats.plcFrames++;
+    if (this._buffer.size === 0) {
+      this._stats.underruns++;
+      this.emit('underrun', { sequenceNumber: seq });
+    }
+    return { frame: null, isPLC: true, sequenceNumber: seq };
+  }
+  /**
+   * Peeks at the next frame without removing it
+   * @returns {{frame: Uint8Array|null, sequenceNumber: number}|null}
+   */
+  peek() {
+    if (this._buffer.has(this._nextPlaySeq)) {
+      const { frame } = this._buffer.get(this._nextPlaySeq);
+      return { frame, sequenceNumber: this._nextPlaySeq };
+    }
+    return null;
+  }
+  /**
+   * Returns current buffer level
+   * @returns {number}
+   */
+  getBufferLevel() {
+    return this._buffer.size;
+  }
+  /**
+   * Returns buffer level in milliseconds
+   * @returns {number}
+   */
+  getBufferMs() {
+    return this._buffer.size * this._frameMs;
+  }
+  /**
+   * Returns whether buffer has enough frames
+   * @returns {boolean}
+   */
+  isReady() {
+    return this._buffer.size >= this._targetDepth;
+  }
+  /**
+   * Returns buffer statistics
+   * @returns {Object}
+   */
+  getStats() {
+    return {
+      ...this._stats,
+      currentLevel: this._buffer.size,
+      targetDepth: this._targetDepth,
+      bufferMs: this.getBufferMs(),
+      lossRatio: this._stats.framesReceived > 0
+        ? this._stats.plcFrames / this._stats.framesReceived
+        : 0
+    };
+  }
+  /**
+   * Clears the buffer
+   */
+  clear() {
+    this._buffer.clear();
+    this._initialized = false;
+    this._nextPlaySeq = 0;
+  }
+  /**
+   * Pauses playback (stops advancing sequence)
+   */
+  pause() {
+    this._paused = true;
+  }
+  /**
+   * Resumes playback
+   */
+  resume() {
+    this._paused = false;
+  }
+}
+module.exports = JitterBuffer;
+</code></pre>
+        </article>
+    </section>
+</div>
+<nav>
+    <h2><a href="index.html">Home</a></h2><h3>Modules</h3><ul><li><a href="module-audio_buffer.html">audio/buffer</a></li><li><a href="module-audio_buffer_FrameBuffer.html">audio/buffer/FrameBuffer</a></li><li><a href="module-audio_buffer_JitterBuffer.html">audio/buffer/JitterBuffer</a></li><li><a href="module-audio_codec.html">audio/codec</a></li><li><a href="module-audio_codec_LC3Codec.html">audio/codec/LC3Codec</a></li><li><a href="module-audio_codec_LC3Decoder.html">audio/codec/LC3Decoder</a></li><li><a href="module-audio_codec_LC3Encoder.html">audio/codec/LC3Encoder</a></li><li><a href="module-audio_session.html">audio/session</a></li><li><a href="module-audio_session_AudioSession.html">audio/session/AudioSession</a></li><li><a href="module-audio_session_VoiceMessage.html">audio/session/VoiceMessage</a></li><li><a href="module-audio_transport.html">audio/transport</a></li><li><a href="module-audio_transport_AudioFragmenter.html">audio/transport/AudioFragmenter</a></li><li><a href="module-audio_transport_AudioFramer.html">audio/transport/AudioFramer</a></li><li><a href="module-constants.html">constants</a></li><li><a href="module-constants_audio.html">constants/audio</a></li><li><a href="module-constants_ble.html">constants/ble</a></li><li><a href="module-constants_crypto.html">constants/crypto</a></li><li><a href="module-constants_errors.html">constants/errors</a></li><li><a href="module-constants_events.html">constants/events</a></li><li><a href="module-constants_protocol.html">constants/protocol</a></li><li><a href="module-crypto.html">crypto</a></li><li><a href="module-crypto_aead.html">crypto/aead</a></li><li><a href="module-crypto_chacha20.html">crypto/chacha20</a></li><li><a href="module-crypto_hkdf.html">crypto/hkdf</a></li><li><a href="module-crypto_hmac.html">crypto/hmac</a></li><li><a href="module-crypto_keys.html">crypto/keys</a></li><li><a href="module-crypto_keys_KeyManager.html">crypto/keys/KeyManager</a></li><li><a href="module-crypto_keys_KeyPair.html">crypto/keys/KeyPair</a></li><li><a href="module-crypto_keys_SecureStorage.html">crypto/keys/SecureStorage</a></li><li><a href="module-crypto_noise.html">crypto/noise</a></li><li><a href="module-crypto_noise_handshake.html">crypto/noise/handshake</a></li><li><a href="module-crypto_noise_session.html">crypto/noise/session</a></li><li><a href="module-crypto_noise_state.html">crypto/noise/state</a></li><li><a href="module-crypto_poly1305.html">crypto/poly1305</a></li><li><a href="module-crypto_sha256.html">crypto/sha256</a></li><li><a href="module-crypto_x25519.html">crypto/x25519</a></li><li><a href="module-errors.html">errors</a></li><li><a href="module-errors_AudioError.html">errors/AudioError</a></li><li><a href="module-errors_ConnectionError.html">errors/ConnectionError</a></li><li><a href="module-errors_CryptoError.html">errors/CryptoError</a></li><li><a href="module-errors_HandshakeError.html">errors/HandshakeError</a></li><li><a href="module-errors_MeshError.html">errors/MeshError</a></li><li><a href="module-errors_MessageError.html">errors/MessageError</a></li><li><a href="module-errors_ValidationError.html">errors/ValidationError</a></li><li><a href="module-hooks.html">hooks</a></li><li><a href="module-hooks_AppStateManager.html">hooks/AppStateManager</a></li><li><a href="module-hooks_useMesh.html">hooks/useMesh</a></li><li><a href="module-hooks_useMessages.html">hooks/useMessages</a></li><li><a href="module-hooks_usePeers.html">hooks/usePeers</a></li><li><a href="module-mesh.html">mesh</a></li><li><a href="module-mesh_dedup.html">mesh/dedup</a></li><li><a href="module-mesh_dedup_BloomFilter.html">mesh/dedup/BloomFilter</a></li><li><a href="module-mesh_dedup_DedupManager.html">mesh/dedup/DedupManager</a></li><li><a href="module-mesh_dedup_MessageCache.html">mesh/dedup/MessageCache</a></li><li><a href="module-mesh_fragment.html">mesh/fragment</a></li><li><a href="module-mesh_fragment_Assembler.html">mesh/fragment/Assembler</a></li><li><a href="module-mesh_fragment_Fragmenter.html">mesh/fragment/Fragmenter</a></li><li><a href="module-mesh_peer.html">mesh/peer</a></li><li><a href="module-mesh_peer_Peer.html">mesh/peer/Peer</a></li><li><a href="module-mesh_peer_PeerDiscovery.html">mesh/peer/PeerDiscovery</a></li><li><a href="module-mesh_peer_PeerManager.html">mesh/peer/PeerManager</a></li><li><a href="module-mesh_router.html">mesh/router</a></li><li><a href="module-mesh_router_MessageRouter.html">mesh/router/MessageRouter</a></li><li><a href="module-mesh_router_PathFinder.html">mesh/router/PathFinder</a></li><li><a href="module-mesh_router_RouteTable.html">mesh/router/RouteTable</a></li><li><a href="module-protocol.html">protocol</a></li><li><a href="module-protocol_crc32.html">protocol/crc32</a></li><li><a href="module-protocol_deserializer.html">protocol/deserializer</a></li><li><a href="module-protocol_header.html">protocol/header</a></li><li><a href="module-protocol_message.html">protocol/message</a></li><li><a href="module-protocol_serializer.html">protocol/serializer</a></li><li><a href="module-protocol_validator.html">protocol/validator</a></li><li><a href="module-rn-ble-mesh.html">rn-ble-mesh</a></li><li><a href="module-service.html">service</a></li><li><a href="module-service_HandshakeManager.html">service/HandshakeManager</a></li><li><a href="module-service_MeshService.html">service/MeshService</a></li><li><a href="module-service_SessionManager.html">service/SessionManager</a></li><li><a href="module-service_audio.html">service/audio</a></li><li><a href="module-service_audio_AudioManager.html">service/audio/AudioManager</a></li><li><a href="module-service_text.html">service/text</a></li><li><a href="module-service_text_TextManager.html">service/text/TextManager</a></li><li><a href="module-service_text_broadcast.html">service/text/broadcast</a></li><li><a href="module-service_text_broadcast_BroadcastManager.html">service/text/broadcast/BroadcastManager</a></li><li><a href="module-service_text_channel.html">service/text/channel</a></li><li><a href="module-service_text_channel_Channel.html">service/text/channel/Channel</a></li><li><a href="module-service_text_channel_ChannelManager.html">service/text/channel/ChannelManager</a></li><li><a href="module-service_text_message.html">service/text/message</a></li><li><a href="module-service_text_message_TextMessage.html">service/text/message/TextMessage</a></li><li><a href="module-service_text_message_TextSerializer.html">service/text/message/TextSerializer</a></li><li><a href="module-storage.html">storage</a></li><li><a href="module-storage_AsyncStorageAdapter.html">storage/AsyncStorageAdapter</a></li><li><a href="module-storage_MemoryStorage.html">storage/MemoryStorage</a></li><li><a href="module-storage_MessageStore.html">storage/MessageStore</a></li><li><a href="module-storage_Storage.html">storage/Storage</a></li><li><a href="module-transport.html">transport</a></li><li><a href="module-transport_BLEAdapter.html">transport/BLEAdapter</a></li><li><a href="module-transport_BLETransport.html">transport/BLETransport</a></li><li><a href="module-transport_MockTransport.html">transport/MockTransport</a></li><li><a href="module-transport_NodeBLEAdapter.html">transport/NodeBLEAdapter</a></li><li><a href="module-transport_RNBLEAdapter.html">transport/RNBLEAdapter</a></li><li><a href="module-transport_Transport.html">transport/Transport</a></li><li><a href="module-transport_adapters.html">transport/adapters</a></li><li><a href="module-transport_adapters_BLEAdapter.html">transport/adapters/BLEAdapter</a></li><li><a href="module-transport_adapters_NodeBLEAdapter.html">transport/adapters/NodeBLEAdapter</a></li><li><a href="module-transport_adapters_RNBLEAdapter.html">transport/adapters/RNBLEAdapter</a></li><li><a href="module-utils.html">utils</a></li><li><a href="module-utils_BoundedMap.html">utils/BoundedMap</a></li><li><a href="module-utils_EventEmitter.html">utils/EventEmitter</a></li><li><a href="module-utils_LRUCache.html">utils/LRUCache</a></li><li><a href="module-utils_RateLimiter.html">utils/RateLimiter</a></li><li><a href="module-utils_TimeoutManager.html">utils/TimeoutManager</a></li><li><a href="module-utils_bytes.html">utils/bytes</a></li><li><a href="module-utils_debug.html">utils/debug</a></li><li><a href="module-utils_encoding.html">utils/encoding</a></li><li><a href="module-utils_retry.html">utils/retry</a></li><li><a href="module-utils_time.html">utils/time</a></li><li><a href="module-utils_uuid.html">utils/uuid</a></li><li><a href="module-utils_validation.html">utils/validation</a></li><li><a href="utils_base64%250A%250AThis%2520implementation%2520avoids%2520string%2520concatenation%2520in%2520loops%2520which%2520is%2520O(n%25C2%25B2).%250AUses%2520array%2520building%2520which%2520is%2520O(n)%2520-%2520critical%2520for%2520React%2520Native%2520performance.module_.html">utils/base64
+This implementation avoids string concatenation in loops which is O(n²).
+Uses array building which is O(n) - critical for React Native performance.</a></li></ul><h3>Classes</h3><ul><li><a href="module-audio_buffer_FrameBuffer-FrameBuffer.html">FrameBuffer</a></li><li><a href="module-audio_buffer_JitterBuffer-JitterBuffer.html">JitterBuffer</a></li><li><a href="module-audio_codec_LC3Codec-LC3Codec.html">LC3Codec</a></li><li><a href="module-audio_codec_LC3Decoder-LC3Decoder.html">LC3Decoder</a></li><li><a href="module-audio_codec_LC3Encoder-LC3Encoder.html">LC3Encoder</a></li><li><a href="module-audio_session_AudioSession-AudioSession.html">AudioSession</a></li><li><a href="module-audio_session_VoiceMessage-VoiceMessage.html">VoiceMessage</a></li><li><a href="module-audio_session_VoiceMessage-VoiceMessageRecorder.html">VoiceMessageRecorder</a></li><li><a href="module-audio_transport_AudioFragmenter-AudioAssembler.html">AudioAssembler</a></li><li><a href="module-audio_transport_AudioFragmenter-AudioFragmenter.html">AudioFragmenter</a></li><li><a href="module-crypto_keys_KeyManager-KeyManager.html">KeyManager</a></li><li><a href="module-crypto_keys_SecureStorage-MemorySecureStorage.html">MemorySecureStorage</a></li><li><a href="module-crypto_keys_SecureStorage-SecureStorage.html">SecureStorage</a></li><li><a href="module-crypto_noise_handshake-NoiseHandshake.html">NoiseHandshake</a></li><li><a href="module-crypto_noise_session-NoiseSession.html">NoiseSession</a></li><li><a href="module-crypto_noise_state-SymmetricState.html">SymmetricState</a></li><li><a href="module-crypto_sha256-HashContext.html">HashContext</a></li><li><a href="module-errors_AudioError-AudioError.html">AudioError</a></li><li><a href="module-errors_ConnectionError-ConnectionError.html">ConnectionError</a></li><li><a href="module-errors_CryptoError-CryptoError.html">CryptoError</a></li><li><a href="module-errors_HandshakeError-HandshakeError.html">HandshakeError</a></li><li><a href="module-errors_MeshError-MeshError.html">MeshError</a></li><li><a href="module-errors_MessageError-MessageError.html">MessageError</a></li><li><a href="module-errors_ValidationError-ValidationError.html">ValidationError</a></li><li><a href="module-hooks_AppStateManager-AppStateManager.html">AppStateManager</a></li><li><a href="module-mesh_dedup_BloomFilter-BloomFilter.html">BloomFilter</a></li><li><a href="module-mesh_dedup_DedupManager-DedupManager.html">DedupManager</a></li><li><a href="module-mesh_dedup_MessageCache-CacheNode.html">CacheNode</a></li><li><a href="module-mesh_dedup_MessageCache-MessageCache.html">MessageCache</a></li><li><a href="module-mesh_fragment_Assembler-Assembler.html">Assembler</a></li><li><a href="module-mesh_fragment_Assembler-PendingFragmentSet.html">PendingFragmentSet</a></li><li><a href="module-mesh_peer_PeerDiscovery-PeerDiscovery.html">PeerDiscovery</a></li><li><a href="module-mesh_peer_PeerManager-PeerManager.html">PeerManager</a></li><li><a href="module-mesh_peer_Peer-Peer.html">Peer</a></li><li><a href="module-mesh_router_MessageRouter-MessageRouter.html">MessageRouter</a></li><li><a href="module-mesh_router_PathFinder-PathFinder.html">PathFinder</a></li><li><a href="module-mesh_router_RouteTable-RouteTable.html">RouteTable</a></li><li><a href="module-protocol_header-MessageHeader.html">MessageHeader</a></li><li><a href="module-protocol_message-Message.html">Message</a></li><li><a href="module-service_HandshakeManager-HandshakeManager.html">HandshakeManager</a></li><li><a href="module-service_MeshService-MeshService.html">MeshService</a></li><li><a href="module-service_SessionManager-SessionManager.html">SessionManager</a></li><li><a href="module-service_audio_AudioManager-AudioManager.html">AudioManager</a></li><li><a href="module-service_text_TextManager-TextManager.html">TextManager</a></li><li><a href="module-service_text_broadcast_BroadcastManager-BroadcastManager.html">BroadcastManager</a></li><li><a href="module-service_text_channel_ChannelManager-ChannelManager.html">ChannelManager</a></li><li><a href="module-service_text_channel_Channel-Channel.html">Channel</a></li><li><a href="module-service_text_message_TextMessage-TextMessage.html">TextMessage</a></li><li><a href="module-storage_AsyncStorageAdapter-AsyncStorageAdapter.html">AsyncStorageAdapter</a></li><li><a href="module-storage_MemoryStorage-MemoryStorage.html">MemoryStorage</a></li><li><a href="module-storage_MessageStore-MessageStore.html">MessageStore</a></li><li><a href="module-storage_Storage-Storage.html">Storage</a></li><li><a href="module-transport_BLEAdapter-BLEAdapter.html">BLEAdapter</a></li><li><a href="module-transport_BLETransport-BLETransport.html">BLETransport</a></li><li><a href="module-transport_MockTransport-MockTransport.html">MockTransport</a></li><li><a href="module-transport_NodeBLEAdapter-NodeBLEAdapter.html">NodeBLEAdapter</a></li><li><a href="module-transport_RNBLEAdapter-RNBLEAdapter.html">RNBLEAdapter</a></li><li><a href="module-transport_Transport-Transport.html">Transport</a></li><li><a href="module-transport_adapters_BLEAdapter-BLEAdapter.html">BLEAdapter</a></li><li><a href="module-transport_adapters_NodeBLEAdapter-NodeBLEAdapter.html">NodeBLEAdapter</a></li><li><a href="module-transport_adapters_RNBLEAdapter-RNBLEAdapter.html">RNBLEAdapter</a></li><li><a href="module-utils_BoundedMap-BoundedMap.html">BoundedMap</a></li><li><a href="module-utils_EventEmitter-EventEmitter.html">EventEmitter</a></li><li><a href="module-utils_LRUCache-LRUCache.html">LRUCache</a></li><li><a href="module-utils_RateLimiter-RateLimiter.html">RateLimiter</a></li><li><a href="module-utils_TimeoutManager-TimeoutManager.html">TimeoutManager</a></li></ul>
+</nav>
+<br class="clear">
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.5</a>
+</footer>
+<script> prettyPrint(); </script>
+<script src="scripts/linenumber.js"> </script>
+</body>
+</html>