[P3] Implement Guardian Social Recovery Methods (#28)

* Fix guardian API paths and implement missing methods

- Fixed all 6 existing guardian methods to use correct /api/v1/identity paths
- Changed removeGuardian() to use DELETE method
- Implemented completeRecovery() method
- Implemented rejectRecovery() method
- Implemented getPendingRecoveries() method
- Updated method signatures to match node implementation

All 9 guardian endpoints now implemented correctly.

* Fix critical guardian method mismatches with node implementation

Fixed 6 critical issues where client methods didn't match node API:

1. addGuardian(): Added session_token and guardian_public_key parameters
2. listGuardians(): Changed to use Authorization header instead of query params
3. removeGuardian(): Changed to use Authorization header, removed identity_id param
4. approveRecovery(): Added session_token, changed signature from string to number[]
5. rejectRecovery(): Added session_token and signature parameters
6. getPendingRecoveries(): Added Authorization header with session_token

Updated types to match node responses:
- Guardian interface now matches GuardianInfo from node
- GuardianResponse includes total_guardians
- RecoverySession matches InitiateRecoveryResponse
- RecoveryStatus matches RecoveryStatusResponse

All methods now correctly implement node's guardian.rs API contract.
Verified against zhtp/src/api/handlers/guardian.rs lines 200-946.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: umwelt

dist/core/types.d.ts

@@ -284,41 +284,29 @@ export interface BackupStatus {
 }
 export interface Guardian {
     guardian_id: string;
-    guardian_name?: string;
-    status: 'pending' | 'active' | 'revoked';
+    guardian_did: string;
+    name: string;
     added_at: number;
-    relationship?: string;
+    status: string;
 }
 export interface GuardianResponse {
     status: string;
     guardian_id: string;
-    message: string;
+    total_guardians: number;
 }
 export interface RecoverySession {
+    status: string;
     recovery_id: string;
-    identity_id: string;
-    status: 'initiated' | 'pending_approvals' | 'completed' | 'cancelled';
-    required_approvals: number;
-    current_approvals: number;
-    guardian_ids: string[];
-    created_at: number;
+    guardians_required: number;
+    guardians_approved: number;
     expires_at: number;
 }
 export interface RecoveryStatus {
     recovery_id: string;
-    status: 'initiated' | 'pending_approvals' | 'completed' | 'cancelled' | 'failed';
-    progress: {
-        required: number;
-        approved: number;
-        declined: number;
-    };
-    guardians: Array<{
-        guardian_id: string;
-        status: 'pending' | 'approved' | 'declined';
-        responded_at?: number;
-    }>;
-    created_at: number;
-    updated_at: number;
+    status: string;
+    approvals: number;
+    required: number;
     expires_at: number;
+    identity_did: string;
 }
 //# sourceMappingURL=types.d.ts.map

dist/core/types.d.ts.map

@@ -80,15 +80,33 @@ export declare abstract class ZhtpApiMethods extends ZhtpApiCore {
      */
     verifySeedPhrase(identityId: string, seedPhrase: string): Promise<SeedVerification>;
     exportSeedPhrases(identityId: string): Promise<SeedPhrases>;
-    addGuardian(identityId: string, guardianId: string, guardianInfo?: Record<string, any>): Promise<GuardianResponse>;
-    listGuardians(identityId: string): Promise<Guardian[]>;
-    removeGuardian(identityId: string, guardianId: string): Promise<void>;
-    acceptGuardianInvite(guardianId: string, identityId: string): Promise<void>;
-    declineGuardianInvite(guardianId: string, identityId: string): Promise<void>;
-    initiateRecovery(identityId: string, guardianIds: string[]): Promise<RecoverySession>;
-    approveRecovery(guardianId: string, recoveryId: string, approval: boolean): Promise<void>;
+    addGuardian(identityId: string, sessionToken: string, guardianDid: string, guardianPublicKey: number[], guardianName: string): Promise<GuardianResponse>;
+    listGuardians(sessionToken: string): Promise<{
+        guardians: Guardian[];
+        threshold: number;
+    }>;
+    removeGuardian(guardianId: string, sessionToken: string): Promise<void>;
+    initiateRecovery(identityDid: string, requesterDevice: string): Promise<RecoverySession>;
+    approveRecovery(recoveryId: string, guardianDid: string, sessionToken: string, signature: number[]): Promise<{
+        status: string;
+        approvals: number;
+        required: number;
+    }>;
+    rejectRecovery(recoveryId: string, guardianDid: string, sessionToken: string, signature: number[]): Promise<void>;
+    completeRecovery(recoveryId: string): Promise<{
+        status: string;
+        session_token: string;
+        identity_did: string;
+    }>;
     getRecoveryStatus(recoveryId: string): Promise<RecoveryStatus>;
-    cancelRecovery(recoveryId: string): Promise<void>;
+    getPendingRecoveries(sessionToken: string): Promise<{
+        pending_requests: Array<{
+            recovery_id: string;
+            identity_did: string;
+            initiated_at: number;
+            expires_at: number;
+        }>;
+    }>;
     applyCitizenship(identityId: string, applicationData?: Record<string, any>): Promise<CitizenshipResult>;
     createZkDid(didData?: Record<string, any>): Promise<any>;
     getIdentity(did: string): Promise<Identity>;