@firecms/user_management 3.3.0 → 3.4.0-canary.1faa2a9

package/dist/useUserManagementPlugin.d.ts

@@ -7,4 +7,4 @@ export declare function IntroWidget({ noUsers, noRoles, userManagement }: {
     noUsers: boolean;
     noRoles: boolean;
     userManagement: UserManagement<any>;
-}): import("react").JSX.Element;
+}): import("react").JSX.Element | null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@firecms/user_management",
   "type": "module",
-  "version": "3.3.0",
+  "version": "3.4.0-canary.1faa2a9",
   "publishConfig": {
     "access": "public"
   },
@@ -29,9 +29,9 @@
   "types": "./dist/index.d.ts",
   "source": "src/index.ts",
   "dependencies": {
-    "@firecms/core": "^3.3.0",
-    "@firecms/formex": "^3.3.0",
-    "@firecms/ui": "^3.3.0",
+    "@firecms/core": "3.4.0-canary.1faa2a9",
+    "@firecms/formex": "3.4.0-canary.1faa2a9",
+    "@firecms/ui": "3.4.0-canary.1faa2a9",
     "date-fns": "^3.6.0"
   },
   "peerDependencies": {
@@ -39,7 +39,7 @@
     "react-dom": ">=18.3.1 || >=19.0.0"
   },
   "devDependencies": {
-    "@types/node": "^20.19.17",
+    "@types/node": "^26.1.1",
     "@types/react": "^19.2.3",
     "@types/react-dom": "^19.2.3",
     "babel-plugin-react-compiler": "^19.0.0-beta-af1b7da-20250417",

package/src/components/UserManagementPausedNotice.tsx

@@ -0,0 +1,35 @@
+import React from "react";
+import { getLicenseSubscribeUrl, useLicenseStatus, useTranslation } from "@firecms/core";
+import { Button, Paper, Typography } from "@firecms/ui";
+
+/**
+ * Shown by the Users and Roles views instead of their editors while FireCMS
+ * PRO is paused. The user management plugin itself stays mounted, so sign-in
+ * and role checks keep working; only editing users and roles is paused.
+ */
+export function UserManagementPausedNotice() {
+    const { t } = useTranslation();
+    const licenseStatus = useLicenseStatus();
+    const linkLabel = licenseStatus?.licenseState === "invalid_project"
+        ? t("license_add_project_to_license")
+        : t("license_get_license");
+
+    return (
+        <Paper
+            className={"flex flex-col items-start px-4 py-6 bg-white dark:bg-surface-accent-800 gap-2"}>
+            <Typography variant={"subtitle2"} className={"uppercase"}>
+                {t("pro_features_paused")}
+            </Typography>
+            <Typography>
+                {t("user_management_paused_description")}
+            </Typography>
+            <Button
+                component={"a"}
+                href={getLicenseSubscribeUrl(licenseStatus)}
+                target={"_blank"}
+                rel={"noopener noreferrer"}>
+                {linkLabel}
+            </Button>
+        </Paper>
+    );
+}

package/src/components/roles/RolesView.tsx

@@ -1,14 +1,16 @@
 import React, { useCallback, useState } from "react";
 
-import { Role, useNavigationController, useTranslation
+import { isProPaused, Role, useLicenseStatus, useNavigationController, useTranslation
 } from "@firecms/core";
 import { AddIcon, Button, Container, Typography } from "@firecms/ui";
 import { RolesTable } from "./RolesTable";
 import { RolesDetailsForm } from "./RolesDetailsForm";
+import { UserManagementPausedNotice } from "../UserManagementPausedNotice";
 
 export const RolesView = React.memo(
     function RolesView({ children }: { children?: React.ReactNode }) {
     const { t } = useTranslation();
+    const paused = isProPaused(useLicenseStatus());
 
 
         const { collections } = useNavigationController();
@@ -25,6 +27,18 @@ export const RolesView = React.memo(
             setDialogOpen(false);
         };
 
+        if (paused) {
+            return (
+                <Container className="w-full flex flex-col py-4 gap-4" maxWidth={"6xl"}>
+                    {children}
+                    <Typography gutterBottom variant="h4"
+                                className="mt-12"
+                                component="h4">{t("roles")}</Typography>
+                    <UserManagementPausedNotice/>
+                </Container>
+            );
+        }
+
         return (
             <Container className="w-full flex flex-col py-4 gap-4" maxWidth={"6xl"}>
 

package/src/components/users/UsersTable.tsx

@@ -1,13 +1,13 @@
 import { useState } from "react";
 
 import { format } from "date-fns";
-import * as locales from "date-fns/locale";
 
 import {
     defaultDateFormat,
     ConfirmationDialog, Role,
     useAuthController,
     useCustomizationController, User,
+    useDateFnsLocale,
     useSnackbarController,
     useTranslation
 } from "@firecms/core";
@@ -44,7 +44,7 @@ export function UsersTable({ onUserClicked }: {
     const snackbarController = useSnackbarController();
 
     const customizationController = useCustomizationController();
-    const dateUtilsLocale = customizationController?.locale ? locales[customizationController?.locale as keyof typeof locales] : undefined;
+    const dateUtilsLocale = useDateFnsLocale(customizationController?.locale);
     const dateFormat: string = customizationController?.dateTimeFormat ?? defaultDateFormat;
 
     const [userToBeDeleted, setUserToBeDeleted] = useState<User | undefined>(undefined);

package/src/components/users/UsersView.tsx

@@ -4,11 +4,13 @@ import { UsersTable } from "./UsersTable";
 import { UserDetailsForm } from "./UserDetailsForm";
 import React, { useCallback, useState } from "react";
 import { useUserManagement } from "../../hooks/useUserManagement";
-import { User, useTranslation
+import { isProPaused, useLicenseStatus, User, useTranslation
 } from "@firecms/core";
+import { UserManagementPausedNotice } from "../UserManagementPausedNotice";
 
 export const UsersView = function UsersView({ children }: { children?: React.ReactNode }) {
     const { t } = useTranslation();
+    const paused = isProPaused(useLicenseStatus());
 
 
     const [dialogOpen, setDialogOpen] = useState<boolean>(false);
@@ -33,6 +35,18 @@ export const UsersView = function UsersView({ children }: { children?: React.Rea
         setDialogOpen(true);
     }, []);
 
+    if (paused) {
+        return (
+            <Container className="w-full flex flex-col py-4 gap-4" maxWidth={"6xl"}>
+                {children}
+                <Typography gutterBottom variant="h4"
+                            className="mt-12"
+                            component="h4">{t("users")}</Typography>
+                <UserManagementPausedNotice/>
+            </Container>
+        );
+    }
+
     return (
         <Container className="w-full flex flex-col py-4 gap-4" maxWidth={"6xl"}>
 

package/src/hooks/useBuildUserManagement.tsx

@@ -200,7 +200,7 @@ export function useBuildUserManagement<CONTROLLER extends AuthController<any> =
                 path: usersPath,
                 id: userExists.uid
             }
-            await dataSourceDelegate.deleteEntity({ entity })
+            await dataSourceDelegate.deleteEntity({ entity, pathSegments: undefined })
                 .then(() => {
                     console.debug("Deleted previous user", userExists);
                 })
@@ -213,6 +213,10 @@ export function useBuildUserManagement<CONTROLLER extends AuthController<any> =
         return dataSourceDelegate.saveEntity({
             status: "existing",
             path: usersPath,
+            // `usersPath` / `rolesPath` are configurable path strings this hook never parses.
+            // Segments are left undefined rather than split out of one: absent means "not known
+            // here", and a split would be wrong for any configured id containing "/".
+            pathSegments: undefined,
             entityId: email,
             values: removeUndefined(data)
         }).then(() => user);
@@ -229,6 +233,10 @@ export function useBuildUserManagement<CONTROLLER extends AuthController<any> =
         return dataSourceDelegate.saveEntity({
             status: "existing",
             path: rolesPath,
+            // `usersPath` / `rolesPath` are configurable path strings this hook never parses.
+            // Segments are left undefined rather than split out of one: absent means "not known
+            // here", and a split would be wrong for any configured id containing "/".
+            pathSegments: undefined,
             entityId: id,
             values: removeUndefined(roleData)
         }).then(() => {
@@ -246,7 +254,7 @@ export function useBuildUserManagement<CONTROLLER extends AuthController<any> =
             id: uid,
             values: {}
         };
-        await dataSourceDelegate.deleteEntity({ entity })
+        await dataSourceDelegate.deleteEntity({ entity, pathSegments: undefined })
     }, [usersPath, dataSourceDelegate?.initialised]);
 
     const deleteRole = useCallback(async (role: Role): Promise<void> => {
@@ -259,7 +267,7 @@ export function useBuildUserManagement<CONTROLLER extends AuthController<any> =
             id: id,
             values: {}
         };
-        await dataSourceDelegate.deleteEntity({ entity })
+        await dataSourceDelegate.deleteEntity({ entity, pathSegments: undefined })
     }, [rolesPath, dataSourceDelegate?.initialised]);
 
     const collectionPermissions: PermissionsBuilder = useCallback(({

package/src/useUserManagementPlugin.tsx

@@ -1,4 +1,12 @@
-import { FireCMSPlugin, useAuthController, User, useSnackbarController, useTranslation } from "@firecms/core";
+import {
+    FireCMSPlugin,
+    isProPaused,
+    useAuthController,
+    useLicenseStatus,
+    User,
+    useSnackbarController,
+    useTranslation
+} from "@firecms/core";
 import { UserManagementProvider } from "./UserManagementProvider";
 import { UserManagement } from "./types";
 import { AddIcon, Button, Paper, Typography } from "@firecms/ui";
@@ -47,6 +55,12 @@ export function IntroWidget({
     const authController = useAuthController();
     const snackbarController = useSnackbarController();
     const { t } = useTranslation();
+    const licenseStatus = useLicenseStatus();
+
+    // Creating roles and users is paused with PRO; the Users and Roles views
+    // say so. The plugin itself stays mounted for sign-in and role checks.
+    if (isProPaused(licenseStatus))
+        return null;
 
     const buttonLabel = noUsers && noRoles
         ? t("create_default_roles_and_add_admin")