@fenelabs/fene-sdk 0.5.0 → 0.7.2

package/dist/index.d.mts

@@ -22,6 +22,10 @@ interface AuthResponse {
     role: "validator" | "delegator";
     expires_at: number;
 }
+interface RefreshResponse {
+    success: boolean;
+    expires_at?: number;
+}
 declare enum ValidatorStatus {
     NOT_EXIST = 0,
     CREATED = 1,
@@ -95,15 +99,13 @@ interface WhitelistCheckResponse {
 }
 interface GeoNode {
     address: string;
-    ip: string;
-    latitude: number;
-    longitude: number;
-    city: string;
+    role: "validator" | "delegator";
+    lat: number;
+    lng: number;
     country: string;
-    country_code: string;
-    last_seen: string;
-    node_type: "validator" | "rpc" | "bootstrap";
+    city?: string;
     online: boolean;
+    last_seen: number;
 }
 interface GeoStats {
     total_nodes: number;
@@ -112,9 +114,51 @@ interface GeoStats {
     cities: number;
 }
 interface GeoUpdateRequest {
+    lat: number;
+    lng: number;
+}
+interface GeoAutoDetectResponse {
+    success: boolean;
+    address: string;
+    role: "validator" | "delegator";
     latitude: number;
     longitude: number;
-    node_type: string;
+    country: string;
+    city: string;
+    is_online: boolean;
+}
+interface UserProfile {
+    address: string;
+    roles: ("validator" | "delegator")[];
+    validator?: ValidatorProfileInfo;
+    delegations?: DelegationInfo[];
+    total_delegation_stake: string;
+    total_pending_rewards: string;
+    avatar_url?: string;
+    geo?: GeoLocation;
+}
+interface ValidatorProfileInfo {
+    address: string;
+    moniker: string;
+    self_stake: string;
+    total_stake: string;
+    commission_rate: number;
+    delegator_count: number;
+    claimable_reward: string;
+    apr: number;
+}
+interface DelegationInfo {
+    validator_address: string;
+    validator_moniker: string;
+    stake_amount: string;
+    pending_rewards: string;
+    apr: number;
+}
+interface GeoLocation {
+    lat: number;
+    lng: number;
+    country: string;
+    city?: string;
 }
 interface NetworkStats {
     total_validators: number;
@@ -255,9 +299,9 @@ declare class ResonanceClient {
     verify(params: AuthVerifyRequest): Promise<AuthResponse>;
     /**
      * Refresh the access token using the refresh token cookie.
-     * Returns true if refresh was successful.
+     * Returns { success: boolean, expires_at?: number }
      */
-    refresh(): Promise<boolean>;
+    refresh(): Promise<RefreshResponse>;
     /**
      * Logout and revoke current session.
      */
@@ -277,10 +321,36 @@ declare class ResonanceClient {
     getReferralKey(key: string): Promise<ReferralKey>;
     getValidatorKeys(address: Address): Promise<ReferralKey[]>;
     checkWhitelist(data: WhitelistCheckRequest): Promise<WhitelistCheckResponse>;
-    getGeoNodes(): Promise<GeoNode[]>;
-    getGeoValidators(): Promise<GeoNode[]>;
+    /**
+     * Get user profile with roles, validator info, delegations, avatar, and geo
+     * @param address The user wallet address
+     */
+    getUserProfile(address: Address): Promise<UserProfile>;
+    /**
+     * Get user avatar URL
+     * @param address The user wallet address
+     */
+    getUserAvatar(address: Address): Promise<{
+        url: string;
+    }>;
+    /**
+     * Upload user avatar
+     * @param address The user wallet address (must match authenticated user)
+     * @param file The image file to upload (png, jpg, or webp)
+     */
+    uploadUserAvatar(address: Address, file: File): Promise<UploadResponse>;
+    /**
+     * Get all geo nodes, optionally filtered by role
+     * @param role Optional filter: "validator" or "delegator"
+     */
+    getGeoNodes(role?: "validator" | "delegator"): Promise<GeoNode[]>;
     getGeoStats(): Promise<GeoStats>;
     updateGeoLocation(data: GeoUpdateRequest): Promise<void>;
+    /**
+     * Auto-detect user geo location from IP and save to server.
+     * Should be called after successful login.
+     */
+    autoDetectGeo(): Promise<GeoAutoDetectResponse>;
     getNetworkStats(): Promise<NetworkStats>;
     getCurrentEpoch(): Promise<EpochInfo>;
     getNetworkAPR(): Promise<NetworkAPR>;
@@ -375,4 +445,4 @@ declare class EventBus {
 }
 declare const eventBus: EventBus;
 
-export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type PriceResponse, type ReferralKey, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type Transaction, type TransactionStats, type TransactionsList, type TransactionsParams, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };
+export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type PriceResponse, type ReferralKey, type RefreshResponse, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type Transaction, type TransactionStats, type TransactionsList, type TransactionsParams, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };

package/dist/index.d.ts

@@ -22,6 +22,10 @@ interface AuthResponse {
     role: "validator" | "delegator";
     expires_at: number;
 }
+interface RefreshResponse {
+    success: boolean;
+    expires_at?: number;
+}
 declare enum ValidatorStatus {
     NOT_EXIST = 0,
     CREATED = 1,
@@ -95,15 +99,13 @@ interface WhitelistCheckResponse {
 }
 interface GeoNode {
     address: string;
-    ip: string;
-    latitude: number;
-    longitude: number;
-    city: string;
+    role: "validator" | "delegator";
+    lat: number;
+    lng: number;
     country: string;
-    country_code: string;
-    last_seen: string;
-    node_type: "validator" | "rpc" | "bootstrap";
+    city?: string;
     online: boolean;
+    last_seen: number;
 }
 interface GeoStats {
     total_nodes: number;
@@ -112,9 +114,51 @@ interface GeoStats {
     cities: number;
 }
 interface GeoUpdateRequest {
+    lat: number;
+    lng: number;
+}
+interface GeoAutoDetectResponse {
+    success: boolean;
+    address: string;
+    role: "validator" | "delegator";
     latitude: number;
     longitude: number;
-    node_type: string;
+    country: string;
+    city: string;
+    is_online: boolean;
+}
+interface UserProfile {
+    address: string;
+    roles: ("validator" | "delegator")[];
+    validator?: ValidatorProfileInfo;
+    delegations?: DelegationInfo[];
+    total_delegation_stake: string;
+    total_pending_rewards: string;
+    avatar_url?: string;
+    geo?: GeoLocation;
+}
+interface ValidatorProfileInfo {
+    address: string;
+    moniker: string;
+    self_stake: string;
+    total_stake: string;
+    commission_rate: number;
+    delegator_count: number;
+    claimable_reward: string;
+    apr: number;
+}
+interface DelegationInfo {
+    validator_address: string;
+    validator_moniker: string;
+    stake_amount: string;
+    pending_rewards: string;
+    apr: number;
+}
+interface GeoLocation {
+    lat: number;
+    lng: number;
+    country: string;
+    city?: string;
 }
 interface NetworkStats {
     total_validators: number;
@@ -255,9 +299,9 @@ declare class ResonanceClient {
     verify(params: AuthVerifyRequest): Promise<AuthResponse>;
     /**
      * Refresh the access token using the refresh token cookie.
-     * Returns true if refresh was successful.
+     * Returns { success: boolean, expires_at?: number }
      */
-    refresh(): Promise<boolean>;
+    refresh(): Promise<RefreshResponse>;
     /**
      * Logout and revoke current session.
      */
@@ -277,10 +321,36 @@ declare class ResonanceClient {
     getReferralKey(key: string): Promise<ReferralKey>;
     getValidatorKeys(address: Address): Promise<ReferralKey[]>;
     checkWhitelist(data: WhitelistCheckRequest): Promise<WhitelistCheckResponse>;
-    getGeoNodes(): Promise<GeoNode[]>;
-    getGeoValidators(): Promise<GeoNode[]>;
+    /**
+     * Get user profile with roles, validator info, delegations, avatar, and geo
+     * @param address The user wallet address
+     */
+    getUserProfile(address: Address): Promise<UserProfile>;
+    /**
+     * Get user avatar URL
+     * @param address The user wallet address
+     */
+    getUserAvatar(address: Address): Promise<{
+        url: string;
+    }>;
+    /**
+     * Upload user avatar
+     * @param address The user wallet address (must match authenticated user)
+     * @param file The image file to upload (png, jpg, or webp)
+     */
+    uploadUserAvatar(address: Address, file: File): Promise<UploadResponse>;
+    /**
+     * Get all geo nodes, optionally filtered by role
+     * @param role Optional filter: "validator" or "delegator"
+     */
+    getGeoNodes(role?: "validator" | "delegator"): Promise<GeoNode[]>;
     getGeoStats(): Promise<GeoStats>;
     updateGeoLocation(data: GeoUpdateRequest): Promise<void>;
+    /**
+     * Auto-detect user geo location from IP and save to server.
+     * Should be called after successful login.
+     */
+    autoDetectGeo(): Promise<GeoAutoDetectResponse>;
     getNetworkStats(): Promise<NetworkStats>;
     getCurrentEpoch(): Promise<EpochInfo>;
     getNetworkAPR(): Promise<NetworkAPR>;
@@ -375,4 +445,4 @@ declare class EventBus {
 }
 declare const eventBus: EventBus;
 
-export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type PriceResponse, type ReferralKey, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type Transaction, type TransactionStats, type TransactionsList, type TransactionsParams, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };
+export { type APIErrorResponse, type Address, type AuthResponse, type AuthVerifyRequest, type AvatarResponse, type DailyBlockStats, type Delegator, type DelegatorRewards, type DelegatorStake, DelegatorStatus, type EpochInfo, ErrorCode, type ErrorCodeType, type GeoNode, type GeoStats, type GeoUpdateRequest, type NetworkAPR, type NetworkStats, type NonceResponse, type PaginatedResponse, type PriceResponse, type ReferralKey, type RefreshResponse, type RequestContext, ResonanceClient, type ResonanceClientConfig, ResonanceError, type ResponseContext, type RewardHistory, type Transaction, type TransactionStats, type TransactionsList, type TransactionsParams, type UploadResponse, type Validator, type ValidatorAPR, ValidatorStatus, type ValidatorSummary, type WhitelistCheckRequest, type WhitelistCheckResponse, createResonanceClient, eventBus, hasErrorCode, isAuthError, isNetworkError, isNotFoundError, isResonanceError };

package/dist/index.js

@@ -349,7 +349,7 @@ var ResonanceClient = class {
   }
   /**
    * Refresh the access token using the refresh token cookie.
-   * Returns true if refresh was successful.
+   * Returns { success: boolean, expires_at?: number }
    */
   async refresh() {
     try {
@@ -361,11 +361,14 @@ var ResonanceClient = class {
       });
       if (response.ok) {
         const data = await response.json();
-        return data.success === true;
+        return {
+          success: data.success === true,
+          expires_at: data.expires_at
+        };
       }
-      return false;
+      return { success: false };
     } catch {
-      return false;
+      return { success: false };
     }
   }
   /**
@@ -442,13 +445,60 @@ var ResonanceClient = class {
     });
   }
   // ============================================
-  // Geo
+  // User Profile
   // ============================================
-  async getGeoNodes() {
-    return this.request("/eth/v1/geo/nodes");
+  /**
+   * Get user profile with roles, validator info, delegations, avatar, and geo
+   * @param address The user wallet address
+   */
+  async getUserProfile(address) {
+    return this.request(`/eth/v1/user/${address}/profile`);
   }
-  async getGeoValidators() {
-    return this.request("/eth/v1/geo/validators");
+  /**
+   * Get user avatar URL
+   * @param address The user wallet address
+   */
+  async getUserAvatar(address) {
+    return this.request(`/eth/v1/user/${address}/avatar`);
+  }
+  /**
+   * Upload user avatar
+   * @param address The user wallet address (must match authenticated user)
+   * @param file The image file to upload (png, jpg, or webp)
+   */
+  async uploadUserAvatar(address, file) {
+    const formData = new FormData();
+    formData.append("file", file);
+    const response = await fetch(
+      `${this.baseUrl}/eth/v1/user/${address}/avatar`,
+      {
+        method: "POST",
+        credentials: "include",
+        // Send httpOnly cookies
+        body: formData
+      }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Upload failed" }));
+      throw new ResonanceError(
+        "UPLOAD_FAILED",
+        error.error || "Failed to upload avatar",
+        void 0,
+        response.status
+      );
+    }
+    return response.json();
+  }
+  // ============================================
+  // Geo
+  // ============================================
+  /**
+   * Get all geo nodes, optionally filtered by role
+   * @param role Optional filter: "validator" or "delegator"
+   */
+  async getGeoNodes(role) {
+    const params = role ? `?role=${role}` : "";
+    return this.request(`/eth/v1/geo/nodes${params}`);
   }
   async getGeoStats() {
     return this.request("/eth/v1/geo/stats");
@@ -459,6 +509,15 @@ var ResonanceClient = class {
       body: JSON.stringify(data)
     });
   }
+  /**
+   * Auto-detect user geo location from IP and save to server.
+   * Should be called after successful login.
+   */
+  async autoDetectGeo() {
+    return this.request("/eth/v1/geo/auto-detect", {
+      method: "POST"
+    });
+  }
   // ============================================
   // Stats
   // ============================================

package/dist/index.mjs

@@ -313,7 +313,7 @@ var ResonanceClient = class {
   }
   /**
    * Refresh the access token using the refresh token cookie.
-   * Returns true if refresh was successful.
+   * Returns { success: boolean, expires_at?: number }
    */
   async refresh() {
     try {
@@ -325,11 +325,14 @@ var ResonanceClient = class {
       });
       if (response.ok) {
         const data = await response.json();
-        return data.success === true;
+        return {
+          success: data.success === true,
+          expires_at: data.expires_at
+        };
       }
-      return false;
+      return { success: false };
     } catch {
-      return false;
+      return { success: false };
     }
   }
   /**
@@ -406,13 +409,60 @@ var ResonanceClient = class {
     });
   }
   // ============================================
-  // Geo
+  // User Profile
   // ============================================
-  async getGeoNodes() {
-    return this.request("/eth/v1/geo/nodes");
+  /**
+   * Get user profile with roles, validator info, delegations, avatar, and geo
+   * @param address The user wallet address
+   */
+  async getUserProfile(address) {
+    return this.request(`/eth/v1/user/${address}/profile`);
   }
-  async getGeoValidators() {
-    return this.request("/eth/v1/geo/validators");
+  /**
+   * Get user avatar URL
+   * @param address The user wallet address
+   */
+  async getUserAvatar(address) {
+    return this.request(`/eth/v1/user/${address}/avatar`);
+  }
+  /**
+   * Upload user avatar
+   * @param address The user wallet address (must match authenticated user)
+   * @param file The image file to upload (png, jpg, or webp)
+   */
+  async uploadUserAvatar(address, file) {
+    const formData = new FormData();
+    formData.append("file", file);
+    const response = await fetch(
+      `${this.baseUrl}/eth/v1/user/${address}/avatar`,
+      {
+        method: "POST",
+        credentials: "include",
+        // Send httpOnly cookies
+        body: formData
+      }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({ error: "Upload failed" }));
+      throw new ResonanceError(
+        "UPLOAD_FAILED",
+        error.error || "Failed to upload avatar",
+        void 0,
+        response.status
+      );
+    }
+    return response.json();
+  }
+  // ============================================
+  // Geo
+  // ============================================
+  /**
+   * Get all geo nodes, optionally filtered by role
+   * @param role Optional filter: "validator" or "delegator"
+   */
+  async getGeoNodes(role) {
+    const params = role ? `?role=${role}` : "";
+    return this.request(`/eth/v1/geo/nodes${params}`);
   }
   async getGeoStats() {
     return this.request("/eth/v1/geo/stats");
@@ -423,6 +473,15 @@ var ResonanceClient = class {
       body: JSON.stringify(data)
     });
   }
+  /**
+   * Auto-detect user geo location from IP and save to server.
+   * Should be called after successful login.
+   */
+  async autoDetectGeo() {
+    return this.request("/eth/v1/geo/auto-detect", {
+      method: "POST"
+    });
+  }
   // ============================================
   // Stats
   // ============================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenelabs/fene-sdk",
-  "version": "0.5.0",
+  "version": "0.7.2",
   "description": "TypeScript SDK for Fene API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -20,6 +20,7 @@
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "lint": "tsc --noEmit",
     "test": "vitest run",
+    "watch": "esbuild src/app.ts --bundle --sourcemap --outdir=www --servedir=www --watch",
     "prepublishOnly": "pnpm run build"
   },
   "keywords": [
@@ -33,9 +34,17 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/fenelabs/fene-sdk"
+    "url": "https://github.com/fenelabs/fene-sdk.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "esbuild": ">=0.25.0"
   },
   "devDependencies": {
+    "esbuild": "^0.25.2",
     "@types/node": "^25.0.3",
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",