boarddata 4.1.2__tar.gz → 4.2.1__tar.gz

{boarddata-4.1.2 → boarddata-4.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boarddata
-Version: 4.1.2
+Version: 4.2.1
 Summary: Python SDK for the BoardData V2 REST API
 License: MIT
 Classifier: Development Status :: 4 - Beta

{boarddata-4.1.2 → boarddata-4.2.1}/__init__.py

@@ -7,7 +7,7 @@ from .errors import BoardDataError
 
 from . import types as types  # noqa: F401 — makes types accessible as boarddata.types
 
-__version__ = "4.1.2"
+__version__ = "4.2.1"
 __all__ = [
     "Base",
     "BoardDataClient",

{boarddata-4.1.2 → boarddata-4.2.1}/_companies.py

@@ -5,7 +5,12 @@ from __future__ import annotations
 import logging
 from typing import Any
 
-from .types.companies import CompanyDetail, CompanyListItem, TemporalAttributePayload
+from .types.companies import (
+    CompanyDetail,
+    CompanyListItem,
+    CompanyResolveResult,
+    TemporalAttributePayload,
+)
 from .types.core import AddressPayload, FieldSourcePayload, PaginatedResponse, UpsertResult
 
 logger = logging.getLogger("boarddata")
@@ -253,6 +258,44 @@ class CompanyMixin:
         results = resp.get("results", []) if isinstance(resp, dict) else resp
         return results[0] if results else None
 
+    def resolve_company(
+        self,
+        *,
+        ticker: str | None = None,
+        isin: str | None = None,
+    ) -> CompanyResolveResult | None:
+        """Resolve a company by ticker and/or ISIN.
+
+        Cascading resolution: DB → OpenFIGI → Perplexity.
+        At least one of ticker or isin is required.
+
+        Args:
+            ticker: Stock ticker symbol (e.g. ``"TTE"``).
+            isin: ISIN identifier (e.g. ``"FR0000120271"``).
+
+        Returns:
+            CompanyResolveResult if found, or ``None`` if not found.
+
+        Raises:
+            BoardDataError: On non-2xx API response (except 404).
+            ValueError: If neither ticker nor isin is provided.
+        """
+        if not ticker and not isin:
+            raise ValueError("Provide at least one of: ticker, isin")
+
+        from .errors import BoardDataError
+
+        try:
+            return self._get(  # type: ignore[attr-defined]
+                "companies/resolve/",
+                ticker=ticker,
+                isin=isin,
+            )
+        except BoardDataError as exc:
+            if exc.status_code == 404:
+                return None
+            raise
+
     def upsert_company(
         self,
         isin: str,

{boarddata-4.1.2 → boarddata-4.2.1}/boarddata.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: boarddata
-Version: 4.1.2
+Version: 4.2.1
 Summary: Python SDK for the BoardData V2 REST API
 License: MIT
 Classifier: Development Status :: 4 - Beta

{boarddata-4.1.2 → boarddata-4.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "boarddata"
-version = "4.1.2"
+version = "4.2.1"
 description = "Python SDK for the BoardData V2 REST API"
 readme = "README.md"
 license = {text = "MIT"}

{boarddata-4.1.2 → boarddata-4.2.1}/types/companies.py

@@ -68,6 +68,15 @@ class UpdateCompanyPayload(TypedDict, total=False):
     field_sources: list[FieldSourcePayload]
 
 
+class CompanyResolveResult(TypedDict):
+    id: str
+    name: str
+    isin: str
+    ticker: str
+    country: str
+    logo: str
+
+
 class CompanyListItem(TypedDict):
     id: str
     name: str

{boarddata-4.1.2 → boarddata-4.2.1}/types/core.py

@@ -10,6 +10,7 @@ except ImportError:
 
 # -- Shared input types --
 
+
 class AddressPayload(TypedDict, total=False):
     country: str
     country_code: str
@@ -29,9 +30,11 @@ class FieldSourcePayload(TypedDict):
 
 # -- Shared response types --
 
+
 class PaginatedResponse(TypedDict):
     """Non-generic paginated response. results is list[Any] at the type level.
     Generic TypedDict requires Python 3.13; we target 3.12+."""
+
     count: int
     next: str | None
     previous: str | None
@@ -54,7 +57,8 @@ class FieldSourceItem(TypedDict):
     document_id: str | None
     document_title: str
     document_type: str
-    document_year: int | None
+    document_fiscal_year: int | None
+    document_publication_date: str | None
     page_number: int | None
     confidence: str
     extracted_value: str
@@ -80,6 +84,7 @@ class SearchResult(TypedDict):
 
 class UpsertResult(TypedDict):
     """Standardised return type for all upsert methods."""
-    action: str        # "created" or "updated"
-    id: str            # UUID of the created/updated entity
+
+    action: str  # "created" or "updated"
+    id: str  # UUID of the created/updated entity
     data: dict[str, Any]  # Full entity detail dict