sachii-safe-logger 1.1.5 β 1.1.6
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 +104 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,21 +1,114 @@
|
|
|
1
|
-
#
|
|
1
|
+
# sachii-safe-logger
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+

|
|
4
|
+

|
|
5
|
+

|
|
6
|
+

|
|
7
|
+
|
|
8
|
+
`sachii-safe-logger` is a lightweight **TypeScript library** for safely logging sensitive data by masking information such as **phone numbers, email addresses, credit card numbers, and tokens**. Ideal for logging, debugging, or displaying user data without exposing sensitive details.
|
|
4
9
|
|
|
5
10
|
---
|
|
6
11
|
|
|
7
|
-
## Features
|
|
12
|
+
## πΉ Features
|
|
8
13
|
|
|
9
|
-
- Mask
|
|
10
|
-
- Mask
|
|
11
|
-
- Mask credit card numbers
|
|
12
|
-
- Mask tokens or keys
|
|
13
|
-
-
|
|
14
|
-
-
|
|
14
|
+
- Mask **phone numbers** for privacy.
|
|
15
|
+
- Mask **email addresses** partially.
|
|
16
|
+
- Mask **credit card numbers** leaving only the last 4 digits.
|
|
17
|
+
- Mask **tokens or API keys** securely.
|
|
18
|
+
- Written in **TypeScript**, with types included.
|
|
19
|
+
- Lightweight, dependency-free, and easy to use.
|
|
15
20
|
|
|
16
21
|
---
|
|
22
|
+
npm package link
|
|
23
|
+
[https://www.npmjs.com/package/sachii-safe-logger](https://www.npmjs.com/package/sachii-safe-logger)
|
|
17
24
|
|
|
18
|
-
## Installation
|
|
25
|
+
## πΎ Installation
|
|
19
26
|
|
|
20
27
|
```bash
|
|
21
|
-
npm install safe-logger
|
|
28
|
+
npm install sachii-safe-logger
|
|
29
|
+
|
|
30
|
+
```Importing
|
|
31
|
+
import { maskPhone, maskEmail, maskCreditCard, maskToken } from "sachii-safe-logger";
|
|
32
|
+
|
|
33
|
+
```Usage
|
|
34
|
+
const phone = "9876543210";
|
|
35
|
+
console.log(maskPhone(phone));
|
|
36
|
+
// Output: *******210
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
const email = "example@example.com";
|
|
41
|
+
console.log(maskEmail(email));
|
|
42
|
+
// Output: e*****@example.com
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
const creditCard = "1234567890123456";
|
|
47
|
+
console.log(maskCreditCard(creditCard));
|
|
48
|
+
// Output: ************3456
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
const token = "abc123def456";
|
|
53
|
+
console.log(maskToken(token));
|
|
54
|
+
// Output: **123**
|
|
55
|
+
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
| Function | Description | Example |
|
|
60
|
+
| ------------------ | ---------------------------------------------- | ---------------------- |
|
|
61
|
+
| `maskEmail()` | Masks email except first letter and domain | `"s*****@example.com"` |
|
|
62
|
+
| `maskPhone()` | Masks phone except last 3 digits | `"*******210"` |
|
|
63
|
+
| `maskCreditCard()` | Masks all except last 4 digits | `"************1111"` |
|
|
64
|
+
| `maskToken()` | Masks API tokens except first 4 & last 4 chars | `"abcd********5678"` |
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
Contributing
|
|
69
|
+
|
|
70
|
+
PRs welcome! Please follow code style and add tests.
|
|
71
|
+
|
|
72
|
+
## π File Structure
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
sachii-safe-logger/
|
|
76
|
+
ββ dist/
|
|
77
|
+
β ββ maskers/
|
|
78
|
+
β β ββ creditCard.js
|
|
79
|
+
β β ββ email.js
|
|
80
|
+
β β ββ phone.js
|
|
81
|
+
β β ββ tokens.js
|
|
82
|
+
β ββ utils.js
|
|
83
|
+
ββ tests/
|
|
84
|
+
β ββ phone.test.ts
|
|
85
|
+
β ββ email.test.ts
|
|
86
|
+
β ββ creditCard.test.ts
|
|
87
|
+
β ββ token.test.ts
|
|
88
|
+
ββ package.json
|
|
89
|
+
ββ README.md
|
|
90
|
+
ββ LICENSE
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Documentation
|
|
97
|
+
[Full API docs](https://sachiinandan.github.io/sachii-safe-logger)
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
## π License
|
|
101
|
+
|
|
102
|
+
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## π Contributing
|
|
107
|
+
|
|
108
|
+
Please read our [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## π Author
|
|
113
|
+
|
|
114
|
+
- **Sachinandan** - [Sachinandan](https://github.com/sachinandan-05)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "sachii-safe-logger",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.6",
|
|
4
4
|
"description": "A lightweight TypeScript library to mask sensitive data (emails, credit cards, phone numbers, API tokens) in logs for security and compliance.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|