Deprecation & Sunset Policy

curl -s -X POST "$BASE/api/v1/advisors/register" \
  -H "Content-Type: application/json" \
  -d '{"did":"...","public_key_b64url":"...","roles":["editor"]}'

curl -s -X POST "$BASE/api/v1/advisors/self-register" \
  -H "Content-Type: application/json" \
  -d '{"did":"...","public_key_b64url":"...","roles":["editor"]}'

BASE=https://phosra-api-sandbox-production.up.railway.app
for path in /api/v1/platforms /.well-known/ocss/trust-list; do
  hdr=$(curl -s -D - -o /dev/null "$BASE$path" \
    | tr -d '\r' | grep -iE '^(deprecation|sunset):')
  if [ -n "$hdr" ]; then
    echo "DEPRECATION NOTICE on $path:"; echo "$hdr"
  fi
done
echo "checked — no sunset windows open"

const BASE = "https://phosra-api-sandbox-production.up.railway.app";

async function checkSunset(path: string): Promise<void> {
  const res = await fetch(`${BASE}${path}`);
  const deprecation = res.headers.get("deprecation"); // @<unix-seconds> or null
  const sunset = res.headers.get("sunset");           // HTTP-date or null
  if (sunset) {
    const stopsAt = new Date(sunset);
    const daysLeft = Math.round((+stopsAt - Date.now()) / 86_400_000);
    throw new Error(`${path} is sunset on ${stopsAt.toISOString()} (${daysLeft}d left) — migrate`);
  }
  if (deprecation) console.warn(`${path} is deprecated (since ${deprecation}) — plan migration`);
}

for (const p of ["/api/v1/platforms", "/.well-known/ocss/trust-list"]) {
  await checkSunset(p); // resolves quietly today; throws the day a sunset lands
}

import requests
from datetime import datetime, timezone
from email.utils import parsedate_to_datetime

BASE = "https://phosra-api-sandbox-production.up.railway.app"

def check_sunset(path: str) -> None:
    r = requests.get(f"{BASE}{path}")
    if sunset := r.headers.get("Sunset"):          # HTTP-date
        stops_at = parsedate_to_datetime(sunset)
        days_left = (stops_at - datetime.now(timezone.utc)).days
        raise SystemExit(f"{path} sunset {stops_at.isoformat()} ({days_left}d left) — migrate")
    if dep := r.headers.get("Deprecation"):        # @<unix-seconds>
        print(f"{path} deprecated (since {dep}) — plan migration")

for p in ("/api/v1/platforms", "/.well-known/ocss/trust-list"):
    check_sunset(p)  # silent today; raises the day a sunset lands