@syntropysoft/syntropyfront 0.3.0 โ†’ 0.4.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.
package/README.md CHANGED
@@ -16,14 +16,15 @@
16
16
  <a href="#"><img src="https://img.shields.io/badge/status-ready%20for%20production-brightgreen.svg" alt="Ready for Production"></a>
17
17
  <a href="#"><img src="https://github.com/Syntropysoft/syntropyfront/workflows/CodeQL/badge.svg" alt="CodeQL"></a>
18
18
  <a href="#"><img src="https://img.shields.io/badge/dependabot-enabled-brightgreen.svg" alt="Dependabot"></a>
19
- <a href="#"><img src="https://img.shields.io/badge/mutation%20score-74.96%25-brightgreen.svg" alt="Mutation Score"></a>
20
- <a href="#"><img src="https://img.shields.io/badge/test%20coverage-91.01%25-brightgreen.svg" alt="Test Coverage"></a>
21
- <a href="#"><img src="https://img.shields.io/badge/bundle%20size-4.88%20KB-brightgreen.svg" alt="Bundle Size"></a>
19
+ <a href="#"><img src="https://img.shields.io/badge/mutation%20score-71.03%25-brightgreen.svg" alt="Mutation Score"></a>
20
+ <a href="#"><img src="https://img.shields.io/badge/test%20coverage-89.47%25-brightgreen.svg" alt="Test Coverage"></a>
21
+ <a href="#"><img src="https://img.shields.io/badge/bundle%20size-34%20KB-brightgreen.svg" alt="Bundle Size"></a>
22
+ <a href="https://socket.dev/npm/package/@syntropysoft/syntropyfront"><img src="https://socket.dev/api/badge/npm/package/@syntropysoft/syntropyfront" alt="Socket Badge"></a>
22
23
  </p>
23
24
 
24
25
  ---
25
26
 
26
- ๐Ÿš€ **Observability library with automatic capture - Just 1 line of code!**
27
+ ๐Ÿš€ **Observability library with automatic capture - Just 1 line of code! No dependencies!**
27
28
 
28
29
  SyntropyFront automatically captures user interactions, errors, HTTP calls, and console logs, providing comprehensive observability for your web applications with minimal setup.
29
30
 
@@ -36,6 +37,8 @@ SyntropyFront automatically captures user interactions, errors, HTTP calls, and
36
37
  - ๐Ÿ’พ **Smart storage** - Keeps the last N events (configurable)
37
38
  - ๐Ÿ“ค **Flexible posting** - Posts errors to your endpoint or logs to console
38
39
  - โšก **Zero configuration** - Works out of the box with just an import
40
+ - ๐Ÿ“ฆ **Zero Dependencies** - 100% standalone, no runtime dependencies
41
+ - ๐Ÿ›ก๏ธ **Highly Resilient** - Automatic retry and persistent queuing
39
42
 
40
43
  ## ๐Ÿš€ Quick Start
41
44
 
@@ -101,23 +104,22 @@ syntropyFront.configure({
101
104
  npm install @syntropysoft/syntropyfront
102
105
  ```
103
106
 
104
- ## ๐Ÿš€ **Performance Optimizations (v0.3.0)**
107
+ ## ๐Ÿš€ **Performance Optimizations (v0.4.1)**
105
108
 
106
109
  SyntropyFront has been optimized for maximum performance and minimal bundle size:
107
110
 
108
111
  ### **๐ŸŽฏ Testing Excellence**
109
- - **Mutation Score**: Improved from 58.14% to **74.96%** (+16.82 points!)
110
- - **Test Coverage**: **91.01%** with 488 comprehensive tests
112
+ - **Mutation Score**: **71.03%** (Total) / **80.02%** (Covered) verified with Stryker
113
+ - **Test Coverage**: **81.47% Branch Coverage** (90.07% Lines)
114
+ - **430+ Comprehensive Tests**: Covering all edge cases and resilience scenarios
111
115
  - **Database Modules**: All modules now have 77-100% mutation score
112
116
  - **Core Components**: 92.70% average mutation score across agent modules
113
117
 
114
118
  ### **๐Ÿ“ฆ Ultra-Lightweight Bundle**
115
- - **Only 1 Runtime Dependency**: `flatted` for circular reference handling
116
- - **45+ Dependencies Removed**: Eliminated unnecessary packages
117
- - **Bundle Size**: **4.88 KB** minified (4,884 bytes)
118
- - **ES Module**: 10.9 KB
119
- - **CommonJS**: 10.98 KB
120
- - **Faster Installation**: Reduced npm install time and disk usage
119
+ - **Zero Runtime Dependencies**: No more external requirements.
120
+ - **Bundle Size**: **34 KB** minified (fully featured with offline support)
121
+ - **ES Module**: 80 KB (unminified)
122
+ - **Zero Runtime Dependencies**: Near-instant installation and minimal noise
121
123
 
122
124
  ### **๐Ÿ”ง Smart Dependency Management**
123
125
  - **Clean Architecture**: All testing tools properly categorized as devDependencies
@@ -476,7 +478,7 @@ src/core/
476
478
  - **Single Responsibility Principle (SRP)**: Each class has one clear purpose
477
479
  - **Dependency Injection**: Components receive dependencies through constructors
478
480
  - **Declarative Error Handling**: Structured error responses with fallbacks
479
- - **Comprehensive Testing**: 488 tests with 74.96% mutation score
481
+ - **Comprehensive Testing**: 430+ tests with 71.03% mutation score
480
482
  - **Optimized Performance**: Timeouts optimized for faster execution
481
483
 
482
484
  ## ๐Ÿงช Testing & Quality
@@ -485,8 +487,8 @@ SyntropyFront maintains high code quality through comprehensive testing:
485
487
 
486
488
  ### Test Coverage & Mutation Testing
487
489
 
488
- - **Mutation Score**: 74.96% - Our tests effectively detect code changes
489
- - **Test Coverage**: 91.01% - Comprehensive unit test coverage
490
+ - **Mutation Score**: 71.03% - Our tests effectively detect code changes
491
+ - **Test Coverage**: 89.47% (Statements) / 81.47% (Branches)
490
492
  - **Key Components Performance**:
491
493
  - `Agent.js`: 87.23% mutation score
492
494
  - `ConfigurationManager.js`: 100% mutation score
@@ -499,6 +501,7 @@ SyntropyFront maintains high code quality through comprehensive testing:
499
501
  - `DatabaseConfigManager.js`: 86.89% mutation score
500
502
  - `DatabaseConnectionManager.js`: 85.96% mutation score
501
503
  - `PersistentBufferManager.js`: 77.63% mutation score
504
+ - `RobustSerializer.js`: 73.36% mutation score
502
505
 
503
506
  ### Testing Stack
504
507
 
@@ -520,6 +523,16 @@ npm run test:coverage
520
523
  npm run test:mutation
521
524
  ```
522
525
 
526
+
527
+ ## ๐Ÿ›ก๏ธ Security & Privacy
528
+
529
+ SyntropyFront is designed with security and transparency in mind:
530
+
531
+ - **Network Access**: Telemetry is sent **only** to the endpoint you configure via `configure({ fetch: { url: '...' } })`. By default, it only logs to the browser console.
532
+ - **No Third-Party Tracking**: We don't include any tracking or analytics scripts. Your data is yours.
533
+ - **PII Protection**: Breadcrumbs focus on technical context. We recommend using a custom `onError` handler to scrub sensitive data if necessary.
534
+ - **Zero Runtime Dependencies**: Minimizes the attack surface by not relying on external code at runtime.
535
+
523
536
  ## ๐Ÿ” Debugging
524
537
 
525
538
  SyntropyFront logs helpful information to the console: