librats 0.5.0 → 0.5.2

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 (66) hide show
  1. package/README.md +1 -1
  2. package/binding.gyp +1 -0
  3. package/lib/index.d.ts +2 -1
  4. package/native-src/3rdparty/android/ifaddrs-android.c +600 -0
  5. package/native-src/3rdparty/android/ifaddrs-android.h +54 -0
  6. package/native-src/CMakeLists.txt +360 -0
  7. package/native-src/LICENSE +21 -0
  8. package/native-src/src/bencode.cpp +485 -0
  9. package/native-src/src/bencode.h +145 -0
  10. package/native-src/src/bittorrent.cpp +3682 -0
  11. package/native-src/src/bittorrent.h +731 -0
  12. package/native-src/src/dht.cpp +2460 -0
  13. package/native-src/src/dht.h +508 -0
  14. package/native-src/src/encrypted_socket.cpp +817 -0
  15. package/native-src/src/encrypted_socket.h +239 -0
  16. package/native-src/src/file_transfer.cpp +1808 -0
  17. package/native-src/src/file_transfer.h +567 -0
  18. package/native-src/src/fs.cpp +639 -0
  19. package/native-src/src/fs.h +108 -0
  20. package/native-src/src/gossipsub.cpp +1137 -0
  21. package/native-src/src/gossipsub.h +403 -0
  22. package/native-src/src/ice.cpp +1386 -0
  23. package/native-src/src/ice.h +328 -0
  24. package/native-src/src/json.hpp +25526 -0
  25. package/native-src/src/krpc.cpp +558 -0
  26. package/native-src/src/krpc.h +145 -0
  27. package/native-src/src/librats.cpp +2735 -0
  28. package/native-src/src/librats.h +1732 -0
  29. package/native-src/src/librats_bittorrent.cpp +167 -0
  30. package/native-src/src/librats_c.cpp +1333 -0
  31. package/native-src/src/librats_c.h +239 -0
  32. package/native-src/src/librats_encryption.cpp +123 -0
  33. package/native-src/src/librats_file_transfer.cpp +226 -0
  34. package/native-src/src/librats_gossipsub.cpp +293 -0
  35. package/native-src/src/librats_ice.cpp +515 -0
  36. package/native-src/src/librats_logging.cpp +158 -0
  37. package/native-src/src/librats_mdns.cpp +171 -0
  38. package/native-src/src/librats_nat.cpp +571 -0
  39. package/native-src/src/librats_persistence.cpp +815 -0
  40. package/native-src/src/logger.h +412 -0
  41. package/native-src/src/mdns.cpp +1178 -0
  42. package/native-src/src/mdns.h +253 -0
  43. package/native-src/src/network_utils.cpp +598 -0
  44. package/native-src/src/network_utils.h +162 -0
  45. package/native-src/src/noise.cpp +981 -0
  46. package/native-src/src/noise.h +227 -0
  47. package/native-src/src/os.cpp +371 -0
  48. package/native-src/src/os.h +40 -0
  49. package/native-src/src/rats_export.h +17 -0
  50. package/native-src/src/sha1.cpp +163 -0
  51. package/native-src/src/sha1.h +42 -0
  52. package/native-src/src/socket.cpp +1376 -0
  53. package/native-src/src/socket.h +309 -0
  54. package/native-src/src/stun.cpp +484 -0
  55. package/native-src/src/stun.h +349 -0
  56. package/native-src/src/threadmanager.cpp +105 -0
  57. package/native-src/src/threadmanager.h +53 -0
  58. package/native-src/src/tracker.cpp +1110 -0
  59. package/native-src/src/tracker.h +268 -0
  60. package/native-src/src/version.cpp +24 -0
  61. package/native-src/src/version.h.in +45 -0
  62. package/native-src/version.rc.in +31 -0
  63. package/package.json +2 -8
  64. package/scripts/build-librats.js +59 -12
  65. package/scripts/prepare-package.js +133 -37
  66. package/src/librats_node.cpp +46 -1
@@ -0,0 +1,360 @@
1
+ cmake_minimum_required(VERSION 3.10)
2
+
3
+ # Get version from git
4
+ find_package(Git QUIET)
5
+ if(GIT_FOUND)
6
+ # Get the current git tag/commit
7
+ execute_process(
8
+ COMMAND ${GIT_EXECUTABLE} describe --tags --always --dirty
9
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
10
+ OUTPUT_VARIABLE GIT_DESCRIBE
11
+ OUTPUT_STRIP_TRAILING_WHITESPACE
12
+ ERROR_QUIET
13
+ )
14
+
15
+ # Extract version from git tag (format: v1.2.3 or 1.2.3)
16
+ execute_process(
17
+ COMMAND ${GIT_EXECUTABLE} describe --tags --abbrev=0
18
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
19
+ OUTPUT_VARIABLE GIT_TAG
20
+ OUTPUT_STRIP_TRAILING_WHITESPACE
21
+ ERROR_QUIET
22
+ )
23
+
24
+ # Get commit count (revision number)
25
+ execute_process(
26
+ COMMAND ${GIT_EXECUTABLE} rev-list --count HEAD
27
+ WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
28
+ OUTPUT_VARIABLE GIT_REVISION_COUNT
29
+ OUTPUT_STRIP_TRAILING_WHITESPACE
30
+ ERROR_QUIET
31
+ )
32
+
33
+ # Parse version components
34
+ if(GIT_TAG MATCHES "^v?([0-9]+)\\.([0-9]+)\\.([0-9]+)")
35
+ set(VERSION_MAJOR ${CMAKE_MATCH_1})
36
+ set(VERSION_MINOR ${CMAKE_MATCH_2})
37
+ set(VERSION_PATCH ${CMAKE_MATCH_3})
38
+ else()
39
+ # Fallback to default version
40
+ set(VERSION_MAJOR 1)
41
+ set(VERSION_MINOR 0)
42
+ set(VERSION_PATCH 0)
43
+ endif()
44
+ else()
45
+ # Fallback when git is not available
46
+ set(VERSION_MAJOR 1)
47
+ set(VERSION_MINOR 0)
48
+ set(VERSION_PATCH 0)
49
+ set(GIT_DESCRIBE "unknown")
50
+ set(GIT_REVISION_COUNT 0)
51
+ endif()
52
+
53
+ # Set build number to revision count (commit count)
54
+ if(GIT_REVISION_COUNT)
55
+ set(VERSION_BUILD ${GIT_REVISION_COUNT})
56
+ else()
57
+ set(VERSION_BUILD 0)
58
+ endif()
59
+ set(VERSION_STRING "${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH}.${VERSION_BUILD}")
60
+
61
+ # Set project version from git
62
+ project(librats VERSION ${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH})
63
+
64
+ set(CMAKE_CXX_STANDARD 17)
65
+ set(CMAKE_CXX_STANDARD_REQUIRED ON)
66
+
67
+ # Options
68
+ option(RATS_BUILD_EXAMPLES "Build examples" ON)
69
+ option(RATS_BUILD_TESTS "Build unit tests" ON)
70
+ option(RATS_ENABLE_ASAN "Enable AddressSanitizer" OFF)
71
+ option(RATS_BINDINGS "Enable bindings" ON)
72
+ option(RATS_CROSSCOMPILING "Force cross-compilation flags" OFF)
73
+ option(RATS_SHARED_LIBRARY "Build as shared library" OFF)
74
+ option(RATS_STATIC_LIBRARY "Build as static library" ON)
75
+ option(RATS_SEARCH_FEATURES "Features related to rats-search project (like bittorrent)" OFF)
76
+
77
+ # Validate library type options
78
+ if(RATS_SHARED_LIBRARY AND RATS_STATIC_LIBRARY)
79
+ message(WARNING "Both RATS_SHARED_LIBRARY and RATS_STATIC_LIBRARY are enabled. Defaulting to shared library.")
80
+ set(RATS_STATIC_LIBRARY OFF)
81
+ elseif(NOT RATS_SHARED_LIBRARY AND NOT RATS_STATIC_LIBRARY)
82
+ message(WARNING "Neither RATS_SHARED_LIBRARY nor RATS_STATIC_LIBRARY are enabled. Defaulting to static library.")
83
+ set(RATS_STATIC_LIBRARY ON)
84
+ endif()
85
+
86
+ # Disable tests when building shared library
87
+ if(RATS_SHARED_LIBRARY AND RATS_BUILD_TESTS)
88
+ message(STATUS "Disabling tests when building shared library.")
89
+ set(RATS_BUILD_TESTS OFF)
90
+ endif()
91
+
92
+ # Configure version.h from template
93
+ configure_file(
94
+ ${PROJECT_SOURCE_DIR}/src/version.h.in
95
+ ${PROJECT_BINARY_DIR}/src/version.h
96
+ @ONLY
97
+ )
98
+
99
+ # Configure version.rc from template
100
+ if(WIN32)
101
+ configure_file(
102
+ ${PROJECT_SOURCE_DIR}/version.rc.in
103
+ ${PROJECT_BINARY_DIR}/version.rc
104
+ @ONLY
105
+ )
106
+ endif()
107
+
108
+ # Define library sources
109
+ set(LIBRARY_SOURCES
110
+ src/socket.cpp
111
+ src/socket.h
112
+ src/network_utils.cpp
113
+ src/network_utils.h
114
+ src/dht.cpp
115
+ src/dht.h
116
+ src/bencode.cpp
117
+ src/bencode.h
118
+ src/krpc.cpp
119
+ src/krpc.h
120
+ src/librats.cpp
121
+ src/librats_logging.cpp
122
+ src/librats_file_transfer.cpp
123
+ src/librats_gossipsub.cpp
124
+ src/librats_nat.cpp
125
+ src/librats_ice.cpp
126
+ src/librats_mdns.cpp
127
+ src/librats_persistence.cpp
128
+ src/librats_encryption.cpp
129
+ src/librats.h
130
+ src/sha1.cpp
131
+ src/sha1.h
132
+ src/os.cpp
133
+ src/os.h
134
+ src/stun.cpp
135
+ src/stun.h
136
+ src/ice.cpp
137
+ src/ice.h
138
+ src/fs.cpp
139
+ src/fs.h
140
+ src/logger.h
141
+ src/noise.cpp
142
+ src/noise.h
143
+ src/encrypted_socket.cpp
144
+ src/encrypted_socket.h
145
+ src/mdns.cpp
146
+ src/mdns.h
147
+ src/threadmanager.cpp
148
+ src/threadmanager.h
149
+ src/gossipsub.cpp
150
+ src/gossipsub.h
151
+ src/file_transfer.cpp
152
+ src/file_transfer.h
153
+ src/version.cpp
154
+ src/rats_export.h
155
+ ${PROJECT_BINARY_DIR}/src/version.h
156
+ )
157
+
158
+ # Add BitTorrent sources if RATS_SEARCH_FEATURES is enabled
159
+ if(RATS_SEARCH_FEATURES)
160
+ list(APPEND LIBRARY_SOURCES
161
+ src/librats_bittorrent.cpp
162
+ src/bittorrent.cpp
163
+ src/bittorrent.h
164
+ src/tracker.cpp
165
+ src/tracker.h
166
+ )
167
+ endif()
168
+
169
+ if(RATS_BINDINGS)
170
+ list(APPEND LIBRARY_SOURCES
171
+ src/librats_c.cpp
172
+ src/librats_c.h
173
+ )
174
+ endif()
175
+
176
+ # Create library with appropriate type
177
+ if(RATS_SHARED_LIBRARY)
178
+ add_library(rats SHARED ${LIBRARY_SOURCES})
179
+ set_target_properties(rats PROPERTIES
180
+ VERSION ${VERSION_STRING}
181
+ SOVERSION ${VERSION_MAJOR}
182
+ )
183
+ target_compile_definitions(rats PRIVATE RATS_EXPORT_DLL)
184
+ else()
185
+ add_library(rats STATIC ${LIBRARY_SOURCES})
186
+ endif()
187
+
188
+ # Enable Position Independent Code for static library (required for linking into shared objects)
189
+ set_target_properties(rats PROPERTIES POSITION_INDEPENDENT_CODE ON)
190
+
191
+ # Include directories
192
+ target_include_directories(rats PUBLIC ${PROJECT_BINARY_DIR}/src src)
193
+
194
+ # Find and link threading support
195
+ find_package(Threads REQUIRED)
196
+ target_link_libraries(rats Threads::Threads)
197
+
198
+ # Link networking libraries
199
+ if(WIN32)
200
+ target_link_libraries(rats ws2_32 iphlpapi bcrypt)
201
+ endif()
202
+
203
+ if(ANDROID)
204
+ if(DEFINED ANDROID_PLATFORM)
205
+ string(REGEX REPLACE "android-" "" ANDROID_API_LEVEL ${ANDROID_PLATFORM})
206
+ math(EXPR ANDROID_API_LEVEL "${ANDROID_API_LEVEL}")
207
+ message(STATUS "Android API level detected: ${ANDROID_API_LEVEL}")
208
+ else()
209
+ message(FATAL_ERROR "ANDROID_PLATFORM is not defined!")
210
+ endif()
211
+
212
+ if(ANDROID_API_LEVEL LESS 24)
213
+ target_sources(rats PRIVATE ${PROJECT_SOURCE_DIR}/3rdparty/android/ifaddrs-android.c)
214
+ target_include_directories(rats
215
+ PRIVATE
216
+ ${PROJECT_SOURCE_DIR}/3rdparty/android
217
+ )
218
+ target_compile_definitions(rats PUBLIC RATS_ANDROID_OLD_API)
219
+ message(STATUS "Using ifaddrs-android for backward compatibility")
220
+ endif()
221
+ endif()
222
+
223
+ if(RATS_SEARCH_FEATURES)
224
+ message(STATUS "Enable rats-search features")
225
+ target_compile_definitions(rats PUBLIC RATS_SEARCH_FEATURES)
226
+ endif(RATS_SEARCH_FEATURES)
227
+
228
+ # Create the main executable
229
+ if(RATS_BUILD_EXAMPLES)
230
+ add_executable(rats-client src/main.cpp)
231
+ target_link_libraries(rats-client rats)
232
+
233
+ # Add version information to help reduce false positives (Windows only)
234
+ if(WIN32 AND EXISTS "${PROJECT_SOURCE_DIR}/version.rc.in")
235
+ set(VERSION_RC "${PROJECT_BINARY_DIR}/version.rc")
236
+ target_sources(rats-client PRIVATE "${VERSION_RC}")
237
+ endif()
238
+
239
+ set_target_properties(rats-client PROPERTIES
240
+ RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin
241
+ )
242
+ endif()
243
+
244
+ # Set output directories
245
+ set_target_properties(rats PROPERTIES
246
+ ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib
247
+ LIBRARY_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib
248
+ RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin
249
+ )
250
+
251
+ # AddressSanitizer configuration
252
+ if(RATS_ENABLE_ASAN)
253
+ if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
254
+ set(ASAN_FLAGS "-fsanitize=address -fno-omit-frame-pointer -g")
255
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} ${ASAN_FLAGS}")
256
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${ASAN_FLAGS}")
257
+ set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} ${ASAN_FLAGS}")
258
+ set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} ${ASAN_FLAGS}")
259
+
260
+ message(STATUS "AddressSanitizer enabled (GCC/Clang)")
261
+ elseif(CMAKE_CXX_COMPILER_ID MATCHES "MSVC")
262
+ set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /fsanitize=address")
263
+ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} /fsanitize=address")
264
+
265
+ message(STATUS "AddressSanitizer enabled (MSVC)")
266
+ else()
267
+ message(WARNING "AddressSanitizer is not supported by this compiler")
268
+ endif()
269
+ endif()
270
+
271
+ if(RATS_BUILD_TESTS)
272
+ target_compile_definitions(rats PUBLIC TESTING)
273
+
274
+ # Enable testing
275
+ enable_testing()
276
+
277
+ # Find GoogleTest
278
+ find_package(GTest QUIET)
279
+
280
+ if(NOT GTest_FOUND)
281
+ # Download GoogleTest
282
+ include(FetchContent)
283
+ FetchContent_Declare(
284
+ googletest
285
+ URL https://github.com/google/googletest/archive/refs/tags/v1.17.0.zip
286
+ DOWNLOAD_EXTRACT_TIMESTAMP TRUE
287
+ )
288
+
289
+ # For Windows: Prevent overriding the parent project's compiler/linker settings
290
+ set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
291
+
292
+ FetchContent_MakeAvailable(googletest)
293
+ endif()
294
+
295
+ # Create test source list
296
+ set(TEST_SOURCES
297
+ tests/test_socket.cpp
298
+ tests/test_bencode.cpp
299
+ tests/test_sha1.cpp
300
+ tests/test_network_utils.cpp
301
+ tests/test_dht.cpp
302
+ tests/test_rats_client.cpp
303
+ tests/test_os.cpp
304
+ tests/test_stun.cpp
305
+ tests/test_ice.cpp
306
+ tests/test_fs.cpp
307
+ tests/test_config_persistence.cpp
308
+ tests/test_main.cpp
309
+ tests/test_message_exchange.cpp
310
+ tests/test_noise.cpp
311
+ tests/test_gossipsub.cpp
312
+ tests/test_logging_api_gtest.cpp
313
+ tests/test_file_transfer.cpp
314
+ )
315
+
316
+ # Add BitTorrent tests if RATS_SEARCH_FEATURES is enabled
317
+ if(RATS_SEARCH_FEATURES)
318
+ list(APPEND TEST_SOURCES
319
+ tests/test_bittorrent.cpp
320
+ tests/test_tracker.cpp
321
+ )
322
+ endif()
323
+
324
+ if(RATS_BINDINGS)
325
+ list(APPEND TEST_SOURCES
326
+ tests/test_librats_c_api.cpp
327
+ )
328
+ endif()
329
+
330
+ # Add mDNS tests only on non-macOS platforms
331
+ if(NOT APPLE)
332
+ list(APPEND TEST_SOURCES tests/test_mdns.cpp)
333
+ endif()
334
+
335
+ # Create test executable
336
+ add_executable(librats_tests ${TEST_SOURCES})
337
+
338
+ # Link with GoogleTest and our library
339
+ target_link_libraries(librats_tests
340
+ rats
341
+ gtest
342
+ gtest_main
343
+ gmock
344
+ gmock_main
345
+ )
346
+
347
+ # Add test discovery
348
+ include(GoogleTest)
349
+ # When cross-compiling, the host cannot execute target binaries. Skip discovery.
350
+ if(NOT CMAKE_CROSSCOMPILING AND NOT RATS_CROSSCOMPILING)
351
+ gtest_discover_tests(librats_tests)
352
+ else()
353
+ message(STATUS "Skipping gtest_discover_tests during cross-compilation")
354
+ endif()
355
+
356
+ # Set test output directory
357
+ set_target_properties(librats_tests PROPERTIES
358
+ RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin
359
+ )
360
+ endif()
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 librats contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.