@blackenedd18/planio-connector 2026.623.2

package/src/shared/request.js

@@ -0,0 +1,97 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { logDebug, logError } from './logger.js';
+import { getRuntimeConfig } from './config.js';
+import { callRedmineFunctionAdapter } from './redmine-functions-adapter.js';
+
+function buildResponsePayload(_method, data) {
+  const text =
+    typeof data === 'string' ? data :
+    data == null ? '' :
+    JSON.stringify(data);
+
+  let structuredContent;
+  if (Array.isArray(data)) {
+    structuredContent = { items: data };
+  } else if (typeof data === 'object' && data !== null) {
+    structuredContent = data;
+  }
+
+  const response = {
+    content: [{ type: 'text', text }],
+  };
+  if (structuredContent !== undefined) {
+    response.structuredContent = structuredContent;
+  }
+
+  logDebug('[request.buildResponsePayload] Response shape normalized', {
+    contentTextLength: text.length,
+    hasStructuredContent: structuredContent !== undefined,
+    structuredKind: Array.isArray(data) ? 'array_as_items' : (typeof data),
+  });
+
+  return response;
+}
+
+export async function makeRequest(method, endpoint, params = undefined, body = undefined) {
+  const config = getRuntimeConfig();
+
+  logDebug('[request.makeRequest] Auth header strategy selected', {
+    headerName: 'X-Redmine-API-Key',
+    authSource: 'CLI_OR_ENV',
+  });
+
+  logDebug('[request.makeRequest] Sending request', {
+    method,
+    endpoint,
+    paramKeys: params ? Object.keys(params) : [],
+    transport: 'local-redmine-functions',
+  });
+
+  try {
+    const data = await callRedmineFunctionAdapter({
+      method,
+      endpoint,
+      params,
+      body,
+      apiKey: config.redmineApiKey,
+      redmineUrl: config.redmineUrl,
+    });
+
+    logDebug('[request.makeRequest] Request success', {
+      method,
+      endpoint,
+      transport: 'local-redmine-functions',
+    });
+
+    return buildResponsePayload(method, data);
+  } catch (error) {
+    if (error instanceof McpError) {
+      throw error;
+    }
+
+    const status = error?.status;
+    const detail = error?.message || 'Unknown local function error';
+    const remediation =
+      status === 401 || status === 403
+        ? 'Verify REDMINE_API_KEY is set and accepted by Redmine API.'
+        : status === 422
+          ? 'Verify request parameters match Redmine controller validation rules (types, enums, and date formats).'
+        : status === 501
+          ? 'Required local Redmine-function handler is missing. Ensure Redmine-functions exports requested endpoint handlers.'
+        : undefined;
+
+    logError('[request.makeRequest] Request failed', {
+      method,
+      endpoint,
+      status,
+      detail,
+      remediation,
+      transport: 'local-redmine-functions',
+    });
+
+    throw new McpError(
+      ErrorCode.InternalError,
+      `Redmine API request failed${status ? ` (${status})` : ''}: ${detail}${remediation ? ` ${remediation}` : ''}`
+    );
+  }
+}