Function useUrlLoader

src/hooks/useUrlLoader.ts:33–274

({ logger = appLogger }: UseUrlLoaderDeps = {})

 * Hook for loading COLMAP reconstructions from URLs
 */
export function useUrlLoader({ logger = appLogger }: UseUrlLoaderDeps = {}) {
  const { processFiles } = useFileDropzone();
  const logError = logger.error;
  const logInfo = logger.info;
  const setError = useReconstructionStore((s) => s.setError);
  const setSourceInfo = useReconstructionStore((s) => s.setSourceInfo);
  const mergeRemoteSplatCatalog = useReconstructionStore((s) => s.mergeRemoteSplatCatalog);

  // Use store state for URL loading (shared across components)
  const urlLoading = useReconstructionStore((s) => s.urlLoading);
  const urlProgress = useReconstructionStore((s) => s.urlProgress);
  const urlError = useReconstructionStore((s) => s.urlError);
  const setUrlLoading = useReconstructionStore((s) => s.setUrlLoading);
  const setUrlProgress = useReconstructionStore((s) => s.setUrlProgress);
  const setUrlError = useReconstructionStore((s) => s.setUrlError);
  const tryStartUrlLoad = useReconstructionStore((s) => s.tryStartUrlLoad);
  const finishUrlLoad = useReconstructionStore((s) => s.finishUrlLoad);
  const shouldKeepUrlLoadingForSplatRenderer = useCallback(() => {
    const state = useReconstructionStore.getState();
    return isSplatLoadingProgressForFile(state.urlProgress, state.loadedFiles?.splatFile);
  }, []);

  /**
   * Fetch and validate the manifest file
   */
  const fetchManifest = useCallback(async (manifestUrl: string): Promise<ColmapManifest> => {
    return fetchUrlManifest(manifestUrl, { setUrlProgress });
  }, [setUrlProgress]);

  /**
   * Load reconstruction from a ZIP URL.
   * Downloads the ZIP, extracts COLMAP files, and sets up lazy image extraction.
   * Note: Caller (loadFromUrl) is responsible for clearing caches before calling this.
   */
  const loadFromZipUrl = useCallback(async (url: string): Promise<boolean> => {
    return loadZipUrlSource(url, {
      log: logInfo,
      processFiles,
      setSourceInfo,
      setUrlProgress,
    });
  }, [logInfo, processFiles, setSourceInfo, setUrlProgress]);

  const loadFromSplatUrl = useCallback(async (
    url: string,
    options: { onSplatFileFetched?: (file: File) => void } = {}
  ): Promise<boolean> => {
    return loadSplatUrlSource(url, {
      log: logInfo,
      onSplatFileFetched: options.onSplatFileFetched,
      processFiles,
      setSourceInfo,
      setUrlProgress,
    });
  }, [logInfo, processFiles, setSourceInfo, setUrlProgress]);

  /**
   * Main entry point: load reconstruction from URL