auto-cors-diagnose

Alat analisis masalah CORS otomatis dengan penjelasan yang jelas dan solusi yang bisa langsung diterapkan.

auto-cors-diagnose adalah CLI dan library Node.js yang membantu developer menganalisis masalah CORS (Cross-Origin Resource Sharing) secara otomatis. Tool ini melakukan preflight request (OPTIONS) dan memeriksa response headers untuk menentukan apakah sebuah API mendukung akses lintas origin — dan jika tidak, tool ini akan memberikan penjelasan yang jelas beserta solusi yang disarankan.

Cocok digunakan untuk:

• Frontend developer yang sering berhadapan dengan error CORS
• Backend developer yang ingin memverifikasi konfigurasi API
• QA engineer yang melakukan validasi endpoint
• Mahasiswa atau pemula yang sedang mempelajari perilaku CORS

---

✨ Fitur

• 🔍 Analisis CORS otomatis untuk endpoint API apa pun
• ⚠ Mendeteksi header CORS yang hilang atau tidak valid
• 🧠 Memberikan rekomendasi yang bisa langsung diterapkan
• 💻 Bisa digunakan sebagai CLI maupun library
• 🚀 Ringan dan minim dependensi

---

📦 Instalasi

Instal secara global:

npm install -g auto-cors-diagnose

Atau gunakan NPX tanpa instalasi:

npx auto-cors-diagnose <url>

---

💻 Penggunaan CLI

Cek konfigurasi CORS dari sebuah API:

npx auto-cors-diagnose https://dummyjson.com/products

Contoh hasil sukses:

{
  "status": "OK",
  "details": "CORS headers terdeteksi.",
  "rawHeaders": {
    "access-control-allow-origin": "*",
    "access-control-allow-methods": "GET,HEAD,PUT,PATCH,POST,DELETE"
  }
}

Contoh hasil gagal:

{
  "status": "CORS_BLOCKED",
  "reason": "missing-allow-origin",
  "details": "Header Access-Control-Allow-Origin tidak ditemukan.",
  "solution": "Tambahkan 'Access-Control-Allow-Origin: *' atau tentukan domain yang diizinkan."
}

---

🧑‍💻 Penggunaan sebagai Library (Node.js)

import { diagnoseCors } from "auto-cors-diagnose";

const result = await diagnoseCors("https://dummyjson.com/products");
console.log(result);

---

📁 Struktur Proyek

auto-cors-diagnose
├─ bin/                 # Launcher CLI
├─ dist/                # JavaScript hasil build
├─ src/                 # Source code TypeScript
│  ├─ core/
│  ├─ utils/
│  └─ cli.ts
└─ tests/               # Pengujian menggunakan Vitest

---

🧪 Menjalankan Test

npm run test

---

🤝 Kontribusi

Kontribusi sangat terbuka! Silakan gunakan alur berikut:

dev branch → development

feat/<nama-fitur> → fitur baru

---

📄 Lisensi

Proyek ini dirilis dengan lisensi MIT License © 2025 Kikuk Afandi.