📖 Introduction

@elainaa/tls adalah pustaka HTTP client tingkat lanjut yang dirancang untuk meniru perilaku browser modern secara presisi. Dibangun di atas modul native Node.js, pustaka ini menawarkan kontrol granular terhadap negosiasi TLS, rotasi header dinamis, dan manajemen cookie otomatis.

Sangat cocok untuk tugas scraping data yang kompleks, pengujian keamanan, atau berinteraksi dengan endpoint yang memiliki filter keamanan ketat.

---

🚀 Features

- 🔮 Dynamic TLS Fingerprinting
Mengacak urutan Ciphers pada setiap request untuk menghindari deteksi statis.

- 🍪 Smart Cookie Jar
Penyimpanan dan pengelolaan cookie sesi secara otomatis antar request.

- 🎭 User-Agent Rotation
Menghasilkan User-Agent Chrome terbaru secara acak untuk menyamarkan identitas klien.

- ⚡ High Performance
Dibangun menggunakan https native dan zlib untuk dekompresi (Gzip, Deflate, Brotli) yang cepat tanpa overhead dependensi berat.

- 🔄 Auto-Follow Redirects
Menangani redirect HTTP (3xx) secara mulus dengan pemeliharaan state cookie.

---

📦 Installation

Pasang package menggunakan NPM:

``bash
npm install @elainaa/tls
`

Atau menggunakan Yarn:

`bash
yarn add @elainaa/tls
`

---

🪄 Usage Example

Berikut adalah contoh implementasi profesional untuk mengambil data dari sebuah endpoint.

$3

`javascript
import { ElainaTLS } from '@elainaa/tls';

(async () => {
// Inisialisasi Client
const client = new ElainaTLS();
const target = 'https://example.com';

console.log(✨ Fetching: ${target});

try {
const response = await client.fetch(target);

if (response.status === 200) {
console.log('✅ Success!');
console.log('📄 Body Length:', response.body.length);
// console.log(response.body);
} else {
console.log(⚠️ Status Code: ${response.status});
}

} catch (error) {
console.error('❌ Request Failed:', error.message);
}
})();
`

$3

Anda dapat menyuntikkan header kustom sesuai kebutuhan project Anda.

`javascript
import { ElainaTLS } from '@elainaa/tls';

const client = new ElainaTLS();

const options = {
headers: {
'Authorization': 'Bearer magical-token-xyz',
'X-Custom-Header': 'Elaina/1.0',
'Referer': 'https://google.com'
}
};

client.fetch('https://api.secure-target.com/data', options)
.then(res => {
console.log(🔮 Status: ${res.status});
console.log(🍪 Cookies:, client.getCookieString());
})
.catch(err => console.error(err));
`

---

⚙️ API Reference

$3

Membuat instance baru dengan cookie jar yang terisolasi.

$3

Melakukan HTTP GET request.
- url: String - URL target.
- options: Object (Optional) - Konfigurasi tambahan (misal: headers).
- Returns: Promise