/* Copyright 2021 The Matrix.org Foundation C.I.C. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ import React, { RefObject, useContext, useRef, useState } from "react"; import { EventType } from "matrix-js-sdk/src/@types/event"; import { JoinRule, Preset } from "matrix-js-sdk/src/@types/partials"; import { Room } from "matrix-js-sdk/src/models/room"; import { EventSubscription } from "fbemitter"; import MatrixClientContext from "../../contexts/MatrixClientContext"; import RoomAvatar from "../views/avatars/RoomAvatar"; import { _t } from "../../languageHandler"; import AccessibleButton from "../views/elements/AccessibleButton"; import RoomName from "../views/elements/RoomName"; import RoomTopic from "../views/elements/RoomTopic"; import InlineSpinner from "../views/elements/InlineSpinner"; import { inviteMultipleToRoom, showRoomInviteDialog } from "../../RoomInvite"; import { useRoomMembers } from "../../hooks/useRoomMembers"; import createRoom, { IOpts } from "../../createRoom"; import Field from "../views/elements/Field"; import { useEventEmitter } from "../../hooks/useEventEmitter"; import withValidation from "../views/elements/Validation"; import * as Email from "../../email"; import defaultDispatcher from "../../dispatcher/dispatcher"; import dis from "../../dispatcher/dispatcher"; import { Action } from "../../dispatcher/actions"; import ResizeNotifier from "../../utils/ResizeNotifier"; import MainSplit from './MainSplit'; import ErrorBoundary from "../views/elements/ErrorBoundary"; import { ActionPayload } from "../../dispatcher/payloads"; import RightPanel from "./RightPanel"; import RightPanelStore from "../../stores/RightPanelStore"; import { RightPanelPhases } from "../../stores/RightPanelStorePhases"; import { SetRightPanelPhasePayload } from "../../dispatcher/payloads/SetRightPanelPhasePayload"; import { useStateArray } from "../../hooks/useStateArray"; import SpacePublicShare from "../views/spaces/SpacePublicShare"; import { shouldShowSpaceSettings, showAddExistingRooms, showCreateNewRoom, showCreateNewSubspace, showSpaceSettings, } from "../../utils/space"; import SpaceHierarchy, { showRoom } from "./SpaceHierarchy"; import MemberAvatar from "../views/avatars/MemberAvatar"; import SpaceStore from "../../stores/SpaceStore"; import FacePile from "../views/elements/FacePile"; import { AddExistingToSpace, defaultDmsRenderer, defaultRoomsRenderer, defaultSpacesRenderer, } from "../views/dialogs/AddExistingToSpaceDialog"; import { ChevronFace, ContextMenuButton, useContextMenu } from "./ContextMenu"; import IconizedContextMenu, { IconizedContextMenuOption, IconizedContextMenuOptionList, } from "../views/context_menus/IconizedContextMenu"; import AccessibleTooltipButton from "../views/elements/AccessibleTooltipButton"; import { BetaPill } from "../views/beta/BetaCard"; import { UserTab } from "../views/dialogs/UserSettingsDialog"; import { EffectiveMembership, getEffectiveMembership } from "../../utils/membership"; import { SpaceFeedbackPrompt } from "../views/spaces/SpaceCreateMenu"; import { CreateEventField, IGroupSummary } from "../views/dialogs/CreateSpaceFromCommunityDialog"; import { useAsyncMemo } from "../../hooks/useAsyncMemo"; import Spinner from "../views/elements/Spinner"; import GroupAvatar from "../views/avatars/GroupAvatar"; import { useDispatcher } from "../../hooks/useDispatcher"; import { logger } from "matrix-js-sdk/src/logger"; interface IProps { space: Room; justCreatedOpts?: IOpts; resizeNotifier: ResizeNotifier; onJoinButtonClicked(): void; onRejectButtonClicked(): void; } interface IState { phase: Phase; firstRoomId?: string; // internal state for the creation wizard showRightPanel: boolean; myMembership: string; } enum Phase { Landing, PublicCreateRooms, PublicShare, PrivateScope, PrivateInvite, PrivateCreateRooms, PrivateExistingRooms, } const RoomMemberCount = ({ room, children }) => { const members = useRoomMembers(room); const count = members.length; if (children) return children(count); return count; }; const useMyRoomMembership = (room: Room) => { const [membership, setMembership] = useState(room.getMyMembership()); useEventEmitter(room, "Room.myMembership", () => { setMembership(room.getMyMembership()); }); return membership; }; const SpaceInfo = ({ space }) => { const joinRule = space.getJoinRule(); let visibilitySection; if (joinRule === "public") { visibilitySection = { _t("Public space") } ; } else { visibilitySection = { _t("Private space") } ; } return
{ visibilitySection } { joinRule === "public" && { (count) => count > 0 ? ( { defaultDispatcher.dispatch({ action: Action.SetRightPanelPhase, phase: RightPanelPhases.RoomMemberList, refireParams: { space }, }); }} > { _t("%(count)s members", { count }) } ) : null } }
; }; const onPreferencesClick = () => { defaultDispatcher.dispatch({ action: Action.ViewUserSettings, initialTabId: UserTab.Preferences, }); }; // XXX: temporary community migration component const GroupTile = ({ groupId }: { groupId: string }) => { const cli = useContext(MatrixClientContext); const groupSummary = useAsyncMemo(() => cli.getGroupSummary(groupId), [cli, groupId]); if (!groupSummary) return ; return <> { groupSummary.profile.name } ; }; interface ISpacePreviewProps { space: Room; onJoinButtonClicked(): void; onRejectButtonClicked(): void; } const SpacePreview = ({ space, onJoinButtonClicked, onRejectButtonClicked }: ISpacePreviewProps) => { const cli = useContext(MatrixClientContext); const myMembership = useMyRoomMembership(space); useDispatcher(defaultDispatcher, payload => { if (payload.action === Action.JoinRoomError && payload.roomId === space.roomId) { setBusy(false); // stop the spinner, join failed } }); const [busy, setBusy] = useState(false); const spacesEnabled = SpaceStore.spacesEnabled; const cannotJoin = getEffectiveMembership(myMembership) === EffectiveMembership.Leave && space.getJoinRule() !== JoinRule.Public; let inviterSection; let joinButtons; if (myMembership === "join") { // XXX remove this when spaces leaves Beta joinButtons = ( { dis.dispatch({ action: "leave_room", room_id: space.roomId, }); }} > { _t("Leave") } ); } else if (myMembership === "invite") { const inviteSender = space.getMember(cli.getUserId())?.events.member?.getSender(); const inviter = inviteSender && space.getMember(inviteSender); if (inviteSender) { inviterSection =
{ _t(" invites you", {}, { inviter: () => { inviter?.name || inviteSender }, }) }
{ inviter ?
{ inviteSender }
: null }
; } joinButtons = <> { setBusy(true); onRejectButtonClicked(); }} > { _t("Reject") } { setBusy(true); onJoinButtonClicked(); }} disabled={!spacesEnabled} > { _t("Accept") } ; } else { joinButtons = ( { setBusy(true); onJoinButtonClicked(); }} disabled={!spacesEnabled || cannotJoin} > { _t("Join") } ); } if (busy) { joinButtons = ; } let footer; if (!spacesEnabled) { footer =
{ myMembership === "join" ? _t("To view this Space, hide communities in your preferences", {}, { a: sub => { sub }, }) : _t("To join this Space, hide communities in your preferences", {}, { a: sub => { sub }, }) }
; } else if (cannotJoin) { footer =
{ _t("To view %(spaceName)s, you need an invite", { spaceName: space.name, }) }
; } let migratedCommunitySection: JSX.Element; const createContent = space.currentState.getStateEvents(EventType.RoomCreate, "")?.getContent(); if (createContent[CreateEventField]) { migratedCommunitySection =
{ _t("Created from ", {}, { Community: () => , }) }
; } return
{ migratedCommunitySection } { inviterSection }

{ (topic, ref) =>
{ topic }
}
{ space.getJoinRule() === "public" && }
{ joinButtons }
{ footer }
; }; const SpaceLandingAddButton = ({ space }) => { const [menuDisplayed, handle, openMenu, closeMenu] = useContextMenu(); let contextMenu; if (menuDisplayed) { const rect = handle.current.getBoundingClientRect(); contextMenu = { e.preventDefault(); e.stopPropagation(); closeMenu(); if (await showCreateNewRoom(space)) { defaultDispatcher.fire(Action.UpdateSpaceHierarchy); } }} /> { e.preventDefault(); e.stopPropagation(); closeMenu(); showAddExistingRooms(space); }} /> { e.preventDefault(); e.stopPropagation(); closeMenu(); showCreateNewSubspace(space); }} > ; } return <> { _t("Add") } { contextMenu } ; }; const SpaceLanding = ({ space }) => { const cli = useContext(MatrixClientContext); const myMembership = useMyRoomMembership(space); const userId = cli.getUserId(); let inviteButton; if (myMembership === "join" && space.canInvite(userId)) { inviteButton = ( { showRoomInviteDialog(space.roomId); }} > { _t("Invite") } ); } const canAddRooms = myMembership === "join" && space.currentState.maySendStateEvent(EventType.SpaceChild, userId); let addRoomButton; if (canAddRooms) { addRoomButton = ; } let settingsButton; if (shouldShowSpaceSettings(space)) { settingsButton = { showSpaceSettings(space); }} title={_t("Settings")} />; } const onMembersClick = () => { defaultDispatcher.dispatch({ action: Action.SetRightPanelPhase, phase: RightPanelPhases.RoomMemberList, refireParams: { space }, }); }; return
{ (name) => { const tags = { name: () =>

{ name }

}; return _t("Welcome to ", {}, tags) as JSX.Element; } }
{ inviteButton } { settingsButton }
{ (topic, ref) => (
{ topic }
) }
; }; const SpaceSetupFirstRooms = ({ space, title, description, onFinished }) => { const [busy, setBusy] = useState(false); const [error, setError] = useState(""); const numFields = 3; const placeholders = [_t("General"), _t("Random"), _t("Support")]; const [roomNames, setRoomName] = useStateArray(numFields, [_t("General"), _t("Random"), ""]); const fields = new Array(numFields).fill(0).map((x, i) => { const name = "roomName" + i; return setRoomName(i, ev.target.value)} autoFocus={i === 2} disabled={busy} autoComplete="off" />; }); const onNextClick = async (ev) => { ev.preventDefault(); if (busy) return; setError(""); setBusy(true); try { const isPublic = space.getJoinRule() === JoinRule.Public; const filteredRoomNames = roomNames.map(name => name.trim()).filter(Boolean); const roomIds = await Promise.all(filteredRoomNames.map(name => { return createRoom({ createOpts: { preset: isPublic ? Preset.PublicChat : Preset.PrivateChat, name, }, spinner: false, encryption: false, andView: false, inlineErrors: true, parentSpace: space, joinRule: !isPublic ? JoinRule.Restricted : undefined, suggested: true, }); })); onFinished(roomIds[0]); } catch (e) { console.error("Failed to create initial space rooms", e); setError(_t("Failed to create initial space rooms")); } setBusy(false); }; let onClick = (ev) => { ev.preventDefault(); onFinished(); }; let buttonLabel = _t("Skip for now"); if (roomNames.some(name => name.trim())) { onClick = onNextClick; buttonLabel = busy ? _t("Creating rooms...") : _t("Continue"); } return

{ title }

{ description }
{ error &&
{ error }
}
{ fields }
; }; const SpaceAddExistingRooms = ({ space, onFinished }) => { return

{ _t("What do you want to organise?") }

{ _t("Pick rooms or conversations to add. This is just a space for you, " + "no one will be informed. You can add more later.") }
{ _t("Skip for now") } } filterPlaceholder={_t("Search for rooms or spaces")} onFinished={onFinished} roomsRenderer={defaultRoomsRenderer} spacesRenderer={defaultSpacesRenderer} dmsRenderer={defaultDmsRenderer} />
; }; interface ISpaceSetupPublicShareProps extends Pick { onFinished(): void; } const SpaceSetupPublicShare = ({ justCreatedOpts, space, onFinished, firstRoomId }: ISpaceSetupPublicShareProps) => { return

{ _t("Share %(name)s", { name: justCreatedOpts?.createOpts?.name || space.name, }) }

{ _t("It's just you at the moment, it will be even better with others.") }
{ firstRoomId ? _t("Go to my first room") : _t("Go to my space") }
; }; const SpaceSetupPrivateScope = ({ space, justCreatedOpts, onFinished }) => { return

{ _t("Who are you working with?") }

{ _t("Make sure the right people have access to %(name)s", { name: justCreatedOpts?.createOpts?.name || space.name, }) }
{ onFinished(false); }} >

{ _t("Just me") }

{ _t("A private space to organise your rooms") }
{ onFinished(true); }} >

{ _t("Me and my teammates") }

{ _t("A private space for you and your teammates") }

{ _t("Teammates might not be able to view or join any private rooms you make.") }

{ _t("We're working on this, but just want to let you know.") }

; }; const validateEmailRules = withValidation({ rules: [{ key: "email", test: ({ value }) => !value || Email.looksValid(value), invalid: () => _t("Doesn't look like a valid email address"), }], }); const SpaceSetupPrivateInvite = ({ space, onFinished }) => { const [busy, setBusy] = useState(false); const [error, setError] = useState(""); const numFields = 3; const fieldRefs: RefObject[] = [useRef(), useRef(), useRef()]; const [emailAddresses, setEmailAddress] = useStateArray(numFields, ""); const fields = new Array(numFields).fill(0).map((x, i) => { const name = "emailAddress" + i; return setEmailAddress(i, ev.target.value)} ref={fieldRefs[i]} onValidate={validateEmailRules} autoFocus={i === 0} disabled={busy} />; }); const onNextClick = async (ev) => { ev.preventDefault(); if (busy) return; setError(""); for (let i = 0; i < fieldRefs.length; i++) { const fieldRef = fieldRefs[i]; const valid = await fieldRef.current.validate({ allowEmpty: true }); if (valid === false) { // true/null are allowed fieldRef.current.focus(); fieldRef.current.validate({ allowEmpty: true, focused: true }); return; } } setBusy(true); const targetIds = emailAddresses.map(name => name.trim()).filter(Boolean); try { const result = await inviteMultipleToRoom(space.roomId, targetIds); const failedUsers = Object.keys(result.states).filter(a => result.states[a] === "error"); if (failedUsers.length > 0) { logger.log("Failed to invite users to space: ", result); setError(_t("Failed to invite the following users to your space: %(csvUsers)s", { csvUsers: failedUsers.join(", "), })); } else { onFinished(); } } catch (err) { console.error("Failed to invite users to space: ", err); setError(_t("We couldn't invite those users. Please check the users you want to invite and try again.")); } setBusy(false); }; let onClick = (ev) => { ev.preventDefault(); onFinished(); }; let buttonLabel = _t("Skip for now"); if (emailAddresses.some(name => name.trim())) { onClick = onNextClick; buttonLabel = busy ? _t("Inviting...") : _t("Continue"); } return

{ _t("Invite your teammates") }

{ _t("Make sure the right people have access. You can invite more later.") }
{ _t("This is an experimental feature. For now, " + "new users receiving an invite will have to open the invite on to actually join.", {}, { b: sub => { sub }, link: () => app.element.io , }) }
{ error &&
{ error }
}
{ fields }
showRoomInviteDialog(space.roomId)} > { _t("Invite by username") }
; }; export default class SpaceRoomView extends React.PureComponent { static contextType = MatrixClientContext; private readonly creator: string; private readonly dispatcherRef: string; private readonly rightPanelStoreToken: EventSubscription; constructor(props, context) { super(props, context); let phase = Phase.Landing; this.creator = this.props.space.currentState.getStateEvents(EventType.RoomCreate, "")?.getSender(); const showSetup = this.props.justCreatedOpts && this.context.getUserId() === this.creator; if (showSetup) { phase = this.props.justCreatedOpts.createOpts.preset === Preset.PublicChat ? Phase.PublicCreateRooms : Phase.PrivateScope; } this.state = { phase, showRightPanel: RightPanelStore.getSharedInstance().isOpenForRoom, myMembership: this.props.space.getMyMembership(), }; this.dispatcherRef = defaultDispatcher.register(this.onAction); this.rightPanelStoreToken = RightPanelStore.getSharedInstance().addListener(this.onRightPanelStoreUpdate); this.context.on("Room.myMembership", this.onMyMembership); } componentWillUnmount() { defaultDispatcher.unregister(this.dispatcherRef); this.rightPanelStoreToken.remove(); this.context.off("Room.myMembership", this.onMyMembership); } private onMyMembership = (room: Room, myMembership: string) => { if (room.roomId === this.props.space.roomId) { this.setState({ myMembership }); } }; private onRightPanelStoreUpdate = () => { this.setState({ showRightPanel: RightPanelStore.getSharedInstance().isOpenForRoom, }); }; private onAction = (payload: ActionPayload) => { if (payload.action === "view_room" && payload.room_id === this.props.space.roomId) { this.setState({ phase: Phase.Landing }); return; } if (payload.action !== Action.ViewUser && payload.action !== "view_3pid_invite") return; if (payload.action === Action.ViewUser && payload.member) { defaultDispatcher.dispatch({ action: Action.SetRightPanelPhase, phase: RightPanelPhases.SpaceMemberInfo, refireParams: { space: this.props.space, member: payload.member, }, }); } else if (payload.action === "view_3pid_invite" && payload.event) { defaultDispatcher.dispatch({ action: Action.SetRightPanelPhase, phase: RightPanelPhases.Space3pidMemberInfo, refireParams: { space: this.props.space, event: payload.event, }, }); } else { defaultDispatcher.dispatch({ action: Action.SetRightPanelPhase, phase: RightPanelPhases.SpaceMemberList, refireParams: { space: this.props.space }, }); } }; private goToFirstRoom = async () => { if (this.state.firstRoomId) { defaultDispatcher.dispatch({ action: "view_room", room_id: this.state.firstRoomId, }); return; } this.setState({ phase: Phase.Landing }); }; private renderBody() { switch (this.state.phase) { case Phase.Landing: if (this.state.myMembership === "join" && SpaceStore.spacesEnabled) { return ; } else { return ; } case Phase.PublicCreateRooms: return this.setState({ phase: Phase.PublicShare, firstRoomId })} />; case Phase.PublicShare: return ; case Phase.PrivateScope: return { this.setState({ phase: invite ? Phase.PrivateInvite : Phase.PrivateExistingRooms }); }} />; case Phase.PrivateInvite: return this.setState({ phase: Phase.PrivateCreateRooms })} />; case Phase.PrivateCreateRooms: return this.setState({ phase: Phase.Landing, firstRoomId })} />; case Phase.PrivateExistingRooms: return this.setState({ phase: Phase.Landing })} />; } } render() { const rightPanel = this.state.showRightPanel && this.state.phase === Phase.Landing ? : null; return
{ this.renderBody() }
; } }