@firecms/collection_editor 3.0.0-alpha.9 → 3.0.0-beta.2-pre.1

package/src/ConfigControllerProvider.tsx

@@ -0,0 +1,336 @@
+import React, { PropsWithChildren, useCallback, useEffect } from "react";
+import equal from "react-fast-compare"
+
+import { CollectionsConfigController } from "./types/config_controller";
+import {
+    Property,
+    useCustomizationController,
+    useNavigationController,
+    User,
+    useSnackbarController
+} from "@firecms/core";
+import { CollectionEditorDialog } from "./ui/collection_editor/CollectionEditorDialog";
+import { useNavigate } from "react-router";
+import { CollectionEditorController } from "./types/collection_editor_controller";
+import { CollectionEditorPermissionsBuilder } from "./types/config_permissions";
+import { CollectionInference } from "./types/collection_inference";
+import { PropertyFormDialog } from "./ui/collection_editor/PropertyEditView";
+import { PersistedCollection } from "./types/persisted_collection";
+
+export const ConfigControllerContext = React.createContext<CollectionsConfigController>({} as any);
+export const CollectionEditorContext = React.createContext<CollectionEditorController>({} as any);
+
+export interface ConfigControllerProviderProps {
+    /**
+     * Controller for managing the collections' config.
+     */
+    collectionConfigController: CollectionsConfigController;
+
+    /**
+     * Callback used to infer the schema from the data.
+     */
+    collectionInference?: CollectionInference;
+
+    /**
+     * Use this builder to define the permissions for the configuration per user.
+     */
+    configPermissions?: CollectionEditorPermissionsBuilder;
+
+    /**
+     * Groups that cannot be used to create new collections.
+     */
+    reservedGroups?: string[];
+
+    extraView?: {
+        View: React.ComponentType<{
+            path: string
+        }>,
+        icon: React.ReactNode
+    };
+
+    pathSuggestions?: (path?: string) => Promise<string[]>;
+
+    getUser: (uid: string) => User | null
+
+    getData?: (path: string, parentPaths: string[]) => Promise<object[]>;
+
+    onAnalyticsEvent?: (event: string, params?: object) => void;
+
+}
+
+export const ConfigControllerProvider = React.memo(
+    function ConfigControllerProvider({
+                                          children,
+                                          collectionConfigController,
+                                          configPermissions,
+                                          reservedGroups,
+                                          collectionInference,
+                                          extraView,
+                                          pathSuggestions,
+                                          getUser,
+                                          getData,
+                                          onAnalyticsEvent
+                                      }: PropsWithChildren<ConfigControllerProviderProps>) {
+
+        const navigation = useNavigationController();
+        const navigate = useNavigate();
+        const snackbarController = useSnackbarController();
+        const { propertyConfigs } = useCustomizationController();
+
+        const {
+            collections
+        } = navigation;
+        const existingPaths = collections.map(col => col.path.trim().toLowerCase());
+
+        const [rootPathSuggestions, setRootPathSuggestions] = React.useState<string[] | undefined>();
+        useEffect(() => {
+            if (pathSuggestions) {
+                pathSuggestions().then((paths) => {
+                    setRootPathSuggestions(paths.filter(p => !existingPaths.includes(p.trim().toLowerCase())));
+                });
+            }
+        }, [pathSuggestions]);
+
+        const [currentDialog, setCurrentDialog] = React.useState<{
+            isNewCollection: boolean,
+            parentCollection?: PersistedCollection,
+            editedCollectionPath?: string,
+            fullPath?: string,
+            parentCollectionIds: string[],
+            initialValues?: {
+                path?: string,
+                group?: string,
+                name?: string
+            },
+            redirect: boolean
+        }>();
+
+        const [currentPropertyDialog, setCurrentPropertyDialog] = React.useState<{
+            propertyKey?: string,
+            property?: Property,
+            namespace?: string,
+            parentCollection?: PersistedCollection,
+            currentPropertiesOrder?: string[],
+            editedCollectionPath: string,
+            fullPath?: string,
+            parentCollectionIds: string[],
+            collectionEditable: boolean;
+        }>();
+
+        const defaultConfigPermissions: CollectionEditorPermissionsBuilder = useCallback(() => ({
+            createCollections: true,
+            editCollections: true,
+            deleteCollections: true
+        }), []);
+
+        const editCollection = useCallback(({
+                                                path,
+                                                fullPath,
+                                                parentCollectionIds,
+                                                parentCollection
+                                            }: {
+            path?: string,
+            fullPath?: string,
+            parentCollectionIds: string[],
+            parentCollection?: PersistedCollection
+        }) => {
+            console.debug("edit collection", path, fullPath, parentCollectionIds, parentCollection);
+            onAnalyticsEvent?.("edit_collection", { path, fullPath });
+            setCurrentDialog({
+                editedCollectionPath: path,
+                fullPath,
+                parentCollectionIds,
+                isNewCollection: false,
+                parentCollection,
+                redirect: false
+            });
+        }, []);
+
+        const editProperty = useCallback(({
+                                              propertyKey,
+                                              property,
+                                              editedCollectionPath,
+                                              currentPropertiesOrder,
+                                              parentCollectionIds,
+                                              collection
+                                          }: {
+            propertyKey?: string,
+            property?: Property,
+            currentPropertiesOrder?: string[],
+            editedCollectionPath: string,
+            parentCollectionIds: string[],
+            collection: PersistedCollection,
+        }) => {
+            console.debug("edit property", propertyKey, property, editedCollectionPath, currentPropertiesOrder, parentCollectionIds, collection);
+            onAnalyticsEvent?.("edit_property", { propertyKey, editedCollectionPath });
+            // namespace is all the path until the last dot
+            const namespace = propertyKey && propertyKey.includes(".")
+                ? propertyKey.substring(0, propertyKey.lastIndexOf("."))
+                : undefined;
+            const propertyKeyWithoutNamespace = propertyKey && propertyKey.includes(".")
+                ? propertyKey.substring(propertyKey.lastIndexOf(".") + 1)
+                : propertyKey;
+            setCurrentPropertyDialog({
+                propertyKey: propertyKeyWithoutNamespace,
+                property,
+                namespace,
+                currentPropertiesOrder,
+                editedCollectionPath,
+                parentCollectionIds,
+                collectionEditable: collection?.editable ?? false
+            });
+        }, []);
+
+        const createCollection = React.useCallback(({
+                                                        parentCollectionIds,
+                                                        parentCollection,
+                                                        initialValues,
+                                                        redirect
+                                                    }: {
+            parentCollectionIds: string[],
+            parentCollection?: PersistedCollection
+            initialValues?: {
+                group?: string,
+                path?: string,
+                name?: string
+            },
+            redirect: boolean
+        }) => {
+            console.debug("create collection", parentCollectionIds, parentCollection, initialValues, redirect);
+            onAnalyticsEvent?.("create_collection", { parentCollectionIds, parentCollection, initialValues, redirect });
+            setCurrentDialog({
+                isNewCollection: true,
+                parentCollectionIds,
+                parentCollection,
+                initialValues,
+                redirect
+            });
+        }, []);
+
+        const getPathSuggestions = !pathSuggestions
+            ? undefined
+            : (path?: string) => {
+                if (!path && rootPathSuggestions)
+                    return Promise.resolve(rootPathSuggestions);
+                else {
+                    return pathSuggestions?.(path);
+                }
+            }
+
+        return (
+            <ConfigControllerContext.Provider value={collectionConfigController}>
+                <CollectionEditorContext.Provider
+                    value={{
+                        editCollection,
+                        createCollection,
+                        editProperty,
+                        configPermissions: configPermissions ?? defaultConfigPermissions,
+                        rootPathSuggestions
+                    }}>
+
+                    {children}
+
+                    <CollectionEditorDialog
+                        open={Boolean(currentDialog)}
+                        configController={collectionConfigController}
+                        isNewCollection={false}
+                        collectionInference={collectionInference}
+                        {...currentDialog}
+                        getData={getData}
+                        reservedGroups={reservedGroups}
+                        extraView={extraView}
+                        pathSuggestions={getPathSuggestions}
+                        getUser={getUser}
+                        handleClose={(collection) => {
+                            if (currentDialog?.redirect) {
+                                if (collection && currentDialog?.isNewCollection && !currentDialog.parentCollectionIds.length) {
+                                    const url = navigation.buildUrlCollectionPath(collection.id ?? collection.path);
+                                    navigate(url);
+                                }
+                            }
+                            setCurrentDialog(undefined);
+                        }}/>
+
+                    {/* Used for editing properties*/}
+                    <PropertyFormDialog
+                        open={Boolean(currentPropertyDialog)}
+                        includeIdAndName={true}
+                        existingProperty={Boolean(currentPropertyDialog?.propertyKey)}
+                        autoUpdateId={!currentPropertyDialog ? false : !currentPropertyDialog?.propertyKey}
+                        autoOpenTypeSelect={!currentPropertyDialog ? false : !currentPropertyDialog?.propertyKey}
+                        inArray={false}
+                        collectionEditable={currentPropertyDialog?.collectionEditable ?? false}
+                        getData={getData && currentPropertyDialog?.editedCollectionPath
+                            ? () => {
+                                console.debug("get data for property", currentPropertyDialog?.editedCollectionPath);
+                                const resolvedPath = navigation.resolveAliasesFrom(currentPropertyDialog.editedCollectionPath!)
+                                return getData(resolvedPath, []);
+                            }
+                            : undefined}
+                        onPropertyChanged={({
+                                                id,
+                                                property
+                                            }) => {
+                            if (!currentPropertyDialog) return;
+                            if (!id) return;
+                            const newProperty = !(currentPropertyDialog.propertyKey);
+                            return collectionConfigController.saveProperty({
+                                path: currentPropertyDialog?.editedCollectionPath,
+                                property,
+                                propertyKey: id,
+                                newPropertiesOrder: newProperty && currentPropertyDialog.currentPropertiesOrder ? [...currentPropertyDialog.currentPropertiesOrder, id] : undefined,
+                                namespace: currentPropertyDialog.namespace,
+                                parentCollectionIds: currentPropertyDialog.parentCollectionIds
+                            })
+                                .catch((e) => {
+                                    console.error(e);
+                                    snackbarController.open({
+                                        type: "error",
+                                        message: "Error persisting property: " + (e.message ?? "Details in the console")
+                                    });
+                                    return false;
+                                });
+                        }}
+                        onPropertyChangedImmediate={false}
+                        onDelete={() => {
+                            if (!currentPropertyDialog?.propertyKey) return;
+                            const newPropertiesOrder = currentPropertyDialog?.currentPropertiesOrder?.filter(p => p !== currentPropertyDialog?.propertyKey);
+                            return collectionConfigController.deleteProperty({
+                                path: currentPropertyDialog?.editedCollectionPath,
+                                propertyKey: currentPropertyDialog?.propertyKey,
+                                namespace: currentPropertyDialog?.namespace,
+                                newPropertiesOrder,
+                                parentCollectionIds: currentPropertyDialog?.parentCollectionIds
+                            })
+                                .then(() => {
+                                    setCurrentPropertyDialog(undefined);
+                                }).catch((e) => {
+                                    console.error(e);
+                                    snackbarController.open({
+                                        type: "error",
+                                        message: "Error deleting property: " + (e.message ?? "Details in the console")
+                                    });
+                                    return false;
+                                });
+                        }}
+                        onError={() => {
+                        }}
+                        onOkClicked={() => {
+                            setCurrentPropertyDialog(undefined);
+                        }}
+                        onCancel={() => {
+                            setCurrentPropertyDialog(undefined);
+                        }}
+                        initialErrors={{}}
+                        forceShowErrors={false}
+                        existingPropertyKeys={[]}
+                        allowDataInference={true}
+                        propertyConfigs={propertyConfigs}
+                        property={currentPropertyDialog?.property}
+                        propertyKey={currentPropertyDialog?.propertyKey}/>
+
+                </CollectionEditorContext.Provider>
+
+            </ConfigControllerContext.Provider>
+        );
+    }, equal);

package/src/index.ts

@@ -0,0 +1,35 @@
+export {
+    useCollectionEditorPlugin
+} from "./useCollectionEditorPlugin";
+
+export {
+    useCollectionEditorController
+} from "./useCollectionEditorController";
+export {
+    useCollectionsConfigController
+} from "./useCollectionsConfigController";
+
+export {
+    editableProperty, removeNonEditableProperties
+} from "./utils/entities";
+
+export type {
+    CollectionsConfigController, DeleteCollectionParams, SaveCollectionParams, UpdateCollectionParams
+} from "./types/config_controller";
+export type {
+    CollectionEditorController
+} from "./types/collection_editor_controller";
+export type {
+    CollectionEditorPermissions, CollectionEditorPermissionsBuilder
+} from "./types/config_permissions";
+export type {
+    PersistedCollection
+} from "./types/persisted_collection";
+
+export type {
+    CollectionInference
+} from "./types/collection_inference";
+
+export { MissingReferenceWidget } from "./ui/MissingReferenceWidget";
+
+export * from "./ui/collection_editor/util";

package/src/types/collection_editor_controller.tsx

@@ -0,0 +1,42 @@
+import { CollectionEditorPermissionsBuilder } from "./config_permissions";
+import { Property } from "@firecms/core";
+import { PersistedCollection } from "./persisted_collection";
+
+/**
+ * Controller to open the collection editor dialog.
+ * @group Hooks and utilities
+ */
+export interface CollectionEditorController {
+
+    editCollection: (props: {
+        path?: string,
+        fullPath?: string,
+        parentCollectionIds: string[],
+        parentCollection?: PersistedCollection
+    }) => void;
+
+    createCollection: (props: {
+        initialValues?: {
+            group?: string,
+            path?: string,
+            name?: string
+        },
+        parentCollectionIds: string[],
+        parentCollection?: PersistedCollection,
+        redirect: boolean
+    }) => void;
+
+    editProperty: (props: {
+        propertyKey?: string,
+        property?: Property,
+        currentPropertiesOrder?: string[],
+        editedCollectionPath: string,
+        parentCollectionIds: string[],
+        collection: PersistedCollection
+    }) => void;
+
+    configPermissions: CollectionEditorPermissionsBuilder;
+
+    rootPathSuggestions?: string[];
+
+}

package/src/types/collection_inference.ts

@@ -0,0 +1,3 @@
+import { EntityCollection } from "@firecms/core";
+
+export type CollectionInference = (path: string, collectionGroup: boolean, parentCollectionIds: string[]) => Promise<Partial<EntityCollection> | null>;

package/src/types/config_controller.tsx

@@ -0,0 +1,60 @@
+import { CMSType, Property } from "@firecms/core";
+import { PersistedCollection } from "./persisted_collection";
+
+/**
+ * Use this controller to access the configuration that is stored externally,
+ * and not defined in code.
+ */
+export interface CollectionsConfigController {
+
+    loading: boolean;
+
+    collections?: PersistedCollection[];
+
+    getCollection: (id: string) => PersistedCollection;
+
+    saveCollection: <M extends { [Key: string]: CMSType }>(params: SaveCollectionParams<M>) => Promise<void>;
+    updateCollection: <M extends { [Key: string]: CMSType }>(params: UpdateCollectionParams<M>) => Promise<void>;
+
+    saveProperty: (params: SavePropertyParams) => Promise<void>;
+    deleteProperty: (params: DeletePropertyParams) => Promise<void>;
+
+    deleteCollection: (props: DeleteCollectionParams) => Promise<void>;
+
+}
+
+export type UpdateCollectionParams<M extends Record<string, any>> = {
+    id: string,
+    collectionData: Partial<PersistedCollection<M>>,
+    previousPath?: string,
+    parentCollectionIds?: string[]
+}
+
+export type SaveCollectionParams<M extends Record<string, any>> = {
+    id: string,
+    collectionData: PersistedCollection<M>,
+    previousPath?: string,
+    parentCollectionIds?: string[]
+}
+
+export type SavePropertyParams = {
+    path: string,
+    propertyKey: string,
+    namespace?: string,
+    newPropertiesOrder?: string[],
+    property: Property,
+    parentCollectionIds?: string[]
+}
+
+export type DeletePropertyParams = {
+    path: string,
+    propertyKey: string,
+    namespace?: string,
+    newPropertiesOrder?: string[],
+    parentCollectionIds?: string[]
+}
+
+export type DeleteCollectionParams = {
+    path: string,
+    parentCollectionIds?: string[]
+}

package/src/types/config_permissions.ts

@@ -0,0 +1,20 @@
+import { EntityCollection } from "@firecms/core";
+
+export type CollectionEditorPermissionsBuilder<UserType = any, EC extends EntityCollection = EntityCollection> = (params: { user: UserType | null, collection?: EC }) => CollectionEditorPermissions;
+
+export type CollectionEditorPermissions = {
+    /**
+     * Is the user allowed to create new collections.
+     */
+    createCollections: boolean;
+
+    /**
+     * Is the user allowed to modify this collection
+     */
+    editCollections: boolean;
+
+    /**
+     * Is the user allowed to delete this collection
+     */
+    deleteCollections: boolean;
+}

package/src/types/persisted_collection.ts

@@ -0,0 +1,9 @@
+import { EntityCollection, User } from "@firecms/core";
+
+export type PersistedCollection<M extends Record<string, any> = any, UserType extends User = User>
+    = Omit<EntityCollection<M, UserType>, "subcollections"> & {
+    // properties: Properties<M>;
+    ownerId: string;
+    subcollections?: PersistedCollection<any, any>[];
+    editable?: boolean;
+}

package/src/ui/CollectionViewHeaderAction.tsx

@@ -0,0 +1,43 @@
+import { ResolvedProperty } from "@firecms/core";
+import { IconButton, SettingsIcon, Tooltip } from "@firecms/ui";
+import React from "react";
+import { useCollectionEditorController } from "../useCollectionEditorController";
+import { PersistedCollection } from "../types/persisted_collection";
+
+export function CollectionViewHeaderAction({
+                                               propertyKey,
+                                               onHover,
+                                               property,
+                                               fullPath,
+                                               parentCollectionIds,
+                                               collection
+                                           }: {
+    property: ResolvedProperty,
+    propertyKey: string,
+    onHover: boolean,
+    fullPath: string,
+    parentCollectionIds: string[],
+    collection: PersistedCollection;
+}) {
+
+    const collectionEditorController = useCollectionEditorController();
+
+    return (
+        <Tooltip title={"Edit"}>
+            <IconButton
+                className={onHover ? "bg-white dark:bg-gray-950" : "hidden"}
+                onClick={() => {
+                    collectionEditorController.editProperty({
+                        propertyKey,
+                        property,
+                        editedCollectionPath: fullPath,
+                        parentCollectionIds,
+                        collection
+                    });
+                }}
+                size={"small"}>
+                <SettingsIcon size={"small"}/>
+            </IconButton>
+        </Tooltip>
+    )
+}

package/src/ui/EditorCollectionAction.tsx

@@ -0,0 +1,109 @@
+import equal from "react-fast-compare"
+
+import {
+    CollectionActionsProps,
+    mergeDeep,
+    useAuthController,
+    useNavigationController,
+    useSnackbarController
+} from "@firecms/core";
+import { Button, IconButton, SaveIcon, SettingsIcon, Tooltip, UndoIcon, } from "@firecms/ui";
+
+import { useCollectionEditorController } from "../useCollectionEditorController";
+import { useCollectionsConfigController } from "../useCollectionsConfigController";
+import { PersistedCollection } from "../types/persisted_collection";
+
+export function EditorCollectionAction({
+                                           path: fullPath,
+                                           parentCollectionIds,
+                                           collection,
+                                           tableController
+                                       }: CollectionActionsProps) {
+
+    const authController = useAuthController();
+    const navigationController = useNavigationController();
+    const collectionEditorController = useCollectionEditorController();
+    const configController = useCollectionsConfigController();
+    const snackbarController = useSnackbarController();
+
+    const parentCollection = navigationController.getCollectionFromIds(parentCollectionIds);
+
+    const canEditCollection = collectionEditorController.configPermissions
+        ? collectionEditorController.configPermissions({
+            user: authController.user,
+            collection
+        }).editCollections
+        : true;
+
+    let saveDefaultFilterButton = null;
+    if (!equal(getObjectOrNull(tableController.filterValues), getObjectOrNull(collection.initialFilter)) ||
+        !equal(getObjectOrNull(tableController.sortBy), getObjectOrNull(collection.initialSort))) {
+        saveDefaultFilterButton = <>
+            {collection.initialFilter || collection.initialSort && <Tooltip
+                title={"Reset to default filter and sort"}>
+                <Button
+                    color={"primary"}
+                    size={"small"}
+                    variant={"text"}
+                    onClick={() => {
+                        tableController.clearFilter?.();
+                        if (collection?.initialFilter)
+                            tableController.setFilterValues?.(collection?.initialFilter);
+                        if (collection?.initialSort)
+                            tableController.setSortBy?.(collection?.initialSort);
+                    }}>
+                    <UndoIcon/>
+                </Button>
+            </Tooltip>}
+
+            <Tooltip
+                title={tableController.sortBy || tableController.filterValues ? "Save default filter and sort" : "Clear default filter and sort"}>
+                <Button
+                    color={"primary"}
+                    size={"small"}
+                    variant={"outlined"}
+                    onClick={() => configController
+                        ?.saveCollection({
+                            id: collection.path,
+                            parentCollectionIds,
+                            collectionData: mergeDeep(collection as PersistedCollection,
+                                {
+                                    initialFilter: tableController.filterValues ?? null,
+                                    initialSort: tableController.sortBy ?? null
+                                })
+                        }).then(() => {
+                            snackbarController.open({
+                                type: "success",
+                                message: "Default config saved"
+                            });
+                        })}>
+                    <SaveIcon/>
+                </Button>
+            </Tooltip>
+        </>;
+    }
+
+    const editorButton = <Tooltip
+        title={canEditCollection ? "Edit collection" : "You don't have permissions to edit this collection"}>
+        <IconButton
+            color={"primary"}
+            disabled={!canEditCollection}
+            onClick={canEditCollection
+                ? () => collectionEditorController?.editCollection({ path: collection.path, fullPath, parentCollectionIds, parentCollection: parentCollection as PersistedCollection })
+                : undefined}>
+            <SettingsIcon/>
+        </IconButton>
+    </Tooltip>;
+
+    return <>
+        {canEditCollection && saveDefaultFilterButton}
+        {editorButton}
+    </>
+
+}
+
+function getObjectOrNull(o?: object): object | null {
+    if (o && Object.keys(o).length === 0)
+        return o
+    return o ?? null;
+}