KUID SDK (JavaScript)

Official JavaScript SDK for the KUID API — resolve, validate and integrate KUID addresses بسهولة.

🚀 Installation

npm install kuid-sdk

## QUICK START

import Kuid from "kuid-sdk";

const kuid = new Kuid("YOUR_API_KEY");
const address = await kuid.getAddress("AO-LUA-CAC-KDIA");
console.log(address);

##  Response Example

{
  "kuid": "AO-LUA-CAC-KDIA",
  "address": "Avenida Deolinda Rodrigues",
  "latitude": -8.82,
  "longitude": 13.24
}


## Methods
🔹 getAddress(kuid)
## Fetch address details from a KUID.
await kuid.getAddress("AO-LUA-CAC-KDIA");

🔹 isValid(kuid)
#3 Validate KUID format.
kuid.isValid("AO-LUA-CAC-KDIA"); // true

🔹 getNavigationUrl(lat, lng)
## Generate navigation link.
kuid.getNavigationUrl(-8.82, 13.24);

## Configuration
const kuid = new Kuid("API_KEY", {
  baseUrl: "https://kuidapi.ndeas.cloud/api/v1"
});