sql-dialect-master 1.1.3__tar.gz → 1.1.5__tar.gz

{sql_dialect_master-1.1.3 → sql_dialect_master-1.1.5}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: sql-dialect-master
-Version: 1.1.3
+Version: 1.1.5
 Summary: SQL Dialect Master - Multi-database SQL conversion engine
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: sqlglot<31.0.0,>=30.18.0
-Requires-Dist: streamlit>=1.38.0
 Requires-Dist: fastapi>=0.115.0
 Requires-Dist: uvicorn>=0.30.0
 Requires-Dist: pydantic>=2.9.0
@@ -21,6 +20,10 @@ Provides-Extra: qa
 Requires-Dist: ruff>=0.6; extra == "qa"
 Requires-Dist: bandit>=1.7; extra == "qa"
 Requires-Dist: pip-audit>=2.7; extra == "qa"
+Requires-Dist: build>=1.2.2; extra == "qa"
+Requires-Dist: twine>=5.1; extra == "qa"
+Requires-Dist: setuptools>=75.0.0; extra == "qa"
+Requires-Dist: wheel>=0.45; extra == "qa"
 Provides-Extra: semantic
 Requires-Dist: duckdb>=1.5.5; extra == "semantic"
 Requires-Dist: psycopg[binary]>=3.3.5; extra == "semantic"
@@ -32,12 +35,12 @@ Dynamic: license-file
 
 Enterprise-grade multi-database SQL conversion engine supporting 12 database dialects.
 
-Current release: 1.1.3
+Current release: 1.1.5
 
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![FastAPI](https://img.shields.io/badge/FastAPI-0.115+-green.svg)](https://fastapi.tiangolo.com/)
-[![Streamlit](https://img.shields.io/badge/Streamlit-1.38+-red.svg)](https://streamlit.io/)
+[![React](https://img.shields.io/badge/React-19-61DAFB.svg)](https://react.dev/)
 
 ## ✨ Features
 
@@ -54,7 +57,7 @@ Current release: 1.1.3
 | 🔧 **Rule Engine** | Deterministic priority ordering, compiled patterns, dialect-aware conflict detection |
 | 🛡️ **Security Validation** | Statement-level stacked-query detection with configurable blocking policy |
 | ⚡ **Performance** | Rule-aware cache versioning, bounded async batch conversion, and reproducible benchmark |
-| 🎨 **Modern UI** | Streamlit developer workspace: dark / light theme system, sidebar navigation, command palette |
+| 🎨 **Modern UI** | React developer workspace with dark / light themes, responsive navigation, and command palette |
 
 ## 💾 Supported Databases
 
@@ -78,32 +81,38 @@ cd sql-dialect-master
 python -m pip install -e .
 ```
 
-For development and testing, install the optional development dependencies:
+For development, testing, quality checks, and local builds, use the project's
+Python environment and install the optional tooling:
 
 ```bash
-python -m pip install -e ".[dev]"
+python -m venv .venv
+.venv/bin/python -m pip install -e ".[dev,qa]"
 ```
 
 For database-backed semantic tests:
 
 ```bash
-python -m pip install -e ".[dev,semantic]"
+.venv/bin/python -m pip install -e ".[dev,semantic]"
 ```
 
-### Run Streamlit UI (Recommended)
+### Run the React UI
 
-```bash
-streamlit run sdm_local_v2.py
-```
-
-After installing the package, the same workspace can be launched from any
-working directory with:
+The React workspace is the product frontend and runs independently from the
+Python package. Start the API first, then run:
 
 ```bash
-sdm-streamlit
+cd frontend-react
+npm install
+npm run dev
 ```
 
-Open http://localhost:8501 in your browser.
+Open http://localhost:5174. The Vite development proxy forwards `/api`,
+`/health`, and `/ready` to `http://127.0.0.1:8000`. Set `VITE_API_BASE_URL`
+for a separately deployed API, or configure the URL and optional API key in
+the React Settings page.
+
+React implementation goals and gates are tracked in
+[`docs/react-frontend-refactor-plan.md`](docs/react-frontend-refactor-plan.md).
 
 ### Run FastAPI Backend
 
@@ -113,6 +122,16 @@ uvicorn backend.api.main:app --reload
 
 API docs available at http://localhost:8000/docs
 
+Set `SDM_API_KEY` in `.env` to require credentials for `/api/*` endpoints.
+Clients may send `X-API-Key` or `Authorization: Bearer <key>`. Health probes
+use the separate `SDM_HEALTH_PROBE_TOKEN` setting. An empty API key preserves
+local access.
+
+`SDM_API_WORKERS` (default 4) and `SDM_API_QUEUE_SIZE` (default 4) bound CPU
+work. When all slots are occupied, requests receive HTTP 503 and a
+`Retry-After` header. `SDM_REQUEST_TIMEOUT` returns HTTP 504 when a request
+times out; running threads retain their capacity until they finish.
+
 ## 📖 Usage Examples
 
 ### Python SDK
@@ -254,42 +273,16 @@ sql-dialect-master/
 │   │   └── validators.py        # Input validation
 │   │
 │   └── tests/                   # Test suite and regression coverage
-├── frontend/                    # Streamlit UI Components (v2 architecture)
-│   ├── core/                    # Cross-cutting concerns
-│   │   ├── design_tokens.py     # Theme model (dark/light) + semantic status
-│   │   ├── navigation.py        # NavigationIntent contract
-│   │   ├── state.py             # SessionState adapter
-│   │   ├── themes.py            # Theme switching (dark/light only)
-│   │   ├── styles.py            # CSS generation from design tokens
-│   │   ├── escaping.py          # HTML-safe rendering helpers
-│   │   └── viewmodels.py        # Typed view models
-│   ├── pages/                   # One module per workspace page
-│   │   ├── convert.py
-│   │   ├── nl2sql.py
-│   │   ├── diff.py
-│   │   ├── lineage.py
-│   │   ├── runtime.py
-│   │   ├── functions.py
-│   │   ├── types.py
-│   │   ├── templates.py
-│   │   ├── history.py
-│   │   ├── settings.py
-│   │   └── query_analysis.py
-│   ├── ui/                      # Reusable UI widgets
-│   │   ├── command_palette.py
-│   │   ├── diff.py
-│   │   ├── editor.py
-│   │   └── status.py
-│   ├── app_context_v2.py        # Shared application context (v2)
-│   └── templates_v2.py          # SQL templates (v2)
 ├── examples/
 │   ├── api_client.py             # API usage examples
 │   └── basic_usage.py            # SDK usage examples
 ├── scripts/
 │   └── verify_readme_consistency.py # README source-of-truth checks
-├── sdm_local_v2.py             # Streamlit Application Entry (v2)
+├── frontend-react/              # React + TypeScript product frontend
+│   ├── src/
+│   ├── package.json
+│   └── vite.config.ts
 ├── pyproject.toml               # Project configuration
-├── requirements.txt              # Legacy/runtime dependency list
 ├── .env.example                 # Environment template
 ├── LICENSE                      # MIT License
 └── README.md

{sql_dialect_master-1.1.3 → sql_dialect_master-1.1.5}/README.md

@@ -2,12 +2,12 @@
 
 Enterprise-grade multi-database SQL conversion engine supporting 12 database dialects.
 
-Current release: 1.1.3
+Current release: 1.1.5
 
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![FastAPI](https://img.shields.io/badge/FastAPI-0.115+-green.svg)](https://fastapi.tiangolo.com/)
-[![Streamlit](https://img.shields.io/badge/Streamlit-1.38+-red.svg)](https://streamlit.io/)
+[![React](https://img.shields.io/badge/React-19-61DAFB.svg)](https://react.dev/)
 
 ## ✨ Features
 
@@ -24,7 +24,7 @@ Current release: 1.1.3
 | 🔧 **Rule Engine** | Deterministic priority ordering, compiled patterns, dialect-aware conflict detection |
 | 🛡️ **Security Validation** | Statement-level stacked-query detection with configurable blocking policy |
 | ⚡ **Performance** | Rule-aware cache versioning, bounded async batch conversion, and reproducible benchmark |
-| 🎨 **Modern UI** | Streamlit developer workspace: dark / light theme system, sidebar navigation, command palette |
+| 🎨 **Modern UI** | React developer workspace with dark / light themes, responsive navigation, and command palette |
 
 ## 💾 Supported Databases
 
@@ -48,32 +48,38 @@ cd sql-dialect-master
 python -m pip install -e .
 ```
 
-For development and testing, install the optional development dependencies:
+For development, testing, quality checks, and local builds, use the project's
+Python environment and install the optional tooling:
 
 ```bash
-python -m pip install -e ".[dev]"
+python -m venv .venv
+.venv/bin/python -m pip install -e ".[dev,qa]"
 ```
 
 For database-backed semantic tests:
 
 ```bash
-python -m pip install -e ".[dev,semantic]"
+.venv/bin/python -m pip install -e ".[dev,semantic]"
 ```
 
-### Run Streamlit UI (Recommended)
+### Run the React UI
 
-```bash
-streamlit run sdm_local_v2.py
-```
-
-After installing the package, the same workspace can be launched from any
-working directory with:
+The React workspace is the product frontend and runs independently from the
+Python package. Start the API first, then run:
 
 ```bash
-sdm-streamlit
+cd frontend-react
+npm install
+npm run dev
 ```
 
-Open http://localhost:8501 in your browser.
+Open http://localhost:5174. The Vite development proxy forwards `/api`,
+`/health`, and `/ready` to `http://127.0.0.1:8000`. Set `VITE_API_BASE_URL`
+for a separately deployed API, or configure the URL and optional API key in
+the React Settings page.
+
+React implementation goals and gates are tracked in
+[`docs/react-frontend-refactor-plan.md`](docs/react-frontend-refactor-plan.md).
 
 ### Run FastAPI Backend
 
@@ -83,6 +89,16 @@ uvicorn backend.api.main:app --reload
 
 API docs available at http://localhost:8000/docs
 
+Set `SDM_API_KEY` in `.env` to require credentials for `/api/*` endpoints.
+Clients may send `X-API-Key` or `Authorization: Bearer <key>`. Health probes
+use the separate `SDM_HEALTH_PROBE_TOKEN` setting. An empty API key preserves
+local access.
+
+`SDM_API_WORKERS` (default 4) and `SDM_API_QUEUE_SIZE` (default 4) bound CPU
+work. When all slots are occupied, requests receive HTTP 503 and a
+`Retry-After` header. `SDM_REQUEST_TIMEOUT` returns HTTP 504 when a request
+times out; running threads retain their capacity until they finish.
+
 ## 📖 Usage Examples
 
 ### Python SDK
@@ -224,42 +240,16 @@ sql-dialect-master/
 │   │   └── validators.py        # Input validation
 │   │
 │   └── tests/                   # Test suite and regression coverage
-├── frontend/                    # Streamlit UI Components (v2 architecture)
-│   ├── core/                    # Cross-cutting concerns
-│   │   ├── design_tokens.py     # Theme model (dark/light) + semantic status
-│   │   ├── navigation.py        # NavigationIntent contract
-│   │   ├── state.py             # SessionState adapter
-│   │   ├── themes.py            # Theme switching (dark/light only)
-│   │   ├── styles.py            # CSS generation from design tokens
-│   │   ├── escaping.py          # HTML-safe rendering helpers
-│   │   └── viewmodels.py        # Typed view models
-│   ├── pages/                   # One module per workspace page
-│   │   ├── convert.py
-│   │   ├── nl2sql.py
-│   │   ├── diff.py
-│   │   ├── lineage.py
-│   │   ├── runtime.py
-│   │   ├── functions.py
-│   │   ├── types.py
-│   │   ├── templates.py
-│   │   ├── history.py
-│   │   ├── settings.py
-│   │   └── query_analysis.py
-│   ├── ui/                      # Reusable UI widgets
-│   │   ├── command_palette.py
-│   │   ├── diff.py
-│   │   ├── editor.py
-│   │   └── status.py
-│   ├── app_context_v2.py        # Shared application context (v2)
-│   └── templates_v2.py          # SQL templates (v2)
 ├── examples/
 │   ├── api_client.py             # API usage examples
 │   └── basic_usage.py            # SDK usage examples
 ├── scripts/
 │   └── verify_readme_consistency.py # README source-of-truth checks
-├── sdm_local_v2.py             # Streamlit Application Entry (v2)
+├── frontend-react/              # React + TypeScript product frontend
+│   ├── src/
+│   ├── package.json
+│   └── vite.config.ts
 ├── pyproject.toml               # Project configuration
-├── requirements.txt              # Legacy/runtime dependency list
 ├── .env.example                 # Environment template
 ├── LICENSE                      # MIT License
 └── README.md

sql_dialect_master-1.1.5/backend/api/auth.py

@@ -0,0 +1,29 @@
+"""Optional shared API-key protection for business endpoints."""
+from __future__ import annotations
+
+import secrets
+
+from fastapi import HTTPException, Request
+
+from backend.core.config import settings
+
+
+async def require_api_access(request: Request) -> None:
+    """Require a configured key for /api endpoints while keeping probes separate."""
+    key = settings.api_key
+    if key is None or not request.url.path.startswith("/api/"):
+        return
+    expected = key.get_secret_value()
+    if not expected:
+        return
+    supplied = request.headers.get("X-API-Key", "")
+    if not supplied:
+        scheme, _, credential = request.headers.get("Authorization", "").partition(" ")
+        if scheme.lower() == "bearer":
+            supplied = credential
+    if not supplied or not secrets.compare_digest(supplied.encode("utf-8"), expected.encode("utf-8")):
+        raise HTTPException(
+            status_code=401,
+            detail="Invalid or missing API key",
+            headers={"WWW-Authenticate": "Bearer"},
+        )