source: Klonkt/src/services/guardianship/context.js@ ea138c0

/**
 * Guardianship (FEP-633c "Guardians") — JSON-LD vocabulary.
 *
 * One source of truth for the shaer namespace and the terms Klonkt emits.
 * ActivityPubService spreads SHAER_CONTEXT into its AP_CONTEXT term block, so
 * every outgoing document declares the namespace and strict JSON-LD
 * processors resolve the terms instead of dropping them.
 */

/** The term block merged into AP_CONTEXT. */
export const SHAER_CONTEXT = {
  // FEP-633c (Guardians): the shaer namespace. helpRequest marks a direct
  // note as a ward's call for help (spec 5.2.1); ignorable by everyone else.
  shaer: 'https://ns.klonkt.com/shaer#',
};

/** The Relationship value in the adoption Offer (FEP-633c §3), both forms. */
export const GUARDIAN_RELATIONSHIP = 'https://ns.klonkt.com/shaer#Guardian';
export const GUARDIAN_RELATIONSHIP_COMPACT = 'shaer:Guardian';

/** True when an Offer's relationship names the guardian relation. */
export function isGuardianRelationship(value) {
  return value === GUARDIAN_RELATIONSHIP || value === GUARDIAN_RELATIONSHIP_COMPACT;
}

/**
 * True when an actor document carries `shaer:guardians` — i.e. it is a ward,
 * and therefore not a valid guardian (§1). The one question §4 asks, in both
 * places it asks it: before committing a guardianship (§4.2) and before
 * delivering an escalation to one (§4.1).
 *
 * §2.1 allows the list as an array of URIs, a single URI, or a Collection, so
 * all three are read here rather than in each caller.
 */
export function carriesGuardians(doc) {
  const g = doc && doc['shaer:guardians'];
  if (Array.isArray(g)) return g.length > 0;
  if (typeof g === 'string') return g.length > 0;
  if (g && typeof g === 'object') return Array.isArray(g.items) ? g.items.length > 0 : true;
  return false;
}

export default { SHAER_CONTEXT, GUARDIAN_RELATIONSHIP, GUARDIAN_RELATIONSHIP_COMPACT, isGuardianRelationship, carriesGuardians };