kuid-sdk 1.0.0

package/index.js

@@ -0,0 +1,2 @@
+import Kuid from "./kuid.js";
+export default Kuid;

package/kuid.js

@@ -0,0 +1,55 @@
+export default class Kuid {
+  constructor(apiKey, baseUrl = "https://kuidapi.ndeas.cloud/api/v1") {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+    this.cache = new Map();
+  }
+
+  async getAddress(kuid) {
+    if (!this.isValid(kuid)) {
+      throw new Error("Formato de KUID inválido");
+    }
+
+    // cache (5 min)
+    if (this.cache.has(kuid)) {
+      return this.cache.get(kuid);
+    }
+
+    const res = await fetch(`${this.baseUrl}/addresses/${kuid}/`, {
+      headers: {
+        "Authorization": `ApiKey ${this.apiKey}`,
+        "Accept": "application/json"
+      }
+    });
+
+    if (!res.ok) {
+      throw new Error("Erro ao obter KUID");
+    }
+
+    const data = await res.json();
+    const normalized = this.normalize(data);
+
+    this.cache.set(kuid, normalized);
+
+    setTimeout(() => this.cache.delete(kuid), 300000);
+
+    return normalized;
+  }
+
+  normalize(data) {
+    return {
+      kuid: data.kuid,
+      address: data.description,
+      latitude: data.latest_location?.latitude,
+      longitude: data.latest_location?.longitude
+    };
+  }
+
+  isValid(kuid) {
+    return /^[A-Z]{2}-[A-Z]{3}-[A-Z]{3}-[A-Z0-9]{4}$/.test(kuid);
+  }
+
+  getNavigationUrl(lat, lng) {
+    return `https://maps.google.com/?q=${lat},${lng}`;
+  }
+}

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "kuid-sdk",
+  "version": "1.0.0",
+  "description": "Official KUID SDK",
+  "main": "index.js",
+  "type": "module",
+  "keywords": ["kuid", "geolocation", "address"],
+  "author": "KUID",
+  "license": "MIT"
+}