"""CenterPay server relay. The browser never receives BuxUp credentials. This process maps a fixed set of public CenterPay operations onto BuxUp's purpose-limited intake API and serves the built React site. """ from __future__ import annotations import os from pathlib import Path import httpx from fastapi import FastAPI, Request, Response from fastapi.responses import FileResponse, JSONResponse from fastapi.staticfiles import StaticFiles DEFAULT_BASE_URL = os.getenv('BUXUP_BASE_URL', '').rstrip('/') DEFAULT_INTAKE_KEY = os.getenv('BUXUP_INTAKE_KEY', '') DEFAULT_AUTH_TOKEN = os.getenv('BUXUP_AUTH_TOKEN', '') DEFAULT_FRONTEND = Path(os.getenv('CENTERPAY_FRONTEND_DIR', '/app/frontend/dist')) TIMEOUT = httpx.Timeout(20.0, connect=10.0) def create_app(*, base_url: str | None = None, intake_key: str | None = None, auth_token: str | None = None, frontend_dir: str | Path | None = None, transport: httpx.AsyncBaseTransport | None = None) -> FastAPI: """Build the relay. Tests inject a temporary BuxUp ASGI transport.""" settings = { 'base_url': (base_url if base_url is not None else DEFAULT_BASE_URL).rstrip('/'), 'intake_key': intake_key if intake_key is not None else DEFAULT_INTAKE_KEY, 'auth_token': auth_token if auth_token is not None else DEFAULT_AUTH_TOKEN, 'frontend_dir': Path(frontend_dir if frontend_dir is not None else DEFAULT_FRONTEND), 'transport': transport, } app = FastAPI(title='CenterPay', docs_url=None, redoc_url=None) app.state.relay = settings def configured() -> bool: return bool(settings['base_url'] and settings['intake_key']) async def forward(request: Request, upstream_path: str) -> Response: if not configured(): return JSONResponse({'detail': 'CenterPay relay is not configured yet'}, status_code=503) body = None if request.method not in ('GET', 'HEAD'): try: body = await request.json() except Exception: body = None headers = {'X-Octopus-Intake-Key': settings['intake_key']} if settings['auth_token']: headers['Authorization'] = 'Bearer ' + settings['auth_token'] forwarded_key = request.headers.get('Idempotency-Key') or request.headers.get('X-Idempotency-Key') if forwarded_key: headers['Idempotency-Key'] = forwarded_key try: async with httpx.AsyncClient(timeout=TIMEOUT, trust_env=False, transport=settings['transport']) as client: upstream = await client.request(request.method, settings['base_url'] + upstream_path, json=body, headers=headers) except httpx.HTTPError: return JSONResponse({'detail': 'The BuxUp service is temporarily unavailable'}, status_code=502) content_type = upstream.headers.get('content-type', 'application/json') if 'application/json' not in content_type.lower(): return JSONResponse({'detail': 'The BuxUp service returned an unreadable response'}, status_code=502) return Response(content=upstream.content, status_code=upstream.status_code, media_type=content_type) @app.get('/api/health') def health(): return {'status': 'ok' if configured() else 'unconfigured', 'relay_configured': configured()} @app.get('/api/catalog') async def catalog(request: Request): return await forward(request, '/api/intake/catalog') @app.post('/api/enquiries') async def enquiries(request: Request): return await forward(request, '/api/intake/enquiries') @app.post('/api/return') async def returning(request: Request): return await forward(request, '/api/intake/return') @app.post('/api/verify') async def verify(request: Request): return await forward(request, '/api/intake/verify') @app.post('/api/providers') async def providers(request: Request): return await forward(request, '/api/intake/providers') @app.post('/api/enquiries/{ident}/resend') async def resend(ident: str, request: Request): return await forward(request, '/api/intake/enquiries/' + ident + '/resend') @app.post('/api/enquiries/{ident}/status') async def enquiry_status(ident: str, request: Request): return await forward(request, '/api/intake/enquiries/' + ident + '/status') @app.post('/api/enquiries/{ident}/help') async def help_request(ident: str, request: Request): return await forward(request, '/api/intake/enquiries/' + ident + '/help') assets = settings['frontend_dir'] / 'assets' if assets.exists(): app.mount('/assets', StaticFiles(directory=str(assets)), name='centerpay-assets') @app.get('/{path:path}') def frontend_page(path: str): if path.startswith('api/'): return JSONResponse({'detail': 'API endpoint not found'}, status_code=404) index = settings['frontend_dir'] / 'index.html' if not index.exists(): return JSONResponse({'status': 'CenterPay frontend build not present'}, status_code=503) return FileResponse(index) return app app = create_app()