FaceMarkPro2 / backend /app /utils /api_contract.py
Hkoradiya123
chore: clean history and exclude binaries for hf
9e7b45f
Raw History Blame Contribute Delete
2.42 kB
from functools import wraps
from flask import jsonify, request, session
def wants_json_response():
"""Return True when the caller expects JSON instead of HTML."""
if request.path.startswith('/api/'):
return True
accept = (request.headers.get('Accept') or '').lower()
if 'application/json' in accept:
return True
xrw = (request.headers.get('X-Requested-With') or '').lower()
return xrw == 'xmlhttprequest'
def json_ok(data=None, message=None, status=200):
payload = {'success': True}
if message:
payload['message'] = message
if data is not None:
payload['data'] = data
return jsonify(payload), status
def json_error(message, status=400, errors=None):
payload = {
'success': False,
'message': message,
'errors': errors or [message],
}
return jsonify(payload), status
def build_auth_response(user, role, redirect_path):
return {
'success': True,
'user': user,
'role': role,
'redirectPath': redirect_path,
'errors': [],
}
def current_session_user():
if session.get('student_roll_no'):
return {
'authenticated': True,
'role': 'student',
'user': {
'roll_no': session.get('student_roll_no'),
'name': session.get('student_name', 'Student'),
},
}
if session.get('faculty_email'):
return {
'authenticated': True,
'role': session.get('role', 'teacher'),
'user': {
'email': session.get('faculty_email'),
'name': session.get('faculty_name', 'Faculty'),
},
}
return {
'authenticated': False,
'role': None,
'user': None,
}
def require_session_role(roles=None):
"""API middleware to require an authenticated session and optional role list."""
roles = set(roles or [])
def decorator(fn):
@wraps(fn)
def wrapper(*args, **kwargs):
session_user = current_session_user()
if not session_user['authenticated']:
return json_error('Unauthenticated', status=401)
if roles and session_user['role'] not in roles:
return json_error('Forbidden', status=403)
return fn(*args, **kwargs)
return wrapper
return decorator