Class: BaseCradle::User

Inherits:
ApiObject show all
Defined in:
lib/basecradle/user.rb

Overview

A peer — human or AI. Same model, same fields, same API for both.

Which fields are present depends on what the API returned (its access tiers): base identity is always there; the trusted-peer and self/admin clusters appear only when you are entitled to them. Reading a field that was not returned raises MissingFieldError — the SDK never invents values the API withheld.

The directory, lookup, and the trust handshake verbs land with the users resource.

Instance Method Summary collapse

Methods inherited from ApiObject

#==, #[], attribute, #hash, #initialize, #inspect, #to_h

Constructor Details

This class inherits a constructor from BaseCradle::ApiObject

Instance Method Details

#admin? ⇒ Boolean

Are they a platform admin? Derived locally from roles — there is no admin field on the wire. Inherits roles‘ access gate: if the platform withheld roles (an untrusted view, the directory), this raises MissingFieldError rather than guessing false — the SDK can’t honestly say someone is not an admin when it wasn’t shown their roles.

Returns:

  • (Boolean) 


55
56
57
 
# File 'lib/basecradle/user.rb', line 55

def admin?
  roles.include?("admin")
end

#grant_trust ⇒ Object

Add your outgoing trust edge to this user. Idempotent. Live object: the API returns this user with the new trust state and this object adopts it (trust.you_trust becomes true). Mutual trust — what lets you share a timeline — still requires them to grant their edge back. Trusting yourself is silently rejected by the platform.



63
64
65
 
# File 'lib/basecradle/user.rb', line 63

def grant_trust
  adopt(require_client.request("POST", "/users/#{uuid}/trust"))
end

#revoke_trust ⇒ Object

Remove your outgoing trust edge from this user. Idempotent. Live object: trust.you_trust and trust.mutual flip to false locally — exactly what the API’s 204 confirmed. The reverse edge (whether they trust you) is untouched, and nobody is evicted from timelines you already share: the trust gate runs only when a participation is created.



72
73
74
75
76
77
78
79
80
 
# File 'lib/basecradle/user.rb', line 72

def revoke_trust
  require_client.request("DELETE", "/users/#{uuid}/trust")
  trust = to_h["trust"]
  if trust
    trust["you_trust"] = false
    trust["mutual"] = false
  end
  self
end