arbiter-sdk 1.0.0

package/ArbiterClient.js

@@ -0,0 +1,39 @@
+import axios from "axios";
+import { ENDPOINTS } from "./endpoints.js";
+
+export default class ArbiterClient{
+    constructor(){
+        this.timeout = 2000;
+        this.primary = ENDPOINTS.primary;
+        this.secondary = ENDPOINTS.secondary;
+
+        this.primaryClient = axios.create({
+            baseURL: this.primary,
+            timeout: this.timeout,
+        });
+
+        this.secondaryClient = axios.create({
+            baseURL: this.secondary,
+            timeout: this.timeout,
+        });
+    }
+
+    async decide(payload){
+        try {
+            const res = await this.primaryClient.post("/decide", payload);
+            return res.data;
+        } catch (error) {
+            if(!this.secondary){
+                throw error;
+            }
+
+            try {
+                const res = await this.secondaryClient.post("/decide", payload);
+                return res.data;
+            }catch (error) {
+                throw new Error("Both primary and secondary endpoints failed");
+            }
+            
+        }
+    }
+}

package/README.md

@@ -0,0 +1,3 @@
+# Arbiter Node.js SDK
+
+Official Node.js SDK for Arbiter a developer-first traffic protection service.

package/endpoints.js

@@ -0,0 +1,4 @@
+export const ENDPOINTS = {
+  primary: "https://arbiter-service.onrender.com",
+  secondary: "http://54.172.120.251"
+};

package/index.js

@@ -0,0 +1,46 @@
+import ArbiterClient from "./ArbiterClient.js";
+
+export function createArbiterClient(config) {
+    const client = new ArbiterClient();
+    const defaultAlgorithm = config.defaultAlgorithm || "leaky-bucket";
+    const globalWhitelist = (config.whitelist || []).map(normalizeKey);
+    const globalBlacklist = (config.blacklist || []).map(normalizeKey);
+
+
+    return {
+        async protect({key, rule}){
+            const ruleConfig = config.rules[rule];
+
+            if(!ruleConfig){
+                throw new Error(`Rule not found: ${rule}`);
+            }
+
+            const algorithm = ruleConfig.algorithm || defaultAlgorithm;
+
+            const policy = {
+                whitelist: (ruleConfig.policy?.whitelist || globalWhitelist).map(normalizeKey),
+                blacklist: (ruleConfig.policy?.blacklist || globalBlacklist).map(normalizeKey),
+            }
+
+            const abuse = ruleConfig.abuse || null;
+
+            return client.decide({
+                key: normalizeKey(key),
+                rule:{
+                    limit: ruleConfig.limit,
+                    window: ruleConfig.window,
+                    algorithm,
+                },
+                policy,
+                abuse
+            });
+        }
+    };
+}
+
+function normalizeKey(key) {
+  if (typeof key === "string" && key.startsWith("::ffff:")) {
+    return key.replace("::ffff:", "");
+  }
+  return key;
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "arbiter-sdk",
+  "version": "1.0.0",
+  "description": "Official Node.js SDK for the Arbiter traffic protection service",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "keywords": [
+    "nodejs",
+    "node-sdk",
+    "rate-limiting",
+    "api-security",
+    "traffic-control",
+    "redis"
+  ],
+  "author": "Guna Sai",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.13.4"
+  }
+}

package/test.js

@@ -0,0 +1,16 @@
+import { createArbiterClient } from "./index.js";
+
+const ab = createArbiterClient({
+    rules:{
+        login:{
+            limit: 5,
+            window: 10
+        }
+    }
+});
+
+for(let i=0;i<10;i++){
+    const res = await ab.protect({key: "user1", rule: "login"});
+    console.log(res);
+    await new Promise(r => setTimeout(r, 500));
+}