---
## 🚀 Overview
This package is engineered for developers building applications (like movie streaming apps or media centers) that require reliable access to Sinhala subtitles. It bypasses the need for heavy, slow headless browsers by utilizing advanced HTML parsing techniques, ensuring lightning-fast performance and low server resource usage.
### ✨ Key Features
* ⚡ **Blazing Fast Performance:** Built on the optimized `nexara` engine for rapid data retrieval.
* 🔍 **Smart Search:** Instantly search movies and TV shows with accurate categorization and TV episode detection.
* 📥 **Direct Subtitle Downloads:** Extracts the final, direct download URL for subtitle files, skipping intermediate pages.
* 💎 **High-Quality Torrent Extraction:** Automatically identifies and categorizes available torrent links (720p, 1080p, 3D, 4K Web/Bluray) along with their file sizes.
* 🖼️ **Advanced Image Resolving:** Intelligently bypasses lazy-loaders to fetch high-resolution poster images.
* 🛡️ **Robust & Reliable:** Includes built-in mechanisms to handle network variations and site structure changes.
---
## 📦 Installation
Install the package easily via npm:
```bash
npm install subz.lk
```
---
## 💻 Usage Examples
### 1️⃣ Search for Movies or TV Shows
Search subz.lk for any keyword and get a list of matching results with basic details.
```javascript
const SubzLK = require('subz.lk');
async function runSearch() {
console.log('⏳ Searching subz.lk...');
try {
// Search for "Jurassic"
const results = await SubzLK.search('Jurassic');
console.log(`✅ Found ${results.length} results!`);
// See output below for the result structure
console.log(JSON.stringify(results.slice(0, 3), null, 2));
} catch (error) {
console.error('❌ Search Error:', error.message);
}
}
runSearch();
```
