@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 +29 -16
- package/dist/index.cjs +2735 -288
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +2735 -288
- package/dist/index.js.map +1 -1
- package/dist/index.min.js +1 -1
- package/dist/index.min.js.map +1 -1
- package/package.json +25 -18
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-
|
|
20
|
-
<a href="#"><img src="https://img.shields.io/badge/test%20coverage-
|
|
21
|
-
<a href="#"><img src="https://img.shields.io/badge/bundle%20size-
|
|
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.
|
|
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**:
|
|
110
|
-
- **Test Coverage**: **
|
|
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
|
-
- **
|
|
116
|
-
- **
|
|
117
|
-
- **
|
|
118
|
-
- **
|
|
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**:
|
|
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**:
|
|
489
|
-
- **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:
|