fin-infra 0.1.62__tar.gz → 0.1.63__tar.gz

{fin_infra-0.1.62 → fin_infra-0.1.63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: fin-infra
-Version: 0.1.62
+Version: 0.1.63
 Summary: Financial infrastructure toolkit: banking connections, market data, credit, cashflows, and brokerage integrations
 License: MIT
 Keywords: finance,banking,plaid,brokerage,markets,credit,tax,cashflow,fintech,infra

{fin_infra-0.1.62 → fin_infra-0.1.63}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "fin-infra"
-version = "0.1.62"
+version = "0.1.63"
 description = "Financial infrastructure toolkit: banking connections, market data, credit, cashflows, and brokerage integrations"
 authors = ["Ali Khatami <aliikhatami94@gmail.com>"]
 license = "MIT"

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/banking/__init__.py

@@ -45,7 +45,7 @@ from __future__ import annotations
 
 import os
 from datetime import date
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING, Optional, cast
 
 from pydantic import BaseModel, Field
 
@@ -199,7 +199,7 @@ def easy_banking(provider: str = "teller", **config) -> BankingProvider:
             }
 
     # Use provider registry to dynamically load and configure provider
-    return resolve("banking", provider, **config)
+    return cast(BankingProvider, resolve("banking", provider, **config))
 
 
 def add_banking(

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/categorization/llm_layer.py

@@ -15,7 +15,7 @@ Expected performance:
 
 import hashlib
 import logging
-from typing import Optional, List, Tuple
+from typing import Optional, List, Tuple, cast
 from pydantic import BaseModel, Field
 
 # ai-infra imports
@@ -245,7 +245,7 @@ class LLMCategorizer:
                 f"Must be one of {len(valid_categories)} valid categories."
             )
 
-        return response
+        return cast(CategoryPrediction, response)
 
     def _build_system_prompt(self) -> str:
         """Build system prompt with few-shot examples (reused across all requests)."""

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/compliance/__init__.py

@@ -21,7 +21,7 @@ from __future__ import annotations
 
 import logging
 from datetime import datetime
-from typing import Any, Callable, TYPE_CHECKING
+from typing import Any, Callable, TYPE_CHECKING, cast
 
 if TYPE_CHECKING:
     from fastapi import FastAPI, Request, Response
@@ -118,7 +118,8 @@ def add_compliance_tracking(
 
         # Track only GET requests (data access)
         if method != "GET":
-            return await call_next(request)
+            from starlette.responses import Response as StarletteResponse
+            return cast("Response", await call_next(request))
 
         # Determine if path is a compliance-tracked endpoint
         event = None
@@ -148,7 +149,7 @@ def add_compliance_tracking(
             if on_event:
                 on_event(event, context)
 
-        return response
+        return cast("Response", response)
 
     logger.info(
         "Compliance tracking enabled",

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/credit/add.py

@@ -23,6 +23,7 @@ Example:
 """
 
 import logging
+from typing import cast
 
 from fastapi import FastAPI, Depends, HTTPException, status
 
@@ -175,7 +176,7 @@ def add_credit(
                 # Don't fail request if webhook publishing fails
                 logger.warning(f"Failed to publish credit.score_changed webhook: {e}")
 
-        return score
+        return cast(CreditScore, score)
 
     @router.post("/report", response_model=CreditReport)
     @credit_resource.cache_read(ttl=cache_ttl, suffix="report")
@@ -219,7 +220,7 @@ def add_credit(
                 detail="Credit bureau service unavailable",
             )
 
-        return report
+        return cast(CreditReport, report)
 
     # Mount router with dual routes (with/without trailing slash)
     app.include_router(router, include_in_schema=True)

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/credit/experian/auth.py

@@ -24,6 +24,7 @@ Example:
 """
 
 import base64
+from typing import cast
 
 import httpx
 from svc_infra.cache import cache_read
@@ -85,7 +86,7 @@ class ExperianAuthManager:
             >>> headers = {"Authorization": f"Bearer {token}"}
         """
         # Call the cached implementation with client_id for cache key
-        return await self._get_token_cached(client_id=self.client_id)
+        return cast(str, await self._get_token_cached(client_id=self.client_id))
 
     @cache_read(
         key="oauth_token:experian:{client_id}",  # Use client_id for uniqueness
@@ -140,7 +141,7 @@ class ExperianAuthManager:
 
         # Parse and return token
         data = response.json()
-        return data["access_token"]
+        return cast(str, data["access_token"])
 
     async def invalidate(self) -> None:
         """Invalidate cached token for THIS client (force refresh on next get_token call).

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/credit/experian/client.py

@@ -14,7 +14,7 @@ Example:
     >>> data = await client.get_credit_score("user123")
 """
 
-from typing import Any
+from typing import Any, cast
 
 import httpx
 from tenacity import (
@@ -155,7 +155,7 @@ class ExperianClient:
                 **kwargs,
             )
             response.raise_for_status()
-            return response.json()
+            return cast(dict[str, Any], response.json())
 
         except httpx.HTTPStatusError as e:
             # Parse error response

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/credit/experian/provider.py

@@ -31,7 +31,7 @@ Example:
 
 import logging
 from datetime import datetime, timezone
-from typing import Literal
+from typing import Literal, cast
 
 from fin_infra.credit.experian.auth import ExperianAuthManager
 from fin_infra.credit.experian.client import ExperianClient
@@ -360,4 +360,4 @@ class ExperianProvider(CreditProvider):
             signature_key=signature_key,
         )
 
-        return data.get("subscriptionId", "unknown")
+        return cast(str, data.get("subscriptionId", "unknown"))

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/goals/add.py

@@ -29,7 +29,7 @@ add_goals(app)
 
 import logging
 from datetime import datetime
-from typing import List, Optional
+from typing import Any, List, Optional, cast
 
 from fastapi import FastAPI, HTTPException, status, Query, Body
 from pydantic import BaseModel, Field
@@ -469,7 +469,7 @@ def add_goals(
             # Get all milestones from the goal (check_milestones only returns newly reached ones)
             goal = get_goal(goal_id)
             milestones = goal.get("milestones", [])
-            return milestones
+            return cast(list[dict[Any, Any]], milestones)
         except KeyError:
             raise HTTPException(
                 status_code=status.HTTP_404_NOT_FOUND, detail=f"Goal {goal_id} not found"

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/goals/management.py

@@ -41,7 +41,7 @@ Example:
 """
 
 from datetime import datetime
-from typing import Any
+from typing import Any, cast
 
 from pydantic import BaseModel, Field
 
@@ -839,7 +839,7 @@ def get_goal(goal_id: str) -> dict[str, Any]:
     if goal_id not in _GOALS_STORE:
         raise KeyError(f"Goal not found: {goal_id}")
 
-    return _GOALS_STORE[goal_id]
+    return cast(dict[str, Any], _GOALS_STORE[goal_id])
 
 
 def update_goal(
@@ -885,7 +885,7 @@ def update_goal(
 
     Goal(**goal)  # Will raise ValidationError if invalid
 
-    return goal
+    return cast(dict[str, Any], goal)
 
 
 def delete_goal(goal_id: str) -> None:

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/goals/milestones.py

@@ -26,7 +26,7 @@ Example:
 """
 
 from datetime import datetime
-from typing import Any
+from typing import Any, cast
 
 from fin_infra.goals.management import get_goal, update_goal
 from fin_infra.goals.models import Milestone
@@ -229,7 +229,7 @@ def get_next_milestone(goal_id: str) -> dict[str, Any] | None:
     # Find first unreached milestone (sorted by amount)
     for milestone in milestones:
         if not milestone.get("reached", False):
-            return milestone
+            return cast(dict[str, Any], milestone)
 
     return None
 

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/investments/providers/plaid.py

@@ -10,7 +10,7 @@ from __future__ import annotations
 
 from datetime import date
 from decimal import Decimal
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, cast
 
 from plaid.api import plaid_api
 from plaid.model.investments_holdings_get_request import InvestmentsHoldingsGetRequest
@@ -103,7 +103,7 @@ class PlaidInvestmentProvider(InvestmentProvider):
             "development": plaid.Environment.Sandbox,  # Map development to sandbox
             "production": plaid.Environment.Production,
         }
-        return hosts.get(environment.lower(), plaid.Environment.Sandbox)
+        return cast(str, hosts.get(environment.lower(), plaid.Environment.Sandbox))
 
     async def get_holdings(
         self, access_token: str, account_ids: Optional[List[str]] = None

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/investments/providers/snaptrade.py

@@ -11,7 +11,7 @@ from __future__ import annotations
 
 from datetime import date
 from decimal import Decimal
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Optional, cast
 
 import httpx
 
@@ -393,7 +393,7 @@ class SnapTradeInvestmentProvider(InvestmentProvider):
             url = f"{self.base_url}/connections"
             response = await self.client.get(url, headers=auth_headers)
             response.raise_for_status()
-            return await response.json()
+            return cast(list[dict[str, Any]], await response.json())
 
         except httpx.HTTPStatusError as e:
             raise self._transform_error(e)

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/normalization/providers/exchangerate.py

@@ -2,7 +2,7 @@
 
 import os
 from datetime import date as DateType
-from typing import Optional
+from typing import Optional, cast
 
 import httpx
 
@@ -66,10 +66,10 @@ class ExchangeRateClient:
                         raise ExchangeRateAPIError(
                             f"API returned error: {data.get('error-type', 'unknown')}"
                         )
-                    return data["conversion_rates"]
+                    return cast(dict[str, float], data["conversion_rates"])
                 else:
                     # Free tier response format
-                    return data["rates"]
+                    return cast(dict[str, float], data["rates"])
 
         except httpx.HTTPError as e:
             raise ExchangeRateAPIError(f"HTTP error fetching rates: {e}")

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/providers/banking/plaid_client.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from datetime import date, datetime, timedelta
+from typing import Any, cast
 
 # Plaid SDK v25+ uses new API structure
 try:
@@ -96,7 +97,7 @@ class PlaidClient(BankingProvider):
             language="en",
         )
         response = self.client.link_token_create(request)
-        return response["link_token"]
+        return cast(str, response["link_token"])
 
     def exchange_public_token(self, public_token: str) -> dict:
         request = ItemPublicTokenExchangeRequest(public_token=public_token)
@@ -146,8 +147,8 @@ class PlaidClient(BankingProvider):
         # Return all balances
         return {"balances": [acc.get("balances", {}) for acc in accounts]}
 
-    def identity(self, access_token: str) -> dict:
+    def identity(self, access_token: str) -> dict[Any, Any]:
         """Fetch identity/account holder information."""
         request = IdentityGetRequest(access_token=access_token)
         response = self.client.identity_get(request)
-        return response.to_dict()
+        return cast(dict[Any, Any], response.to_dict())

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/providers/banking/teller_client.py

@@ -24,7 +24,7 @@ from __future__ import annotations
 
 import ssl
 import httpx
-from typing import Any
+from typing import Any, cast
 
 from ..base import BankingProvider
 
@@ -139,7 +139,7 @@ class TellerClient(BankingProvider):
                 "products": ["accounts", "transactions", "balances", "identity"],
             },
         )
-        return response.get("enrollment_id", "")
+        return cast(str, response.get("enrollment_id", ""))
 
     def exchange_public_token(self, public_token: str) -> dict:
         """Exchange public token for access token.
@@ -186,7 +186,7 @@ class TellerClient(BankingProvider):
             auth=(access_token, ""),
         )
         response.raise_for_status()
-        return response.json()
+        return cast(list[dict[Any, Any]], response.json())
 
     def transactions(
         self,
@@ -229,7 +229,7 @@ class TellerClient(BankingProvider):
             params=params,
         )
         response.raise_for_status()
-        return response.json()
+        return cast(list[dict[Any, Any]], response.json())
 
     def balances(self, access_token: str, account_id: str | None = None) -> dict:
         """Fetch current balances.
@@ -261,7 +261,7 @@ class TellerClient(BankingProvider):
             )
 
         response.raise_for_status()
-        return response.json()
+        return cast(dict[Any, Any], response.json())
 
     def identity(self, access_token: str) -> dict:
         """Fetch identity/account holder information.
@@ -285,7 +285,7 @@ class TellerClient(BankingProvider):
             auth=(access_token, ""),
         )
         response.raise_for_status()
-        return response.json()
+        return cast(dict[Any, Any], response.json())
 
     def __del__(self) -> None:
         """Close HTTP client on cleanup."""

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/providers/brokerage/alpaca.py

@@ -7,7 +7,7 @@ mode for development and testing. Live trading requires explicit opt-in.
 from __future__ import annotations
 
 import os
-from typing import Literal
+from typing import Any, Literal, cast
 
 try:
     from alpaca_trade_api import REST
@@ -308,14 +308,14 @@ class AlpacaBrokerage(BrokerageProvider):
         return self._extract_raw(watchlist)
 
     @staticmethod
-    def _extract_raw(obj) -> dict:
+    def _extract_raw(obj: Any) -> dict[Any, Any]:
         """Extract raw dict from Alpaca entity object.
 
         Alpaca entities have a _raw attribute with the API response data.
         """
         if hasattr(obj, "_raw"):
-            return obj._raw
+            return cast(dict[Any, Any], obj._raw)
         elif hasattr(obj, "__dict__"):
-            return obj.__dict__
+            return cast(dict[Any, Any], obj.__dict__)
         else:
-            return obj
+            return cast(dict[Any, Any], obj)

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/providers/market/ccxt_crypto.py

@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import Any, cast
+
 import ccxt
 
 from ..base import CryptoDataProvider
@@ -15,14 +17,14 @@ class CCXTCryptoData(CryptoDataProvider):
         # Defer load_markets to first call to avoid network on construction
         self._markets_loaded = False
 
-    def ticker(self, symbol_pair: str) -> dict:
+    def ticker(self, symbol_pair: str) -> dict[Any, Any]:
         if not self._markets_loaded:
             self.exchange.load_markets()
             self._markets_loaded = True
-        return self.exchange.fetch_ticker(symbol_pair)
+        return cast(dict[Any, Any], self.exchange.fetch_ticker(symbol_pair))
 
     def ohlcv(self, symbol_pair: str, timeframe: str = "1d", limit: int = 100) -> list[list[float]]:
         if not self._markets_loaded:
             self.exchange.load_markets()
             self._markets_loaded = True
-        return self.exchange.fetch_ohlcv(symbol_pair, timeframe=timeframe, limit=limit)
+        return cast(list[list[float]], self.exchange.fetch_ohlcv(symbol_pair, timeframe=timeframe, limit=limit))

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/recurring/detectors_llm.py

@@ -14,7 +14,7 @@ Only called for ambiguous patterns (20-40% variance, ~10% of patterns).
 from __future__ import annotations
 
 import logging
-from typing import Any, Optional
+from typing import Any, Optional, cast
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -292,7 +292,7 @@ class VariableDetectorLLM:
 
         # Extract structured output
         if hasattr(response, "structured") and response.structured:
-            return response.structured
+            return cast(VariableRecurringPattern, response.structured)
         else:
             raise ValueError(f"LLM returned no structured output for '{merchant_name}'")
 

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/recurring/insights.py

@@ -15,7 +15,7 @@ from __future__ import annotations
 
 import hashlib
 import logging
-from typing import Any, Optional
+from typing import Any, Optional, cast
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -383,7 +383,7 @@ class SubscriptionInsightsGenerator:
 
         # Extract structured output
         if hasattr(response, "structured") and response.structured:
-            return response.structured
+            return cast(SubscriptionInsights, response.structured)
         else:
             raise ValueError("LLM returned no structured output for insights")
 

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/recurring/normalizer.py

@@ -11,6 +11,7 @@ from __future__ import annotations
 
 import re
 from functools import lru_cache
+from typing import cast
 
 try:
     from rapidfuzz import fuzz, process
@@ -165,7 +166,7 @@ class FuzzyMatcher:
         norm2 = normalize_merchant(name2)
 
         similarity = fuzz.token_sort_ratio(norm1, norm2)
-        return similarity >= self.similarity_threshold
+        return cast(bool, similarity >= self.similarity_threshold)
 
     def group_merchants(self, merchants: list[str]) -> dict[str, list[str]]:
         """

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/recurring/normalizers.py

@@ -16,7 +16,7 @@ from __future__ import annotations
 
 import hashlib
 import logging
-from typing import Any, Optional
+from typing import Any, Optional, cast
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -354,7 +354,7 @@ class MerchantNormalizer:
 
         # Extract structured output
         if hasattr(response, "structured") and response.structured:
-            return response.structured
+            return cast(MerchantNormalized, response.structured)
         else:
             raise ValueError(f"LLM returned no structured output for '{merchant_name}'")
 

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/security/encryption.py

@@ -7,7 +7,7 @@ Encrypt/decrypt financial provider API tokens at rest.
 import base64
 import json
 import os
-from typing import Any, Dict, Optional
+from typing import Any, Dict, Optional, cast
 
 from cryptography.fernet import Fernet, InvalidToken
 
@@ -144,7 +144,7 @@ class ProviderTokenEncryption:
                         "Token may have been tampered with or used for wrong user/provider."
                     )
 
-            return data["token"]
+            return cast(str, data["token"])
 
         except InvalidToken as e:
             raise ValueError(

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/security/pii_patterns.py

@@ -67,7 +67,7 @@ def luhn_checksum(card_number: str) -> bool:
         True if valid, False otherwise
     """
 
-    def digits_of(n):
+    def digits_of(n: int | str) -> list[int]:
         return [int(d) for d in str(n)]
 
     digits = digits_of(card_number)

{fin_infra-0.1.62 → fin_infra-0.1.63}/src/fin_infra/utils/http.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import httpx
+from typing import Any, cast
 from tenacity import retry, stop_after_attempt, wait_exponential, retry_if_exception_type
 
 _DEFAULT_TIMEOUT = httpx.Timeout(20.0)
@@ -12,8 +13,8 @@ _DEFAULT_TIMEOUT = httpx.Timeout(20.0)
     retry=retry_if_exception_type(httpx.HTTPError),
     reraise=True,
 )
-async def aget_json(url: str, **kwargs) -> dict:
+async def aget_json(url: str, **kwargs) -> dict[Any, Any]:
     async with httpx.AsyncClient(timeout=_DEFAULT_TIMEOUT) as client:
         r = await client.get(url, **kwargs)
         r.raise_for_status()
-        return r.json()
+        return cast(dict[Any, Any], r.json())