Files
devplacepy/devplacepy/routers/dbapi/_shared.py
T
retoor d31ccba6c1 feat: add admin/internal database API with CRUD, read-only query, and natural-language SQL endpoints
Add a new `/dbapi` router package providing a generic database API over `dataset`, restricted to admin sessions, admin API keys, and the internal gateway key. Includes:

- `tables.py`: list all tables and inspect table schemas
- `crud.py`: full CRUD operations (GET, POST, PATCH, DELETE) with soft-delete awareness, born-live inserts, `?include_deleted`, `.../restore`, and `?hard=true` purge
- `query.py`: validated read-only SELECT execution via sqlglot parsing, classification, and EXPLAIN dry-run; async query jobs with WebSocket streaming via `DbApiJobService`
- `nl.py`: natural-language-to-SQL conversion using the platform AI gateway with re-prompting until validation passes

Also register `DbApiJobService` and `PubSubService` in the service manager, add `DBAPI_DIR` to config data paths, and force cleartext `http://` connections to HTTP/1.1 in `curl_transport` to fix large request failures against uvicorn's HTTP/1.1-only internal gateway.
2026-06-14 23:00:30 +00:00

80 lines
2.5 KiB
Python

# retoor <retoor@molodetz.nl>
from __future__ import annotations
from fastapi import HTTPException, Request
from fastapi.responses import JSONResponse
from devplacepy.services.dbapi import policy
from devplacepy.services.dbapi.policy import Caller, DbApiBadTable, DbApiDenied
OPERATORS = {"gte": ">=", "lte": "<=", "gt": ">", "lt": "<"}
RESERVED = {"limit", "before", "search", "include_deleted", "key", "hard", "execute"}
def require_dbapi_caller(request: Request) -> Caller:
try:
return policy.require_caller(request)
except DbApiDenied as exc:
from devplacepy.services.audit import record as audit
audit.record(
request,
"database.access.denied",
result="denied",
summary=f"denied database API access to {request.url.path}",
)
raise HTTPException(status_code=403, detail=str(exc))
def assert_table(name: str):
try:
return policy.assert_table(name)
except DbApiBadTable as exc:
raise HTTPException(status_code=404, detail=str(exc))
def error(status: int, message: str, **extra) -> JSONResponse:
return JSONResponse(
{"error": {"status": status, "message": message, **extra}}, status_code=status
)
async def read_body(request: Request) -> dict:
content_type = request.headers.get("content-type", "")
if content_type.startswith("application/json"):
try:
data = await request.json()
except Exception:
return {}
return data if isinstance(data, dict) else {}
form = await request.form()
return {key: value for key, value in form.items()}
def row_payload(body: dict) -> dict:
if "values_json" in body:
import json
try:
parsed = json.loads(body["values_json"])
except Exception:
return {}
return parsed if isinstance(parsed, dict) else {}
return {key: value for key, value in body.items() if key not in ("confirm", "values_json")}
def parse_filters(request: Request) -> tuple[dict, dict]:
filters: dict = {}
comparisons: dict = {}
for key, value in request.query_params.multi_items():
if key in RESERVED:
continue
if "." in key:
prefix, column = key.split(".", 1)
if prefix in ("filter", "eq"):
filters[column] = value
elif prefix in OPERATORS:
comparisons[column] = {OPERATORS[prefix]: value}
return filters, comparisons