@rebasepro/core 0.2.3 → 0.2.5

package/src/core/RebaseProps.tsx

@@ -1,5 +1,10 @@
 import React from "react";
-import { Locale, User, AuthController, AnalyticsEvent, DataDriver, StorageSource, UserConfigurationPersistence, CollectionRegistryController, DatabaseAdmin, UrlController, NavigationStateController, RebaseData, RebaseClient, RebaseContext, UserManagementDelegate, EntityLinkBuilder, RebasePlugin, SlotContribution, PropertyConfig, EntityCustomView, EntityAction } from "@rebasepro/types";
+import { Locale, User, AuthController, AnalyticsEvent, DataDriver, StorageSource, UserConfigurationPersistence, CollectionRegistryController, DatabaseAdmin, UrlController, NavigationStateController, RebaseData, RebaseClient, RebaseContext, UserManagementDelegate, EntityLinkBuilder, RebasePlugin, SlotContribution, PropertyConfig, EntityCustomView, EntityAction, RebaseTranslations } from "@rebasepro/types";
+
+/** DeepPartial helper — allows partial overrides at any nesting level */
+type DeepPartial<T> = T extends object
+    ? { [K in keyof T]?: DeepPartial<T[K]> }
+    : T;
 
 /**
  * Controller to simulate different roles when dev mode is active.
@@ -138,7 +143,7 @@ export type RebaseProps<USER extends User> = {
     /**
      * Entity Views
      */
-    entityViews?: EntityCustomView<any>[];
+    entityViews?: EntityCustomView[];
 
     /**
      * Entity Actions
@@ -161,4 +166,12 @@ export type RebaseProps<USER extends User> = {
      */
     effectiveRoleController?: EffectiveRoleController;
 
+    /**
+     * Override or extend any Rebase UI string, keyed by locale.
+     */
+    translations?: {
+        [locale: string]: DeepPartial<RebaseTranslations>;
+    };
+
 };
+

package/src/core/RebaseRouter.tsx

@@ -5,7 +5,7 @@ export function RebaseRouter({
     children,
     basePath
 }: {
-    children: any,
+    children: React.ReactNode,
     basePath?: string;
 }) {
     return <RouterProvider router={createBrowserRouter([

package/src/hooks/data/useCollectionFetch.tsx

@@ -22,6 +22,16 @@ export interface CollectionFetchProps<M extends Record<string, any>> {
      */
     itemCount?: number;
 
+    /**
+     * Number of items to skip
+     */
+    offset?: number;
+
+    /**
+     * Page number (1-indexed), alternative to offset
+     */
+    page?: number;
+
     /**
      * Filter the fetched data by the property
      */
@@ -46,6 +56,7 @@ export interface CollectionFetchResult<M extends Record<string, any>> {
     dataLoading: boolean;
     noMoreToLoad: boolean;
     dataLoadingError?: Error;
+    totalCount?: number;
 }
 
 /**
@@ -55,6 +66,8 @@ export interface CollectionFetchResult<M extends Record<string, any>> {
  * @param filterValues
  * @param sortBy
  * @param itemCount
+ * @param offset
+ * @param page
  * @param searchString
  * @group Hooks and utilities
  */
@@ -65,6 +78,8 @@ export function useCollectionFetch<M extends Record<string, any>, USER extends U
         filterValues,
         sortBy,
         itemCount,
+        offset,
+        page,
         searchString
     }: CollectionFetchProps<M>): CollectionFetchResult<M> {
     const dataClient = useData();
@@ -99,12 +114,13 @@ export function useCollectionFetch<M extends Record<string, any>, USER extends U
     const [dataLoading, setDataLoading] = useState<boolean>(false);
     const [dataLoadingError, setDataLoadingError] = useState<Error | undefined>();
     const [noMoreToLoad, setNoMoreToLoad] = useState<boolean>(false);
+    const [totalCount, setTotalCount] = useState<number | undefined>();
 
     useEffect(() => {
 
         setDataLoading(true);
 
-        const onEntitiesUpdate = async (res: { data: Entity<M>[], meta: { hasMore: boolean } }) => {
+        const onEntitiesUpdate = async (res: { data: Entity<M>[], meta: { hasMore: boolean; total?: number } }) => {
             const entities = res.data;
             setDataLoading(false);
             setDataLoadingError(undefined);
@@ -112,6 +128,7 @@ export function useCollectionFetch<M extends Record<string, any>, USER extends U
                 ...e
             })));
             setNoMoreToLoad(!res.meta.hasMore);
+            setTotalCount(res.meta.total);
         };
 
         const onError = (error: Error) => {
@@ -119,6 +136,7 @@ export function useCollectionFetch<M extends Record<string, any>, USER extends U
             setDataLoading(false);
             setData([]);
             setDataLoadingError(error);
+            setTotalCount(undefined);
         };
 
         const accessor = dataClient.collection(path);
@@ -133,6 +151,8 @@ export function useCollectionFetch<M extends Record<string, any>, USER extends U
             return accessor.listen({
                 where: whereParams,
                 limit: itemCount,
+                offset,
+                page,
                 orderBy: orderByParams,
                 searchString,
                 include: includeParams
@@ -141,6 +161,8 @@ export function useCollectionFetch<M extends Record<string, any>, USER extends U
             accessor.find({
                 where: whereParams,
                 limit: itemCount,
+                offset,
+                page,
                 orderBy: orderByParams,
                 searchString,
                 include: includeParams
@@ -150,13 +172,14 @@ export function useCollectionFetch<M extends Record<string, any>, USER extends U
             return () => {
             };
         }
-    }, [path, itemCount, currentSort, sortByProperty, filterValues, searchString, dataClient, collection]);
+    }, [path, itemCount, offset, page, currentSort, sortByProperty, filterValues, searchString, dataClient, collection]);
 
     return useMemo(() => ({
         data,
         dataLoading,
         dataLoadingError,
-        noMoreToLoad
-    }), [data, dataLoading, dataLoadingError, noMoreToLoad]);
+        noMoreToLoad,
+        totalCount
+    }), [data, dataLoading, dataLoadingError, noMoreToLoad, totalCount]);
 
 }

package/src/hooks/data/useUserSelector.tsx

@@ -142,7 +142,7 @@ export function useUserSelector(
     }, []);
 
     const getUser = useCallback((uid: string): User | null => {
-        return userManagement?.getUser(uid) ?? null;
+        return userManagement?.getUser?.(uid) ?? null;
     }, [userManagement]);
 
     return useMemo(() => ({

package/src/hooks/index.tsx

@@ -33,7 +33,6 @@ export * from "./useCustomizationController";
 export * from "./useBuildLocalConfigurationPersistence";
 export * from "./useBuildModeController";
 
-export * from "./useValidateAuthenticator";
 export * from "./useRebaseRegistry";
 export * from "./useBackendStorageSource";
 export * from "./usePermissions";

package/src/hooks/useResolvedComponent.tsx

@@ -13,7 +13,8 @@ import { isLazyComponentRef } from "@rebasepro/types";
  * to the `React.lazy()` wrapper it produced. Strings are keyed by a separate
  * plain Map since they can't be WeakMap keys.
  */
-const lazyCache = new WeakMap<object | ((..._args: any[]) => any), React.ComponentType<any>>();
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const lazyCache = new WeakMap<object | Function, React.ComponentType<any>>();
 
 /**
  * Resolves a `ComponentRef` into a renderable `React.ComponentType`.
@@ -62,7 +63,7 @@ export function useResolvedComponent<P = unknown>(
  * same loader always returns the same lazy component identity.
  */
 function getOrCreateLazy<P>(
-    key: object | ((..._args: any[]) => any),
+    key: object | Function,
     loader: () => Promise<{ default: React.ComponentType<P> }>
 ): React.ComponentType<P> {
     const cached = lazyCache.get(key);
@@ -108,7 +109,7 @@ export function resolveComponentRef<P = unknown>(
 
     // 3. Function — either a React component or a lazy import loader.
     if (typeof ref === "function") {
-        const fn = ref as (..._args: any[]) => any;
+        const fn = ref as Function;
 
         // Class components (React.Component / PureComponent) have this flag
         if (fn.prototype?.isReactComponent) {

package/src/locales/en.ts

@@ -164,6 +164,9 @@ export const en: RebaseTranslations = {
     navigation_drawer: "Navigation drawer",
     collapse: "Collapse",
     expand: "Expand",
+    change_language: "Change language",
+    toggle_theme: "Toggle theme",
+    user_menu: "User menu",
 
     // ─── Error states ─────────────────────────────────────────────
     error: "Error",
@@ -451,7 +454,17 @@ export const en: RebaseTranslations = {
     select_references: "Select references",
     account_settings: "Account Settings",
     profile: "Profile",
+    security: "Security",
     sessions: "Sessions",
+    change_password: "Change Password",
+    current_password: "Current Password",
+    new_password: "New Password",
+    confirm_password: "Confirm New Password",
+    password_changed: "Password changed successfully. You will be logged out.",
+    passwords_dont_match: "Passwords don't match",
+    password_too_short: "Password must be at least 8 characters",
+    password_change_not_available: "Password change is not available for accounts using external sign-in providers.",
+    changing_password: "Changing...",
     display_name: "Display Name",
     photo_url: "Photo URL",
     save_profile: "Save Profile",

package/src/locales/es.ts

@@ -652,7 +652,17 @@ no_filter: "No filter",
     select_references: "Select references",
     account_settings: "Account Settings",
     profile: "Profile",
-    sessions: "Sessions",
+    sessions: "Sesiones",
+    security: "Seguridad",
+    change_password: "Cambiar Contraseña",
+    current_password: "Contraseña Actual",
+    new_password: "Nueva Contraseña",
+    confirm_password: "Confirmar Nueva Contraseña",
+    password_changed: "Contraseña cambiada con éxito. Se cerrará tu sesión.",
+    passwords_dont_match: "Las contraseñas no coinciden",
+    password_too_short: "La contraseña debe tener al menos 8 caracteres",
+    password_change_not_available: "El cambio de contraseña no está disponible para cuentas que usan proveedores de inicio de sesión externos.",
+    changing_password: "Cambiando...",
     display_name: "Display Name",
     photo_url: "Photo URL",
     save_profile: "Save Profile",

package/src/util/entity_cache.ts

@@ -154,9 +154,7 @@ export function getEntityFromMemoryCache(path: string): object | undefined {
     return entityCache.get(path);
 }
 
-export function hasEntityInCache(path: string): boolean {
-    return entityCache.has(path);
-}
+
 
 /**
  * Retrieves an entity from the in-memory cache or `sessionStorage`.
@@ -212,31 +210,7 @@ export function removeEntityFromCache(path: string): void {
     }
 }
 
-/**
- * Clears the entire in-memory cache and removes all related entities from `sessionStorage`.
- */
-export function clearEntityCache(): void {
-    // Clear the in-memory cache
-    entityCache.clear();
 
-    // Remove all entities with the specified prefix from sessionStorage
-    if (isSessionStorageAvailable) {
-        try {
-            const keysToRemove: string[] = [];
-            for (let i = 0; i < sessionStorage.length; i++) {
-                const fullKey = sessionStorage.key(i);
-                if (fullKey && fullKey.startsWith(LOCAL_STORAGE_PREFIX)) {
-                    keysToRemove.push(fullKey);
-                }
-            }
-
-            // Remove the keys after collecting them to avoid issues while iterating
-            keysToRemove.forEach((key) => sessionStorage.removeItem(key));
-        } catch (error) {
-            console.error("Failed to clear entity cache from sessionStorage:", error);
-        }
-    }
-}
 
 export function flattenKeys(obj: Record<string, unknown> | unknown[], prefix = "", result: string[] = []): string[] {
 

package/src/util/icon_list.ts

@@ -1,11 +1,11 @@
-import { iconSynonyms } from "./icon_synonyms";
+const iconSynonyms: Record<string, string> = {};
 import { iconKeys } from "@rebasepro/ui";
 import Fuse from "fuse.js";
 
 
 const map = iconKeys
     .map((importName) => {
-        const iconSynonym = importName in iconSynonyms ? (iconSynonyms as Record<string, string>)[importName] : "";
+        const iconSynonym = importName in iconSynonyms ? iconSynonyms[importName] : "";
         return {
             key: importName,
             synonyms: iconSynonym

package/src/util/index.ts

@@ -1,12 +1,12 @@
 
 export * from "./icon_list";
-export * from "./icon_synonyms";
+
 export * from "./icons";
 export * from "./createFormexStub";
 export * from "./entity_cache";
 
 export * from "./useStorageUploadController";
-export * from "./useTraceUpdate";
+
 export * from "./previews";
 export * from "./enums";
 export * from "./constants";

package/src/util/previews.ts

@@ -22,6 +22,11 @@ function isRelationProperty(property: Property) {
     return false;
 }
 
+function isHiddenProperty(property: Property | undefined): boolean {
+    if (!property) return false;
+    return Boolean(property.ui?.hideFromCollection);
+}
+
 export function getEntityPreviewKeys(
     authController: AuthController,
     targetCollection: EntityCollection<any>,
@@ -45,7 +50,7 @@ export function getEntityPreviewKeys(
             })
             .filter(key => {
                 const property = targetCollection.properties[key];
-                return property && !isPropertyBuilder(property) && !isReferenceProperty(property) && !isRelationProperty(property);
+                return property && !isPropertyBuilder(property) && !isReferenceProperty(property) && !isRelationProperty(property) && !isHiddenProperty(property);
             }).slice(0, limit);
     }
 }
@@ -62,6 +67,9 @@ export function getEntityTitlePropertyKey<M extends Record<string, any>>(collect
         const property = collection.properties[key];
         if (property && !isPropertyBuilder(property)) {
             const prop = property as Property;
+            if (isHiddenProperty(prop)) {
+                continue;
+            }
             if (prop.type === "string" && !prop.ui?.multiline && !prop.ui?.markdown && !prop.storage && !prop.isId) {
                 if (!firstStringCandidate) {
                     firstStringCandidate = key;

package/src/util/useStorageUploadController.tsx

@@ -21,7 +21,7 @@ export interface StorageFieldItem {
     storagePathOrDownloadUrl?: string;
     file?: File;
     fileName?: string;
-    metadata?: any,
+    metadata?: Record<string, unknown>,
     size: StorageFieldSize
 }
 
@@ -63,7 +63,7 @@ export function useStorageUploadController<M extends Record<string, unknown>>({
 
     const processFile = storage?.processFile;
 
-    const metadata: Record<string, any> | undefined = storage?.metadata;
+    const metadata: Record<string, unknown> | undefined = storage?.metadata;
     const size = multipleFilesSupported ? "medium" : "large";
 
     const imageResize = storage?.imageResize;
@@ -116,7 +116,7 @@ export function useStorageUploadController<M extends Record<string, unknown>>({
 
     const onFileUploadComplete = useCallback(async (uploadedPath: string,
         entry: StorageFieldItem,
-        metadata?: any,
+        metadata?: Record<string, unknown>,
         uploadedUrl?: string) => {
 
         console.debug("onFileUploadComplete", uploadedPath, entry);
@@ -242,7 +242,7 @@ export function useStorageUploadController<M extends Record<string, unknown>>({
 
 function getInternalInitialValue(multipleFilesSupported: boolean,
     value: string | string[] | null,
-    metadata: Record<string, any> | undefined,
+    metadata: Record<string, unknown> | undefined,
     size: StorageFieldSize): StorageFieldItem[] {
     let strings: string[] = [];
     if (multipleFilesSupported) {

package/dist/hooks/useValidateAuthenticator.d.ts

@@ -1,21 +0,0 @@
-import { AuthController, Authenticator, RebaseData, StorageSource, User } from "@rebasepro/types";
-/**
- * This hook is used internally for validating an authenticator.
- *
- * @param authController
- * @param authentication
- * @param storageSource
- * @param data
- */
-export declare function useValidateAuthenticator<USER extends User = any>({ disabled, authController, authenticator, storageSource, data }: {
-    disabled?: boolean;
-    authController: AuthController<USER>;
-    authenticator?: boolean | Authenticator<USER>;
-    data: RebaseData;
-    storageSource: StorageSource;
-}): {
-    canAccessMainView: boolean;
-    authLoading: boolean;
-    notAllowedError: any;
-    authVerified: boolean;
-};

package/dist/util/icon_synonyms.d.ts

@@ -1 +0,0 @@
-export declare const iconSynonyms: Record<string, string>;

package/dist/util/useTraceUpdate.d.ts

@@ -1,2 +0,0 @@
-export declare function printChanged(props: any, prev: any, path?: string | undefined, depth?: number | undefined, maxDepth?: number | undefined): void;
-export declare function useTraceUpdate(props: any, maxDepth?: number): void;

package/src/hooks/useValidateAuthenticator.tsx

@@ -1,116 +0,0 @@
-
-import { useCallback, useEffect, useRef, useState, useMemo } from "react";
-import { deepEqual as equal } from "fast-equals";
-
-import { AuthController, Authenticator, RebaseData, StorageSource, User } from "@rebasepro/types";
-
-/**
- * This hook is used internally for validating an authenticator.
- *
- * @param authController
- * @param authentication
- * @param storageSource
- * @param data
- */
-export function useValidateAuthenticator<USER extends User = any>
-({
-     disabled,
-     authController,
-     authenticator,
-     storageSource,
-     data
- }:
- {
-     disabled?: boolean,
-     authController: AuthController<USER>,
-     authenticator?: boolean | Authenticator<USER>,
-     data: RebaseData;
-     storageSource: StorageSource;
- }): {
-    canAccessMainView: boolean,
-    authLoading: boolean,
-    notAllowedError: any,
-    authVerified: boolean,
-} {
-
-    const authenticationEnabled = Boolean(authenticator);
-
-    const [authLoading, setAuthLoading] = useState<boolean>(authenticationEnabled);
-    const [notAllowedError, setNotAllowedError] = useState<any>(false);
-    const [authVerified, setAuthVerified] = useState<boolean>(!authenticationEnabled || Boolean(authController.loginSkipped));
-
-    const canAccessMainView = (authVerified) &&
-        (!authenticationEnabled || Boolean(authController.user) || Boolean(authController.loginSkipped)) &&
-        !notAllowedError;
-
-    useEffect(() => {
-        if (authController.loginSkipped)
-            setAuthVerified(true);
-    }, [authController.loginSkipped]);
-
-    /**
-     * We use this ref to check the authentication only if the user has
-     * changed.
-     */
-    const checkedUserRef = useRef<User | undefined>(undefined);
-
-    const checkAuthentication = useCallback(async () => {
-
-        if (disabled) {
-            return;
-        }
-
-        if (authController.initialLoading) {
-            return;
-        }
-
-        if (!authController.user && !authController.loginSkipped) {
-            checkedUserRef.current = undefined;
-            setAuthLoading(false);
-            setAuthVerified(false);
-            return;
-        }
-
-        const delegateUser = authController.user;
-
-        if (authenticator instanceof Function && delegateUser && !equal(checkedUserRef.current?.uid, delegateUser.uid)) {
-            setAuthLoading(true);
-            try {
-                const allowed = await authenticator({
-                    user: delegateUser,
-                    authController,
-                    data,
-                    storageSource
-                });
-                if (!allowed) {
-                    authController.signOut();
-                    setNotAllowedError(true);
-                }
-            } catch (e) {
-                setNotAllowedError(e);
-                authController.signOut();
-            }
-            setAuthLoading(false);
-            setAuthVerified(true);
-            checkedUserRef.current = delegateUser;
-        } else {
-            setAuthLoading(false);
-        }
-
-        if (!authController.initialLoading && !delegateUser) {
-            setAuthVerified(true);
-        }
-
-    }, [disabled, authController, authenticator, data, storageSource]);
-
-    useEffect(() => {
-        checkAuthentication();
-    }, [checkAuthentication]);
-
-    return useMemo(() => ({
-        canAccessMainView,
-        authLoading: authenticationEnabled && authLoading,
-        notAllowedError,
-        authVerified
-    }), [canAccessMainView, authenticationEnabled, authLoading, notAllowedError, authVerified]);
-}

package/src/util/icon_synonyms.ts

@@ -1 +0,0 @@
-export const iconSynonyms: Record<string, string> = {};

package/src/util/useTraceUpdate.tsx

@@ -1,24 +0,0 @@
-import { useEffect, useRef } from "react";
-
-export function printChanged(props: any, prev: any, path: string | undefined = "", depth: number | undefined = 0, maxDepth: number | undefined = 10) {
-    if (depth > maxDepth) {
-        return;
-    }
-    if (props && prev && typeof props === "object" && typeof prev === "object") {
-        Object.keys(props).forEach((key) => {
-            printChanged(props[key], prev[key], path + "." + key, depth + 1, maxDepth);
-        });
-    } else if (props !== prev) {
-        console.log("Changed props:", path);
-    }
-
-}
-
-export function useTraceUpdate(props: any, maxDepth = 3) {
-    const prev = useRef(props);
-    useEffect(() => {
-        console.log("Changed props:");
-        printChanged(props, prev.current, "", 0, maxDepth);
-        prev.current = props;
-    });
-}