Function constructUser

apps/hash-frontend/src/lib/user-and-org.ts:364–564

(params: {
  orgMembershipLinks?: LinkEntity[];
  subgraph: Subgraph<EntityRootType<HashEntity>>;
  resolvedOrgs?: Org[];
  userEntity: Entity<UserEntity>;
  verifiableAddresses?: VerifiableIdentityAddress[];
})

 * @param params.orgMembershipLinks provides a minor optimization to avoid looking up membership links if they are already known
 */
export const constructUser = (params: {
  orgMembershipLinks?: LinkEntity[];
  subgraph: Subgraph<EntityRootType<HashEntity>>;
  resolvedOrgs?: Org[];
  userEntity: Entity<UserEntity>;
  verifiableAddresses?: VerifiableIdentityAddress[];
}): User => {
  const { orgMembershipLinks, resolvedOrgs, subgraph, userEntity } = params;

  const { email } = simplifyProperties(userEntity.properties);

  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- permissions means this may be undefined. @todo types to account for property-level permissions
  const primaryEmailAddress = email?.[0] ?? "";

  const normalizedPrimaryEmail = normalizeEmail(primaryEmailAddress);

  const isPrimaryEmailAddressVerified =
    params.verifiableAddresses?.find(
      ({ value }) => normalizeEmail(value) === normalizedPrimaryEmail,
    )?.verified === true;

  const minimalUser = constructMinimalUser({ userEntity });

  const orgMemberships =
    orgMembershipLinks ??
    getOutgoingLinksForEntity(
      subgraph,
      userEntity.metadata.recordId.entityId,
      intervalForTimestamp(currentTimestamp()),
    ).filter((linkEntity) =>
      linkEntity.metadata.entityTypeIds.includes(
        systemLinkEntityTypes.isMemberOf.linkEntityTypeId,
      ),
    );

  const memberOf = orgMemberships.map((untypedLinkEntity) => {
    const linkEntity = untypedLinkEntity as LinkEntity<IsMemberOf>;

    const { linkData, metadata } = linkEntity;

    const fullyResolvedOrg = resolvedOrgs?.find(
      (org) => org.entity.metadata.recordId.entityId === linkData.rightEntityId,
    );
    if (fullyResolvedOrg) {
      return {
        linkEntity,
        org: fullyResolvedOrg,
      };
    }

    const orgEntityRevisions = getRightEntityForLinkEntity(
      subgraph,
      metadata.recordId.entityId,
      intervalForTimestamp(currentTimestamp()),
    );

    if (!orgEntityRevisions || orgEntityRevisions.length === 0) {
      throw new Error(