""" Medications API - medication scheduling, logging, and adherence tracking """ import os import uuid from datetime import datetime, date, timedelta import flask import jwt from psycopg2.extras import Json import core.auth as auth import core.postgres as postgres def _get_user_uuid(token): try: payload = jwt.decode(token, os.getenv("JWT_SECRET"), algorithms=["HS256"]) return payload.get("sub") except (jwt.ExpiredSignatureError, jwt.InvalidTokenError): return None def _auth(request): """Extract and verify token. Returns user_uuid or None.""" header = request.headers.get("Authorization", "") if not header.startswith("Bearer "): return None token = header[7:] user_uuid = _get_user_uuid(token) if not user_uuid or not auth.verifyLoginToken(token, userUUID=user_uuid): return None return user_uuid _JSON_COLS = {"times", "days_of_week"} def _wrap_json(data): """Wrap list/dict values in Json() for psycopg2 when targeting JSON columns.""" return {k: Json(v) if k in _JSON_COLS and isinstance(v, (list, dict)) else v for k, v in data.items()} def _is_med_due_today(med, today, current_day): """Check if a medication is scheduled for today based on its frequency.""" freq = med.get("frequency", "daily") if freq in ("daily", "twice_daily"): return True if freq == "as_needed": return True # always show PRN, but with no scheduled times if freq == "specific_days": days = med.get("days_of_week", []) return current_day in days if freq == "every_n_days": start = med.get("start_date") interval = med.get("interval_days") if start and interval: start_d = start if isinstance(start, date) else datetime.strptime(str(start), "%Y-%m-%d").date() days_since = (today - start_d).days return days_since >= 0 and days_since % interval == 0 return False return True def _compute_next_dose_date(med): """Compute the next dose date for every_n_days medications.""" interval = med.get("interval_days") if not interval: return None return (date.today() + timedelta(days=interval)).isoformat() def _count_expected_doses(med, period_start, days): """Count expected doses in a period based on frequency and schedule.""" freq = med.get("frequency", "daily") times_per_day = len(med.get("times", [])) or 1 if freq == "as_needed": return 0 # PRN has no expected doses if freq in ("daily", "twice_daily"): return days * times_per_day if freq == "specific_days": dow = med.get("days_of_week", []) count = 0 for d in range(days): check_date = period_start + timedelta(days=d) if check_date.strftime("%a").lower() in dow: count += times_per_day return count if freq == "every_n_days": interval = med.get("interval_days", 1) start = med.get("start_date") if not start: return 0 start_d = start if isinstance(start, date) else datetime.strptime(str(start), "%Y-%m-%d").date() count = 0 for d in range(days): check_date = period_start + timedelta(days=d) diff = (check_date - start_d).days if diff >= 0 and diff % interval == 0: count += times_per_day return count return days * times_per_day def _count_logs_in_period(logs, period_start_str, action): """Count logs of a given action where created_at >= period_start.""" return sum( 1 for log in logs if log.get("action") == action and str(log.get("created_at", ""))[:10] >= period_start_str ) def register(app): # ── Medications CRUD ────────────────────────────────────────── @app.route("/api/medications", methods=["GET"]) def api_listMedications(): """List all medications for the logged-in user.""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 meds = postgres.select("medications", where={"user_uuid": user_uuid}, order_by="name") return flask.jsonify(meds), 200 @app.route("/api/medications", methods=["POST"]) def api_addMedication(): """Add a medication. Body: {name, dosage, unit, frequency, times?, days_of_week?, interval_days?, start_date?, notes?}""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 data = flask.request.get_json() if not data: return flask.jsonify({"error": "missing body"}), 400 required = ["name", "dosage", "unit", "frequency"] missing = [f for f in required if not data.get(f)] if missing: return flask.jsonify({"error": f"missing required fields: {', '.join(missing)}"}), 400 row = { "id": str(uuid.uuid4()), "user_uuid": user_uuid, "name": data["name"], "dosage": data["dosage"], "unit": data["unit"], "frequency": data["frequency"], "times": data.get("times", []), "days_of_week": data.get("days_of_week", []), "interval_days": data.get("interval_days"), "start_date": data.get("start_date"), "notes": data.get("notes"), "active": True, } # Compute next_dose_date for interval meds if data.get("frequency") == "every_n_days" and data.get("start_date") and data.get("interval_days"): start = datetime.strptime(data["start_date"], "%Y-%m-%d").date() today = date.today() if start > today: row["next_dose_date"] = data["start_date"] else: days_since = (today - start).days remainder = days_since % data["interval_days"] if remainder == 0: row["next_dose_date"] = today.isoformat() else: row["next_dose_date"] = (today + timedelta(days=data["interval_days"] - remainder)).isoformat() med = postgres.insert("medications", _wrap_json(row)) return flask.jsonify(med), 201 @app.route("/api/medications/", methods=["GET"]) def api_getMedication(med_id): """Get a single medication with its schedule.""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 med = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not med: return flask.jsonify({"error": "not found"}), 404 return flask.jsonify(med), 200 @app.route("/api/medications/", methods=["PUT"]) def api_updateMedication(med_id): """Update medication details.""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 data = flask.request.get_json() if not data: return flask.jsonify({"error": "missing body"}), 400 existing = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not existing: return flask.jsonify({"error": "not found"}), 404 allowed = [ "name", "dosage", "unit", "frequency", "times", "notes", "active", "days_of_week", "interval_days", "start_date", "next_dose_date", ] updates = {k: v for k, v in data.items() if k in allowed} if not updates: return flask.jsonify({"error": "no valid fields to update"}), 400 result = postgres.update("medications", _wrap_json(updates), {"id": med_id, "user_uuid": user_uuid}) return flask.jsonify(result[0] if result else {}), 200 @app.route("/api/medications/", methods=["DELETE"]) def api_deleteMedication(med_id): """Delete a medication and its logs.""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 existing = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not existing: return flask.jsonify({"error": "not found"}), 404 postgres.delete("med_logs", {"medication_id": med_id}) postgres.delete("medications", {"id": med_id, "user_uuid": user_uuid}) return flask.jsonify({"deleted": True}), 200 # ── Medication Logging (take / skip / snooze) ───────────────── @app.route("/api/medications//take", methods=["POST"]) def api_takeMedication(med_id): """Log that a dose was taken. Body: {scheduled_time?, notes?}""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 med = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not med: return flask.jsonify({"error": "not found"}), 404 data = flask.request.get_json() or {} log_entry = { "id": str(uuid.uuid4()), "medication_id": med_id, "user_uuid": user_uuid, "action": "taken", "scheduled_time": data.get("scheduled_time"), "notes": data.get("notes"), } log = postgres.insert("med_logs", log_entry) # Advance next_dose_date for interval meds if med.get("frequency") == "every_n_days" and med.get("interval_days"): next_date = _compute_next_dose_date(med) if next_date: postgres.update("medications", {"next_dose_date": next_date}, {"id": med_id}) return flask.jsonify(log), 201 @app.route("/api/medications//skip", methods=["POST"]) def api_skipMedication(med_id): """Log a skipped dose. Body: {scheduled_time?, reason?}""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 med = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not med: return flask.jsonify({"error": "not found"}), 404 data = flask.request.get_json() or {} log_entry = { "id": str(uuid.uuid4()), "medication_id": med_id, "user_uuid": user_uuid, "action": "skipped", "scheduled_time": data.get("scheduled_time"), "notes": data.get("reason"), } log = postgres.insert("med_logs", log_entry) # Advance next_dose_date for interval meds if med.get("frequency") == "every_n_days" and med.get("interval_days"): next_date = _compute_next_dose_date(med) if next_date: postgres.update("medications", {"next_dose_date": next_date}, {"id": med_id}) return flask.jsonify(log), 201 @app.route("/api/medications//snooze", methods=["POST"]) def api_snoozeMedication(med_id): """Snooze a reminder. Body: {minutes: 15}""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 med = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not med: return flask.jsonify({"error": "not found"}), 404 data = flask.request.get_json() or {} minutes = data.get("minutes", 15) return flask.jsonify({"snoozed_until_minutes": minutes}), 200 # ── Medication Log / History ────────────────────────────────── @app.route("/api/medications//log", methods=["GET"]) def api_getMedLog(med_id): """Get dose log for a medication. Query: ?days=30""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 med = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not med: return flask.jsonify({"error": "not found"}), 404 days = flask.request.args.get("days", 30, type=int) logs = postgres.select( "med_logs", where={"medication_id": med_id}, order_by="created_at DESC", limit=days * 10, ) return flask.jsonify(logs), 200 @app.route("/api/medications/today", methods=["GET"]) def api_todaysMeds(): """Get today's medication schedule with taken/pending status.""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 meds = postgres.select("medications", where={"user_uuid": user_uuid, "active": True}) now = datetime.now() today = date.today() today_str = today.isoformat() current_day = now.strftime("%a").lower() # "mon","tue", etc. result = [] for med in meds: if not _is_med_due_today(med, today, current_day): continue freq = med.get("frequency", "daily") is_prn = freq == "as_needed" # Get today's taken times by filtering on created_at date all_logs = postgres.select( "med_logs", where={"medication_id": med["id"], "action": "taken"}, ) today_taken = [ log.get("scheduled_time", "") for log in all_logs if str(log.get("created_at", ""))[:10] == today_str ] result.append({ "medication": med, "scheduled_times": [] if is_prn else med.get("times", []), "taken_times": today_taken, "is_prn": is_prn, }) return flask.jsonify(result), 200 # ── Adherence Stats ─────────────────────────────────────────── @app.route("/api/medications/adherence", methods=["GET"]) def api_adherenceStats(): """Get adherence stats across all meds. Query: ?days=30""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 num_days = flask.request.args.get("days", 30, type=int) meds = postgres.select("medications", where={"user_uuid": user_uuid, "active": True}) today = date.today() period_start = today - timedelta(days=num_days) period_start_str = period_start.isoformat() result = [] for med in meds: freq = med.get("frequency", "daily") is_prn = freq == "as_needed" expected = _count_expected_doses(med, period_start, num_days) logs = postgres.select("med_logs", where={"medication_id": med["id"]}) taken = _count_logs_in_period(logs, period_start_str, "taken") skipped = _count_logs_in_period(logs, period_start_str, "skipped") if is_prn: adherence_pct = None elif expected > 0: adherence_pct = round(min(taken / expected * 100, 100), 1) else: adherence_pct = 0 result.append({ "medication_id": med["id"], "name": med["name"], "taken": taken, "skipped": skipped, "expected": expected, "adherence_percent": adherence_pct, "is_prn": is_prn, }) return flask.jsonify(result), 200 @app.route("/api/medications//adherence", methods=["GET"]) def api_medAdherence(med_id): """Get adherence stats for a single medication. Query: ?days=30""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 med = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not med: return flask.jsonify({"error": "not found"}), 404 num_days = flask.request.args.get("days", 30, type=int) today = date.today() period_start = today - timedelta(days=num_days) period_start_str = period_start.isoformat() freq = med.get("frequency", "daily") is_prn = freq == "as_needed" expected = _count_expected_doses(med, period_start, num_days) logs = postgres.select("med_logs", where={"medication_id": med_id}) taken = _count_logs_in_period(logs, period_start_str, "taken") skipped = _count_logs_in_period(logs, period_start_str, "skipped") if is_prn: adherence_pct = None elif expected > 0: adherence_pct = round(min(taken / expected * 100, 100), 1) else: adherence_pct = 0 return flask.jsonify({ "medication_id": med_id, "name": med["name"], "taken": taken, "skipped": skipped, "expected": expected, "adherence_percent": adherence_pct, "is_prn": is_prn, }), 200 # ── Refills ─────────────────────────────────────────────────── @app.route("/api/medications//refill", methods=["PUT"]) def api_setRefill(med_id): """Set refill info. Body: {quantity_remaining, refill_date?, pharmacy_notes?}""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 med = postgres.select_one("medications", {"id": med_id, "user_uuid": user_uuid}) if not med: return flask.jsonify({"error": "not found"}), 404 data = flask.request.get_json() if not data: return flask.jsonify({"error": "missing body"}), 400 allowed = ["quantity_remaining", "refill_date", "pharmacy_notes"] updates = {k: v for k, v in data.items() if k in allowed} if not updates: return flask.jsonify({"error": "no valid fields to update"}), 400 result = postgres.update("medications", updates, {"id": med_id, "user_uuid": user_uuid}) return flask.jsonify(result[0] if result else {}), 200 @app.route("/api/medications/refills-due", methods=["GET"]) def api_refillsDue(): """Get medications that need refills soon. Query: ?days_ahead=7""" user_uuid = _auth(flask.request) if not user_uuid: return flask.jsonify({"error": "unauthorized"}), 401 days_ahead = flask.request.args.get("days_ahead", 7, type=int) cutoff = (datetime.now() + timedelta(days=days_ahead)).strftime("%Y-%m-%d") meds = postgres.select( "medications", where={"user_uuid": user_uuid}, ) due = [] for med in meds: qty = med.get("quantity_remaining") refill_date = med.get("refill_date") if qty is not None and qty <= 7: due.append(med) elif refill_date and str(refill_date) <= cutoff: due.append(med) return flask.jsonify(due), 200