// src/utils/apiHelpers.ts
import { getAuthService } from '../services/authService.js';
import { formatError } from './responseHelpers.js';
/**
* Makes an authenticated API request to PingOne AIC
* @param url - The full URL to request
* @param scopes - Array of OAuth scopes required for this request
* @param options - Optional fetch RequestInit options (method, body, etc.)
* @returns Object containing the parsed JSON data and the Response object
* @throws Error if the request fails with formatted error message
*/
export async function makeAuthenticatedRequest(
url: string,
scopes: string[],
options: RequestInit = {}
): Promise<{ data: unknown; response: Response }> {
const token = await getAuthService().getToken(scopes);
const response = await fetch(url, {
...options,
headers: {
'Authorization': `Bearer ${token}`,
// Only add Content-Type header if the request has a body
...(options.body && { 'Content-Type': 'application/json' }),
...options.headers,
}
});
if (!response.ok) {
const errorBody = await response.text();
throw new Error(formatError(response, errorBody));
}
// Handle empty responses (e.g., 204 No Content or DELETE operations)
const contentLength = response.headers.get('content-length');
const data = response.status === 204 || contentLength === '0'
? null
: await response.json();
return { data, response };
}
/**
* Creates a standardized MCP tool response
* @param text - The text content to return to the MCP client
* @returns MCP-formatted response object
*/
export function createToolResponse(text: string) {
return {
content: [{
type: 'text' as const,
text
}]
};
}
