@smartbear/mcp 0.8.0 → 0.9.0

package/dist/api-hub/client/api.js

@@ -1,3 +1,4 @@
+import { ToolError } from "../../common/types.js";
 // Regex to extract owner, name, and version from SwaggerHub URLs.
 // Matches /apis/owner/name/version, /domains/owner/name/version, or /templates/owner/name/version
 // Example: /apis/acme/petstore/1.0.0
@@ -70,7 +71,7 @@ export class ApiHubAPI {
      */
     async handleResponse(response, defaultReturn = {}) {
         if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            throw new ToolError(`HTTP ${response.status}: ${response.statusText}`);
         }
         return this.parseResponse(response, defaultReturn);
     }
@@ -101,7 +102,7 @@ export class ApiHubAPI {
         });
         const result = await this.handleResponse(response);
         if (!("id" in result)) {
-            throw new Error("Portal not found or empty response");
+            throw new ToolError("Portal not found or empty response");
         }
         return result;
     }
@@ -112,7 +113,7 @@ export class ApiHubAPI {
         });
         if (!response.ok) {
             const errorText = await response.text().catch(() => "");
-            throw new Error(`API Hub deletePortal failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}`);
+            throw new ToolError(`API Hub deletePortal failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}`);
         }
     }
     async updatePortal(portalId, body) {
@@ -150,7 +151,7 @@ export class ApiHubAPI {
         });
         const result = await this.handleResponse(response);
         if (!("id" in result)) {
-            throw new Error("Product not found or empty response");
+            throw new ToolError("Product not found or empty response");
         }
         return result;
     }
@@ -212,7 +213,7 @@ export class ApiHubAPI {
             headers: this.headers,
         });
         if (!response.ok) {
-            throw new Error(`SwaggerHub Registry API searchApis failed - status: ${response.status} ${response.statusText}`);
+            throw new ToolError(`SwaggerHub Registry API searchApis failed - status: ${response.status} ${response.statusText}`);
         }
         const apisJsonResponse = (await response.json());
         // Transform APIs.json response to our ApiMetadata format
@@ -267,7 +268,7 @@ export class ApiHubAPI {
             headers: this.headers,
         });
         if (!response.ok) {
-            throw new Error(`SwaggerHub Registry API getApiDefinition failed - status: ${response.status} ${response.statusText}`);
+            throw new ToolError(`SwaggerHub Registry API getApiDefinition failed - status: ${response.status} ${response.statusText}`);
         }
         // Return the raw API definition (could be JSON or YAML)
         const contentType = response.headers.get("content-type");
@@ -301,7 +302,7 @@ export class ApiHubAPI {
                 requestBody = JSON.stringify(parsedDefinition);
             }
             catch (error) {
-                throw new Error(`Invalid JSON format in definition: ${error instanceof Error ? error.message : "Unknown error"}`);
+                throw new ToolError(`Invalid JSON format in definition: ${error instanceof Error ? error.message : "Unknown error"}`);
             }
         }
         // Construct the URL with query parameters
@@ -320,7 +321,7 @@ export class ApiHubAPI {
         });
         if (!response.ok) {
             const errorText = await response.text().catch(() => "");
-            throw new Error(`SwaggerHub Registry API createOrUpdateApi failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}. URL: ${url}`);
+            throw new ToolError(`SwaggerHub Registry API createOrUpdateApi failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}. URL: ${url}`);
         }
         // Determine operation type based on HTTP status code
         const operation = response.status === 201 ? "create" : "update";
@@ -353,7 +354,7 @@ export class ApiHubAPI {
         });
         if (!response.ok) {
             const errorText = await response.text().catch(() => "");
-            throw new Error(`SwaggerHub Registry API createApiFromTemplate failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}. URL: ${url}`);
+            throw new ToolError(`SwaggerHub Registry API createApiFromTemplate failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}. URL: ${url}`);
         }
         // Determine operation type based on HTTP status code
         const operation = response.status === 201 ? "create" : "update";
@@ -374,7 +375,7 @@ export class ApiHubAPI {
     detectDefinitionFormat(definition) {
         const trimmed = definition.trim();
         if (!trimmed) {
-            throw new Error("Empty definition content provided");
+            throw new ToolError("Empty definition content provided");
         }
         try {
             JSON.parse(trimmed);
@@ -384,4 +385,44 @@ export class ApiHubAPI {
             return "yaml";
         }
     }
+    /**
+     * Run a standardization scan against an API definition
+     * @param params Parameters including organization name and API definition
+     * @returns Standardization result with validation errors
+     */
+    async scanStandardization(params) {
+        // Auto-detect format from the definition content
+        const format = this.detectDefinitionFormat(params.definition);
+        let contentType;
+        let requestBody;
+        if (format === "yaml") {
+            contentType = "application/yaml";
+            requestBody = params.definition; // Send YAML as-is
+        }
+        else {
+            contentType = "application/json";
+            // For JSON, parse and stringify to ensure valid JSON
+            try {
+                const parsedDefinition = JSON.parse(params.definition);
+                requestBody = JSON.stringify(parsedDefinition);
+            }
+            catch (error) {
+                throw new Error(`Invalid JSON format in definition: ${error instanceof Error ? error.message : "Unknown error"}`);
+            }
+        }
+        const url = `${this.config.registryBasePath}/standardization/${encodeURIComponent(params.orgName)}/scan`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                ...this.headers,
+                "Content-Type": contentType,
+            },
+            body: requestBody,
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "");
+            throw new Error(`SwaggerHub Registry API scanStandardization failed - status: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}. URL: ${url}`);
+        }
+        return await this.handleResponse(response);
+    }
 }

package/dist/api-hub/client/registry-types.js

@@ -67,3 +67,11 @@ export const CreateApiFromTemplateParamsSchema = z.object({
         .string()
         .describe("Template name to use for creating the API. Format: owner/template-name/version (e.g., 'swagger-hub/petstore-template/1.0.0'). API is created with fixed values: private visibility, no project assignment, and reconciliation enabled."),
 });
+export const ScanStandardizationParamsSchema = z.object({
+    orgName: z
+        .string()
+        .describe("The organization name to use for standardization rules"),
+    definition: z
+        .string()
+        .describe("API definition content (OpenAPI/AsyncAPI specification in JSON or YAML format) to scan for standardization errors"),
+});

package/dist/api-hub/client/tools.js

@@ -6,7 +6,7 @@
  * This follows the pattern established in the pactflow module.
  */
 import { CreatePortalArgsSchema, CreateProductArgsSchema, PortalArgsSchema, ProductArgsSchema, UpdatePortalArgsSchema, UpdateProductArgsSchema, } from "./portal-types.js";
-import { ApiDefinitionParamsSchema, ApiSearchParamsSchema, CreateApiFromTemplateParamsSchema, CreateApiParamsSchema, } from "./registry-types.js";
+import { ApiDefinitionParamsSchema, ApiSearchParamsSchema, CreateApiFromTemplateParamsSchema, CreateApiParamsSchema, ScanStandardizationParamsSchema, } from "./registry-types.js";
 export const TOOLS = [
     {
         title: "List Portals",
@@ -95,4 +95,10 @@ export const TOOLS = [
         zodSchema: CreateApiFromTemplateParamsSchema,
         handler: "createApiFromTemplate",
     },
+    {
+        title: "Scan API Standardization",
+        summary: "Run a standardization scan against an API definition using the organization's standardization configuration. Accepts a YAML or JSON OpenAPI/AsyncAPI definition and returns a list of standardization errors and validation issues.",
+        zodSchema: ScanStandardizationParamsSchema,
+        handler: "scanStandardization",
+    },
 ];

package/dist/api-hub/client.js

@@ -57,6 +57,9 @@ export class ApiHubClient {
     async createApiFromTemplate(args) {
         return this.api.createApiFromTemplate(args);
     }
+    async scanStandardization(args) {
+        return this.api.scanStandardization(args);
+    }
     registerTools(register, _getInput) {
         TOOLS.forEach((tool) => {
             const { handler, formatResponse, ...toolParams } = tool;

package/dist/bugsnag/client/api/CurrentUser.js

@@ -1,41 +1,19 @@
-import { BaseAPI, pickFieldsFromArray } from "./base.js";
+import { CurrentUserApiFetchParamCreator, } from "./api.js";
+import { BaseAPI } from "./base.js";
 import { ProjectAPI } from "./Project.js";
-// --- API Class ---
 export class CurrentUserAPI extends BaseAPI {
-    static filterFields = [
-        "collaborators_url",
-        "projects_url",
-        "upgrade_url",
+    static organizationFields = [
+        "id",
+        "name",
+        "slug",
     ];
-    static organizationFields = ["id", "name", "slug"];
-    constructor(configuration) {
-        super(configuration, CurrentUserAPI.filterFields);
-    }
     /**
      * List the current user's organizations
      * GET /user/organizations
      */
-    async listUserOrganizations(options = {}) {
-        const { admin, ...queryOptions } = options;
-        const params = new URLSearchParams();
-        if (admin !== undefined)
-            params.append("admin", String(admin));
-        for (const [key, value] of Object.entries(queryOptions)) {
-            if (value !== undefined)
-                params.append(key, String(value));
-        }
-        const url = params.toString()
-            ? `/user/organizations?${params}`
-            : "/user/organizations";
-        const data = await this.request({
-            method: "GET",
-            url,
-        });
-        // Only return allowed fields
-        return {
-            ...data,
-            body: pickFieldsFromArray(data.body || [], CurrentUserAPI.organizationFields),
-        };
+    async listUserOrganizations(admin, perPage, options = {}) {
+        const localVarFetchArgs = CurrentUserApiFetchParamCreator(this.configuration).listUserOrganizations(admin, perPage, options);
+        return await this.requestArray(localVarFetchArgs.url, localVarFetchArgs.options, true, CurrentUserAPI.organizationFields);
     }
     /**
      * List projects for a given organization
@@ -44,23 +22,8 @@ export class CurrentUserAPI extends BaseAPI {
      * @param options Optional parameters for filtering, pagination, etc.
      * @returns A promise that resolves to the list of projects in the organization
      */
-    async getOrganizationProjects(organizationId, options = {}) {
-        const { ...queryOptions } = options;
-        const params = new URLSearchParams();
-        for (const [key, value] of Object.entries(queryOptions)) {
-            if (value !== undefined)
-                params.append(key, String(value));
-        }
-        const url = params.toString()
-            ? `/organizations/${organizationId}/projects?${params}`
-            : `/organizations/${organizationId}/projects`;
-        const data = await this.request({
-            method: "GET",
-            url,
-        });
-        return {
-            ...data,
-            body: pickFieldsFromArray(data.body || [], ProjectAPI.projectFields),
-        };
+    async getOrganizationProjects(organizationId, q, sort, direction, perPage, options) {
+        const localVarFetchArgs = CurrentUserApiFetchParamCreator(this.configuration).getOrganizationProjects(organizationId, q, sort, direction, perPage, options);
+        return await this.requestArray(localVarFetchArgs.url, localVarFetchArgs.options, true, ProjectAPI.projectFields);
     }
 }

package/dist/bugsnag/client/api/Error.js

@@ -1,177 +1,64 @@
-import { BaseAPI } from "./base.js";
-import { toQueryString } from "./filters.js";
-export const ErrorOperations = [
-    "override_severity",
-    "assign",
-    "create_issue",
-    "link_issue",
-    "unlink_issue",
-    "open",
-    "snooze",
-    "fix",
-    "ignore",
-    "delete",
-    "discard",
-    "undiscard",
-];
-export const ReopenConditions = [
-    "occurs_after",
-    "n_occurrences_in_m_hours",
-    "n_additional_occurrences",
-    "n_additional_users",
-];
-// --- API Class ---
+import { ErrorsApiFetchParamCreator, } from "./api.js";
+import { BaseAPI, getQueryParams } from "./base.js";
 export class ErrorAPI extends BaseAPI {
     static filterFields = ["url", "project_url", "events_url"];
-    constructor(configuration) {
-        super(configuration, ErrorAPI.filterFields);
-    }
     /**
      * View an Error on a Project
      * GET /projects/{project_id}/errors/{error_id}
      */
-    async viewErrorOnProject(projectId, errorId, options = {}) {
-        const params = new URLSearchParams();
-        for (const [key, value] of Object.entries(options)) {
-            if (value !== undefined)
-                params.append(key, String(value));
-        }
-        const url = params.toString()
-            ? `/projects/${projectId}/errors/${errorId}?${params}`
-            : `/projects/${projectId}/errors/${errorId}`;
-        return (await this.request({
-            method: "GET",
-            url,
-        }));
+    async viewErrorOnProject(projectId, errorId) {
+        const localVarFetchArgs = ErrorsApiFetchParamCreator(this.configuration).viewErrorOnProject(projectId, errorId);
+        return await this.requestObject(localVarFetchArgs.url, localVarFetchArgs.options);
     }
     /**
      * Get the latest Event in a Project, with optional filters
      * GET /projects/{project_id}/events
      */
-    async getLatestEventOnProject(projectId, queryString = "") {
-        const url = `/projects/${projectId}/events${queryString}`;
-        const response = await this.request({
-            method: "GET",
-            url,
-        });
-        return {
-            ...response,
-            body: response.body && response.body.length > 0
-                ? response.body[0]
-                : undefined, // Return only the latest event
-        };
+    async listEventsOnProject(projectId, base, sort, direction, perPage, filters, fullReports) {
+        const localVarFetchArgs = ErrorsApiFetchParamCreator(this.configuration).listEventsOnProject(projectId, base ?? undefined, sort, direction, perPage, undefined, fullReports, { query: filters });
+        return await this.requestArray(localVarFetchArgs.url, localVarFetchArgs.options, false);
     }
     /**
      * View an Event by ID
      * GET /projects/{project_id}/events/{event_id}
      */
-    async viewEventById(projectId, eventId, options = {}) {
-        const params = new URLSearchParams();
-        for (const [key, value] of Object.entries(options)) {
-            if (value !== undefined)
-                params.append(key, String(value));
-        }
-        const url = params.toString()
-            ? `/projects/${projectId}/events/${eventId}?${params}`
-            : `/projects/${projectId}/events/${eventId}`;
-        return (await this.request({
-            method: "GET",
-            url,
-        }));
+    async viewEventById(projectId, eventId) {
+        const localVarFetchArgs = ErrorsApiFetchParamCreator(this.configuration).viewEventById(projectId, eventId);
+        return await this.requestObject(localVarFetchArgs.url, localVarFetchArgs.options);
     }
     /**
      * List the Errors on a Project
      * GET /projects/{project_id}/errors
      */
-    async listProjectErrors(projectId, options = {}) {
-        let url = `/projects/${projectId}/errors`;
-        // Next links need to be used as-is to ensure results are consistent, so only the page size can be modified
-        if (options.next_url !== undefined) {
-            const nextUrl = new URL(options.next_url);
-            if (options.per_page !== undefined) {
-                nextUrl.searchParams.set("per_page", options.per_page.toString());
+    async listProjectErrors(projectId, base, sort, direction, perPage, filters, nextUrl) {
+        const options = getQueryParams(nextUrl, nextUrl ? undefined : filters);
+        if (nextUrl) {
+            if (perPage) {
+                // Next links need to be used as-is to ensure results are consistent, so only the page size can be modified
+                // the others will get overridden
+                options.query.per_page = perPage.toString();
             }
-            url = nextUrl.toString();
+            direction = undefined;
+            sort = undefined;
+            base = undefined;
         }
-        else {
-            const params = new URLSearchParams();
-            // Add filter parameters
-            if (options.filters) {
-                const filterParams = new URLSearchParams(toQueryString(options.filters));
-                filterParams.forEach((value, key) => {
-                    params.append(key, value);
-                });
-            }
-            // Add pagination and sorting parameters
-            if (options.base !== undefined) {
-                params.append("base", options.base);
-            }
-            if (options.sort !== undefined) {
-                params.append("sort", options.sort);
-            }
-            if (options.direction !== undefined) {
-                params.append("direction", options.direction);
-            }
-            if (options.per_page !== undefined) {
-                params.append("per_page", options.per_page.toString());
-            }
-            if (params.size > 0) {
-                url = `/projects/${projectId}/errors?${params}`;
-            }
-        }
-        return (await this.request({
-            method: "GET",
-            url,
-        }, false));
+        const localVarFetchArgs = ErrorsApiFetchParamCreator(this.configuration).listProjectErrors(projectId, base ?? undefined, sort, direction, perPage, undefined, options);
+        return await this.requestArray(localVarFetchArgs.url, localVarFetchArgs.options, false);
     }
     /**
      * Update an Error on a Project
      * PATCH /projects/{project_id}/errors/{error_id}
      */
-    async updateErrorOnProject(projectId, errorId, data, options = {}) {
-        const params = new URLSearchParams();
-        for (const [key, value] of Object.entries(options)) {
-            if (value !== undefined)
-                params.append(key, String(value));
-        }
-        const url = params.toString()
-            ? `/projects/${projectId}/errors/${errorId}?${params}`
-            : `/projects/${projectId}/errors/${errorId}`;
-        return (await this.request({
-            method: "PATCH",
-            url,
-            body: data,
-        }));
+    async updateErrorOnProject(projectId, errorId, body) {
+        const localVarFetchArgs = ErrorsApiFetchParamCreator(this.configuration).updateErrorOnProject(body, projectId, errorId);
+        return await this.requestObject(localVarFetchArgs.url, localVarFetchArgs.options);
     }
     /**
      * List Pivots on an Error
      * GET /projects/{project_id}/errors/{error_id}/pivots
      */
-    async listErrorPivots(projectId, errorId, options = {}) {
-        const params = new URLSearchParams();
-        if (options.filters) {
-            const filterParams = new URLSearchParams(toQueryString(options.filters));
-            filterParams.forEach((value, key) => {
-                params.append(key, value);
-            });
-        }
-        if (options.summary_size !== undefined) {
-            params.append("summary_size", options.summary_size.toString());
-        }
-        if (options.pivots && options.pivots.length > 0) {
-            options.pivots.forEach((pivot) => {
-                params.append("pivots[]", pivot);
-            });
-        }
-        if (options.per_page !== undefined) {
-            params.append("per_page", options.per_page.toString());
-        }
-        const url = params.toString()
-            ? `/projects/${projectId}/errors/${errorId}/pivots?${params}`
-            : `/projects/${projectId}/errors/${errorId}/pivots`;
-        return await this.request({
-            method: "GET",
-            url,
-        });
+    async getPivotValuesOnAnError(projectId, errorId, filters, summarySize, pivots, perPage) {
+        const localVarFetchArgs = ErrorsApiFetchParamCreator(this.configuration).listPivotsOnAnError(projectId, errorId, undefined, summarySize, pivots, perPage, { query: filters });
+        return await this.requestArray(localVarFetchArgs.url, localVarFetchArgs.options, false);
     }
 }