@selfcommunity/react-ui 0.7.9-alpha.0 → 0.7.9-alpha.2

package/lib/esm/components/GroupInviteButton/GroupInviteButton.js

@@ -0,0 +1,256 @@
+import { __rest } from "tslib";
+import React, { useContext, useEffect, useMemo, useState } from 'react';
+import { useThemeProps } from '@mui/system';
+import { styled } from '@mui/material/styles';
+import { Avatar, Box, Button, Chip, Icon, IconButton, InputAdornment, TextField, Typography } from '@mui/material';
+import { defineMessages, FormattedMessage, useIntl } from 'react-intl';
+import { SCUserContext, useSCFetchGroup } from '@selfcommunity/react-core';
+import classNames from 'classnames';
+import BaseDialog from '../../shared/BaseDialog';
+import { LoadingButton } from '@mui/lab';
+import { GroupService } from '@selfcommunity/api-services';
+import Autocomplete from '@mui/material/Autocomplete';
+import User from '../User';
+import { SCOPE_SC_UI } from '../../constants/Errors';
+import { Logger } from '@selfcommunity/utils';
+const messages = defineMessages({
+    placeholder: {
+        id: 'ui.groupInviteButton.searchBar.placeholder',
+        defaultMessage: 'ui.groupInviteButton.searchBar.placeholder'
+    }
+});
+const PREFIX = 'SCGroupInviteButton';
+const classes = {
+    root: `${PREFIX}-root`,
+    dialogRoot: `${PREFIX}-dialog-root`,
+    dialogTitle: `${PREFIX}-dialog-title`,
+    dialogContent: `${PREFIX}-dialog-content`,
+    autocomplete: `${PREFIX}-autocomplete`,
+    icon: `${PREFIX}-icon`,
+    input: `${PREFIX}-input`,
+    clear: `${PREFIX}-clear`,
+    invitedBox: `${PREFIX}-invited-box`,
+    suggested: `${PREFIX}-suggested`
+};
+const Root = styled(Button, {
+    name: PREFIX,
+    slot: 'Root',
+    overridesResolver: (props, styles) => styles.root
+})(({ theme }) => ({}));
+const DialogRoot = styled(BaseDialog, {
+    name: PREFIX,
+    slot: 'Root',
+    overridesResolver: (props, styles) => styles.dialogRoot
+})(({ theme }) => ({}));
+/**
+ *> API documentation for the Community-JS Group Invite Button component. Learn about the available props and the CSS API.
+ *
+ #### Import
+ ```jsx
+ import {SCGroupInviteButton} from '@selfcommunity/react-ui';
+ ```
+
+ #### Component Name
+ The name `SCGroupInviteButton` can be used when providing style overrides in the theme.
+
+ #### CSS
+
+ |Rule Name|Global class|Description|
+ |---|---|---|
+ |root|.SCGroupInviteButton-root|Styles applied to the root element.|
+ |dialogRoot|.SCGroupInviteButton-dialog-root|Styles applied to the dialog root.|
+ |dialogTitle|.SCGroupInviteButton-dialog-title|Styles applied to the dialog title element.|
+ |dialogContent|.SCGroupInviteButton-dialog-content|Styles applied to the dialog content.|
+ |autocomplete|.SCGroupInviteButton-autocomplete|Styles applied to the autocomplete element.|
+ |icon|.SCGroupInviteButton-icon|Styles applied to the autocomplete icon element.|
+ |input|.SCGroupInviteButton-input|Styles applied to the autocomplete input element.|
+ |clear|.SCGroupInviteButton-clear|Styles applied to the autocomplete clear icon element.|
+ |invitedBox|.SCGroupInviteButton-invited-box|Styles applied to the invited users box.|
+ |suggested|.SCGroupInviteButton-suggested|Styles applied to the suggested users box.|
+
+ * @param inProps
+ */
+export default function GroupInviteButton(inProps) {
+    //PROPS
+    const props = useThemeProps({
+        props: inProps,
+        name: PREFIX
+    });
+    const { className, group, groupId, handleInvitations = null } = props, rest = __rest(props, ["className", "group", "groupId", "handleInvitations"]);
+    // CONTEXT
+    const scUserContext = useContext(SCUserContext);
+    // STATE
+    const [open, setOpen] = useState(false);
+    const [isSending, setIsSending] = useState(false);
+    const [value, setValue] = useState('');
+    const [suggested, setSuggested] = useState([]);
+    const [list, setList] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [invited, setInvited] = useState([]);
+    function convertToInvitedUsersObject(data) {
+        const invited_users = {};
+        data.forEach((user, index) => {
+            invited_users[`invited_users[${index}]`] = user.id;
+        });
+        return invited_users;
+    }
+    /**
+     * Memoized users invited ids
+     */
+    const ids = useMemo(() => {
+        if (invited) {
+            return invited.map((u) => {
+                return parseInt(u.id, 10);
+            });
+        }
+        return [invited];
+    }, [invited]);
+    // CONST
+    const authUserId = scUserContext.user ? scUserContext.user.id : null;
+    // HOOKS
+    const { scGroup } = useSCFetchGroup({ id: groupId, group });
+    // INTL
+    const intl = useIntl();
+    function fetchResults() {
+        setLoading(true);
+        GroupService.getGroupSuggestedUsers(scGroup === null || scGroup === void 0 ? void 0 : scGroup.id, value)
+            .then((data) => {
+            setLoading(false);
+            setSuggested(data.results);
+        })
+            .catch((error) => {
+            setLoading(false);
+            Logger.error(SCOPE_SC_UI, error);
+        });
+    }
+    function fetchGeneralResults() {
+        setLoading(true);
+        GroupService.getGroupsSuggestedUsers(value)
+            .then((data) => {
+            setLoading(false);
+            setSuggested(data.results);
+        })
+            .catch((error) => {
+            setLoading(false);
+            Logger.error(SCOPE_SC_UI, error);
+        });
+    }
+    useEffect(() => {
+        if (scGroup === null || scGroup === void 0 ? void 0 : scGroup.id) {
+            GroupService.getGroupSuggestedUsers(scGroup === null || scGroup === void 0 ? void 0 : scGroup.id, value).then((data) => {
+                setLoading(false);
+                setList(data.results);
+            });
+        }
+        else {
+            GroupService.getGroupsSuggestedUsers(value).then((data) => {
+                setLoading(false);
+                setList(data.results);
+            });
+        }
+    }, [scGroup === null || scGroup === void 0 ? void 0 : scGroup.id]);
+    /**
+     * If a value is entered in new message field, it fetches user suggested
+     */
+    useEffect(() => {
+        if (value && !handleInvitations) {
+            fetchResults();
+        }
+        fetchGeneralResults();
+    }, [value, handleInvitations]);
+    /**
+     * Handles dialog close
+     */
+    const handleClose = () => {
+        setOpen((p) => !p);
+    };
+    /**
+     * Handles invitation sending
+     */
+    const handleSendInvitations = () => {
+        if (handleInvitations) {
+            handleInvitations(convertToInvitedUsersObject(invited));
+            setOpen(false);
+        }
+        else {
+            const data = { users: ids };
+            setIsSending(true);
+            GroupService.inviteOrAcceptGroupRequest(scGroup.id, data)
+                .then(() => {
+                setIsSending(false);
+            })
+                .catch((error) => {
+                setLoading(false);
+                Logger.error(SCOPE_SC_UI, error);
+            });
+        }
+    };
+    // Autocomplete Handlers
+    const handleInputChange = (event, value, reason) => {
+        switch (reason) {
+            case 'input':
+                setValue(value);
+                !value && setSuggested([]);
+                break;
+            case 'reset':
+                setValue(value);
+                break;
+        }
+    };
+    const handleChange = (event, value, reason, details) => {
+        event.preventDefault();
+        event.stopPropagation();
+        switch (reason) {
+            case 'selectOption':
+                setInvited(value);
+                setList((prev) => prev.filter((u) => u.id !== details.option.id));
+                break;
+            case 'removeOption':
+                setInvited(value);
+                setList((prev) => [...prev, details.option]);
+                break;
+        }
+        return false;
+    };
+    const handleUserInvite = (user) => {
+        setInvited((prev) => [...prev, user]);
+        setList((prev) => prev.filter((u) => u.id !== user.id));
+    };
+    const handleDelete = (option) => {
+        setInvited(invited.filter((v) => v !== option));
+        setList((prev) => [...prev, option]);
+    };
+    /**
+     * If there's no authUserId, component is hidden.
+    //  */
+    if (!authUserId) {
+        return null;
+    }
+    /**
+     * Renders root object
+     */
+    return (React.createElement(React.Fragment, null,
+        React.createElement(Root, Object.assign({ className: classNames(classes.root, className), onClick: handleClose, size: "small", variant: "outlined", startIcon: React.createElement(Icon, { fontSize: "small" }, "add") }, rest),
+            React.createElement(FormattedMessage, { id: "ui.groupInviteButton", defaultMessage: "ui.groupInviteButton" })),
+        open && (React.createElement(DialogRoot, { DialogContentProps: { dividers: false }, open: true, className: classes.dialogRoot, title: React.createElement(React.Fragment, null,
+                React.createElement(IconButton, { onClick: handleClose },
+                    React.createElement(Icon, { fontSize: "medium" }, "arrow_back")),
+                React.createElement(Typography, { className: classes.dialogTitle },
+                    React.createElement(FormattedMessage, { id: "ui.groupInviteButton.dialog.title", defaultMessage: "ui.groupInviteButton.dialog.title" })),
+                React.createElement(LoadingButton, { size: "small", color: "secondary", variant: "contained", onClick: handleSendInvitations, loading: isSending },
+                    React.createElement(FormattedMessage, { id: "ui.groupInviteButton.dialog.button.end", defaultMessage: "ui.groupInviteButton.dialog.button.end" }))) },
+            React.createElement(Box, { className: classes.dialogContent },
+                React.createElement(Autocomplete, { className: classes.autocomplete, loading: loading, size: "small", multiple: true, freeSolo: true, disableClearable: true, options: suggested, onChange: handleChange, onInputChange: handleInputChange, inputValue: value, value: invited, getOptionLabel: (option) => (option ? option.username : '...'), isOptionEqualToValue: (option, value) => (option ? value.id === option.id : false), renderTags: () => null, renderOption: (props, option) => (React.createElement(Box, Object.assign({ component: "li" }, props),
+                        React.createElement(Avatar, { alt: option.username, src: option.avatar }),
+                        React.createElement(Typography, { ml: 1 }, option.username))), renderInput: (params) => (React.createElement(TextField, Object.assign({}, params, { variant: "outlined", placeholder: `${intl.formatMessage(messages.placeholder)}`, InputProps: Object.assign(Object.assign({}, params.InputProps), { className: classes.input, startAdornment: (React.createElement(React.Fragment, null,
+                                React.createElement(InputAdornment, { position: "start" },
+                                    React.createElement(Icon, { className: classes.icon }, "search")),
+                                params.InputProps.startAdornment)) }) }))) }),
+                React.createElement(Box, { className: classes.invitedBox }, invited.map((option, index) => (React.createElement(Chip, { key: index, avatar: React.createElement(Avatar, { alt: option.username, src: option.avatar }), label: option.username, onDelete: () => {
+                        handleDelete(option);
+                    }, style: { marginRight: 8 } })))),
+                React.createElement(Box, { className: classes.suggested },
+                    list.length !== 0 && (React.createElement(Typography, { variant: "h4", fontWeight: "bold" },
+                        React.createElement(FormattedMessage, { id: "ui.groupInviteButton.dialog.content.list", defaultMessage: "ui.groupInviteButton.dialog.content.list" }))),
+                    list.slice(0, 5).map((user, index) => (React.createElement(User, { elevation: 0, actions: React.createElement(React.Fragment, null), user: user, userId: user.id, key: index, buttonProps: { onClick: () => handleUserInvite(user) } })))))))));
+}

package/lib/esm/components/GroupInviteButton/index.d.ts

@@ -0,0 +1,3 @@
+import GroupInviteButton, { GroupInviteButtonProps } from './GroupInviteButton';
+export default GroupInviteButton;
+export { GroupInviteButtonProps };

package/lib/esm/components/GroupInviteButton/index.js

@@ -0,0 +1,2 @@
+import GroupInviteButton from './GroupInviteButton';
+export default GroupInviteButton;

package/lib/esm/components/GroupMembersButton/GroupMembersButton.d.ts

@@ -0,0 +1,46 @@
+import { BaseDialogProps } from '../../shared/BaseDialog';
+import { SCGroupType } from '@selfcommunity/types';
+import { ButtonProps } from '@mui/material/Button/Button';
+export interface GroupMembersButtonProps extends Pick<ButtonProps, Exclude<keyof ButtonProps, 'onClick' | 'disabled'>> {
+    /**
+     * Group Object
+     * @default null
+     */
+    group?: SCGroupType;
+    /**
+     * Id of the group
+     * @default null
+     */
+    groupId?: number | string;
+    /**
+     * Props to spread to followedBy dialog
+     * @default {}
+     */
+    DialogProps?: BaseDialogProps;
+    /**
+     * Any other properties
+     */
+    [p: string]: any;
+}
+/**
+ *> API documentation for the Community-JS Group Members Button component. Learn about the available props and the CSS API.
+ *
+ #### Import
+ ```jsx
+ import {GroupMembersButton} from '@selfcommunity/react-ui';
+ ```
+ #### Component Name
+
+ The name `SCGroupMembersButton` can be used when providing style overrides in the theme.
+
+ * #### CSS
+ *
+ |Rule Name|Global class|Description|
+ |---|---|---|
+ |root|.SCGroupMembersButton-root|Styles applied to the root element.|
+ |dialogRoot|.SCGroupMembersButton-dialog-root|Styles applied to the root element.|
+ |endMessage|.SCCategoriesFollowedWidget-end-message|Styles applied to the end message element.|
+
+ * @param inProps
+ */
+export default function GroupMembersButton(inProps: GroupMembersButtonProps): JSX.Element;

package/lib/esm/components/GroupMembersButton/GroupMembersButton.js

@@ -0,0 +1,132 @@
+import { __rest } from "tslib";
+import React, { useEffect, useMemo, useState } from 'react';
+import { styled } from '@mui/material/styles';
+import { Avatar, AvatarGroup, Button, List, ListItem, Typography, useTheme } from '@mui/material';
+import BaseDialog from '../../shared/BaseDialog';
+import { FormattedMessage } from 'react-intl';
+import InfiniteScroll from '../../shared/InfiniteScroll';
+import User, { UserSkeleton } from '../User';
+import { GroupService, Endpoints, http } from '@selfcommunity/api-services';
+import { useSCFetchGroup } from '@selfcommunity/react-core';
+import AvatarGroupSkeleton from '../Skeleton/AvatarGroupSkeleton';
+import classNames from 'classnames';
+import { useThemeProps } from '@mui/system';
+import useMediaQuery from '@mui/material/useMediaQuery';
+import { Logger } from '@selfcommunity/utils';
+import { SCOPE_SC_UI } from '../../constants/Errors';
+import { useDeepCompareEffectNoCheck } from 'use-deep-compare-effect';
+const PREFIX = 'SCGroupMembersButton';
+const classes = {
+    root: `${PREFIX}-root`,
+    dialogRoot: `${PREFIX}-dialog-root`,
+    endMessage: `${PREFIX}-end-message`
+};
+const Root = styled(Button, {
+    name: PREFIX,
+    slot: 'Root',
+    overridesResolver: (props, styles) => styles.root
+})(() => ({}));
+const DialogRoot = styled(BaseDialog, {
+    name: PREFIX,
+    slot: 'Root',
+    overridesResolver: (props, styles) => styles.dialogRoot
+})(() => ({}));
+/**
+ *> API documentation for the Community-JS Group Members Button component. Learn about the available props and the CSS API.
+ *
+ #### Import
+ ```jsx
+ import {GroupMembersButton} from '@selfcommunity/react-ui';
+ ```
+ #### Component Name
+
+ The name `SCGroupMembersButton` can be used when providing style overrides in the theme.
+
+ * #### CSS
+ *
+ |Rule Name|Global class|Description|
+ |---|---|---|
+ |root|.SCGroupMembersButton-root|Styles applied to the root element.|
+ |dialogRoot|.SCGroupMembersButton-dialog-root|Styles applied to the root element.|
+ |endMessage|.SCCategoriesFollowedWidget-end-message|Styles applied to the end message element.|
+
+ * @param inProps
+ */
+export default function GroupMembersButton(inProps) {
+    // PROPS
+    const props = useThemeProps({
+        props: inProps,
+        name: PREFIX
+    });
+    const { className, groupId, group, DialogProps = {} } = props, rest = __rest(props, ["className", "groupId", "group", "DialogProps"]);
+    // STATE
+    const [loading, setLoading] = useState(true);
+    const [next, setNext] = useState(null);
+    const [offset, setOffset] = useState(null);
+    const [members, setMembers] = useState([]);
+    const [open, setOpen] = useState(false);
+    // HOOKS
+    const { scGroup } = useSCFetchGroup({ id: groupId, group });
+    // FETCH FIRST FOLLOWERS
+    useDeepCompareEffectNoCheck(() => {
+        if (!scGroup) {
+            return;
+        }
+        if (members.length === 0) {
+            GroupService.getGroupMembers(scGroup.id, { limit: 3 }).then((res) => {
+                setMembers([...res.results]);
+                setOffset(3);
+                setLoading(false);
+            });
+        }
+        else {
+            setOffset(0);
+        }
+    }, [scGroup]);
+    useEffect(() => {
+        if (open && offset !== null) {
+            setLoading(true);
+            GroupService.getGroupMembers(scGroup.id, { offset, limit: 20 }).then((res) => {
+                setMembers([...(offset === 0 ? [] : members), ...res.results]);
+                setNext(res.next);
+                setLoading(false);
+                setOffset(null);
+            });
+        }
+    }, [open, members, offset]);
+    /**
+     * Memoized fetchMembers
+     */
+    const fetchMembers = useMemo(() => () => {
+        if (!next) {
+            return;
+        }
+        http
+            .request({
+            url: next,
+            method: Endpoints.GetGroupSubscribers.method
+        })
+            .then((res) => {
+            setMembers([...members, ...res.data.results]);
+            setNext(res.data.next);
+        })
+            .catch((error) => Logger.error(SCOPE_SC_UI, error))
+            .then(() => setLoading(false));
+    }, [members, scGroup, next]);
+    /**
+     * Opens dialog votes
+     */
+    const handleToggleDialogOpen = useMemo(() => () => {
+        setOpen((prev) => !prev);
+    }, [setOpen]);
+    // RENDER
+    const theme = useTheme();
+    const isMobile = useMediaQuery(theme.breakpoints.down('md'));
+    return (React.createElement(React.Fragment, null,
+        React.createElement(Root, Object.assign({ className: classNames(classes.root, className), onClick: handleToggleDialogOpen, disabled: loading || !scGroup || scGroup.subscribers_counter === 0 }, rest), loading || !scGroup ? (React.createElement(AvatarGroupSkeleton, Object.assign({}, rest))) : (React.createElement(AvatarGroup, { total: scGroup.subscribers_counter }, members.map((c) => (React.createElement(Avatar, { key: c.id, alt: c.username, src: c.avatar })))))),
+        open && (React.createElement(DialogRoot, Object.assign({ className: classes.dialogRoot, title: React.createElement(FormattedMessage, { defaultMessage: "ui.groupMembersButton.dialogTitle", id: "ui.groupMembersButton.dialogTitle", values: { total: scGroup.subscribers_counter } }), onClose: handleToggleDialogOpen, open: open }, DialogProps),
+            React.createElement(InfiniteScroll, { dataLength: members.length, next: fetchMembers, hasMoreNext: next !== null || loading, loaderNext: React.createElement(UserSkeleton, { elevation: 0 }), height: isMobile ? '100%' : 400, endMessage: React.createElement(Typography, { className: classes.endMessage },
+                    React.createElement(FormattedMessage, { id: "ui.groupMembersButton.noOtherMembers", defaultMessage: "ui.groupMembersButton.noOtherMembers" })) },
+                React.createElement(List, null, members.map((member) => (React.createElement(ListItem, { key: member.id },
+                    React.createElement(User, { elevation: 0, user: member }))))))))));
+}

package/lib/esm/components/GroupMembersButton/index.d.ts

@@ -0,0 +1,3 @@
+import GroupMembersButton, { GroupMembersButtonProps } from './GroupMembersButton';
+export default GroupMembersButton;
+export { GroupMembersButtonProps };

package/lib/esm/components/GroupMembersButton/index.js

@@ -0,0 +1,2 @@
+import GroupMembersButton from './GroupMembersButton';
+export default GroupMembersButton;

package/lib/esm/components/GroupMembersWidget/GroupMembersWidget.d.ts

@@ -0,0 +1,79 @@
+import { WidgetProps } from '../Widget';
+import { SCGroupType } from '@selfcommunity/types';
+import { CacheStrategies } from '@selfcommunity/utils';
+import { BaseDialogProps } from '../../shared/BaseDialog';
+import { VirtualScrollerItemProps } from '../../types/virtualScroller';
+import { UserProps } from '../User';
+export interface GroupMembersWidgetProps extends VirtualScrollerItemProps, WidgetProps {
+    /**
+     * Group Object
+     * @default null
+     */
+    group?: SCGroupType;
+    /**
+     * Id of the group
+     * @default null
+     */
+    groupId?: number | string;
+    /**
+     * Hides this component
+     * @default false
+     */
+    autoHide?: boolean;
+    /**
+     * Limit the number of users to show
+     * @default false
+     */
+    limit?: number;
+    /**
+     * Caching strategies
+     * @default CacheStrategies.CACHE_FIRST
+     */
+    cacheStrategy?: CacheStrategies;
+    /**
+     * Props to spread to single user object
+     * @default empty object
+     */
+    UserProps?: UserProps;
+    /**
+     * Props to spread to followers users dialog
+     * @default {}
+     */
+    DialogProps?: BaseDialogProps;
+    /**
+     * Other props
+     */
+    [p: string]: any;
+}
+/**
+ * > API documentation for the Community-JS Group Members Widget component. Learn about the available props and the CSS API.
+ *
+ *
+ * This component renders the list of the follows of the given group.
+ * Take a look at our <strong>demo</strong> component [here](/docs/sdk/community-js/react-ui/Components/GroupMembers)
+
+ #### Import
+
+ ```jsx
+ import {GroupMembersWidget} from '@selfcommunity/react-ui';
+ ```
+
+ #### Component Name
+
+ The name `SCGroupMembersWidget` can be used when providing style overrides in the theme.
+
+
+ #### CSS
+
+ |Rule Name|Global class|Description|
+ |---|---|---|
+ |root|.SCGroupMembersWidget-root|Styles applied to the root element.|
+ |title|.SCGroupMembersWidget-title|Styles applied to the title element.|
+ |noResults|.SCGroupMembersWidget-no-results|Styles applied to no results section.|
+ |showMore|.SCGroupMembersWidget-show-more|Styles applied to show more button element.|
+ |dialogRoot|.SCGroupMembersWidget-dialog-root|Styles applied to the dialog root element.|
+ |endMessage|.SCGroupMembersWidget-end-message|Styles applied to the end message element.|
+
+ * @param inProps
+ */
+export default function GroupMembersWidget(inProps: GroupMembersWidgetProps): JSX.Element;