fin-infra 0.1.83__py3-none-any.whl → 0.1.85__py3-none-any.whl

fin_infra/analytics/cash_flow.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 
 from datetime import datetime, timedelta
 from decimal import Decimal
-from typing import Any, Optional
+from typing import Any
 
 from ..models import Transaction
 from .models import CashFlowAnalysis
@@ -17,7 +17,7 @@ async def calculate_cash_flow(
     user_id: str,
     start_date: str | datetime,
     end_date: str | datetime,
-    accounts: Optional[list[str]] = None,
+    accounts: list[str] | None = None,
     *,
     banking_provider=None,
     categorization_provider=None,
@@ -117,7 +117,7 @@ async def calculate_cash_flow(
 async def forecast_cash_flow(
     user_id: str,
     months: int = 6,
-    assumptions: Optional[dict[str, Any]] = None,
+    assumptions: dict[str, Any] | None = None,
     *,
     recurring_provider=None,
 ) -> list[CashFlowAnalysis]:

fin_infra/analytics/models.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -72,7 +72,7 @@ class SavingsRateData(BaseModel):
     expenses: float = Field(..., description="Total expenses for period")
     period: Period = Field(..., description="Period type")
     definition: SavingsDefinition = Field(..., description="Calculation method used")
-    trend: Optional[TrendDirection] = Field(None, description="Trend over time")
+    trend: TrendDirection | None = Field(None, description="Trend over time")
 
 
 class SpendingAnomaly(BaseModel):
@@ -132,7 +132,7 @@ class PersonalizedSpendingAdvice(BaseModel):
     alerts: list[str] = Field(
         default_factory=list, description="Urgent spending issues requiring attention"
     )
-    estimated_monthly_savings: Optional[float] = Field(
+    estimated_monthly_savings: float | None = Field(
         None, description="Potential monthly savings if recommendations followed"
     )
 
@@ -183,7 +183,7 @@ class BenchmarkComparison(BaseModel):
     benchmark_return_percent: float = Field(..., description="Benchmark return percentage")
     benchmark_symbol: str = Field(..., description="Benchmark ticker (e.g., SPY)")
     alpha: float = Field(..., description="Portfolio alpha (excess return)")
-    beta: Optional[float] = Field(None, description="Portfolio beta (volatility vs benchmark)")
+    beta: float | None = Field(None, description="Portfolio beta (volatility vs benchmark)")
     period: str = Field(..., description="Comparison period (1y, 3y, 5y, etc.)")
 
 
@@ -213,6 +213,6 @@ class GrowthProjection(BaseModel):
     assumptions: dict[str, Any] = Field(
         default_factory=dict, description="Assumptions used (inflation, returns, etc.)"
     )
-    confidence_intervals: Optional[dict[str, tuple[float, float]]] = Field(
+    confidence_intervals: dict[str, tuple[float, float]] | None = Field(
         None, description="95% confidence intervals by scenario"
     )

fin_infra/analytics/spending.py

@@ -45,7 +45,6 @@ Examples:
 from collections import defaultdict
 from datetime import timedelta
 from decimal import Decimal
-from typing import Optional
 
 from fin_infra.analytics.models import (
     PersonalizedSpendingAdvice,
@@ -60,7 +59,7 @@ async def analyze_spending(
     user_id: str,
     *,
     period: str = "30d",
-    categories: Optional[list[str]] = None,
+    categories: list[str] | None = None,
     banking_provider=None,
     categorization_provider=None,
 ) -> SpendingInsight:
@@ -426,7 +425,7 @@ def _generate_mock_transactions(days: int) -> list[Transaction]:
 async def generate_spending_insights(
     spending_insight: SpendingInsight,
     *,
-    user_context: Optional[dict] = None,
+    user_context: dict | None = None,
     llm_provider=None,
 ) -> "PersonalizedSpendingAdvice":
     """Generate personalized spending insights using LLM.
@@ -521,7 +520,7 @@ async def generate_spending_insights(
 
 def _build_spending_insights_prompt(
     spending_insight: SpendingInsight,
-    user_context: Optional[dict] = None,
+    user_context: dict | None = None,
 ) -> str:
     """Build LLM prompt with financial context.
 
@@ -621,7 +620,7 @@ Be specific, encouraging, and actionable. Focus on realistic savings, not extrem
 
 def _generate_rule_based_insights(
     spending_insight: SpendingInsight,
-    user_context: Optional[dict] = None,
+    user_context: dict | None = None,
 ) -> "PersonalizedSpendingAdvice":
     """Generate rule-based insights when LLM is unavailable.
 

fin_infra/budgets/alerts.py

@@ -35,7 +35,7 @@ Example:
 from __future__ import annotations
 
 from datetime import datetime
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 from fin_infra.budgets.models import (
     AlertSeverity,
@@ -51,7 +51,7 @@ if TYPE_CHECKING:
 async def check_budget_alerts(
     budget_id: str,
     tracker: BudgetTracker,
-    thresholds: Optional[dict[str, float]] = None,
+    thresholds: dict[str, float] | None = None,
 ) -> list[BudgetAlert]:
     """
     Check budget for alerts (overspending, approaching limits, unusual patterns).

fin_infra/budgets/ease.py

@@ -12,7 +12,6 @@ Generic Design:
 from __future__ import annotations
 
 import os
-from typing import Optional
 
 from sqlalchemy.ext.asyncio import create_async_engine
 
@@ -20,7 +19,7 @@ from fin_infra.budgets.tracker import BudgetTracker
 
 
 def easy_budgets(
-    db_url: Optional[str] = None,
+    db_url: str | None = None,
     pool_size: int = 5,
     max_overflow: int = 10,
     pool_pre_ping: bool = True,

fin_infra/budgets/models.py

@@ -8,7 +8,6 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -296,7 +295,7 @@ class BudgetAlert(BaseModel):
     """
 
     budget_id: str = Field(..., description="Budget identifier")
-    category: Optional[str] = Field(None, description="Category triggering alert")
+    category: str | None = Field(None, description="Category triggering alert")
     alert_type: AlertType = Field(..., description="Type of alert")
     threshold: float = Field(..., description="Threshold that triggered alert")
     message: str = Field(..., description="Human-readable alert message")

fin_infra/budgets/templates.py

@@ -16,7 +16,7 @@ Generic Design:
 from __future__ import annotations
 
 from datetime import datetime
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 from fin_infra.budgets.models import Budget, BudgetPeriod, BudgetType
 
@@ -177,9 +177,9 @@ async def apply_template(
     template_name: str,
     total_income: float,
     tracker: BudgetTracker,
-    budget_name: Optional[str] = None,
-    start_date: Optional[datetime] = None,
-    custom_template: Optional[BudgetTemplate] = None,
+    budget_name: str | None = None,
+    start_date: datetime | None = None,
+    custom_template: BudgetTemplate | None = None,
 ) -> Budget:
     """Apply a budget template to create a new budget.
 

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, Optional
+from typing import TYPE_CHECKING
 
 from sqlalchemy.ext.asyncio import async_sessionmaker
 
@@ -116,7 +116,7 @@ class BudgetTracker:
         type: str,  # BudgetType value
         period: str,  # BudgetPeriod value
         categories: dict[str, float],
-        start_date: Optional[datetime] = None,
+        start_date: datetime | None = None,
         rollover_enabled: bool = False,
     ) -> Budget:
         """
@@ -205,7 +205,7 @@ class BudgetTracker:
     async def get_budgets(
         self,
         user_id: str,
-        type: Optional[str] = None,
+        type: str | None = None,
     ) -> list[Budget]:
         """
         Get all budgets for a user.

fin_infra/categorization/ease.py

@@ -5,7 +5,7 @@ Provides one-line setup with sensible defaults.
 """
 
 from pathlib import Path
-from typing import Literal, Optional
+from typing import Literal
 
 from .engine import CategorizationEngine
 
@@ -21,10 +21,10 @@ def easy_categorization(
     taxonomy: str = "mx",
     enable_ml: bool = False,
     confidence_threshold: float = 0.6,
-    model_path: Optional[Path] = None,
+    model_path: Path | None = None,
     # LLM-specific parameters (V2)
     llm_provider: Literal["google", "openai", "anthropic", "none"] = "google",
-    llm_model: Optional[str] = None,
+    llm_model: str | None = None,
     llm_confidence_threshold: float = 0.6,
     llm_cache_ttl: int = 86400,  # 24 hours
     llm_max_cost_per_day: float = 0.10,  # $0.10/day

fin_infra/categorization/models.py

@@ -4,7 +4,6 @@ Pydantic models for transaction categorization.
 
 from datetime import datetime
 from enum import Enum
-from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -34,7 +33,7 @@ class CategoryPrediction(BaseModel):
         default_factory=list,
         description="Alternative predictions (category, confidence)",
     )
-    reasoning: Optional[str] = Field(None, description="Explanation of prediction (for LLM)")
+    reasoning: str | None = Field(None, description="Explanation of prediction (for LLM)")
 
     model_config = ConfigDict(
         json_schema_extra={
@@ -100,7 +99,7 @@ class CategorizationRequest(BaseModel):
     """Request to categorize a merchant."""
 
     merchant_name: str = Field(..., description="Merchant name to categorize")
-    user_id: Optional[str] = Field(None, description="User ID for personalized overrides")
+    user_id: str | None = Field(None, description="User ID for personalized overrides")
     include_alternatives: bool = Field(default=False, description="Include alternative predictions")
     min_confidence: float = Field(
         default=0.0,
@@ -152,7 +151,7 @@ class CategoryStats(BaseModel):
     total_categories: int = Field(..., description="Total number of categories")
     categories_by_group: dict[str, int] = Field(..., description="Category counts by group")
     total_rules: int = Field(..., description="Total number of rules")
-    cache_hit_rate: Optional[float] = Field(None, description="Cache hit rate (0-1)")
+    cache_hit_rate: float | None = Field(None, description="Cache hit rate (0-1)")
 
     model_config = ConfigDict(
         json_schema_extra={

fin_infra/documents/models.py

@@ -31,7 +31,6 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 from svc_infra.documents import Document as BaseDocument
@@ -111,8 +110,8 @@ class FinancialDocument(BaseDocument):
 
     # Financial-specific fields
     type: DocumentType = Field(..., description="Document type category (financial-specific)")
-    tax_year: Optional[int] = Field(None, description="Tax year for tax documents (e.g., 2024)")
-    form_type: Optional[str] = Field(None, description="Tax form type (W-2, 1099-INT, 1040, etc.)")
+    tax_year: int | None = Field(None, description="Tax year for tax documents (e.g., 2024)")
+    form_type: str | None = Field(None, description="Tax form type (W-2, 1099-INT, 1040, etc.)")
 
 
 # Backward compatibility: alias for existing code

fin_infra/investments/ease.py

@@ -8,13 +8,13 @@ and SnapTrade (retail brokerages) for maximum coverage.
 from __future__ import annotations
 
 import os
-from typing import Any, Literal, Optional
+from typing import Any, Literal
 
 from .providers.base import InvestmentProvider
 
 
 def easy_investments(
-    provider: Optional[Literal["plaid", "snaptrade"]] = None,
+    provider: Literal["plaid", "snaptrade"] | None = None,
     **config: Any,
 ) -> InvestmentProvider:
     """Create investment provider with auto-configuration.

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, Optional
+from typing import TYPE_CHECKING
 
 from pydantic import BaseModel, ConfigDict, Field, computed_field
 
@@ -121,22 +121,20 @@ class Security(BaseModel):
 
     # Identifiers (at least one required for matching)
     security_id: str = Field(..., description="Provider-specific security ID")
-    cusip: Optional[str] = Field(None, description="CUSIP identifier (US securities)")
-    isin: Optional[str] = Field(None, description="ISIN identifier (international)")
-    sedol: Optional[str] = Field(None, description="SEDOL identifier (UK securities)")
-    ticker_symbol: Optional[str] = Field(None, description="Trading symbol (AAPL, GOOGL)")
+    cusip: str | None = Field(None, description="CUSIP identifier (US securities)")
+    isin: str | None = Field(None, description="ISIN identifier (international)")
+    sedol: str | None = Field(None, description="SEDOL identifier (UK securities)")
+    ticker_symbol: str | None = Field(None, description="Trading symbol (AAPL, GOOGL)")
 
     # Basic info
     name: str = Field(..., description="Security name")
     type: SecurityType = Field(..., description="Security type (equity, etf, bond, etc.)")
-    sector: Optional[str] = Field(
-        None, description="Sector classification (Technology, Healthcare)"
-    )
+    sector: str | None = Field(None, description="Sector classification (Technology, Healthcare)")
 
     # Market data
-    close_price: Optional[Decimal] = Field(None, ge=0, description="Latest closing price")
-    close_price_as_of: Optional[date] = Field(None, description="Date of close_price")
-    exchange: Optional[str] = Field(None, description="Exchange (NASDAQ, NYSE, etc.)")
+    close_price: Decimal | None = Field(None, ge=0, description="Latest closing price")
+    close_price_as_of: date | None = Field(None, description="Date of close_price")
+    exchange: str | None = Field(None, description="Exchange (NASDAQ, NYSE, etc.)")
     currency: str = Field("USD", description="Currency code (USD, EUR, etc.)")
 
 
@@ -198,26 +196,26 @@ class Holding(BaseModel):
     institution_value: Decimal = Field(
         ..., ge=0, description="Current market value (quantity × price)"
     )
-    cost_basis: Optional[Decimal] = Field(
+    cost_basis: Decimal | None = Field(
         None, ge=0, description="Total cost basis (original purchase price)"
     )
 
     # Additional data
     currency: str = Field("USD", description="Currency code")
-    unofficial_currency_code: Optional[str] = Field(None, description="For crypto/alt currencies")
-    as_of_date: Optional[date] = Field(None, description="Date of pricing data")
+    unofficial_currency_code: str | None = Field(None, description="For crypto/alt currencies")
+    as_of_date: date | None = Field(None, description="Date of pricing data")
 
     if TYPE_CHECKING:
 
         @property
-        def unrealized_gain_loss(self) -> Optional[Decimal]:
+        def unrealized_gain_loss(self) -> Decimal | None:
             """Calculate unrealized gain/loss (current value - cost basis)."""
             if self.cost_basis is None:
                 return None
             return self.institution_value - self.cost_basis
 
         @property
-        def unrealized_gain_loss_percent(self) -> Optional[Decimal]:
+        def unrealized_gain_loss_percent(self) -> Decimal | None:
             """Calculate unrealized gain/loss percentage."""
             if self.cost_basis is None or self.cost_basis == 0:
                 return None
@@ -228,7 +226,7 @@ class Holding(BaseModel):
 
         @computed_field
         @property
-        def unrealized_gain_loss(self) -> Optional[Decimal]:
+        def unrealized_gain_loss(self) -> Decimal | None:
             """Calculate unrealized gain/loss (current value - cost basis)."""
             if self.cost_basis is None:
                 return None
@@ -236,7 +234,7 @@ class Holding(BaseModel):
 
         @computed_field
         @property
-        def unrealized_gain_loss_percent(self) -> Optional[Decimal]:
+        def unrealized_gain_loss_percent(self) -> Decimal | None:
             """Calculate unrealized gain/loss percentage."""
             if self.cost_basis is None or self.cost_basis == 0:
                 return None
@@ -304,17 +302,17 @@ class InvestmentTransaction(BaseModel):
     transaction_type: TransactionType = Field(
         ..., alias="type", description="Transaction type (buy, sell, dividend)"
     )
-    subtype: Optional[str] = Field(None, description="Provider-specific subtype")
+    subtype: str | None = Field(None, description="Provider-specific subtype")
 
     # Amounts
     quantity: Decimal = Field(..., description="Number of shares (0 for fees/dividends)")
     amount: Decimal = Field(..., description="Transaction amount (negative for purchases)")
-    price: Optional[Decimal] = Field(None, ge=0, description="Price per share")
-    fees: Optional[Decimal] = Field(None, ge=0, description="Transaction fees")
+    price: Decimal | None = Field(None, ge=0, description="Price per share")
+    fees: Decimal | None = Field(None, ge=0, description="Transaction fees")
 
     # Additional data
     currency: str = Field("USD", description="Currency code")
-    unofficial_currency_code: Optional[str] = Field(None, description="For crypto/alt currencies")
+    unofficial_currency_code: str | None = Field(None, description="For crypto/alt currencies")
 
 
 class InvestmentAccount(BaseModel):
@@ -371,10 +369,10 @@ class InvestmentAccount(BaseModel):
     account_id: str = Field(..., description="Account identifier")
     name: str = Field(..., description="Account name (Fidelity 401k)")
     type: str = Field(..., description="Account type (investment)")
-    subtype: Optional[str] = Field(None, description="Account subtype (401k, ira, brokerage)")
+    subtype: str | None = Field(None, description="Account subtype (401k, ira, brokerage)")
 
     # Balances
-    balances: dict[str, Optional[Decimal]] = Field(
+    balances: dict[str, Decimal | None] = Field(
         ..., description="Current, available, and limit balances"
     )
 
@@ -405,7 +403,7 @@ class InvestmentAccount(BaseModel):
             return holdings_value - self.total_cost_basis
 
         @property
-        def total_unrealized_gain_loss_percent(self) -> Optional[Decimal]:
+        def total_unrealized_gain_loss_percent(self) -> Decimal | None:
             """Calculate total unrealized P&L percentage."""
             if self.total_cost_basis == 0:
                 return None
@@ -439,7 +437,7 @@ class InvestmentAccount(BaseModel):
 
         @computed_field
         @property
-        def total_unrealized_gain_loss_percent(self) -> Optional[Decimal]:
+        def total_unrealized_gain_loss_percent(self) -> Decimal | None:
             """Calculate total unrealized P&L percentage."""
             if self.total_cost_basis == 0:
                 return None

fin_infra/models/accounts.py

@@ -2,7 +2,6 @@ from __future__ import annotations
 
 from decimal import Decimal
 from enum import Enum
-from typing import Optional
 
 from pydantic import BaseModel, field_validator
 
@@ -26,11 +25,11 @@ class Account(BaseModel):
     id: str
     name: str
     type: AccountType
-    mask: Optional[str] = None
+    mask: str | None = None
     currency: str = "USD"
-    institution: Optional[str] = None
-    balance_available: Optional[Decimal] = None
-    balance_current: Optional[Decimal] = None
+    institution: str | None = None
+    balance_available: Decimal | None = None
+    balance_current: Decimal | None = None
 
     @field_validator("balance_available", "balance_current", mode="before")
     @classmethod

fin_infra/models/transactions.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from datetime import date
+import datetime
 from decimal import Decimal
 
 from pydantic import BaseModel, field_validator
@@ -15,7 +15,7 @@ class Transaction(BaseModel):
 
     id: str
     account_id: str
-    date: date
+    date: datetime.date
     amount: Decimal
     currency: str = "USD"
     description: str | None = None

fin_infra/normalization/currency_converter.py

@@ -2,7 +2,6 @@
 
 import logging
 from datetime import date as DateType
-from typing import Optional
 
 from fin_infra.exceptions import CurrencyNotSupportedError, ExchangeRateAPIError
 from fin_infra.normalization.models import CurrencyConversionResult
@@ -25,7 +24,7 @@ class CurrencyConverter:
     Supports 160+ currencies including crypto (BTC, ETH).
     """
 
-    def __init__(self, api_key: Optional[str] = None):
+    def __init__(self, api_key: str | None = None):
         """
         Initialize currency converter.
 
@@ -39,7 +38,7 @@ class CurrencyConverter:
         amount: float,
         from_currency: str,
         to_currency: str,
-        date: Optional[DateType] = None,
+        date: DateType | None = None,
     ) -> float:
         """
         Convert amount from one currency to another.
@@ -79,7 +78,7 @@ class CurrencyConverter:
         self,
         from_currency: str,
         to_currency: str,
-        date: Optional[DateType] = None,
+        date: DateType | None = None,
     ) -> float:
         """
         Get exchange rate between two currencies.
@@ -142,7 +141,7 @@ class CurrencyConverter:
         amount: float,
         from_currency: str,
         to_currency: str,
-        date: Optional[DateType] = None,
+        date: DateType | None = None,
     ) -> CurrencyConversionResult:
         """
         Convert amount with detailed result information.

fin_infra/normalization/models.py

@@ -1,7 +1,6 @@
 """Data models for normalization module."""
 
 from datetime import date as DateType
-from typing import Optional
 
 from pydantic import BaseModel, Field
 
@@ -11,12 +10,12 @@ class SymbolMetadata(BaseModel):
 
     ticker: str = Field(..., description="Standard ticker symbol")
     name: str = Field(..., description="Company or asset name")
-    exchange: Optional[str] = Field(None, description="Primary exchange (e.g., NASDAQ, NYSE)")
-    cusip: Optional[str] = Field(None, description="CUSIP identifier")
-    isin: Optional[str] = Field(None, description="ISIN identifier")
-    sector: Optional[str] = Field(None, description="Business sector")
-    industry: Optional[str] = Field(None, description="Industry classification")
-    market_cap: Optional[float] = Field(None, description="Market capitalization in USD")
+    exchange: str | None = Field(None, description="Primary exchange (e.g., NASDAQ, NYSE)")
+    cusip: str | None = Field(None, description="CUSIP identifier")
+    isin: str | None = Field(None, description="ISIN identifier")
+    sector: str | None = Field(None, description="Business sector")
+    industry: str | None = Field(None, description="Industry classification")
+    market_cap: float | None = Field(None, description="Market capitalization in USD")
     asset_type: str = Field(default="stock", description="Asset type: stock, etf, crypto, forex")
 
 
@@ -26,8 +25,8 @@ class ExchangeRate(BaseModel):
     from_currency: str = Field(..., description="Source currency code (e.g., USD)")
     to_currency: str = Field(..., description="Target currency code (e.g., EUR)")
     rate: float = Field(..., description="Exchange rate (1 from_currency = rate to_currency)")
-    date: Optional[DateType] = Field(None, description="Rate date (None = current)")
-    timestamp: Optional[int] = Field(None, description="Unix timestamp of rate")
+    date: DateType | None = Field(None, description="Rate date (None = current)")
+    timestamp: int | None = Field(None, description="Unix timestamp of rate")
 
 
 class CurrencyConversionResult(BaseModel):
@@ -38,4 +37,4 @@ class CurrencyConversionResult(BaseModel):
     to_currency: str = Field(..., description="Target currency")
     converted: float = Field(..., description="Converted amount")
     rate: float = Field(..., description="Exchange rate used")
-    date: Optional[DateType] = Field(None, description="Rate date")
+    date: DateType | None = Field(None, description="Rate date")

fin_infra/normalization/symbol_resolver.py

@@ -1,7 +1,6 @@
 """Symbol resolver for converting between ticker formats."""
 
 import logging
-from typing import Optional
 
 from fin_infra.exceptions import SymbolNotFoundError
 from fin_infra.normalization.models import SymbolMetadata
@@ -231,9 +230,9 @@ class SymbolResolver:
     def add_mapping(
         self,
         ticker: str,
-        cusip: Optional[str] = None,
-        isin: Optional[str] = None,
-        metadata: Optional[dict] = None,
+        cusip: str | None = None,
+        isin: str | None = None,
+        metadata: dict | None = None,
     ):
         """
         Add or override a symbol mapping (useful for custom symbols).

fin_infra/security/add.py

@@ -5,7 +5,6 @@ Easy integration of financial PII masking and token encryption.
 """
 
 import logging
-from typing import Optional
 
 from fastapi import FastAPI
 
@@ -15,7 +14,7 @@ from .pii_filter import FinancialPIIFilter
 
 def add_financial_security(
     app: FastAPI,
-    encryption_key: Optional[bytes] = None,
+    encryption_key: bytes | None = None,
     enable_pii_filter: bool = True,
     enable_audit_log: bool = True,
     mask_emails: bool = False,

fin_infra/security/audit.py

@@ -6,7 +6,6 @@ Track access to sensitive financial data for compliance.
 
 import logging
 from datetime import datetime
-from typing import Optional
 
 from .models import PIIAccessLog
 
@@ -23,10 +22,10 @@ async def log_pii_access(
     pii_type: str,
     action: str,
     resource: str,
-    ip_address: Optional[str] = None,
-    user_agent: Optional[str] = None,
+    ip_address: str | None = None,
+    user_agent: str | None = None,
     success: bool = True,
-    error_message: Optional[str] = None,
+    error_message: str | None = None,
 ) -> PIIAccessLog:
     """
     Log PII access for audit trail.
@@ -86,9 +85,9 @@ async def log_pii_access(
 
 
 def get_audit_logs(
-    user_id: Optional[str] = None,
-    pii_type: Optional[str] = None,
-    action: Optional[str] = None,
+    user_id: str | None = None,
+    pii_type: str | None = None,
+    action: str | None = None,
     limit: int = 100,
 ) -> list[PIIAccessLog]:
     """

fin_infra/security/token_store.py

@@ -5,7 +5,6 @@ Database operations for encrypted provider tokens.
 """
 
 from datetime import datetime
-from typing import Optional
 
 from sqlalchemy import Column, DateTime, String, Text, select, update
 from sqlalchemy.dialects.postgresql import UUID
@@ -48,8 +47,8 @@ async def store_provider_token(
     provider: str,
     token: str,
     encryption: ProviderTokenEncryption,
-    expires_at: Optional[datetime] = None,
-    key_id: Optional[str] = None,
+    expires_at: datetime | None = None,
+    key_id: str | None = None,
 ) -> ProviderTokenMetadata:
     """
     Store encrypted provider token in database.

{fin_infra-0.1.83.dist-info → fin_infra-0.1.85.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: fin-infra
-Version: 0.1.83
+Version: 0.1.85
 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.83.dist-info → fin_infra-0.1.85.dist-info}/RECORD

@@ -2,39 +2,39 @@ fin_infra/__init__.py,sha256=7oL-CCsALNifBODAn9LriicaIrzgJkmVPvE-9duP0mw,1574
 fin_infra/__main__.py,sha256=1qNP7j0ffw0wFs1dBwDcJ9TNXlC6FcYuulzoV87pMi8,262
 fin_infra/analytics/__init__.py,sha256=zjAOFkI9xjg76ozZStYBXEPNwIsioj5fUBltja5JLyc,2327
 fin_infra/analytics/add.py,sha256=-iAqKdvf9t0gQjjo3uOO56qA_ei4omKYDOynxb4SZPI,12654
-fin_infra/analytics/cash_flow.py,sha256=lH-J6RIUzcV9Fuy56i12N6vuIdPaGz-rhWquSgjkldU,10300
+fin_infra/analytics/cash_flow.py,sha256=VSsQHwTi6r6VFoScH9nu9Fj8XHC4O4B9TkAI8Alobm4,10284
 fin_infra/analytics/ease.py,sha256=aTAPc-Lmh6XP7REPVlAom38MtKCqeS-auNW-rpXRZJs,14282
-fin_infra/analytics/models.py,sha256=cK6VKLZ763zXfn9REXOnLGx0v3Q8bUa-vH8aoNs2w-A,8215
+fin_infra/analytics/models.py,sha256=XFHeVZoPE0PcSFj59dNsdxISFVwdrTLU4sDCtExumrg,8193
 fin_infra/analytics/portfolio.py,sha256=d39sZGa3TQVX1xN2nplPHuxhsE-rahuiyzd612DeZ_Y,26417
 fin_infra/analytics/projections.py,sha256=T7LLG0Pe5f-WwgfDITdTMk-l8cCLZTM9cEC_Vxf6mkc,9154
 fin_infra/analytics/rebalancing.py,sha256=VM8MgoJofmrCXPK1rbmVqWGB4FauNmHCL5HOEbrZR2g,14610
 fin_infra/analytics/savings.py,sha256=n3rGNFP8TU5mW-uz9kOuqX_mDiVnDyAeDN06Q7Abotw,7570
 fin_infra/analytics/scenarios.py,sha256=LE_dZVkbxxAx5sxitGhiOhZfWTlYtVbIvS9pEXkijLc,12246
-fin_infra/analytics/spending.py,sha256=wCa8mhtdMTnI3eG9W28ljCgB_AQRVGxkrRA2ZwLi_RQ,26249
+fin_infra/analytics/spending.py,sha256=ogLcfF5ZOLMkBIj02RISnA3hiY_PsLWZ2_AAzA7FenY,26209
 fin_infra/banking/__init__.py,sha256=6wwGNITzyehC9MBQc5jy0ewSTuNetyQu2AdND51O55w,22450
 fin_infra/banking/history.py,sha256=BYvKLI_F198TBrtP7vMCCcBcszzFxZkmD-ClCezSVW8,10575
 fin_infra/banking/utils.py,sha256=HhxZbeaA8zqVttgMiJGnShTo_r_0DaD7T3IMq8n8340,15252
 fin_infra/brokerage/__init__.py,sha256=wJpgdOMWNxKt01eUIbu2oSmcFlL189nlWR0-PhLLVFc,17154
 fin_infra/budgets/__init__.py,sha256=GgfujfgdVld6_yUf8bhkW-bsIXBLb4THlJMocVpA4mM,3986
 fin_infra/budgets/add.py,sha256=i7Av--Z14sYQDJHETiF9VL71ouWBZcs3H3VZ62gqFEo,13508
-fin_infra/budgets/alerts.py,sha256=KlK3r2qPzMw4naFMHsFjqkwKDxdj_2b_y-ofD1nldkg,9714
-fin_infra/budgets/ease.py,sha256=vK5O8rvKzzJ1MUiwi7p9egayDFqyB23hPbbEhb1mhXE,8203
-fin_infra/budgets/models.py,sha256=qd6bcjl2cOtFqRtNe1Xso_05cQlGG-4qhBkiTQKchy0,14335
+fin_infra/budgets/alerts.py,sha256=XDSUPpRR1LNgSQU0Szlht0bLWI7RRBh1ElbcwGexbPs,9701
+fin_infra/budgets/ease.py,sha256=SB0hEuKw7avb32Ax1jY471hh7Y4Nhc4YtNOL7z1BOs0,8172
+fin_infra/budgets/models.py,sha256=q_6aqzC3fT-h5lJfTy2YjwBJgHAJha9e18KkuyxG2Dc,14304
 fin_infra/budgets/scaffold_templates/README.md,sha256=FBtRSrQSkg7Xp8SPiuSmzGR94I2zzjOckb0_vKtcksY,14084
 fin_infra/budgets/scaffold_templates/__init__.py,sha256=zQXi_vY4QS5a4Ddi2mVXMLM--rP021h5D94ohIC1dkU,172
 fin_infra/budgets/scaffold_templates/models.py.tmpl,sha256=rpKhXwnx1gQjV_GGVqs8CvkFNHctrYcagC9swE14pVU,7553
 fin_infra/budgets/scaffold_templates/repository.py.tmpl,sha256=khFgnQnVNnOo8DWYDmYz58MvdeSJpoS9QvTXcGhsa8g,10023
 fin_infra/budgets/scaffold_templates/schemas.py.tmpl,sha256=x5gSQ7Kiuq08tum5joKmeY0ib2r3ekLKk09dFOl0PS0,5658
-fin_infra/budgets/templates.py,sha256=Sbc7RcHXscq34g4t7J8OXM2Kfkt5DHuvqVnFU0Jiddc,12112
-fin_infra/budgets/tracker.py,sha256=gF68a6sivdSfVDZanSwdGdhEcg6SEic0K_rO9ed7lvI,16460
+fin_infra/budgets/templates.py,sha256=V1Hfh0P_6iMdaSLtnFm9iEvXDUyFb7yqBObat98hDjU,12093
+fin_infra/budgets/tracker.py,sha256=RDPfYhOLSAp-RFlTWFTpYaB5mysu3QfQhhcqJzmVWUU,16444
 fin_infra/cashflows/__init__.py,sha256=N9ZGKwIrQs-eiZZxqCow2aLBhW1MKcJoasQjGtyV6l4,8517
 fin_infra/cashflows/core.py,sha256=YWvF0DVOfBkvO_MuDODjE-V_g52H2ixFRH_TjMXExDE,541
 fin_infra/categorization/__init__.py,sha256=efLje12AW-ec9Vs5ynb41r4XCIWx5a-Z9WoGb3kQdIE,2030
 fin_infra/categorization/add.py,sha256=-I-V7R8vWj2-B8yjtFn_pNryQV5uascFR18a1Ltcqm0,6247
-fin_infra/categorization/ease.py,sha256=bomEtJAgwk9uiemNt1rk-IsTjJIhyJn0GJ_c58YEmJs,5836
+fin_infra/categorization/ease.py,sha256=gvlVb_TL7kwm5oM_gWdrhZt4cJOSvYEgGipNJKK8CpM,5820
 fin_infra/categorization/engine.py,sha256=u1ZYDmuB0gZeJHn-CKvvwd7Z1HFiB-S91YuV_ZrK_Rc,12117
 fin_infra/categorization/llm_layer.py,sha256=CSe6q-cKQgnKUKSItdDQwzMd8K1dsp-Mwua7SWZ9Ux0,12670
-fin_infra/categorization/models.py,sha256=-rGXR0RW2EU_FQ7ZfDWBIXxx8QGJDxeBF9zKGYyVgqY,5931
+fin_infra/categorization/models.py,sha256=A8m3hAIbsUUV3eNjXpTiPWD1sYGjSdXEByTS3ZZASEA,5894
 fin_infra/categorization/rules.py,sha256=IpDnHBeuykRdu5vs3Lph4Y9-3RseIjjleQ5hZphQvNk,12849
 fin_infra/categorization/taxonomy.py,sha256=p-tSOwJ0O-rFZ1LIlHSYdaYdSc65084j0fdMI_6LW84,13251
 fin_infra/chat/__init__.py,sha256=-gufQz-rOZVXkcTUcCcXdG2oGL8csJBxwSuOMN_5aVc,6324
@@ -61,7 +61,7 @@ fin_infra/documents/__init__.py,sha256=Ub1hbX3PTrBSsBdcbL8PFf6oq8jSH4pYxW45-qOYP
 fin_infra/documents/add.py,sha256=2RSf_i39-JUT6c_jVsEQwW3FfQSlH4H9Z0t_H0vz86U,8091
 fin_infra/documents/analysis.py,sha256=UWKTR_qXZoumItXUwHFMH3LAG2vFVlPITbIC8Y_r0s8,13970
 fin_infra/documents/ease.py,sha256=z8hLaYhO1znBbcA9F10uNVa1BnH4rm3Jm5pexQwyiJY,9574
-fin_infra/documents/models.py,sha256=RpazzhE9qBcTRk_NO7Dl_uvcHw9UpGtnpXFcJURMtYc,6865
+fin_infra/documents/models.py,sha256=VEkJynM2REAf37ZachIz7_MfTevpzmG4Cmpku388YwE,6831
 fin_infra/documents/ocr.py,sha256=8I0XhiEdDhew55jUxOB5whoO5OcSXD71xiv8HhnyYno,9565
 fin_infra/documents/storage.py,sha256=HXfubl-4PspvA-U8czB-4TgZKI1kOlw440jYHRDzjoY,10300
 fin_infra/exceptions.py,sha256=k7L3vfXcONM2-AqmqNhQvOHobVBrLPTYp44cMUxuP3o,16951
@@ -81,8 +81,8 @@ fin_infra/insights/aggregator.py,sha256=HtaJipSA-O_HVComBcyQdkGs6guoW81sYwRYHXGd
 fin_infra/insights/models.py,sha256=xov_YV8oBLJt3YdyVjbryRfcXqmGeGiPvZsZHSbvtl8,3202
 fin_infra/investments/__init__.py,sha256=DQJa32LdXspbtxydric-AfT3o5iDkqIByAsSriSfGak,6729
 fin_infra/investments/add.py,sha256=UV2_99z1p8cUiifVFJXOF0lGd0ucMgZ5s9N7IFyE_NY,17193
-fin_infra/investments/ease.py,sha256=d5ISfxpCius6JM2LZNReztW6-IizaqoxNU4aEbXWA74,9487
-fin_infra/investments/models.py,sha256=UyOvtU1-uxrgE0zLP5WY3wpn3YOdOv6_b05oGismxNU,18412
+fin_infra/investments/ease.py,sha256=s716nYv5kzkJ-vGbVeIumqAN0-TEl1ai-If84uP9h68,9474
+fin_infra/investments/models.py,sha256=Es1GdrB640k50gtdzTtfh_66nxvYxORq0xbtXryoRGo,18319
 fin_infra/investments/providers/__init__.py,sha256=V1eIzz6EnGJ-pq-9L3S2-evmcExF-YdZfd5P6JMyDtc,383
 fin_infra/investments/providers/base.py,sha256=1plM-o_fV6jQyyPnpZT5q8ir96oyxvh0zwA3qpiVIFY,9810
 fin_infra/investments/providers/plaid.py,sha256=X42cMpsHNcOPcYvl73jrP8x7nQ399n2_it3Ko9UIkI0,18751
@@ -94,14 +94,14 @@ fin_infra/investments/scaffold_templates/repository.py.tmpl,sha256=XwOEpQZfuXut1
 fin_infra/investments/scaffold_templates/schemas.py.tmpl,sha256=knWmn-Kyr7AdgPD4ZPMb6T49ZuPXeuOMqmjYNyA0CA0,5451
 fin_infra/markets/__init__.py,sha256=Ba9iUTfDkkla8GwPo3gULTJYUDQh5gSgGN15BxHINpo,9865
 fin_infra/models/__init__.py,sha256=y94RJ_1-bzgNUCxqE76X56WIOk3-El_Jueqy7uB0rb8,860
-fin_infra/models/accounts.py,sha256=ExQimE2O5dyugFMW7nCboWbWcaX3Nnl5Gg-B1XLSdIk,1138
+fin_infra/models/accounts.py,sha256=m_HdYHOe_m0GLnc_f5njo9n-zscWu-C0rJB6SAd5-aY,1098
 fin_infra/models/brokerage.py,sha256=TV5KMe78e-ttjcUbZIfdGo3x0NisAQ3puwv_ehtgSHc,8312
 fin_infra/models/candle.py,sha256=5JeqUvqlFfYE61uViBeLKZCh2wKdJZH7Pvi-TLzN4FI,536
 fin_infra/models/credit.py,sha256=rSdSURsMe9_i2gxmwPTDwNQWOuM2zutL-OhvHsnbtmw,12144
 fin_infra/models/money.py,sha256=63pdGD1WBMHicJ1w7pbU1g5fqt4gIzPuqQQ2-NSlBuc,401
 fin_infra/models/quotes.py,sha256=-YBzgnjjCihRAprUdaPRtfwKrgliDIGgqAnaM69VbDU,521
 fin_infra/models/tax.py,sha256=as40J9h24BB7LmeaIfay509UaYEctmk5CPW9CfcjWZc,15657
-fin_infra/models/transactions.py,sha256=8C4taS9ZGLeFYGqG7JGkLq5ZinvAjHPLrKyRu_Sy5_0,791
+fin_infra/models/transactions.py,sha256=gzc6hLKKU6VUWGshqw2WChU_x0qyXhdvOGwmj9H_H3I,790
 fin_infra/net_worth/__init__.py,sha256=4LzVM2Y0OkBlZoD5FUAbLwtORp1okYcsYc4zj0P8C7k,3452
 fin_infra/net_worth/add.py,sha256=QWfHIHJs2CV99WRBqjQ2OteiOrn5cR9nurmxTF9v5rg,23191
 fin_infra/net_worth/aggregator.py,sha256=9Kx2vUR71QwqYZdGaCfmYrJ1hNxzd1EEuAdWJoNjqTI,12780
@@ -116,12 +116,12 @@ fin_infra/net_worth/scaffold_templates/models.py.tmpl,sha256=9BKsoD08RZbSdOm0wFT
 fin_infra/net_worth/scaffold_templates/repository.py.tmpl,sha256=DSErnNxeAe4pWeefARRK3bU0hHltqdIFffENfVwdd7c,12798
 fin_infra/net_worth/scaffold_templates/schemas.py.tmpl,sha256=VkFsxyZx4DFDhXDhn-7KT0IgrXCvgaS5ZdWbjyezWj0,4709
 fin_infra/normalization/__init__.py,sha256=O-8YvPbKWgfdC6E2qzXuCFLJ6cM-CS8GmBO8TDcJ9X0,6246
-fin_infra/normalization/currency_converter.py,sha256=uuu8ASa5ppEniWLEVEpiDxXjZzln9nopWrhrATcD6Z4,7058
-fin_infra/normalization/models.py,sha256=gNC9chpbQPRN58V2j__VEPVNReO1N8jH_AHObwGPWu0,1928
+fin_infra/normalization/currency_converter.py,sha256=dhiSAYD7onQgCiT17TtGzL4czeX_qJ9_yW2zsvvBErg,7018
+fin_infra/normalization/models.py,sha256=h8zC2n642WwVWC1yvx_VCILDOgUwPDrZwjb0QIbA8cE,1873
 fin_infra/normalization/providers/__init__.py,sha256=LFU1tB2hVO42Yrkw-IDpPexD4mIlxob9lRrJEeGYqpE,559
 fin_infra/normalization/providers/exchangerate.py,sha256=I_2TK_LLOcYCy3HcN9Nut3UwqTWEOX26GktmX3cczvY,6340
 fin_infra/normalization/providers/static_mappings.py,sha256=m14VHmTZipbqrgyE0ABToabVx-pDcyB577LNWrACEUM,6809
-fin_infra/normalization/symbol_resolver.py,sha256=M7Li7LFiH4xpvxXcYQlJyk0iqgqpwaj6zQKsTzWZzas,8130
+fin_infra/normalization/symbol_resolver.py,sha256=UAfhxmiINpQhE8tPLh-GMCfDZGmK5wf2DwtYZP3sSUo,8093
 fin_infra/obs/__init__.py,sha256=kMMVl0fdwtJtZeKiusTuw0iO61Jo9-HNXsLmn3ffLRE,631
 fin_infra/obs/classifier.py,sha256=JasWCqSkYjllJNZ5Gwbrd53ZhLwhYNZ0i2nbTcklEog,5155
 fin_infra/providers/__init__.py,sha256=jxhQm79T6DVXf7Wpy7luL-p50cE_IMUbjt4o3apzJQU,768
@@ -158,13 +158,13 @@ fin_infra/scaffold/__init__.py,sha256=IfL_CHHMpQB1efqY37BlIu07356tLaeVI2Mv3C0qYD
 fin_infra/scaffold/budgets.py,sha256=qLnyPh-a-ZrslstaxRtR__Bpwlz0EncSdVnCM7fDBI4,9481
 fin_infra/scaffold/goals.py,sha256=C1mexWRbWV3aRdmiT65LpKMMWzhTWTX_upeCcsjTcWw,9684
 fin_infra/security/__init__.py,sha256=wM341EZioKtfTawpFCciaFh0FlpHHkoEoviW9pGYqpI,1363
-fin_infra/security/add.py,sha256=Y_XXNd-FTpSaHmO4xkYvkW4CLlFGCuQWe9gJ7WuwiLY,2746
-fin_infra/security/audit.py,sha256=TekYWCOUT9Sf1sDS2-EEREtW7nhWo3H7iaLVbLPx308,3322
+fin_infra/security/add.py,sha256=SIMBlSQ4FWCNiBfzgbzeVpRoo2JS3dqW-51uvq3hQU0,2715
+fin_infra/security/audit.py,sha256=nb4H2Jq7XwalHLOx6LqleUtSXkBRz6u65LJ7lyuQNDo,3276
 fin_infra/security/encryption.py,sha256=Cr_9xhBiUvYx1tDjCiLTzyY9NRTlqljWGgswqXT499Y,6139
 fin_infra/security/models.py,sha256=s8dsvpxP-7DThUZl3Fvr3S6KVAfL5r3TKcd4uj_hCTE,1689
 fin_infra/security/pii_filter.py,sha256=nVqzbG_-Z6m8fzzS1KBy9yFwaZ8eRrU00Q72fSkVyU8,8307
 fin_infra/security/pii_patterns.py,sha256=SM-o7cL6NdgkOmtBedsN2nJZ5QPbeYehZdYmAujk8Y8,3070
-fin_infra/security/token_store.py,sha256=qgxhBKwhtVpchyHv30mM-cttuGZlzZvZLC4Oa-gTTeg,6075
+fin_infra/security/token_store.py,sha256=FsfoAkIMQ2NRfkBuyG1eH30nnfO3w_V5tDPAZwUj9Os,6041
 fin_infra/settings.py,sha256=11JgIhjGwWnwixV-hveEWpoWd_JC0ixLnOQoLWCiwNo,1387
 fin_infra/tax/__init__.py,sha256=U0EUKQwbDqnAYwU8WRx6AD07TaB-ELdKGISOQ-904lw,6103
 fin_infra/tax/add.py,sha256=dYigcgQFEP38NLoNuhh7vpSoy07sWX6Z_DTp1tWFJXw,14553
@@ -173,8 +173,8 @@ fin_infra/utils/__init__.py,sha256=gKacLSWMAis--pasd8AuVN7ap0e9Z1TjRGur0J23EDo,6
 fin_infra/utils/http.py,sha256=rDEgYsEBrEe75ml5RA-iSs3xeU5W-3j-czJlT7WbrM4,632
 fin_infra/utils/retry.py,sha256=YiyTgy26eJ1ah7fE2_-ZPa4hv4bIT4OzjYolkNWb5j0,1057
 fin_infra/version.py,sha256=4t_crzhrLum--oyowUMxtjBTzUtWp7oRTF22ewEvJG4,49
-fin_infra-0.1.83.dist-info/LICENSE,sha256=wK-Ya7Ylxa38dSIZRhvNj1ZVLIrHC-BAI8v38PNADiA,1061
-fin_infra-0.1.83.dist-info/METADATA,sha256=X4R2GNABxoN7u8D1d90fXL8XWlJwnyFUaprYaAW6s9o,10479
-fin_infra-0.1.83.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-fin_infra-0.1.83.dist-info/entry_points.txt,sha256=Sr1uikvALZMeKm-DIkeKG4L9c4SNqysXGO_IRF8_9eU,53
-fin_infra-0.1.83.dist-info/RECORD,,
+fin_infra-0.1.85.dist-info/LICENSE,sha256=wK-Ya7Ylxa38dSIZRhvNj1ZVLIrHC-BAI8v38PNADiA,1061
+fin_infra-0.1.85.dist-info/METADATA,sha256=y13UC--sOtnmoLfYI4s1Z_THKBcpLzH3JaYaXOH41y8,10479
+fin_infra-0.1.85.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+fin_infra-0.1.85.dist-info/entry_points.txt,sha256=Sr1uikvALZMeKm-DIkeKG4L9c4SNqysXGO_IRF8_9eU,53
+fin_infra-0.1.85.dist-info/RECORD,,