svc-infra 0.1.595__py3-none-any.whl → 0.1.706__py3-none-any.whl

svc_infra/__init__.py

@@ -1,3 +1,59 @@
-from . import api, app
+"""svc-infra: Service Infrastructure Toolkit.
 
-__all__ = ["app", "api"]
+A comprehensive backend infrastructure library providing:
+- API framework (FastAPI scaffolding, dual routers, auth)
+- Database (SQL/Mongo, migrations, repositories)
+- Caching (Redis, decorators)
+- Jobs (background tasks, queues)
+- Webhooks (delivery, subscriptions)
+- Billing (Stripe/Adyen integration)
+- Observability (logging, metrics)
+
+Example:
+    from svc_infra.api.fastapi import easy_service_app
+    from svc_infra.api.fastapi.auth import add_auth_users
+
+    app = easy_service_app(name="MyAPI")
+    add_auth_users(app)
+"""
+
+from __future__ import annotations
+
+# Core modules (lazy import pattern for optional dependencies)
+from . import api, app, cache, db, jobs, webhooks
+
+# Base exception
+from .exceptions import SvcInfraError
+
+# Content Loaders
+from .loaders import (
+    BaseLoader,
+    GitHubLoader,
+    LoadedContent,
+    URLLoader,
+    load_github,
+    load_github_sync,
+    load_url,
+    load_url_sync,
+)
+
+__all__ = [
+    # Core modules
+    "api",
+    "app",
+    "cache",
+    "db",
+    "jobs",
+    "webhooks",
+    # Base exception
+    "SvcInfraError",
+    # Loaders
+    "BaseLoader",
+    "GitHubLoader",
+    "LoadedContent",
+    "URLLoader",
+    "load_github",
+    "load_github_sync",
+    "load_url",
+    "load_url_sync",
+]

svc_infra/apf_payments/models.py

@@ -3,7 +3,16 @@ from __future__ import annotations
 from datetime import datetime
 from typing import Optional
 
-from sqlalchemy import JSON, Boolean, DateTime, Index, Numeric, String, UniqueConstraint, text
+from sqlalchemy import (
+    JSON,
+    Boolean,
+    DateTime,
+    Index,
+    Numeric,
+    String,
+    UniqueConstraint,
+    text,
+)
 from sqlalchemy.orm import Mapped, mapped_column
 
 from svc_infra.db.sql.authref import user_fk_constraint, user_id_type
@@ -18,10 +27,14 @@ class PayCustomer(ModelBase):
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
     # Tenant scoping
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
     # Always typed to match the actual auth PK; FK is enforced at table level
-    user_id: Mapped[Optional[str]] = mapped_column(user_id_type(), index=True, nullable=True)
+    user_id: Mapped[Optional[str]] = mapped_column(
+        user_id_type(), index=True, nullable=True
+    )
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_customer_id: Mapped[str] = mapped_column(
@@ -29,7 +42,9 @@ class PayCustomer(ModelBase):
     )
 
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
     __table_args__ = (
@@ -44,9 +59,13 @@ class PayIntent(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
-    user_id: Mapped[Optional[str]] = mapped_column(user_id_type(), index=True, nullable=True)
+    user_id: Mapped[Optional[str]] = mapped_column(
+        user_id_type(), index=True, nullable=True
+    )
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_intent_id: Mapped[str] = mapped_column(
@@ -57,7 +76,9 @@ class PayIntent(ModelBase):
     status: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     client_secret: Mapped[Optional[str]] = mapped_column(String(255))
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
     confirmed_at: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True))
     captured: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
@@ -74,7 +95,9 @@ class PayEvent(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_event_id: Mapped[str] = mapped_column(
@@ -82,9 +105,13 @@ class PayEvent(ModelBase):
     )
     type: Mapped[str] = mapped_column(String(64), index=True, nullable=False)
     received_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
-    payload_json: Mapped[dict] = mapped_column(JSON, nullable=False)  # compact JSON string
+    payload_json: Mapped[dict] = mapped_column(
+        JSON, nullable=False
+    )  # compact JSON string
 
 
 class LedgerEntry(ModelBase):
@@ -92,7 +119,9 @@ class LedgerEntry(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
     ts: Mapped[datetime] = mapped_column(
         DateTime(timezone=True),
@@ -103,11 +132,17 @@ class LedgerEntry(ModelBase):
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_ref: Mapped[Optional[str]] = mapped_column(String(128), index=True)
-    user_id: Mapped[Optional[str]] = mapped_column(user_id_type(), index=True, nullable=True)
+    user_id: Mapped[Optional[str]] = mapped_column(
+        user_id_type(), index=True, nullable=True
+    )
     amount: Mapped[int] = mapped_column(Numeric(18, 0), nullable=False)
     currency: Mapped[str] = mapped_column(String(8), nullable=False)
-    kind: Mapped[str] = mapped_column(String(24), nullable=False)  # payment|refund|fee|payout...
-    status: Mapped[str] = mapped_column(String(24), nullable=False)  # pending|posted|void
+    kind: Mapped[str] = mapped_column(
+        String(24), nullable=False
+    )  # payment|refund|fee|payout...
+    status: Mapped[str] = mapped_column(
+        String(24), nullable=False
+    )  # pending|posted|void
 
     __table_args__ = (
         user_fk_constraint("user_id", ondelete="SET NULL"),
@@ -128,11 +163,17 @@ class PayPaymentMethod(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
-    user_id: Mapped[Optional[str]] = mapped_column(user_id_type(), index=True, nullable=True)
+    user_id: Mapped[Optional[str]] = mapped_column(
+        user_id_type(), index=True, nullable=True
+    )
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
-    provider_customer_id: Mapped[str] = mapped_column(String(128), index=True, nullable=False)
+    provider_customer_id: Mapped[str] = mapped_column(
+        String(128), index=True, nullable=False
+    )
     provider_method_id: Mapped[str] = mapped_column(
         String(128), unique=True, index=True, nullable=False
     )
@@ -142,7 +183,9 @@ class PayPaymentMethod(ModelBase):
     exp_year: Mapped[Optional[int]] = mapped_column(Numeric(4, 0))
     is_default: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
     __table_args__ = (
@@ -161,7 +204,9 @@ class PayProduct(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_product_id: Mapped[str] = mapped_column(
@@ -170,7 +215,9 @@ class PayProduct(ModelBase):
     name: Mapped[str] = mapped_column(String(128), nullable=False)
     active: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
 
@@ -179,20 +226,28 @@ class PayPrice(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_price_id: Mapped[str] = mapped_column(
         String(128), unique=True, index=True, nullable=False
     )
-    provider_product_id: Mapped[str] = mapped_column(String(128), index=True, nullable=False)
+    provider_product_id: Mapped[str] = mapped_column(
+        String(128), index=True, nullable=False
+    )
     currency: Mapped[str] = mapped_column(String(8), nullable=False)
-    unit_amount: Mapped[int] = mapped_column(Numeric(18, 0), nullable=False)  # minor units
+    unit_amount: Mapped[int] = mapped_column(
+        Numeric(18, 0), nullable=False
+    )  # minor units
     interval: Mapped[Optional[str]] = mapped_column(String(16))  # month|year|week|day
     trial_days: Mapped[Optional[int]] = mapped_column(Numeric(5, 0))
     active: Mapped[bool] = mapped_column(Boolean, default=True, nullable=False)
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
 
@@ -201,23 +256,37 @@ class PaySubscription(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
-    user_id: Mapped[Optional[str]] = mapped_column(user_id_type(), index=True, nullable=True)
+    user_id: Mapped[Optional[str]] = mapped_column(
+        user_id_type(), index=True, nullable=True
+    )
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
-    provider_customer_id: Mapped[str] = mapped_column(String(128), index=True, nullable=False)
+    provider_customer_id: Mapped[str] = mapped_column(
+        String(128), index=True, nullable=False
+    )
     provider_subscription_id: Mapped[str] = mapped_column(
         String(128), unique=True, index=True, nullable=False
     )
-    provider_price_id: Mapped[str] = mapped_column(String(128), index=True, nullable=False)
+    provider_price_id: Mapped[str] = mapped_column(
+        String(128), index=True, nullable=False
+    )
     status: Mapped[str] = mapped_column(
         String(32), index=True, nullable=False
     )  # active|trialing|canceled|past_due|incomplete
     quantity: Mapped[int] = mapped_column(Numeric(10, 0), default=1, nullable=False)
-    cancel_at_period_end: Mapped[bool] = mapped_column(Boolean, default=False, nullable=False)
-    current_period_end: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True))
+    cancel_at_period_end: Mapped[bool] = mapped_column(
+        Boolean, default=False, nullable=False
+    )
+    current_period_end: Mapped[Optional[datetime]] = mapped_column(
+        DateTime(timezone=True)
+    )
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
     __table_args__ = (
@@ -236,14 +305,20 @@ class PayInvoice(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
-    user_id: Mapped[Optional[str]] = mapped_column(user_id_type(), index=True, nullable=True)
+    user_id: Mapped[Optional[str]] = mapped_column(
+        user_id_type(), index=True, nullable=True
+    )
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_invoice_id: Mapped[str] = mapped_column(
         String(128), unique=True, index=True, nullable=False
     )
-    provider_customer_id: Mapped[str] = mapped_column(String(128), index=True, nullable=False)
+    provider_customer_id: Mapped[str] = mapped_column(
+        String(128), index=True, nullable=False
+    )
     status: Mapped[str] = mapped_column(
         String(24), index=True, nullable=False
     )  # draft|open|paid|void|uncollectible
@@ -252,7 +327,9 @@ class PayInvoice(ModelBase):
     hosted_invoice_url: Mapped[Optional[str]] = mapped_column(String(255))
     pdf_url: Mapped[Optional[str]] = mapped_column(String(255))
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
     __table_args__ = (
@@ -271,9 +348,13 @@ class PaySetupIntent(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
-    user_id: Mapped[Optional[str]] = mapped_column(user_id_type(), index=True, nullable=True)
+    user_id: Mapped[Optional[str]] = mapped_column(
+        user_id_type(), index=True, nullable=True
+    )
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_setup_intent_id: Mapped[str] = mapped_column(
         String(128), unique=True, index=True, nullable=False
@@ -283,7 +364,9 @@ class PaySetupIntent(ModelBase):
     )  # requires_action|succeeded|canceled|processing
     client_secret: Mapped[Optional[str]] = mapped_column(String(255))
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
     __table_args__ = (
@@ -297,7 +380,9 @@ class PayDispute(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_dispute_id: Mapped[str] = mapped_column(
@@ -312,7 +397,9 @@ class PayDispute(ModelBase):
     )  # needs_response|under_review|won|lost|warning_closed
     evidence_due_by: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True))
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )
 
 
@@ -321,7 +408,9 @@ class PayPayout(ModelBase):
 
     id: Mapped[str] = mapped_column(String(64), primary_key=True)
 
-    tenant_id: Mapped[str] = mapped_column(String(TENANT_ID_LEN), index=True, nullable=False)
+    tenant_id: Mapped[str] = mapped_column(
+        String(TENANT_ID_LEN), index=True, nullable=False
+    )
 
     provider: Mapped[str] = mapped_column(String(32), index=True, nullable=False)
     provider_payout_id: Mapped[str] = mapped_column(
@@ -335,5 +424,7 @@ class PayPayout(ModelBase):
     arrival_date: Mapped[Optional[datetime]] = mapped_column(DateTime(timezone=True))
     type: Mapped[Optional[str]] = mapped_column(String(32))  # bank_account|card|...
     created_at: Mapped[datetime] = mapped_column(
-        DateTime(timezone=True), server_default=text("CURRENT_TIMESTAMP"), nullable=False
+        DateTime(timezone=True),
+        server_default=text("CURRENT_TIMESTAMP"),
+        nullable=False,
     )