Function useFileSystem

apps/webuiapps/src/hooks/useFileSystem.ts:90–273

(options: UseFileSystemOptions = {})

 * const fs = useFileSystem({ useLocalApi: true });
 */
export function useFileSystem(options: UseFileSystemOptions = {}): UseFileSystemReturn {
  const { useLocalApi = false, fileApi: customFileApi, loadFromCloud = false } = options;

  // Create store (only on first render)
  const storeRef = useRef<FileSystemStore | null>(null);
  if (!storeRef.current) {
    // Priority: customFileApi > useLocalApi > default real API
    const api = customFileApi || (useLocalApi ? createLocalFileApi() : defaultFileApi);
    storeRef.current = createFileSystemStore(api);
  }
  const store = storeRef.current;

  // State
  const [, forceUpdate] = useState({});
  const [isLoading, setIsLoading] = useState(loadFromCloud);
  const [error, setError] = useState<Error | null>(null);

  // Subscribe to store changes
  useEffect(() => {
    const unsubscribe = store.subscribe(() => {
      forceUpdate({});
    });
    return unsubscribe;
  }, [store]);

  // Initialize from cloud
  useEffect(() => {
    if (loadFromCloud) {
      store
        .initFromCloud()
        .then(() => {
          setIsLoading(false);
        })
        .catch((err) => {
          setError(err);
          setIsLoading(false);
        });
    }
  }, [store, loadFromCloud]);

  // Query methods
  const getById = useCallback((id: string) => store.getById(id), [store]);
  const getByPath = useCallback((path: string) => store.getByPath(path), [store]);
  const getChildren = useCallback((nodeId: string) => store.getChildren(nodeId), [store]);
  const getChildrenByPath = useCallback((path: string) => store.getChildrenByPath(path), [store]);
  const exists = useCallback((path: string) => store.exists(path), [store]);

  // Write methods
  const addNode = useCallback((params: CreateFileNodeParams) => store.addNode(params), [store]);
  const updateNode = useCallback(
    (id: string, updates: UpdateFileNodeParams) => store.updateNode(id, updates),
    [store],
  );
  const removeNode = useCallback((id: string) => store.removeNode(id), [store]);
  const removeByPath = useCallback((path: string) => store.removeByPath(path), [store]);
  const moveNode = useCallback(
    (id: string, newPath: string) => store.moveNode(id, newPath),
    [store],