fin-infra 0.1.79__tar.gz → 0.1.81__tar.gz

{fin_infra-0.1.79 → fin_infra-0.1.81}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: fin-infra
-Version: 0.1.79
+Version: 0.1.81
 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.79 → fin_infra-0.1.81}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "fin-infra"
-version = "0.1.79"
+version = "0.1.81"
 description = "Financial infrastructure toolkit: banking connections, market data, credit, cashflows, and brokerage integrations"
 authors = ["Ali Khatami <aliikhatami94@gmail.com>"]
 license = "MIT"
@@ -81,6 +81,10 @@ pre-commit = ">=3.0.0"
 types-requests = ">=2.31.0"
 pytest-cov = ">=4.0.0"
 aiosqlite = ">=0.20.0"
+# Documentation
+mkdocs = ">=1.6.0"
+mkdocs-material = ">=9.5.0"
+mkdocstrings = {extras = ["python"], version = ">=0.25.0"}
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/analytics/__init__.py

@@ -7,6 +7,16 @@ This module provides comprehensive financial analytics capabilities including:
 - Portfolio analytics (returns, allocation, benchmarking)
 - Growth projections (net worth forecasting with scenarios)
 
+Feature Status:
+    ✅ STABLE: Core calculation functions (all analytics work with provided data)
+    ⚠️  INTEGRATION: Auto-fetching from providers requires setup:
+        - Banking provider for transaction data
+        - Brokerage provider for investment data
+        - Categorization for expense categorization
+
+    When providers aren't configured, functions accept data directly or return
+    sensible placeholder values for testing/development.
+
 Serves multiple use cases:
 - Personal finance apps (cash flow, savings tracking)
 - Wealth management platforms (portfolio analytics, projections)

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/banking/__init__.py

@@ -174,7 +174,6 @@ def easy_banking(provider: str = "teller", **config) -> BankingProvider:
     See Also:
         - add_banking(): For FastAPI integration with routes
         - docs/banking.md: Comprehensive banking integration guide
-        - docs/adr/0003-banking-integration.md: Architecture decisions
     """
     # Auto-detect provider config from environment if not explicitly provided
     # Only auto-detect if no config params were passed

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/banking/history.py

@@ -42,7 +42,7 @@ from __future__ import annotations
 import logging
 import os
 from datetime import date, datetime, timedelta
-from typing import List, Optional
+from typing import Optional
 from pydantic import BaseModel, Field, ConfigDict
 
 
@@ -59,7 +59,7 @@ _logger = logging.getLogger(__name__)
 
 # In-memory storage for testing (will be replaced with SQL database in production)
 # ⚠️ WARNING: All data is LOST on restart when using in-memory storage!
-_balance_snapshots: List[BalanceSnapshot] = []
+_balance_snapshots: list[BalanceSnapshot] = []
 _production_warning_logged = False
 
 
@@ -157,7 +157,7 @@ def get_balance_history(
     days: int = 90,
     start_date: Optional[date] = None,
     end_date: Optional[date] = None,
-) -> List[BalanceSnapshot]:
+) -> list[BalanceSnapshot]:
     """Get balance history for an account.
 
     Retrieves balance snapshots for the specified account within a date range.
@@ -216,8 +216,8 @@ def get_balance_history(
 
 def get_balance_snapshots(
     account_id: str,
-    dates: List[date],
-) -> List[BalanceSnapshot]:
+    dates: list[date],
+) -> list[BalanceSnapshot]:
     """Get balance snapshots for specific dates.
 
     Args:

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/banking/utils.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 
 import re
 from datetime import datetime, timezone
-from typing import Any, Dict, Optional, Literal
+from typing import Any, Optional, Literal
 from pydantic import BaseModel, ConfigDict, Field
 
 from ..providers.base import BankingProvider
@@ -179,7 +179,7 @@ def validate_provider_token(provider: str, access_token: str) -> bool:
     return validator(access_token)
 
 
-def parse_banking_providers(banking_providers: Dict[str, Any]) -> BankingConnectionStatus:
+def parse_banking_providers(banking_providers: dict[str, Any]) -> BankingConnectionStatus:
     """
     Parse banking_providers JSON field into structured status.
 
@@ -257,7 +257,7 @@ def parse_banking_providers(banking_providers: Dict[str, Any]) -> BankingConnect
     return status
 
 
-def sanitize_connection_status(status: BankingConnectionStatus) -> Dict[str, Any]:
+def sanitize_connection_status(status: BankingConnectionStatus) -> dict[str, Any]:
     """
     Sanitize connection status for API responses (removes access tokens).
 
@@ -298,10 +298,10 @@ def sanitize_connection_status(status: BankingConnectionStatus) -> Dict[str, Any
 
 
 def mark_connection_unhealthy(
-    banking_providers: Dict[str, Any],
+    banking_providers: dict[str, Any],
     provider: str,
     error_message: str,
-) -> Dict[str, Any]:
+) -> dict[str, Any]:
     """
     Mark a provider connection as unhealthy (for error handling).
 
@@ -335,9 +335,9 @@ def mark_connection_unhealthy(
 
 
 def mark_connection_healthy(
-    banking_providers: Dict[str, Any],
+    banking_providers: dict[str, Any],
     provider: str,
-) -> Dict[str, Any]:
+) -> dict[str, Any]:
     """
     Mark a provider connection as healthy (after successful sync).
 
@@ -368,7 +368,7 @@ def mark_connection_healthy(
 
 
 def get_primary_access_token(
-    banking_providers: Dict[str, Any],
+    banking_providers: dict[str, Any],
 ) -> tuple[Optional[str], Optional[str]]:
     """
     Get the primary access token and provider name.
@@ -437,7 +437,7 @@ async def test_connection_health(
             return False, error_msg
 
 
-def should_refresh_token(banking_providers: Dict[str, Any], provider: str) -> bool:
+def should_refresh_token(banking_providers: dict[str, Any], provider: str) -> bool:
     """
     Check if a provider token should be refreshed.
 

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/budgets/alerts.py

@@ -35,7 +35,7 @@ Example:
 from __future__ import annotations
 
 from datetime import datetime
-from typing import TYPE_CHECKING, List, Optional
+from typing import TYPE_CHECKING, Optional
 
 from fin_infra.budgets.models import (
     AlertSeverity,
@@ -52,7 +52,7 @@ async def check_budget_alerts(
     budget_id: str,
     tracker: BudgetTracker,
     thresholds: Optional[dict[str, float]] = None,
-) -> List[BudgetAlert]:
+) -> list[BudgetAlert]:
     """
     Check budget for alerts (overspending, approaching limits, unusual patterns).
 
@@ -111,7 +111,7 @@ async def check_budget_alerts(
     # Get budget progress
     progress = await tracker.get_budget_progress(budget_id)
 
-    alerts: List[BudgetAlert] = []
+    alerts: list[BudgetAlert] = []
 
     # Check each category for alerts
     for category in progress.categories:

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/budgets/tracker.py

@@ -36,7 +36,7 @@ from __future__ import annotations
 
 import uuid
 from datetime import datetime, timedelta
-from typing import TYPE_CHECKING, List, Optional
+from typing import TYPE_CHECKING, Optional
 
 from sqlalchemy.ext.asyncio import async_sessionmaker
 
@@ -206,7 +206,7 @@ class BudgetTracker:
         self,
         user_id: str,
         type: Optional[str] = None,
-    ) -> List[Budget]:
+    ) -> list[Budget]:
         """
         Get all budgets for a user.
 

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/cashflows/core.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Iterable
+from collections.abc import Iterable
 
 import numpy as np
 import numpy_financial as npf

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/categorization/llm_layer.py

@@ -15,7 +15,7 @@ Expected performance:
 
 import hashlib
 import logging
-from typing import Any, List, Optional, Tuple, cast
+from typing import Any, Optional, cast
 from pydantic import BaseModel, Field
 
 # ai-infra imports
@@ -40,7 +40,7 @@ class CategoryPrediction(BaseModel):
 
 
 # Few-shot examples (20 diverse merchants covering all major categories)
-FEW_SHOT_EXAMPLES: List[Tuple[str, str, str]] = [
+FEW_SHOT_EXAMPLES: list[tuple[str, str, str]] = [
     # Food & Dining (5 examples)
     ("STARBUCKS #1234", "Coffee Shops", "Popular coffee shop chain"),
     ("MCDONALD'S", "Fast Food", "Fast food restaurant"),

fin_infra-0.1.81/src/fin_infra/clients/__init__.py

@@ -0,0 +1,25 @@
+"""DEPRECATED: Use fin_infra.providers instead.
+
+This module is deprecated and will be removed in a future version.
+All ABCs have been consolidated into fin_infra.providers.base.
+
+Migration:
+    # Old (deprecated)
+    from fin_infra.clients import BankingClient, MarketDataClient
+
+    # New
+    from fin_infra.providers.base import BankingProvider, MarketDataProvider
+"""
+
+import warnings
+
+from .base import BankingClient, CreditClient, MarketDataClient
+
+warnings.warn(
+    "fin_infra.clients is deprecated. Use fin_infra.providers instead. "
+    "This module will be removed in a future version.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+__all__ = ["BankingClient", "MarketDataClient", "CreditClient"]

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/clients/base.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import abc
-from typing import Iterable, Sequence
+from collections.abc import Iterable, Sequence
 
 from ..models import Account, Quote, Transaction
 

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/clients/plaid.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Sequence
+from collections.abc import Sequence
 
 from .base import BankingClient
 from ..models import Account

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/compliance/__init__.py

@@ -21,7 +21,8 @@ from __future__ import annotations
 
 import logging
 from datetime import datetime
-from typing import Any, Callable, TYPE_CHECKING, cast
+from typing import Any, TYPE_CHECKING, cast
+from collections.abc import Callable
 
 if TYPE_CHECKING:
     from fastapi import FastAPI, Request, Response

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/documents/analysis.py

@@ -24,7 +24,7 @@ from __future__ import annotations
 
 import re
 from datetime import datetime
-from typing import TYPE_CHECKING, Dict
+from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
     from svc_infra.storage.base import StorageBackend
@@ -32,7 +32,7 @@ if TYPE_CHECKING:
     from .models import DocumentAnalysis
 
 # In-memory analysis cache (production: use svc-infra cache)
-_analysis_cache: Dict[str, "DocumentAnalysis"] = {}
+_analysis_cache: dict[str, "DocumentAnalysis"] = {}
 
 
 async def analyze_document(

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/documents/models.py

@@ -31,7 +31,7 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Dict, List, Optional
+from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 from svc_infra.documents import Document as BaseDocument
@@ -145,7 +145,7 @@ class OCRResult(BaseModel):
     confidence: float = Field(
         ..., description="Overall OCR confidence score (0.0-1.0)", ge=0.0, le=1.0
     )
-    fields_extracted: Dict[str, str] = Field(
+    fields_extracted: dict[str, str] = Field(
         default_factory=dict,
         description="Structured fields extracted from document (names, amounts, dates)",
     )
@@ -181,10 +181,10 @@ class DocumentAnalysis(BaseModel):
 
     document_id: str = Field(..., description="Document that was analyzed")
     summary: str = Field(..., description="High-level document summary")
-    key_findings: List[str] = Field(
+    key_findings: list[str] = Field(
         default_factory=list, description="Important facts extracted from document"
     )
-    recommendations: List[str] = Field(
+    recommendations: list[str] = Field(
         default_factory=list, description="Action items or suggestions based on document content"
     )
     analysis_date: datetime = Field(

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/documents/ocr.py

@@ -25,7 +25,7 @@ from __future__ import annotations
 
 import re
 from datetime import datetime
-from typing import TYPE_CHECKING, Dict, Optional
+from typing import TYPE_CHECKING, Optional
 
 if TYPE_CHECKING:
     from svc_infra.storage.base import StorageBackend
@@ -33,7 +33,7 @@ if TYPE_CHECKING:
     from .models import OCRResult
 
 # In-memory OCR cache (production: use svc-infra cache)
-_ocr_cache: Dict[str, "OCRResult"] = {}
+_ocr_cache: dict[str, "OCRResult"] = {}
 
 
 async def extract_text(

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/documents/storage.py

@@ -36,7 +36,7 @@ Quick Start:
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, List, Optional
+from typing import TYPE_CHECKING, Optional
 
 try:
     from svc_infra.documents import (
@@ -242,7 +242,7 @@ def list_documents(
     tax_year: Optional[int] = None,
     limit: int = 100,
     offset: int = 0,
-) -> List["FinancialDocument"]:
+) -> list["FinancialDocument"]:
     """
     List user's financial documents with optional filters (delegates to svc-infra).
 

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/goals/add.py

@@ -29,7 +29,7 @@ add_goals(app)
 
 import logging
 from datetime import datetime
-from typing import Any, List, Optional, cast
+from typing import Any, Optional, cast
 
 from fastapi import FastAPI, HTTPException, status, Query, Body
 from pydantic import BaseModel, Field
@@ -89,7 +89,7 @@ class CreateGoalRequest(BaseModel):
     description: Optional[str] = Field(None, description="Goal description")
     current_amount: Optional[float] = Field(0.0, ge=0, description="Current amount")
     auto_contribute: Optional[bool] = Field(False, description="Auto-contribute enabled")
-    tags: Optional[List[str]] = Field(None, description="Goal tags")
+    tags: Optional[list[str]] = Field(None, description="Goal tags")
 
 
 class UpdateGoalRequest(BaseModel):
@@ -102,7 +102,7 @@ class UpdateGoalRequest(BaseModel):
     current_amount: Optional[float] = Field(None, ge=0)
     status: Optional[GoalStatus] = None
     auto_contribute: Optional[bool] = None
-    tags: Optional[List[str]] = None
+    tags: Optional[list[str]] = None
 
 
 class AddMilestoneRequest(BaseModel):
@@ -238,14 +238,14 @@ def add_goals(
         except ValueError as e:
             raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
 
-    @router.get("", response_model=List[dict])
+    @router.get("", response_model=list[dict])
     async def list_goals_endpoint(
         user_id: Optional[str] = Query(
             None, description="User identifier (optional, returns all if not provided)"
         ),
         goal_type: Optional[str] = Query(None, description="Filter by goal type"),
         status_filter: Optional[str] = Query(None, alias="status", description="Filter by status"),
-    ) -> List[dict]:
+    ) -> list[dict]:
         """
         List all goals for a user with optional filters.
 
@@ -442,8 +442,8 @@ def add_goals(
         except ValueError as e:
             raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
 
-    @router.get("/{goal_id}/milestones", response_model=List[dict])
-    async def list_milestones_endpoint(goal_id: str) -> List[dict]:
+    @router.get("/{goal_id}/milestones", response_model=list[dict])
+    async def list_milestones_endpoint(goal_id: str) -> list[dict]:
         """
         List all milestones for a goal.
 
@@ -540,8 +540,8 @@ def add_goals(
         except ValueError as e:
             raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
 
-    @router.get("/{goal_id}/funding", response_model=List[dict])
-    async def list_funding_sources_endpoint(goal_id: str) -> List[dict]:
+    @router.get("/{goal_id}/funding", response_model=list[dict])
+    async def list_funding_sources_endpoint(goal_id: str) -> list[dict]:
         """
         List all funding sources for a goal.
 

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/goals/funding.py

@@ -22,14 +22,12 @@ Example:
     >>> # Raises ValueError if total allocation > 100%
 """
 
-from typing import Dict, List
-
 from fin_infra.goals.models import FundingSource
 from fin_infra.goals.management import get_goal
 
 # In-memory storage for funding allocations
 # Structure: {account_id: {goal_id: allocation_percent}}
-_FUNDING_STORE: Dict[str, Dict[str, float]] = {}
+_FUNDING_STORE: dict[str, dict[str, float]] = {}
 
 
 def link_account_to_goal(
@@ -108,7 +106,7 @@ def link_account_to_goal(
     )
 
 
-def get_goal_funding_sources(goal_id: str) -> List[FundingSource]:
+def get_goal_funding_sources(goal_id: str) -> list[FundingSource]:
     """
     Get all accounts funding a specific goal.
 
@@ -154,7 +152,7 @@ def get_goal_funding_sources(goal_id: str) -> List[FundingSource]:
     return funding_sources
 
 
-def get_account_allocations(account_id: str) -> Dict[str, float]:
+def get_account_allocations(account_id: str) -> dict[str, float]:
     """
     Get all goal allocations for a specific account.
 

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/investments/models.py

@@ -20,7 +20,7 @@ from __future__ import annotations
 from datetime import date
 from decimal import Decimal
 from enum import Enum
-from typing import TYPE_CHECKING, Dict, List, Optional
+from typing import TYPE_CHECKING, Optional
 
 from pydantic import BaseModel, ConfigDict, Field, computed_field
 
@@ -374,12 +374,12 @@ class InvestmentAccount(BaseModel):
     subtype: Optional[str] = Field(None, description="Account subtype (401k, ira, brokerage)")
 
     # Balances
-    balances: Dict[str, Optional[Decimal]] = Field(
+    balances: dict[str, Optional[Decimal]] = Field(
         ..., description="Current, available, and limit balances"
     )
 
     # Holdings
-    holdings: List[Holding] = Field(default_factory=list, description="List of holdings in account")
+    holdings: list[Holding] = Field(default_factory=list, description="List of holdings in account")
 
     if TYPE_CHECKING:
 
@@ -487,11 +487,11 @@ class AssetAllocation(BaseModel):
         },
     )
 
-    by_security_type: Dict[SecurityType, float] = Field(
+    by_security_type: dict[SecurityType, float] = Field(
         default_factory=dict,
         description="Percentage breakdown by security type (equity, bond, etc.)",
     )
-    by_sector: Dict[str, float] = Field(
+    by_sector: dict[str, float] = Field(
         default_factory=dict,
         description="Percentage breakdown by sector (Technology, Healthcare, etc.)",
     )

{fin_infra-0.1.79 → fin_infra-0.1.81}/src/fin_infra/investments/providers/base.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from abc import ABC, abstractmethod
 from datetime import date
-from typing import List, Optional
+from typing import Optional
 
 # Import will work once models.py is fully implemented in Task 3
 # For now, using TYPE_CHECKING to avoid circular imports
@@ -30,8 +30,8 @@ class InvestmentProvider(ABC):
 
     @abstractmethod
     async def get_holdings(
-        self, access_token: str, account_ids: Optional[List[str]] = None
-    ) -> List[Holding]:
+        self, access_token: str, account_ids: Optional[list[str]] = None
+    ) -> list[Holding]:
         """Fetch holdings for investment accounts.
 
         Args:
@@ -54,8 +54,8 @@ class InvestmentProvider(ABC):
         access_token: str,
         start_date: date,
         end_date: date,
-        account_ids: Optional[List[str]] = None,
-    ) -> List[InvestmentTransaction]:
+        account_ids: Optional[list[str]] = None,
+    ) -> list[InvestmentTransaction]:
         """Fetch investment transactions within date range.
 
         Args:
@@ -77,7 +77,7 @@ class InvestmentProvider(ABC):
         pass
 
     @abstractmethod
-    async def get_securities(self, access_token: str, security_ids: List[str]) -> List[Security]:
+    async def get_securities(self, access_token: str, security_ids: list[str]) -> list[Security]:
         """Fetch security details (ticker, name, type, current price).
 
         Args:
@@ -95,7 +95,7 @@ class InvestmentProvider(ABC):
         pass
 
     @abstractmethod
-    async def get_investment_accounts(self, access_token: str) -> List[InvestmentAccount]:
+    async def get_investment_accounts(self, access_token: str) -> list[InvestmentAccount]:
         """Fetch investment accounts with aggregated holdings.
 
         Args:
@@ -113,7 +113,7 @@ class InvestmentProvider(ABC):
 
     # Helper methods (concrete - shared across all providers)
 
-    def calculate_allocation(self, holdings: List[Holding]) -> AssetAllocation:
+    def calculate_allocation(self, holdings: list[Holding]) -> AssetAllocation:
         """Calculate asset allocation by security type and sector.
 
         Groups holdings by security type (equity, bond, ETF, etc.) and calculates
@@ -183,7 +183,7 @@ class InvestmentProvider(ABC):
             cash_percent=cash_percent,
         )
 
-    def calculate_portfolio_metrics(self, holdings: List[Holding]) -> dict:
+    def calculate_portfolio_metrics(self, holdings: list[Holding]) -> dict:
         """Calculate total value, cost basis, unrealized gain/loss.
 
         Aggregates holdings to calculate portfolio-level metrics.

{fin_infra-0.1.79 → fin_infra-0.1.81}/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, cast
+from typing import Any, Optional, cast
 
 try:
     from plaid.api import plaid_api
@@ -131,8 +131,8 @@ class PlaidInvestmentProvider(InvestmentProvider):
         return cast(str, hosts.get(environment.lower(), plaid.Environment.Sandbox))
 
     async def get_holdings(
-        self, access_token: str, account_ids: Optional[List[str]] = None
-    ) -> List[Holding]:
+        self, access_token: str, account_ids: Optional[list[str]] = None
+    ) -> list[Holding]:
         """Fetch investment holdings from Plaid.
 
         Retrieves holdings with security details, quantity, cost basis, and current value.
@@ -189,8 +189,8 @@ class PlaidInvestmentProvider(InvestmentProvider):
         access_token: str,
         start_date: date,
         end_date: date,
-        account_ids: Optional[List[str]] = None,
-    ) -> List[InvestmentTransaction]:
+        account_ids: Optional[list[str]] = None,
+    ) -> list[InvestmentTransaction]:
         """Fetch investment transactions from Plaid.
 
         Retrieves buy/sell/dividend transactions within the specified date range.
@@ -252,7 +252,7 @@ class PlaidInvestmentProvider(InvestmentProvider):
         except ApiException as e:
             raise self._transform_error(e)
 
-    async def get_securities(self, access_token: str, security_ids: List[str]) -> List[Security]:
+    async def get_securities(self, access_token: str, security_ids: list[str]) -> list[Security]:
         """Fetch security details from Plaid holdings.
 
         Note: Plaid doesn't have a dedicated securities endpoint.
@@ -290,7 +290,7 @@ class PlaidInvestmentProvider(InvestmentProvider):
         except ApiException as e:
             raise self._transform_error(e)
 
-    async def get_investment_accounts(self, access_token: str) -> List[InvestmentAccount]:
+    async def get_investment_accounts(self, access_token: str) -> list[InvestmentAccount]:
         """Fetch investment accounts with aggregated holdings.
 
         Returns accounts with total value, cost basis, and unrealized P&L.
@@ -321,7 +321,7 @@ class PlaidInvestmentProvider(InvestmentProvider):
             }
 
             # Group holdings by account
-            accounts_map: Dict[str, Dict[str, Any]] = {}
+            accounts_map: dict[str, dict[str, Any]] = {}
             for plaid_holding in response.holdings:
                 holding_dict = plaid_holding.to_dict()
                 account_id = holding_dict["account_id"]
@@ -373,7 +373,7 @@ class PlaidInvestmentProvider(InvestmentProvider):
 
     # Helper methods for data transformation
 
-    def _transform_security(self, plaid_security: Dict[str, Any]) -> Security:
+    def _transform_security(self, plaid_security: dict[str, Any]) -> Security:
         """Transform Plaid security data to Security model."""
         # Handle close_price - Plaid may return None for securities without recent pricing
         close_price_raw = plaid_security.get("close_price")
@@ -394,7 +394,7 @@ class PlaidInvestmentProvider(InvestmentProvider):
             currency=plaid_security.get("iso_currency_code", "USD"),
         )
 
-    def _transform_holding(self, plaid_holding: Dict[str, Any], security: Security) -> Holding:
+    def _transform_holding(self, plaid_holding: dict[str, Any], security: Security) -> Holding:
         """Transform Plaid holding data to Holding model."""
         return Holding(
             account_id=plaid_holding["account_id"],
@@ -410,7 +410,7 @@ class PlaidInvestmentProvider(InvestmentProvider):
         )
 
     def _transform_transaction(
-        self, plaid_transaction: Dict[str, Any], security: Security
+        self, plaid_transaction: dict[str, Any], security: Security
     ) -> InvestmentTransaction:
         """Transform Plaid investment transaction to InvestmentTransaction model."""
         # Map Plaid transaction type to our enum