@debros/network-ts-sdk 0.3.4 → 0.4.3

package/dist/index.js

@@ -40,6 +40,13 @@ var HttpClient = class {
     this.maxRetries = config.maxRetries ?? 3;
     this.retryDelayMs = config.retryDelayMs ?? 1e3;
     this.fetch = config.fetch ?? createFetchWithTLSConfig();
+    this.onNetworkError = config.onNetworkError;
+  }
+  /**
+   * Set the network error callback
+   */
+  setOnNetworkError(callback) {
+    this.onNetworkError = callback;
   }
   setApiKey(apiKey) {
     this.apiKey = apiKey;
@@ -91,6 +98,12 @@ var HttpClient = class {
   getApiKey() {
     return this.apiKey;
   }
+  /**
+   * Get the base URL
+   */
+  getBaseURL() {
+    return this.baseURL;
+  }
   async request(method, path, options = {}) {
     const startTime = performance.now();
     const url = new URL(this.baseURL + path);
@@ -189,6 +202,21 @@ var HttpClient = class {
           }
         }
       }
+      if (this.onNetworkError) {
+        const sdkError = error instanceof SDKError ? error : new SDKError(
+          error instanceof Error ? error.message : String(error),
+          0,
+          // httpStatus 0 indicates network-level failure
+          "NETWORK_ERROR"
+        );
+        this.onNetworkError(sdkError, {
+          method,
+          path,
+          isRetry: false,
+          attempt: this.maxRetries
+          // All retries exhausted
+        });
+      }
       throw error;
     } finally {
       clearTimeout(timeoutId);
@@ -212,7 +240,13 @@ var HttpClient = class {
       }
       return response.text();
     } catch (error) {
-      if (error instanceof SDKError && attempt < this.maxRetries && [408, 429, 500, 502, 503, 504].includes(error.httpStatus)) {
+      const isRetryableError = error instanceof SDKError && [408, 429, 500, 502, 503, 504].includes(error.httpStatus);
+      if (isRetryableError && attempt < this.maxRetries) {
+        if (typeof console !== "undefined") {
+          console.warn(
+            `[HttpClient] Retrying request (attempt ${attempt + 1}/${this.maxRetries})`
+          );
+        }
         await new Promise(
           (resolve) => setTimeout(resolve, this.retryDelayMs * (attempt + 1))
         );
@@ -279,6 +313,19 @@ var HttpClient = class {
           error
         );
       }
+      if (this.onNetworkError) {
+        const sdkError = error instanceof SDKError ? error : new SDKError(
+          error instanceof Error ? error.message : String(error),
+          0,
+          "NETWORK_ERROR"
+        );
+        this.onNetworkError(sdkError, {
+          method: "POST",
+          path,
+          isRetry: false,
+          attempt: this.maxRetries
+        });
+      }
       throw error;
     } finally {
       clearTimeout(timeoutId);
@@ -303,16 +350,26 @@ var HttpClient = class {
       const response = await this.fetch(url.toString(), fetchOptions);
       if (!response.ok) {
         clearTimeout(timeoutId);
-        const error = await response.json().catch(() => ({
+        const errorBody = await response.json().catch(() => ({
           error: response.statusText
         }));
-        throw SDKError.fromResponse(response.status, error);
+        throw SDKError.fromResponse(response.status, errorBody);
       }
       return response;
     } catch (error) {
       clearTimeout(timeoutId);
-      if (error instanceof SDKError) {
-        throw error;
+      if (this.onNetworkError) {
+        const sdkError = error instanceof SDKError ? error : new SDKError(
+          error instanceof Error ? error.message : String(error),
+          0,
+          "NETWORK_ERROR"
+        );
+        this.onNetworkError(sdkError, {
+          method: "GET",
+          path,
+          isRetry: false,
+          attempt: 0
+        });
       }
       throw error;
     }
@@ -798,10 +855,23 @@ var WSClient = class {
     this.closeHandlers = /* @__PURE__ */ new Set();
     this.openHandlers = /* @__PURE__ */ new Set();
     this.isClosed = false;
-    this.url = config.wsURL;
+    this.wsURL = config.wsURL;
     this.timeout = config.timeout ?? 3e4;
     this.authToken = config.authToken;
     this.WebSocketClass = config.WebSocket ?? WebSocket;
+    this.onNetworkError = config.onNetworkError;
+  }
+  /**
+   * Set the network error callback
+   */
+  setOnNetworkError(callback) {
+    this.onNetworkError = callback;
+  }
+  /**
+   * Get the current WebSocket URL
+   */
+  get url() {
+    return this.wsURL;
   }
   /**
    * Connect to WebSocket server
@@ -814,13 +884,20 @@ var WSClient = class {
         this.isClosed = false;
         const timeout = setTimeout(() => {
           this.ws?.close();
-          reject(
-            new SDKError("WebSocket connection timeout", 408, "WS_TIMEOUT")
-          );
+          const error = new SDKError("WebSocket connection timeout", 408, "WS_TIMEOUT");
+          if (this.onNetworkError) {
+            this.onNetworkError(error, {
+              method: "WS",
+              path: this.wsURL,
+              isRetry: false,
+              attempt: 0
+            });
+          }
+          reject(error);
         }, this.timeout);
         this.ws.addEventListener("open", () => {
           clearTimeout(timeout);
-          console.log("[WSClient] Connected to", this.url);
+          console.log("[WSClient] Connected to", this.wsURL);
           this.openHandlers.forEach((handler) => handler());
           resolve();
         });
@@ -832,7 +909,16 @@ var WSClient = class {
           console.error("[WSClient] WebSocket error:", event);
           clearTimeout(timeout);
           const error = new SDKError("WebSocket error", 500, "WS_ERROR", event);
+          if (this.onNetworkError) {
+            this.onNetworkError(error, {
+              method: "WS",
+              path: this.wsURL,
+              isRetry: false,
+              attempt: 0
+            });
+          }
           this.errorHandlers.forEach((handler) => handler(error));
+          reject(error);
         });
         this.ws.addEventListener("close", () => {
           clearTimeout(timeout);
@@ -848,7 +934,7 @@ var WSClient = class {
    * Build WebSocket URL with auth token
    */
   buildWSUrl() {
-    let url = this.url;
+    let url = this.wsURL;
     if (this.authToken) {
       const separator = url.includes("?") ? "&" : "?";
       const paramName = this.authToken.startsWith("ak_") ? "api_key" : "token";
@@ -1009,14 +1095,32 @@ var PubSubClient = class {
     );
     return response.topics || [];
   }
+  /**
+   * Get current presence for a topic without subscribing
+   */
+  async getPresence(topic) {
+    const response = await this.httpClient.get(
+      `/v1/pubsub/presence?topic=${encodeURIComponent(topic)}`
+    );
+    return response;
+  }
   /**
    * Subscribe to a topic via WebSocket
    * Creates one WebSocket connection per topic
    */
-  async subscribe(topic, handlers = {}) {
+  async subscribe(topic, options = {}) {
     const wsUrl = new URL(this.wsConfig.wsURL || "ws://127.0.0.1:6001");
     wsUrl.pathname = "/v1/pubsub/ws";
     wsUrl.searchParams.set("topic", topic);
+    let presence;
+    if (options.presence?.enabled) {
+      presence = options.presence;
+      wsUrl.searchParams.set("presence", "true");
+      wsUrl.searchParams.set("member_id", presence.memberId);
+      if (presence.meta) {
+        wsUrl.searchParams.set("member_meta", JSON.stringify(presence.meta));
+      }
+    }
     const authToken = this.httpClient.getApiKey() ?? this.httpClient.getToken();
     const wsClient = new WSClient({
       ...this.wsConfig,
@@ -1024,21 +1128,26 @@ var PubSubClient = class {
       authToken
     });
     await wsClient.connect();
-    const subscription = new Subscription(wsClient, topic);
-    if (handlers.onMessage) {
-      subscription.onMessage(handlers.onMessage);
+    const subscription = new Subscription(
+      wsClient,
+      topic,
+      presence,
+      () => this.getPresence(topic)
+    );
+    if (options.onMessage) {
+      subscription.onMessage(options.onMessage);
     }
-    if (handlers.onError) {
-      subscription.onError(handlers.onError);
+    if (options.onError) {
+      subscription.onError(options.onError);
     }
-    if (handlers.onClose) {
-      subscription.onClose(handlers.onClose);
+    if (options.onClose) {
+      subscription.onClose(options.onClose);
     }
     return subscription;
   }
 };
 var Subscription = class {
-  constructor(wsClient, topic) {
+  constructor(wsClient, topic, presenceOptions, getPresenceFn) {
     this.messageHandlers = /* @__PURE__ */ new Set();
     this.errorHandlers = /* @__PURE__ */ new Set();
     this.closeHandlers = /* @__PURE__ */ new Set();
@@ -1048,12 +1157,31 @@ var Subscription = class {
     this.wsCloseHandler = null;
     this.wsClient = wsClient;
     this.topic = topic;
+    this.presenceOptions = presenceOptions;
+    this.getPresenceFn = getPresenceFn;
     this.wsMessageHandler = (data) => {
       try {
         const envelope = JSON.parse(data);
         if (!envelope || typeof envelope !== "object") {
           throw new Error("Invalid envelope: not an object");
         }
+        if (envelope.type === "presence.join" || envelope.type === "presence.leave") {
+          if (!envelope.member_id) {
+            console.warn("[Subscription] Presence event missing member_id");
+            return;
+          }
+          const presenceMember = {
+            memberId: envelope.member_id,
+            joinedAt: envelope.timestamp,
+            meta: envelope.meta
+          };
+          if (envelope.type === "presence.join" && this.presenceOptions?.onJoin) {
+            this.presenceOptions.onJoin(presenceMember);
+          } else if (envelope.type === "presence.leave" && this.presenceOptions?.onLeave) {
+            this.presenceOptions.onLeave(presenceMember);
+          }
+          return;
+        }
         if (!envelope.data || typeof envelope.data !== "string") {
           throw new Error("Invalid envelope: missing or invalid data field");
         }
@@ -1090,6 +1218,22 @@ var Subscription = class {
     };
     this.wsClient.onClose(this.wsCloseHandler);
   }
+  /**
+   * Get current presence (requires presence.enabled on subscribe)
+   */
+  async getPresence() {
+    if (!this.presenceOptions?.enabled) {
+      throw new Error("Presence is not enabled for this subscription");
+    }
+    const response = await this.getPresenceFn();
+    return response.members;
+  }
+  /**
+   * Check if presence is enabled for this subscription
+   */
+  hasPresence() {
+    return !!this.presenceOptions?.enabled;
+  }
   /**
    * Register message handler
    */
@@ -1511,6 +1655,38 @@ var StorageClient = class {
   }
 };
 
+// src/functions/client.ts
+var FunctionsClient = class {
+  constructor(httpClient, config) {
+    this.httpClient = httpClient;
+    this.gatewayURL = config?.gatewayURL;
+    this.namespace = config?.namespace ?? "default";
+  }
+  /**
+   * Invoke a serverless function by name
+   * 
+   * @param functionName - Name of the function to invoke
+   * @param input - Input payload for the function
+   * @returns The function response
+   */
+  async invoke(functionName, input) {
+    const url = this.gatewayURL ? `${this.gatewayURL}/v1/invoke/${this.namespace}/${functionName}` : `/v1/invoke/${this.namespace}/${functionName}`;
+    try {
+      const response = await this.httpClient.post(url, input);
+      return response;
+    } catch (error) {
+      if (error instanceof SDKError) {
+        throw error;
+      }
+      throw new SDKError(
+        `Function ${functionName} failed`,
+        500,
+        error instanceof Error ? error.message : String(error)
+      );
+    }
+  }
+};
+
 // src/index.ts
 function createClient(config) {
   const httpClient = new HttpClient({
@@ -1518,7 +1694,8 @@ function createClient(config) {
     timeout: config.timeout,
     maxRetries: config.maxRetries,
     retryDelayMs: config.retryDelayMs,
-    fetch: config.fetch
+    fetch: config.fetch,
+    onNetworkError: config.onNetworkError
   });
   const auth = new AuthClient({
     httpClient,
@@ -1526,28 +1703,32 @@ function createClient(config) {
     apiKey: config.apiKey,
     jwt: config.jwt
   });
-  const wsURL = config.wsConfig?.wsURL ?? config.baseURL.replace(/^http/, "ws").replace(/\/$/, "");
+  const wsURL = config.baseURL.replace(/^http/, "ws").replace(/\/$/, "");
   const db = new DBClient(httpClient);
   const pubsub = new PubSubClient(httpClient, {
     ...config.wsConfig,
-    wsURL
+    wsURL,
+    onNetworkError: config.onNetworkError
   });
   const network = new NetworkClient(httpClient);
   const cache = new CacheClient(httpClient);
   const storage = new StorageClient(httpClient);
+  const functions = new FunctionsClient(httpClient, config.functionsConfig);
   return {
     auth,
     db,
     pubsub,
     network,
     cache,
-    storage
+    storage,
+    functions
   };
 }
 export {
   AuthClient,
   CacheClient,
   DBClient,
+  FunctionsClient,
   HttpClient,
   LocalStorageAdapter,
   MemoryStorage,