feat(document-search) add location metadata to document

packages/ragbits-document-search/src/ragbits/document_search/documents/element.py

@@ -7,13 +7,23 @@
 from ragbits.document_search.documents.document import DocumentMeta
 
 
+class ElementLocation(BaseModel):
+    """
+    An object representing position of chunk within document.
+    """
+
+    page_number: int | None = None
+    coordinates: dict | None = None
+
+
 class Element(BaseModel, ABC):
     """
     An object representing an element in a document.
     """
 
     element_type: str
     document_meta: DocumentMeta
+    location: ElementLocation | None = None
 
     _elements_registry: ClassVar[dict[str, type["Element"]]] = {}
 

packages/ragbits-document-search/src/ragbits/document_search/ingestion/providers/unstructured/utils.py

@@ -8,7 +8,7 @@
 from ragbits.core.llms.base import LLM
 from ragbits.core.prompt.base import BasePrompt
 from ragbits.document_search.documents.document import DocumentMeta
-from ragbits.document_search.documents.element import TextElement
+from ragbits.document_search.documents.element import ElementLocation, TextElement
 
 
 def to_text_element(element: UnstructuredElement, document_meta: DocumentMeta) -> TextElement:
@@ -22,9 +22,30 @@ def to_text_element(element: UnstructuredElement, document_meta: DocumentMeta) -
     Returns:
         text element
     """
+    location = to_element_location(element)
     return TextElement(
         document_meta=document_meta,
         content=element.text,
+        location=location,
+    )
+
+
+def to_element_location(element: UnstructuredElement) -> ElementLocation:
+    """
+    Converts unstructured element to element location.
+
+    Args:
+        element: element from unstructured
+
+    Returns:
+        element location
+    """
+    metadata = element.metadata.to_dict()
+    page_number = metadata.get("page_number")
+    coordinates = metadata.get("coordinates")
+    return ElementLocation(
+        page_number=page_number,
+        coordinates=coordinates,
     )