Skip to content

OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.

Python
4.2 KB
Raw Blame
import { toast } from "sonner";

export interface CloudFile {
  id: string;
  name: string;
  mimeType: string;
  webViewLink?: string;
  iconLink?: string;
  size?: number;
  modifiedTime?: string;
  isFolder?: boolean;
  webUrl?: string;
  downloadUrl?: string;
}

export type CloudProvider = "google_drive" | "onedrive" | "sharepoint";

export interface UnifiedCloudPickerProps {
  provider: CloudProvider;
  onFileSelected: (files: CloudFile[]) => void;
  selectedFiles?: CloudFile[];
  isAuthenticated: boolean;
  accessToken?: string;
  onPickerStateChange?: (isOpen: boolean) => void;
  // OneDrive/SharePoint specific props
  clientId?: string;
  baseUrl?: string;
  /** Controlled ingest state from the upload page (single source of truth). */
  ingestSettings?: IngestSettings;
  onIngestSettingsChange?: (settings: IngestSettings) => void;
  /** @deprecated Prefer ingestSettings + onIngestSettingsChange from the page. */
  onSettingsChange?: (settings: IngestSettings) => void;
  isIngesting: boolean;
}

export interface GoogleAPI {
  load: (
    api: string,
    options: { callback: () => void; onerror?: () => void },
  ) => void;
}

export interface GooglePickerData {
  action: string;
  docs: GooglePickerDocument[];
}

export interface GooglePickerDocument {
  [key: string]: string;
}

declare global {
  interface Window {
    gapi: GoogleAPI;
    google: {
      picker: {
        api: {
          load: (callback: () => void) => void;
        };
        PickerBuilder: new () => GooglePickerBuilder;
        DocsView: new () => GoogleDocsView;
        ViewId: {
          DOCS: string;
          FOLDERS: string;
          DOCS_IMAGES_AND_VIDEOS: string;
          DOCUMENTS: string;
          PRESENTATIONS: string;
          SPREADSHEETS: string;
        };
        Feature: {
          MULTISELECT_ENABLED: string;
          NAV_HIDDEN: string;
          SIMPLE_UPLOAD_ENABLED: string;
        };
        Action: {
          PICKED: string;
          CANCEL: string;
        };
        Document: {
          ID: string;
          NAME: string;
          MIME_TYPE: string;
          URL: string;
          ICON_URL: string;
        };
      };
    };
    OneDrive?: any;
  }
}

export interface GoogleDocsView {
  setIncludeFolders: (include: boolean) => GoogleDocsView;
  setSelectFolderEnabled: (enabled: boolean) => GoogleDocsView;
}

export interface GooglePickerBuilder {
  addView: (view: GoogleDocsView | string) => GooglePickerBuilder;
  setOAuthToken: (token: string) => GooglePickerBuilder;
  setCallback: (
    callback: (data: GooglePickerData) => void,
  ) => GooglePickerBuilder;
  enableFeature: (feature: string) => GooglePickerBuilder;
  setTitle: (title: string) => GooglePickerBuilder;
  build: () => GooglePicker;
}

export interface GooglePicker {
  setVisible: (visible: boolean) => void;
}

export interface IngestSettings {
  chunkSize: number;
  chunkOverlap: number;
  ocr: boolean;
  pictureDescriptions: boolean;
  embeddingModel: string;
  /** When true, index without an owner so all users in the instance can retrieve the document. COS only. */
  shared?: boolean;
}

/** Inline error message if ingest or chunk settings are invalid; otherwise null. */
export function getIngestChunkSettingsError(
  settings: Pick<
    IngestSettings,
    "embeddingModel" | "chunkSize" | "chunkOverlap"
  >,
): string | null {
  if (!settings.embeddingModel.trim()) {
    return "Select an embedding model in Settings before ingesting files";
  }
  return getChunkSettingsError(settings);
}

/** Inline error message if chunk settings are invalid; otherwise null. */
export function getChunkSettingsError(
  settings: Pick<IngestSettings, "chunkSize" | "chunkOverlap">,
): string | null {
  if (settings.chunkSize < 1) {
    return "Chunk size must be at least 1";
  }
  if (settings.chunkOverlap >= settings.chunkSize) {
    return "Chunk overlap must be less than chunk size";
  }
  return null;
}

export function validateIngestSettingsOrToast(
  settings:
    | Pick<IngestSettings, "embeddingModel" | "chunkSize" | "chunkOverlap">
    | undefined,
): boolean {
  if (!settings) return true;
  const chunkErr = getIngestChunkSettingsError(settings);
  if (chunkErr) {
    toast.error("Could not start ingest", { description: chunkErr });
    return false;
  }
  return true;
}