danz-lirik 🎵

Package Node.js untuk mencari lirik lagu Indonesia dengan mudah menggunakan JavaScript (ESM).

Cocok untuk:

• Bot Telegram / WhatsApp
• CLI tools
• Aplikasi Node.js
• Project backend / automation

✨ Fitur

• 🔍 Cari lirik lagu Indonesia
• ⚡ Cepat & async
• 🧹 Lirik otomatis diformat rapi
• 🚫 Error handling jelas
• 📦 Support ESM (import)
• 🟢 Node.js >= 20

📦 Instalasi

npm install danz-lirik


---

🚀 Cara Pakai

Import (ES Module)

import cariLirik from "danz-lirik";

atau

import { cariLirik, cariLirikMultiple } from "danz-lirik";


---

🔍 Contoh 1: Cari Lirik Lagu

import cariLirik from "danz-lirik";

const run = async () => {
  try {
    const lirik = await cariLirik("Tulus - Hati Hati di Jalan");
    console.log(lirik);
  } catch (err) {
    console.error(err.message);
  }
};

run();

Output contoh:

Hati-Hati di Jalan - Tulus
==================================================

Kau melangkah dengan siapa
Aku di sini menunggumu...


---

📚 Contoh 2: Cari Banyak Lagu Sekaligus

import { cariLirikMultiple } from "danz-lirik";

const run = async () => {
  const hasil = await cariLirikMultiple("Menepi", 3);
  console.log(hasil);
};

run();

Output:

[
  {
    judul: "Menepi",
    penyanyi: "Ngatmombilung",
    lirikPreview: "Aku sing ngalah..."
  },
  {
    judul: "Menepi",
    penyanyi: "Another Artist",
    lirikPreview: "Saat kau pergi..."
  }
]


---

🧠 API Reference

cariLirik(query: string): Promise<string>

Mencari lirik lagu berdasarkan judul atau judul - penyanyi.

Parameter:

query (string) — judul lagu


Return:

string — lirik lagu yang sudah diformat



---

cariLirikMultiple(query: string, limit?: number): Promise<Array>

Mencari beberapa hasil lagu sekaligus.

Parameter:

query (string)

limit (number, default 5, max 10)


Return:

Array<{
  judul: string
  penyanyi: string
  lirikPreview: string
}>


---

⚠️ Error Handling

Package ini akan melempar Error dengan pesan yang jelas, contoh:

Query kosong

Timeout

Server error

Koneksi gagal


Pastikan pakai try/catch.


---

🔧 Requirement

Node.js >= 20

Internet aktif



---

📄 Lisens danz-