trusera-sdk 0.2.0 → 1.1.0

package/README.md

@@ -1,5 +1,7 @@
 # Trusera SDK for JavaScript/TypeScript
 
+> **Beta** — This SDK is under active development. Expected GA: April 2026.
+
 [![npm version](https://badge.fury.io/js/trusera-sdk.svg)](https://www.npmjs.com/package/trusera-sdk)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client.ts
+var SDK_VERSION = "1.0.0";
 var TruseraClient = class {
   apiKey;
   baseUrl;
@@ -52,6 +53,14 @@ var TruseraClient = class {
   eventQueue = [];
   flushTimer;
   isClosed = false;
+  // Fleet auto-registration
+  autoRegister;
+  agentName;
+  agentType;
+  environment;
+  heartbeatInterval;
+  fleetAgentId;
+  heartbeatTimer;
   constructor(options) {
     this.apiKey = options.apiKey;
     this.baseUrl = options.baseUrl ?? "https://api.trusera.io";
@@ -59,11 +68,28 @@ var TruseraClient = class {
     this.batchSize = options.batchSize ?? 100;
     this.flushInterval = options.flushInterval ?? 5e3;
     this.debug = options.debug ?? false;
+    const envAuto = (typeof process !== "undefined" ? process.env?.TRUSERA_AUTO_REGISTER : void 0) ?? "";
+    if (envAuto.toLowerCase() === "true" || envAuto === "1") {
+      this.autoRegister = true;
+    } else if (envAuto.toLowerCase() === "false" || envAuto === "0") {
+      this.autoRegister = false;
+    } else {
+      this.autoRegister = options.autoRegister ?? false;
+    }
+    const hostname = typeof process !== "undefined" && process.env?.HOSTNAME ? process.env.HOSTNAME : typeof globalThis !== "undefined" && "navigator" in globalThis ? "browser" : "unknown";
+    this.agentName = options.agentName ?? (typeof process !== "undefined" ? process.env?.TRUSERA_AGENT_NAME : void 0) ?? hostname;
+    this.agentType = options.agentType ?? (typeof process !== "undefined" ? process.env?.TRUSERA_AGENT_TYPE : void 0) ?? "";
+    this.environment = options.environment ?? (typeof process !== "undefined" ? process.env?.TRUSERA_ENVIRONMENT : void 0) ?? "";
+    const envHb = typeof process !== "undefined" ? process.env?.TRUSERA_HEARTBEAT_INTERVAL : void 0;
+    this.heartbeatInterval = envHb ? parseInt(envHb, 10) * 1e3 : options.heartbeatInterval ?? 6e4;
     if (!this.apiKey.startsWith("tsk_")) {
       throw new Error("Invalid API key format. Must start with 'tsk_'");
     }
     this.startFlushTimer();
-    this.log("TruseraClient initialized", { baseUrl: this.baseUrl, batchSize: this.batchSize });
+    if (this.autoRegister) {
+      void this.registerWithFleet();
+    }
+    this.log("TruseraClient initialized", { baseUrl: this.baseUrl, batchSize: this.batchSize, autoRegister: this.autoRegister });
   }
   /**
    * Registers a new agent with Trusera backend.
@@ -167,6 +193,7 @@ var TruseraClient = class {
     this.log("Closing client");
     this.isClosed = true;
     this.stopFlushTimer();
+    this.stopHeartbeat();
     await this.flush();
     this.log("Client closed");
   }
@@ -182,6 +209,102 @@ var TruseraClient = class {
   getAgentId() {
     return this.agentId;
   }
+  // -- Fleet auto-registration --
+  getProcessInfo() {
+    if (typeof process === "undefined") return {};
+    return {
+      pid: process.pid,
+      argv: process.argv?.slice(0, 10),
+      node_version: process.version,
+      platform: process.platform,
+      arch: process.arch
+    };
+  }
+  getNetworkInfo() {
+    const info = {};
+    if (typeof process !== "undefined") {
+      try {
+        const os = require("os");
+        info.hostname = os.hostname?.();
+      } catch {
+        info.hostname = process.env?.HOSTNAME ?? "unknown";
+      }
+    }
+    return info;
+  }
+  async registerWithFleet() {
+    const payload = {
+      name: this.agentName,
+      discovery_method: "sdk",
+      sdk_version: SDK_VERSION,
+      hostname: this.agentName,
+      process_info: this.getProcessInfo(),
+      network_info: this.getNetworkInfo()
+    };
+    if (this.agentType) payload.framework = this.agentType;
+    if (this.environment) payload.environment = this.environment;
+    try {
+      const response = await fetch(`${this.baseUrl}/api/v1/fleet/register`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        this.log("Fleet auto-register failed", { status: response.status });
+        return;
+      }
+      const data = await response.json();
+      const agentData = data.data ?? data;
+      const fleetId = agentData.id;
+      if (fleetId) {
+        this.fleetAgentId = String(fleetId);
+        this.startHeartbeat();
+        this.log("Fleet auto-register succeeded", { fleetAgentId: this.fleetAgentId });
+      }
+    } catch (err) {
+      this.log("Fleet auto-register error (continuing without)", { error: String(err) });
+    }
+  }
+  startHeartbeat() {
+    this.heartbeatTimer = setInterval(() => {
+      void this.sendHeartbeat();
+    }, this.heartbeatInterval);
+    if (this.heartbeatTimer.unref) {
+      this.heartbeatTimer.unref();
+    }
+  }
+  stopHeartbeat() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = void 0;
+    }
+  }
+  async sendHeartbeat() {
+    if (!this.fleetAgentId) return;
+    try {
+      const payload = {
+        process_info: this.getProcessInfo(),
+        network_info: this.getNetworkInfo()
+      };
+      const response = await fetch(`${this.baseUrl}/api/v1/fleet/${this.fleetAgentId}/heartbeat`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${this.apiKey}`
+        },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        this.log("Fleet heartbeat failed", { status: response.status });
+      }
+    } catch (err) {
+      this.log("Fleet heartbeat error", { error: String(err) });
+    }
+  }
+  // -- Timers --
   startFlushTimer() {
     this.flushTimer = setInterval(() => {
       void this.flush();