Configure and authenticate @praxa/sdk

const client = new PraxaClient({
  baseUrl: "https://gateway.example",
  accessToken: acquireDelegatedToken,
});

type CachedToken = { value: string; expiresAt: number };

let cached: CachedToken | undefined;
let refreshInFlight: Promise<CachedToken> | undefined;

async function acquireDelegatedToken(): Promise<string> {
  const refreshBeforeMs = 30_000;
  if (cached && cached.expiresAt - Date.now() > refreshBeforeMs) {
    return cached.value;
  }

  refreshInFlight ??= exchangeApplicationSessionForPraxaToken()
    .then((token) => (cached = token))
    .finally(() => {
      refreshInFlight = undefined;
    });

  return (await refreshInFlight).value;
}

const controller = new AbortController();
const timeout = setTimeout(() => controller.abort(), 30_000);

try {
  const mission = await client.getMission(runId, controller.signal);
  return mission;
} finally {
  clearTimeout(timeout);
}

const client = new PraxaClient({
  baseUrl,
  accessToken: acquireDelegatedToken,
  maximumAttempts: 3,
  retryBaseDelayMs: 200,
});

const observedFetch: typeof fetch = async (input, init) => {
  const started = performance.now();
  const url = new URL(input instanceof Request ? input.url : String(input));

  try {
    const response = await fetch(input, init);
    recordPraxaRequest({
      method: init?.method ?? (input instanceof Request ? input.method : "GET"),
      host: url.host,
      route: redactRouteIdentifiers(url.pathname),
      status: response.status,
      durationMs: performance.now() - started,
    });
    return response;
  } catch (error) {
    recordPraxaRequest({
      method: init?.method ?? "GET",
      host: url.host,
      route: redactRouteIdentifiers(url.pathname),
      status: "network_error",
      durationMs: performance.now() - started,
    });
    throw error;
  }
};

import {
  PRAXA_CONTRACT_VERSION,
  PRAXA_OPENAPI_SHA256,
  PRAXA_OPENAPI_VERSION,
} from "@praxa/sdk";

if (PRAXA_OPENAPI_VERSION !== "8.1.0") {
  throw new Error(`Unsupported Praxa OpenAPI ${PRAXA_OPENAPI_VERSION}`);
}

if (
  PRAXA_OPENAPI_SHA256 !==
  "a9835faa4654246f83c452ae968a569c85be28f93017882e710ca35c10dbbecc"
) {
  throw new Error("Praxa contract fingerprint changed; review before deploy");
}

console.info("Praxa contract", PRAXA_CONTRACT_VERSION);