clutch-hub-sdk-js 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## [1.3.0](https://github.com/clutch-protocol/clutch-hub-sdk-js/compare/v1.2.0...v1.3.0) (2025-08-23)
+
+
+### Features
+
+* **sdk:** add getPublicKey and isAuthenticated utility methods ([c0ac16e](https://github.com/clutch-protocol/clutch-hub-sdk-js/commit/c0ac16e1166cf9d6e4bcb5ae8cc37a17d6ae7028))
+
+
+### Bug Fixes
+
+* **auth:** add buffer time to prevent token expiration race conditions ([29b3b53](https://github.com/clutch-protocol/clutch-hub-sdk-js/commit/29b3b538dc260c34d80814da4723a5d13a140a48))
+
+
+### Performance Improvements
+
+* **sdk:** optimize float64ToUint64 conversion with cached buffers ([43a76b9](https://github.com/clutch-protocol/clutch-hub-sdk-js/commit/43a76b91cd05b737a5942a381653419816656fdd))
+
 ## [1.2.0](https://github.com/clutch-protocol/clutch-hub-sdk-js/compare/v1.1.0...v1.2.0) (2025-08-23)
 
 

package/dist/sdk.d.ts

@@ -23,6 +23,16 @@ export declare class ClutchHubSdk {
     private token;
     private tokenExpireTime;
     constructor(apiUrl: string, publicKey: string);
+    /**
+     * Get the current public key associated with this SDK instance.
+     * @returns The public key string
+     */
+    getPublicKey(): string;
+    /**
+     * Check if the SDK is currently authenticated.
+     * @returns True if authenticated and token is not expired
+     */
+    isAuthenticated(): boolean;
     private get authHeaders();
     private executeGraphQL;
     private ensureAuth;
@@ -50,6 +60,9 @@ export declare class ClutchHubSdk {
     private encodeFunctionCall;
     /**
      * Converts a JavaScript number to uint64 bits as BigInt.
+     * Uses cached ArrayBuffer and DataView for better performance.
      */
+    private static readonly floatBuffer;
+    private static readonly floatView;
     private float64ToUint64;
 }

package/dist/sdk.js

@@ -17,6 +17,22 @@ export class ClutchHubSdk {
         this.apiClient = axios.create({ baseURL: apiUrl });
         this.publicKey = publicKey;
     }
+    /**
+     * Get the current public key associated with this SDK instance.
+     * @returns The public key string
+     */
+    getPublicKey() {
+        return this.publicKey;
+    }
+    /**
+     * Check if the SDK is currently authenticated.
+     * @returns True if authenticated and token is not expired
+     */
+    isAuthenticated() {
+        const now = Date.now();
+        const bufferTime = 30000; // 30 seconds
+        return !!(this.token && now < (this.tokenExpireTime - bufferTime));
+    }
     get authHeaders() {
         return this.token ? { Authorization: `Bearer ${this.token}` } : {};
     }
@@ -32,7 +48,9 @@ export class ClutchHubSdk {
     }
     async ensureAuth() {
         const now = Date.now();
-        if (!this.token || now >= this.tokenExpireTime) {
+        // Add buffer time to prevent race conditions near token expiration
+        const bufferTime = 30000; // 30 seconds
+        if (!this.token || now >= (this.tokenExpireTime - bufferTime)) {
             const query = `
         mutation GenerateToken($publicKey: String!) {
           generateToken(publicKey: $publicKey) {
@@ -168,15 +186,16 @@ export class ClutchHubSdk {
                 throw new Error(`Unsupported FunctionCall type: ${type}`);
         }
     }
-    /**
-     * Converts a JavaScript number to uint64 bits as BigInt.
-     */
     float64ToUint64(value) {
-        const buffer = new ArrayBuffer(8);
-        const view = new DataView(buffer);
-        view.setFloat64(0, value, false);
-        const high = BigInt(view.getUint32(0, false));
-        const low = BigInt(view.getUint32(4, false));
+        ClutchHubSdk.floatView.setFloat64(0, value, false);
+        const high = BigInt(ClutchHubSdk.floatView.getUint32(0, false));
+        const low = BigInt(ClutchHubSdk.floatView.getUint32(4, false));
         return (high << BigInt(32)) | low;
     }
 }
+/**
+ * Converts a JavaScript number to uint64 bits as BigInt.
+ * Uses cached ArrayBuffer and DataView for better performance.
+ */
+ClutchHubSdk.floatBuffer = new ArrayBuffer(8);
+ClutchHubSdk.floatView = new DataView(ClutchHubSdk.floatBuffer);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clutch-hub-sdk-js",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "JavaScript SDK for interacting with the clutch-hub-api",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/sdk.ts

@@ -37,6 +37,24 @@ export class ClutchHubSdk {
     this.publicKey = publicKey;
   }
 
+  /**
+   * Get the current public key associated with this SDK instance.
+   * @returns The public key string
+   */
+  public getPublicKey(): string {
+    return this.publicKey;
+  }
+
+  /**
+   * Check if the SDK is currently authenticated.
+   * @returns True if authenticated and token is not expired
+   */
+  public isAuthenticated(): boolean {
+    const now = Date.now();
+    const bufferTime = 30000; // 30 seconds
+    return !!(this.token && now < (this.tokenExpireTime - bufferTime));
+  }
+
   private get authHeaders(): Record<string, string> {
     return this.token ? { Authorization: `Bearer ${this.token}` } : {};
   }
@@ -58,7 +76,9 @@ export class ClutchHubSdk {
 
   private async ensureAuth(): Promise<void> {
     const now = Date.now();
-    if (!this.token || now >= this.tokenExpireTime) {
+    // Add buffer time to prevent race conditions near token expiration
+    const bufferTime = 30000; // 30 seconds
+    if (!this.token || now >= (this.tokenExpireTime - bufferTime)) {
       const query = `
         mutation GenerateToken($publicKey: String!) {
           generateToken(publicKey: $publicKey) {
@@ -223,13 +243,15 @@ export class ClutchHubSdk {
 
   /**
    * Converts a JavaScript number to uint64 bits as BigInt.
+   * Uses cached ArrayBuffer and DataView for better performance.
    */
+  private static readonly floatBuffer = new ArrayBuffer(8);
+  private static readonly floatView = new DataView(ClutchHubSdk.floatBuffer);
+  
   private float64ToUint64(value: number): bigint {
-    const buffer = new ArrayBuffer(8);
-    const view = new DataView(buffer);
-    view.setFloat64(0, value, false);
-    const high = BigInt(view.getUint32(0, false));
-    const low = BigInt(view.getUint32(4, false));
+    ClutchHubSdk.floatView.setFloat64(0, value, false);
+    const high = BigInt(ClutchHubSdk.floatView.getUint32(0, false));
+    const low = BigInt(ClutchHubSdk.floatView.getUint32(4, false));
     return (high << BigInt(32)) | low;
   }
 }