@lumiapassport/core 1.10.1 → 1.11.0

package/dist/clients/index.cjs

@@ -1264,11 +1264,35 @@ var ServerWalletClient = class {
     });
     if (!response.ok) {
       const errorData = await response.json().catch(() => ({}));
-      const errorMessage = errorData.error || errorData.message || `HTTP ${response.status}`;
+      const errorCode = errorData.error;
+      const errorMessage = errorCode || errorData.message || `HTTP ${response.status}`;
       if (this.debug) {
         console.error("[ServerWalletClient] Error:", errorMessage, errorData);
       }
-      throw new Error(`TSS API error: ${errorMessage}`);
+      let userFriendlyMessage;
+      switch (response.status) {
+        case 400:
+          userFriendlyMessage = `Invalid request: ${errorMessage}`;
+          break;
+        case 401:
+          userFriendlyMessage = `Authentication failed: ${errorMessage}. Check your API key.`;
+          break;
+        case 403:
+          userFriendlyMessage = `Access denied: ${errorMessage}. You may be trying to access a resource outside your project.`;
+          break;
+        case 404:
+          userFriendlyMessage = `Not found: ${errorMessage}`;
+          break;
+        case 503:
+          userFriendlyMessage = `Service unavailable: ${errorMessage}. Please try again later.`;
+          break;
+        default:
+          userFriendlyMessage = `TSS API error: ${errorMessage}`;
+      }
+      const error = new Error(userFriendlyMessage);
+      error.statusCode = response.status;
+      error.errorCode = errorCode;
+      throw error;
     }
     const data = await response.json();
     if (this.debug) {
@@ -1443,6 +1467,39 @@ var ServerWalletClient = class {
       }
     );
   }
+  // ==================== KYC Status ====================
+  /**
+   * Get KYC verification status for a user
+   *
+   * Retrieves the current KYC verification status for a specified user.
+   * The user must belong to the same project as the API key used for authentication.
+   *
+   * @param userId - Internal Lumia Passport user identifier
+   * @returns KYC status response with verification details
+   * @throws Error if user not found, unauthorized, or cross-project access attempted
+   *
+   * @example
+   * ```ts
+   * const kycStatus = await client.getKycStatus('user_abc123');
+   *
+   * if (kycStatus.status === 'verified') {
+   *   console.log('User is KYC verified');
+   * } else if (kycStatus.status === 'rejected') {
+   *   console.log('KYC rejected:', kycStatus.rejectionReason);
+   * }
+   * ```
+   */
+  async getKycStatus(userId) {
+    if (!userId || typeof userId !== "string") {
+      throw new Error("Invalid user ID: must be a non-empty string");
+    }
+    return this.request(
+      `/api/tss/server/${encodeURIComponent(userId)}/kyc/status`,
+      {
+        method: "GET"
+      }
+    );
+  }
 };
 function createServerWalletClient(config) {
   return new ServerWalletClient(config);