@debros/network-ts-sdk 0.2.5 → 0.3.2

package/dist/index.js

@@ -34,14 +34,6 @@ var HttpClient = class {
   }
   setApiKey(apiKey) {
     this.apiKey = apiKey;
-    if (typeof console !== "undefined") {
-      console.log(
-        "[HttpClient] API key set:",
-        !!apiKey,
-        "JWT still present:",
-        !!this.jwt
-      );
-    }
   }
   setJwt(jwt) {
     this.jwt = jwt;
@@ -59,12 +51,21 @@ var HttpClient = class {
     const isDbOperation = path.includes("/v1/rqlite/");
     const isPubSubOperation = path.includes("/v1/pubsub/");
     const isProxyOperation = path.includes("/v1/proxy/");
-    if (isDbOperation || isPubSubOperation || isProxyOperation) {
+    const isCacheOperation = path.includes("/v1/cache/");
+    const isAuthOperation = path.includes("/v1/auth/");
+    if (isDbOperation || isPubSubOperation || isProxyOperation || isCacheOperation) {
       if (this.apiKey) {
         headers["X-API-Key"] = this.apiKey;
       } else if (this.jwt) {
         headers["Authorization"] = `Bearer ${this.jwt}`;
       }
+    } else if (isAuthOperation) {
+      if (this.apiKey) {
+        headers["X-API-Key"] = this.apiKey;
+      }
+      if (this.jwt) {
+        headers["Authorization"] = `Bearer ${this.jwt}`;
+      }
     } else {
       if (this.jwt) {
         headers["Authorization"] = `Bearer ${this.jwt}`;
@@ -82,6 +83,7 @@ var HttpClient = class {
     return this.apiKey;
   }
   async request(method, path, options = {}) {
+    const startTime = performance.now();
     const url = new URL(this.baseURL + path);
     if (options.query) {
       Object.entries(options.query).forEach(([key, value]) => {
@@ -93,14 +95,6 @@ var HttpClient = class {
       ...this.getAuthHeaders(path),
       ...options.headers
     };
-    if (typeof console !== "undefined" && (path.includes("/db/") || path.includes("/query") || path.includes("/auth/") || path.includes("/pubsub/") || path.includes("/proxy/"))) {
-      console.log("[HttpClient] Request headers for", path, {
-        hasAuth: !!headers["Authorization"],
-        hasApiKey: !!headers["X-API-Key"],
-        authPrefix: headers["Authorization"] ? headers["Authorization"].substring(0, 20) : "none",
-        apiKeyPrefix: headers["X-API-Key"] ? headers["X-API-Key"].substring(0, 20) : "none"
-      });
-    }
     const controller = new AbortController();
     const requestTimeout = options.timeout ?? this.timeout;
     const timeoutId = setTimeout(() => controller.abort(), requestTimeout);
@@ -112,13 +106,86 @@ var HttpClient = class {
     if (options.body !== void 0) {
       fetchOptions.body = JSON.stringify(options.body);
     }
+    const isRqliteOperation = path.includes("/v1/rqlite/");
+    let queryDetails = null;
+    if (isRqliteOperation && options.body) {
+      try {
+        const body = typeof options.body === "string" ? JSON.parse(options.body) : options.body;
+        if (body.sql) {
+          queryDetails = `SQL: ${body.sql}`;
+          if (body.args && body.args.length > 0) {
+            queryDetails += ` | Args: [${body.args.map((a) => typeof a === "string" ? `"${a}"` : a).join(", ")}]`;
+          }
+        } else if (body.table) {
+          queryDetails = `Table: ${body.table}`;
+          if (body.criteria && Object.keys(body.criteria).length > 0) {
+            queryDetails += ` | Criteria: ${JSON.stringify(body.criteria)}`;
+          }
+          if (body.options) {
+            queryDetails += ` | Options: ${JSON.stringify(body.options)}`;
+          }
+          if (body.select) {
+            queryDetails += ` | Select: ${JSON.stringify(body.select)}`;
+          }
+          if (body.where) {
+            queryDetails += ` | Where: ${JSON.stringify(body.where)}`;
+          }
+          if (body.limit) {
+            queryDetails += ` | Limit: ${body.limit}`;
+          }
+          if (body.offset) {
+            queryDetails += ` | Offset: ${body.offset}`;
+          }
+        }
+      } catch (e) {
+      }
+    }
     try {
-      return await this.requestWithRetry(url.toString(), fetchOptions);
+      const result = await this.requestWithRetry(
+        url.toString(),
+        fetchOptions,
+        0,
+        startTime
+      );
+      const duration = performance.now() - startTime;
+      if (typeof console !== "undefined") {
+        const logMessage = `[HttpClient] ${method} ${path} completed in ${duration.toFixed(
+          2
+        )}ms`;
+        if (queryDetails) {
+          console.log(logMessage);
+          console.log(`[HttpClient]   ${queryDetails}`);
+        } else {
+          console.log(logMessage);
+        }
+      }
+      return result;
+    } catch (error) {
+      const duration = performance.now() - startTime;
+      if (typeof console !== "undefined") {
+        const is404FindOne = path === "/v1/rqlite/find-one" && error instanceof SDKError && error.httpStatus === 404;
+        if (is404FindOne) {
+          console.warn(
+            `[HttpClient] ${method} ${path} returned 404 after ${duration.toFixed(
+              2
+            )}ms (expected for optional lookups)`
+          );
+        } else {
+          const errorMessage = `[HttpClient] ${method} ${path} failed after ${duration.toFixed(
+            2
+          )}ms:`;
+          console.error(errorMessage, error);
+          if (queryDetails) {
+            console.error(`[HttpClient]   ${queryDetails}`);
+          }
+        }
+      }
+      throw error;
     } finally {
       clearTimeout(timeoutId);
     }
   }
-  async requestWithRetry(url, options, attempt = 0) {
+  async requestWithRetry(url, options, attempt = 0, startTime) {
     try {
       const response = await this.fetch(url, options);
       if (!response.ok) {
@@ -140,7 +207,7 @@ var HttpClient = class {
         await new Promise(
           (resolve) => setTimeout(resolve, this.retryDelayMs * (attempt + 1))
         );
-        return this.requestWithRetry(url, options, attempt + 1);
+        return this.requestWithRetry(url, options, attempt + 1, startTime);
       }
       throw error;
     }
@@ -157,6 +224,90 @@ var HttpClient = class {
   async delete(path, options) {
     return this.request("DELETE", path, options);
   }
+  /**
+   * Upload a file using multipart/form-data
+   * This is a special method for file uploads that bypasses JSON serialization
+   */
+  async uploadFile(path, formData, options) {
+    const startTime = performance.now();
+    const url = new URL(this.baseURL + path);
+    const headers = {
+      ...this.getAuthHeaders(path)
+      // Don't set Content-Type - browser will set it with boundary
+    };
+    const controller = new AbortController();
+    const requestTimeout = options?.timeout ?? this.timeout * 5;
+    const timeoutId = setTimeout(() => controller.abort(), requestTimeout);
+    const fetchOptions = {
+      method: "POST",
+      headers,
+      body: formData,
+      signal: controller.signal
+    };
+    try {
+      const result = await this.requestWithRetry(
+        url.toString(),
+        fetchOptions,
+        0,
+        startTime
+      );
+      const duration = performance.now() - startTime;
+      if (typeof console !== "undefined") {
+        console.log(
+          `[HttpClient] POST ${path} (upload) completed in ${duration.toFixed(
+            2
+          )}ms`
+        );
+      }
+      return result;
+    } catch (error) {
+      const duration = performance.now() - startTime;
+      if (typeof console !== "undefined") {
+        console.error(
+          `[HttpClient] POST ${path} (upload) failed after ${duration.toFixed(
+            2
+          )}ms:`,
+          error
+        );
+      }
+      throw error;
+    } finally {
+      clearTimeout(timeoutId);
+    }
+  }
+  /**
+   * Get a binary response (returns Response object for streaming)
+   */
+  async getBinary(path) {
+    const url = new URL(this.baseURL + path);
+    const headers = {
+      ...this.getAuthHeaders(path)
+    };
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout * 5);
+    const fetchOptions = {
+      method: "GET",
+      headers,
+      signal: controller.signal
+    };
+    try {
+      const response = await this.fetch(url.toString(), fetchOptions);
+      if (!response.ok) {
+        clearTimeout(timeoutId);
+        const error = await response.json().catch(() => ({
+          error: response.statusText
+        }));
+        throw SDKError.fromResponse(response.status, error);
+      }
+      return response;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof SDKError) {
+        throw error;
+      }
+      throw error;
+    }
+  }
   getToken() {
     return this.getAuthToken();
   }
@@ -522,7 +673,9 @@ var Repository = class {
   buildInsertSql(entity) {
     const columns = Object.keys(entity).filter((k) => entity[k] !== void 0);
     const placeholders = columns.map(() => "?").join(", ");
-    return `INSERT INTO ${this.tableName} (${columns.join(", ")}) VALUES (${placeholders})`;
+    return `INSERT INTO ${this.tableName} (${columns.join(
+      ", "
+    )}) VALUES (${placeholders})`;
   }
   buildInsertArgs(entity) {
     return Object.entries(entity).filter(([, v]) => v !== void 0).map(([, v]) => v);
@@ -1062,6 +1215,293 @@ var NetworkClient = class {
   }
 };
 
+// src/cache/client.ts
+var CacheClient = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  /**
+   * Check cache service health
+   */
+  async health() {
+    return this.httpClient.get("/v1/cache/health");
+  }
+  /**
+   * Get a value from cache
+   * Returns null if the key is not found (cache miss/expired), which is normal behavior
+   */
+  async get(dmap, key) {
+    try {
+      return await this.httpClient.post("/v1/cache/get", {
+        dmap,
+        key
+      });
+    } catch (error) {
+      if (error instanceof SDKError && (error.httpStatus === 404 || error.httpStatus === 500 && error.message?.toLowerCase().includes("key not found"))) {
+        return null;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Put a value into cache
+   */
+  async put(dmap, key, value, ttl) {
+    return this.httpClient.post("/v1/cache/put", {
+      dmap,
+      key,
+      value,
+      ttl
+    });
+  }
+  /**
+   * Delete a value from cache
+   */
+  async delete(dmap, key) {
+    return this.httpClient.post("/v1/cache/delete", {
+      dmap,
+      key
+    });
+  }
+  /**
+   * Get multiple values from cache in a single request
+   * Returns a map of key -> value (or null if not found)
+   * Gracefully handles 404 errors (endpoint not implemented) by returning empty results
+   */
+  async multiGet(dmap, keys) {
+    try {
+      if (keys.length === 0) {
+        return /* @__PURE__ */ new Map();
+      }
+      const response = await this.httpClient.post(
+        "/v1/cache/mget",
+        {
+          dmap,
+          keys
+        }
+      );
+      const resultMap = /* @__PURE__ */ new Map();
+      keys.forEach((key) => {
+        resultMap.set(key, null);
+      });
+      if (response.results) {
+        response.results.forEach(({ key, value }) => {
+          resultMap.set(key, value);
+        });
+      }
+      return resultMap;
+    } catch (error) {
+      if (error instanceof SDKError && error.httpStatus === 404) {
+        const resultMap2 = /* @__PURE__ */ new Map();
+        keys.forEach((key) => {
+          resultMap2.set(key, null);
+        });
+        return resultMap2;
+      }
+      const resultMap = /* @__PURE__ */ new Map();
+      keys.forEach((key) => {
+        resultMap.set(key, null);
+      });
+      console.error(`[CacheClient] Error in multiGet for ${dmap}:`, error);
+      return resultMap;
+    }
+  }
+  /**
+   * Scan keys in a distributed map, optionally matching a regex pattern
+   */
+  async scan(dmap, match) {
+    return this.httpClient.post("/v1/cache/scan", {
+      dmap,
+      match
+    });
+  }
+};
+
+// src/storage/client.ts
+var StorageClient = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  /**
+   * Upload content to IPFS and optionally pin it.
+   * Supports both File objects (browser) and Buffer/ReadableStream (Node.js).
+   *
+   * @param file - File to upload (File, Blob, or Buffer)
+   * @param name - Optional filename
+   * @param options - Optional upload options
+   * @param options.pin - Whether to pin the content (default: true). Pinning happens asynchronously on the backend.
+   * @returns Upload result with CID
+   *
+   * @example
+   * ```ts
+   * // Browser
+   * const fileInput = document.querySelector('input[type="file"]');
+   * const file = fileInput.files[0];
+   * const result = await client.storage.upload(file, file.name);
+   * console.log(result.cid);
+   *
+   * // Node.js
+   * const fs = require('fs');
+   * const fileBuffer = fs.readFileSync('image.jpg');
+   * const result = await client.storage.upload(fileBuffer, 'image.jpg', { pin: true });
+   * ```
+   */
+  async upload(file, name, options) {
+    const formData = new FormData();
+    if (file instanceof File) {
+      formData.append("file", file);
+    } else if (file instanceof Blob) {
+      formData.append("file", file, name);
+    } else if (file instanceof ArrayBuffer) {
+      const blob = new Blob([file]);
+      formData.append("file", blob, name);
+    } else if (file instanceof Uint8Array) {
+      const buffer = file.buffer.slice(
+        file.byteOffset,
+        file.byteOffset + file.byteLength
+      );
+      const blob = new Blob([buffer], { type: "application/octet-stream" });
+      formData.append("file", blob, name);
+    } else if (file instanceof ReadableStream) {
+      const chunks = [];
+      const reader = file.getReader();
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        const buffer = value.buffer.slice(
+          value.byteOffset,
+          value.byteOffset + value.byteLength
+        );
+        chunks.push(buffer);
+      }
+      const blob = new Blob(chunks);
+      formData.append("file", blob, name);
+    } else {
+      throw new Error(
+        "Unsupported file type. Use File, Blob, ArrayBuffer, Uint8Array, or ReadableStream."
+      );
+    }
+    const shouldPin = options?.pin !== false;
+    formData.append("pin", shouldPin ? "true" : "false");
+    return this.httpClient.uploadFile(
+      "/v1/storage/upload",
+      formData,
+      { timeout: 3e5 }
+      // 5 minute timeout for large files
+    );
+  }
+  /**
+   * Pin an existing CID
+   *
+   * @param cid - Content ID to pin
+   * @param name - Optional name for the pin
+   * @returns Pin result
+   */
+  async pin(cid, name) {
+    return this.httpClient.post("/v1/storage/pin", {
+      cid,
+      name
+    });
+  }
+  /**
+   * Get the pin status for a CID
+   *
+   * @param cid - Content ID to check
+   * @returns Pin status information
+   */
+  async status(cid) {
+    return this.httpClient.get(`/v1/storage/status/${cid}`);
+  }
+  /**
+   * Retrieve content from IPFS by CID
+   *
+   * @param cid - Content ID to retrieve
+   * @returns ReadableStream of the content
+   *
+   * @example
+   * ```ts
+   * const stream = await client.storage.get(cid);
+   * const reader = stream.getReader();
+   * while (true) {
+   *   const { done, value } = await reader.read();
+   *   if (done) break;
+   *   // Process chunk
+   * }
+   * ```
+   */
+  async get(cid) {
+    const maxAttempts = 8;
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        const response = await this.httpClient.getBinary(
+          `/v1/storage/get/${cid}`
+        );
+        if (!response.body) {
+          throw new Error("Response body is null");
+        }
+        return response.body;
+      } catch (error) {
+        lastError = error;
+        const isNotFound = error?.httpStatus === 404 || error?.message?.includes("not found") || error?.message?.includes("404");
+        if (!isNotFound || attempt === maxAttempts) {
+          throw error;
+        }
+        const backoffMs = attempt * 2500;
+        await new Promise((resolve) => setTimeout(resolve, backoffMs));
+      }
+    }
+    throw lastError || new Error("Failed to retrieve content");
+  }
+  /**
+   * Retrieve content from IPFS by CID and return the full Response object
+   * Useful when you need access to response headers (e.g., content-length)
+   *
+   * @param cid - Content ID to retrieve
+   * @returns Response object with body stream and headers
+   *
+   * @example
+   * ```ts
+   * const response = await client.storage.getBinary(cid);
+   * const contentLength = response.headers.get('content-length');
+   * const reader = response.body.getReader();
+   * // ... read stream
+   * ```
+   */
+  async getBinary(cid) {
+    const maxAttempts = 8;
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        const response = await this.httpClient.getBinary(
+          `/v1/storage/get/${cid}`
+        );
+        if (!response) {
+          throw new Error("Response is null");
+        }
+        return response;
+      } catch (error) {
+        lastError = error;
+        const isNotFound = error?.httpStatus === 404 || error?.message?.includes("not found") || error?.message?.includes("404");
+        if (!isNotFound || attempt === maxAttempts) {
+          throw error;
+        }
+        const backoffMs = attempt * 2500;
+        await new Promise((resolve) => setTimeout(resolve, backoffMs));
+      }
+    }
+    throw lastError || new Error("Failed to retrieve content");
+  }
+  /**
+   * Unpin a CID
+   *
+   * @param cid - Content ID to unpin
+   */
+  async unpin(cid) {
+    await this.httpClient.delete(`/v1/storage/unpin/${cid}`);
+  }
+};
+
 // src/index.ts
 function createClient(config) {
   const httpClient = new HttpClient({
@@ -1084,15 +1524,20 @@ function createClient(config) {
     wsURL
   });
   const network = new NetworkClient(httpClient);
+  const cache = new CacheClient(httpClient);
+  const storage = new StorageClient(httpClient);
   return {
     auth,
     db,
     pubsub,
-    network
+    network,
+    cache,
+    storage
   };
 }
 export {
   AuthClient,
+  CacheClient,
   DBClient,
   HttpClient,
   LocalStorageAdapter,
@@ -1102,6 +1547,7 @@ export {
   QueryBuilder,
   Repository,
   SDKError,
+  StorageClient,
   Subscription,
   WSClient,
   createClient