# @onepunya/yt-converter-js

YouTube search, download & play — powered by **ClinetAPI** & **[@onepunya/xontol](https://www.npmjs.com/package/@onepunya/xontol)**.

## Installation

```bash
npm install @onepunya/yt-converter-js
```

## Setup

```js
import Youtube from '@onepunya/yt-converter-js'

const yt = new Youtube('YOUR_API_KEY', 'base-url')
```
### Grab Apikey and base-url in onepunya.qzz.io
OnepunyaAPI** & **[onepunya.qzz.io](https://onepunya.qzz.io)**.

## Methods

### `search(query)`
```js
const result = await yt.search('Kokoronashi')

// result.items[0]
// { videoId, title, youtubeUrl, duration, views, author, thumbnail }
```

### `download(videoUrl, format?, quality?)`
```js
// MP4 — quality: 144 | 360 | 480 | 720 | 1080
const mp4 = await yt.download('https://youtu.be/xxxx', 'mp4', 720)
console.log(mp4.mp4DownloadLink)

// MP3 — quality: 92 | 128 | 256 | 320
const mp3 = await yt.download('https://youtu.be/xxxx', 'mp3', 128)
console.log(mp3.mp3DownloadLink)
```

### `play(title)`
Cari lagu by judul → langsung dapat audio URL.
```js
const music = await yt.play('Shape of You')
console.log(music.audioUrl)   // direct stream URL
console.log(music.title)
console.log(music.thumbnail)
```

## License
ISC