@realtimex/sdk 1.0.6 → 1.0.8

package/dist/index.d.mts

@@ -137,7 +137,9 @@ declare class WebhookModule {
 
 declare class ApiModule {
     private realtimexUrl;
-    constructor(realtimexUrl: string);
+    private appId;
+    constructor(realtimexUrl: string, appId: string);
+    private getHeaders;
     getAgents(): Promise<Agent[]>;
     getWorkspaces(): Promise<Workspace[]>;
     getThreads(workspaceSlug: string): Promise<Thread[]>;
@@ -186,9 +188,13 @@ declare class PortModule {
      */
     getSuggestedPort(): number;
     /**
-     * Check if a port is available
+     * Check if a port is available on a specific host
+     */
+    private isPortAvailableOn;
+    /**
+     * Check if a port is available (checks both IPv4 and IPv6)
      * @param port - Port number to check
-     * @returns Promise resolving to true if port is available
+     * @returns Promise resolving to true if port is available on ALL interfaces
      */
     isPortAvailable(port: number): Promise<boolean>;
     /**

package/dist/index.d.ts

@@ -137,7 +137,9 @@ declare class WebhookModule {
 
 declare class ApiModule {
     private realtimexUrl;
-    constructor(realtimexUrl: string);
+    private appId;
+    constructor(realtimexUrl: string, appId: string);
+    private getHeaders;
     getAgents(): Promise<Agent[]>;
     getWorkspaces(): Promise<Workspace[]>;
     getThreads(workspaceSlug: string): Promise<Thread[]>;
@@ -186,9 +188,13 @@ declare class PortModule {
      */
     getSuggestedPort(): number;
     /**
-     * Check if a port is available
+     * Check if a port is available on a specific host
+     */
+    private isPortAvailableOn;
+    /**
+     * Check if a port is available (checks both IPv4 and IPv6)
      * @param port - Port number to check
-     * @returns Promise resolving to true if port is available
+     * @returns Promise resolving to true if port is available on ALL interfaces
      */
     isPortAvailable(port: number): Promise<boolean>;
     /**

package/dist/index.js

@@ -170,29 +170,44 @@ var WebhookModule = class {
 
 // src/modules/api.ts
 var ApiModule = class {
-  constructor(realtimexUrl) {
+  constructor(realtimexUrl, appId) {
     this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+    this.appId = appId;
+  }
+  getHeaders() {
+    return {
+      "Content-Type": "application/json",
+      "x-app-id": this.appId
+    };
   }
   async getAgents() {
-    const response = await fetch(`${this.realtimexUrl}/agents`);
+    const response = await fetch(`${this.realtimexUrl}/agents`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get agents");
     return data.agents;
   }
   async getWorkspaces() {
-    const response = await fetch(`${this.realtimexUrl}/workspaces`);
+    const response = await fetch(`${this.realtimexUrl}/workspaces`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get workspaces");
     return data.workspaces;
   }
   async getThreads(workspaceSlug) {
-    const response = await fetch(`${this.realtimexUrl}/workspaces/${encodeURIComponent(workspaceSlug)}/threads`);
+    const response = await fetch(`${this.realtimexUrl}/workspaces/${encodeURIComponent(workspaceSlug)}/threads`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get threads");
     return data.threads;
   }
   async getTask(taskUuid) {
-    const response = await fetch(`${this.realtimexUrl}/task/${encodeURIComponent(taskUuid)}`);
+    const response = await fetch(`${this.realtimexUrl}/task/${encodeURIComponent(taskUuid)}`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get task");
     return { ...data.task, runs: data.runs };
@@ -258,11 +273,9 @@ var PortModule = class {
     return envPort ? parseInt(envPort, 10) : this.defaultPort;
   }
   /**
-   * Check if a port is available
-   * @param port - Port number to check
-   * @returns Promise resolving to true if port is available
+   * Check if a port is available on a specific host
    */
-  async isPortAvailable(port) {
+  async isPortAvailableOn(port, host) {
     return new Promise((resolve) => {
       const server = net.createServer();
       server.once("error", () => resolve(false));
@@ -270,9 +283,22 @@ var PortModule = class {
         server.close();
         resolve(true);
       });
-      server.listen(port, "127.0.0.1");
+      server.listen(port, host);
     });
   }
+  /**
+   * Check if a port is available (checks both IPv4 and IPv6)
+   * @param port - Port number to check
+   * @returns Promise resolving to true if port is available on ALL interfaces
+   */
+  async isPortAvailable(port) {
+    const ipv4Available = await this.isPortAvailableOn(port, "127.0.0.1");
+    if (!ipv4Available) return false;
+    const ipv6Available = await this.isPortAvailableOn(port, "::1");
+    if (!ipv6Available) return false;
+    const allInterfacesAvailable = await this.isPortAvailableOn(port, "0.0.0.0");
+    return allInterfacesAvailable;
+  }
   /**
    * Find an available port starting from the suggested port
    * @param startPort - Starting port number (default: RTX_PORT or defaultPort)
@@ -320,7 +346,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     const realtimexUrl = config.realtimex?.url || _RealtimeXSDK.DEFAULT_REALTIMEX_URL;
     this.activities = new ActivitiesModule(realtimexUrl, this.appId);
     this.webhook = new WebhookModule(realtimexUrl, this.appName, this.appId);
-    this.api = new ApiModule(realtimexUrl);
+    this.api = new ApiModule(realtimexUrl, this.appId);
     this.task = new TaskModule(realtimexUrl, this.appName, this.appId);
     this.port = new PortModule(config.defaultPort);
   }

package/dist/index.mjs

@@ -129,29 +129,44 @@ var WebhookModule = class {
 
 // src/modules/api.ts
 var ApiModule = class {
-  constructor(realtimexUrl) {
+  constructor(realtimexUrl, appId) {
     this.realtimexUrl = realtimexUrl.replace(/\/$/, "");
+    this.appId = appId;
+  }
+  getHeaders() {
+    return {
+      "Content-Type": "application/json",
+      "x-app-id": this.appId
+    };
   }
   async getAgents() {
-    const response = await fetch(`${this.realtimexUrl}/agents`);
+    const response = await fetch(`${this.realtimexUrl}/agents`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get agents");
     return data.agents;
   }
   async getWorkspaces() {
-    const response = await fetch(`${this.realtimexUrl}/workspaces`);
+    const response = await fetch(`${this.realtimexUrl}/workspaces`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get workspaces");
     return data.workspaces;
   }
   async getThreads(workspaceSlug) {
-    const response = await fetch(`${this.realtimexUrl}/workspaces/${encodeURIComponent(workspaceSlug)}/threads`);
+    const response = await fetch(`${this.realtimexUrl}/workspaces/${encodeURIComponent(workspaceSlug)}/threads`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get threads");
     return data.threads;
   }
   async getTask(taskUuid) {
-    const response = await fetch(`${this.realtimexUrl}/task/${encodeURIComponent(taskUuid)}`);
+    const response = await fetch(`${this.realtimexUrl}/task/${encodeURIComponent(taskUuid)}`, {
+      headers: this.getHeaders()
+    });
     const data = await response.json();
     if (!response.ok) throw new Error(data.error || "Failed to get task");
     return { ...data.task, runs: data.runs };
@@ -217,11 +232,9 @@ var PortModule = class {
     return envPort ? parseInt(envPort, 10) : this.defaultPort;
   }
   /**
-   * Check if a port is available
-   * @param port - Port number to check
-   * @returns Promise resolving to true if port is available
+   * Check if a port is available on a specific host
    */
-  async isPortAvailable(port) {
+  async isPortAvailableOn(port, host) {
     return new Promise((resolve) => {
       const server = net.createServer();
       server.once("error", () => resolve(false));
@@ -229,9 +242,22 @@ var PortModule = class {
         server.close();
         resolve(true);
       });
-      server.listen(port, "127.0.0.1");
+      server.listen(port, host);
     });
   }
+  /**
+   * Check if a port is available (checks both IPv4 and IPv6)
+   * @param port - Port number to check
+   * @returns Promise resolving to true if port is available on ALL interfaces
+   */
+  async isPortAvailable(port) {
+    const ipv4Available = await this.isPortAvailableOn(port, "127.0.0.1");
+    if (!ipv4Available) return false;
+    const ipv6Available = await this.isPortAvailableOn(port, "::1");
+    if (!ipv6Available) return false;
+    const allInterfacesAvailable = await this.isPortAvailableOn(port, "0.0.0.0");
+    return allInterfacesAvailable;
+  }
   /**
    * Find an available port starting from the suggested port
    * @param startPort - Starting port number (default: RTX_PORT or defaultPort)
@@ -279,7 +305,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     const realtimexUrl = config.realtimex?.url || _RealtimeXSDK.DEFAULT_REALTIMEX_URL;
     this.activities = new ActivitiesModule(realtimexUrl, this.appId);
     this.webhook = new WebhookModule(realtimexUrl, this.appName, this.appId);
-    this.api = new ApiModule(realtimexUrl);
+    this.api = new ApiModule(realtimexUrl, this.appId);
     this.task = new TaskModule(realtimexUrl, this.appName, this.appId);
     this.port = new PortModule(config.defaultPort);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.0.6",
+    "version": "1.0.8",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -40,4 +40,4 @@
     "engines": {
         "node": ">=18.0.0"
     }
-}
+}