@smartbear/mcp 0.6.0 → 0.7.0

package/dist/common/info.js

@@ -1,3 +1,3 @@
-import packageJson from '../../package.json' with { type: "json" };
+import packageJson from "../../package.json" with { type: "json" };
 export const MCP_SERVER_NAME = packageJson.config.mcpServerName;
 export const MCP_SERVER_VERSION = packageJson.version;

package/dist/common/server.js

@@ -1,4 +1,4 @@
-import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer, ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ZodAny, ZodArray, ZodBoolean, ZodEnum, ZodLiteral, ZodNumber, ZodObject, ZodString, ZodUnion, } from "zod";
 import Bugsnag from "../common/bugsnag.js";
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "./info.js";
@@ -41,7 +41,9 @@ export class SmartBearMcpServer extends McpServer {
         });
         if (client.registerResources) {
             client.registerResources((name, path, cb) => {
-                return super.registerResource(name, new ResourceTemplate(`${client.prefix}://${name}/${path}`, { list: undefined }), {}, async (url, variables, extra) => {
+                return super.registerResource(name, new ResourceTemplate(`${client.prefix}://${name}/${path}`, {
+                    list: undefined,
+                }), {}, async (url, variables, extra) => {
                     try {
                         return await cb(url, variables, extra);
                     }
@@ -94,64 +96,70 @@ export class SmartBearMcpServer extends McpServer {
         return args;
     }
     getDescription(params) {
-        const { summary, useCases, examples, parameters, zodSchema, hints, outputFormat } = params;
+        const { summary, useCases, examples, parameters, zodSchema, hints, outputFormat, } = params;
         let description = summary;
         // Parameters if available otherwise use zodSchema
         if ((parameters ?? []).length > 0) {
-            description += `\n\n**Parameters:**\n${parameters?.map(p => `- ${p.name} (${this.getReadableTypeName(p.type)})${p.required ? ' *required*' : ''}` +
-                `${p.description ? `: ${p.description}` : ''}` +
-                `${p.examples ? ` (e.g. ${p.examples.join(', ')})` : ''}` +
-                `${p.constraints ? `\n  - ${p.constraints.join('\n  - ')}` : ''}`).join('\n')}`;
+            description += `\n\n**Parameters:**\n${parameters
+                ?.map((p) => `- ${p.name} (${this.getReadableTypeName(p.type)})${p.required ? " *required*" : ""}` +
+                `${p.description ? `: ${p.description}` : ""}` +
+                `${p.examples ? ` (e.g. ${p.examples.join(", ")})` : ""}` +
+                `${p.constraints ? `\n  - ${p.constraints.join("\n  - ")}` : ""}`)
+                .join("\n")}`;
         }
         if (zodSchema && zodSchema instanceof ZodObject) {
             description += "\n\n**Parameters:**\n";
             description += Object.keys(zodSchema.shape)
-                .map(key => this.formatParameterDescription(key, zodSchema.shape[key]))
-                .join('\n');
+                .map((key) => this.formatParameterDescription(key, zodSchema.shape[key]))
+                .join("\n");
         }
         if (outputFormat) {
             description += `\n\n**Output Format:** ${outputFormat}`;
         }
         // Use Cases
         if (useCases && useCases.length > 0) {
-            description += `\n\n**Use Cases:** ${useCases.map((uc, i) => `${i + 1}. ${uc}`).join(' ')}`;
+            description += `\n\n**Use Cases:** ${useCases.map((uc, i) => `${i + 1}. ${uc}`).join(" ")}`;
         }
         // Examples
         if (examples && examples.length > 0) {
-            description += `\n\n**Examples:**\n` + examples.map((ex, idx) => `${idx + 1}. ${ex.description}\n\`\`\`json\n${JSON.stringify(ex.parameters, null, 2)}\n\`\`\`${ex.expectedOutput ? `\nExpected Output: ${ex.expectedOutput}` : ''}`).join('\n\n');
+            description +=
+                `\n\n**Examples:**\n` +
+                    examples
+                        .map((ex, idx) => `${idx + 1}. ${ex.description}\n\`\`\`json\n${JSON.stringify(ex.parameters, null, 2)}\n\`\`\`${ex.expectedOutput ? `\nExpected Output: ${ex.expectedOutput}` : ""}`)
+                        .join("\n\n");
         }
         // Hints
         if (hints && hints.length > 0) {
-            description += `\n\n**Hints:** ${hints.map((hint, i) => `${i + 1}. ${hint}`).join(' ')}`;
+            description += `\n\n**Hints:** ${hints.map((hint, i) => `${i + 1}. ${hint}`).join(" ")}`;
         }
         return description.trim();
     }
     formatParameterDescription(key, field) {
-        return `- ${key} (${this.getReadableTypeName(field)})` +
-            `${field.isOptional() ? '' : ' *required*'}` +
-            `${field.description ? `: ${field.description}` : ''}` +
-            `${key === "examples" && field instanceof ZodEnum ? ` (e.g. ${Object.keys(field.enum).join(', ')})` : ''}` +
-            `${key === "constraints" && field instanceof ZodEnum ? `\n  - ${Object.keys(field.enum).join('\n  - ')}` : ''}`;
+        return (`- ${key} (${this.getReadableTypeName(field)})` +
+            `${field.isOptional() ? "" : " *required*"}` +
+            `${field.description ? `: ${field.description}` : ""}` +
+            `${key === "examples" && field instanceof ZodEnum ? ` (e.g. ${Object.keys(field.enum).join(", ")})` : ""}` +
+            `${key === "constraints" && field instanceof ZodEnum ? `\n  - ${Object.keys(field.enum).join("\n  - ")}` : ""}`);
     }
     getReadableTypeName(zodType) {
         if (zodType instanceof ZodString)
-            return 'string';
+            return "string";
         if (zodType instanceof ZodNumber)
-            return 'number';
+            return "number";
         if (zodType instanceof ZodBoolean)
-            return 'boolean';
+            return "boolean";
         if (zodType instanceof ZodArray)
-            return 'array';
+            return "array";
         if (zodType instanceof ZodObject)
-            return 'object';
+            return "object";
         if (zodType instanceof ZodEnum)
-            return 'enum';
+            return "enum";
         if (zodType instanceof ZodLiteral)
-            return 'literal';
+            return "literal";
         if (zodType instanceof ZodUnion)
-            return 'union';
+            return "union";
         if (zodType instanceof ZodAny)
-            return 'any';
-        return 'any';
+            return "any";
+        return "any";
     }
 }

package/dist/index.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import Bugsnag from "./common/bugsnag.js";
-import { BugsnagClient } from "./bugsnag/client.js";
-import { ReflectClient } from "./reflect/client.js";
 import { ApiHubClient } from "./api-hub/client.js";
+import { BugsnagClient } from "./bugsnag/client.js";
+import Bugsnag from "./common/bugsnag.js";
 import { SmartBearMcpServer } from "./common/server.js";
 import { PactflowClient } from "./pactflow/client.js";
+import { QmetryClient } from "./qmetry/client.js";
+import { ReflectClient } from "./reflect/client.js";
 // This is used to report errors in the MCP server itself
 // If you want to use your own BugSnag API key, set the MCP_SERVER_BUGSNAG_API_KEY environment variable
 const McpServerBugsnagAPIKey = process.env.MCP_SERVER_BUGSNAG_API_KEY;
@@ -21,6 +22,8 @@ async function main() {
     const pactBrokerUrl = process.env.PACT_BROKER_BASE_URL;
     const pactBrokerUsername = process.env.PACT_BROKER_USERNAME;
     const pactBrokerPassword = process.env.PACT_BROKER_PASSWORD;
+    const qmetryToken = process.env.QMETRY_API_KEY;
+    const qmetryBaseUrl = process.env.QMETRY_BASE_URL;
     let client_defined = false;
     if (reflectToken) {
         server.addClient(new ReflectClient(reflectToken));
@@ -49,8 +52,12 @@ async function main() {
             console.error("If the Pact Broker base URL is specified, you must specify either (a) a PactFlow token, or (b) a Pact Broker username and password pair.");
         }
     }
+    if (qmetryToken) {
+        server.addClient(new QmetryClient(qmetryToken, qmetryBaseUrl));
+        client_defined = true;
+    }
     if (!client_defined) {
-        console.error("Please set one of REFLECT_API_TOKEN, BUGSNAG_AUTH_TOKEN, API_HUB_API_KEY or PACT_BROKER_BASE_URL / (and relevant Pact auth) environment variables");
+        console.error("Please set one of REFLECT_API_TOKEN, BUGSNAG_AUTH_TOKEN, API_HUB_API_KEY, QMETRY_API_KEY or PACT_BROKER_BASE_URL / (and relevant Pact auth) environment variables");
         process.exit(1);
     }
     const transport = new StdioServerTransport();

package/dist/pactflow/client/ai.js

@@ -146,18 +146,15 @@ export const GenerationInputSchema = z.object({
     testTemplate: FileInputSchema.optional().describe("Optional test template to use as a basis for generation. Helps ensure generated tests follow your specific patterns, frameworks, and coding standards"),
 });
 export const MatcherRecommendationInputSchema = z.array(EndpointMatcherSchema);
-export const AiCreditsSchema = z.object({
-    total: z
-        .number()
-        .describe("The total number of AI credits available."),
-    used: z
-        .number()
-        .describe("The number of AI credits used."),
-}).describe("AI credits information.");
-export const OrganizationEntitlementsSchema = z.object({
-    name: z
-        .string()
-        .describe("The name of the organization."),
+export const AiCreditsSchema = z
+    .object({
+    total: z.number().describe("The total number of AI credits available."),
+    used: z.number().describe("The number of AI credits used."),
+})
+    .describe("AI credits information.");
+export const OrganizationEntitlementsSchema = z
+    .object({
+    name: z.string().describe("The name of the organization."),
     planAiEnabled: z
         .boolean()
         .describe("Whether AI features are enabled at the plan level."),
@@ -165,13 +162,16 @@ export const OrganizationEntitlementsSchema = z.object({
         .boolean()
         .describe("Whether AI features are enabled at the preferences level."),
     aiCredits: AiCreditsSchema.describe("AI credits information."),
-}).describe("Organization entitlements information.");
-export const UserEntitlementsSchema = z.object({
-    aiPermissions: z
-        .array(z.string())
-        .describe("List of AI permissions."),
-}).describe("User entitlements information.");
-export const EntitlementsSchema = z.object({
+})
+    .describe("Organization entitlements information.");
+export const UserEntitlementsSchema = z
+    .object({
+    aiPermissions: z.array(z.string()).describe("List of AI permissions."),
+})
+    .describe("User entitlements information.");
+export const EntitlementsSchema = z
+    .object({
     organizationEntitlements: OrganizationEntitlementsSchema.describe("Organization entitlements information."),
     userEntitlements: UserEntitlementsSchema.describe("User entitlements information."),
-}).describe("Entitlements information.");
+})
+    .describe("Entitlements information.");

package/dist/pactflow/client/base.js

@@ -1,19 +1,54 @@
 import { z } from "zod";
 export const CanIDeploySchema = z.object({
-    pacticipant: z.string().describe("The name of the pacticipant (application/service) being evaluated for deployment"),
-    version: z.string().describe("The version of the pacticipant that you want to check if it's safe to deploy"),
-    environment: z.string().describe("The target environment where the pacticipant version will be deployed (e.g., 'production', 'staging', 'test')"),
+    pacticipant: z
+        .string()
+        .describe("The name of the pacticipant (application/service) being evaluated for deployment"),
+    version: z
+        .string()
+        .describe("The version of the pacticipant that you want to check if it's safe to deploy"),
+    environment: z
+        .string()
+        .describe("The target environment where the pacticipant version will be deployed (e.g., 'production', 'staging', 'test')"),
 });
 export const MatrixSchema = z.object({
-    latestby: z.string().optional().describe("This property removes the rows for the overridden pacts/verifications from the results. The options are cvp (show only the latest row for each consumer version and provider) and cvpv (show only the latest row each consumer version and provider version). For a can-i-deploy query with one selector, it should be set to cvp. For a can-i-deploy query with two selectors, it should be set to cvpv."),
-    limit: z.number().min(1).max(1000).default(100).optional().describe("The limit on the number of results to return (1-1000, default: 100)"),
-    q: z.array(z.object({
-        pacticipant: z.string().describe("Name of the pacticipant (application)"),
+    latestby: z
+        .string()
+        .optional()
+        .describe("This property removes the rows for the overridden pacts/verifications from the results. The options are cvp (show only the latest row for each consumer version and provider) and cvpv (show only the latest row each consumer version and provider version). For a can-i-deploy query with one selector, it should be set to cvp. For a can-i-deploy query with two selectors, it should be set to cvpv."),
+    limit: z
+        .number()
+        .min(1)
+        .max(1000)
+        .default(100)
+        .optional()
+        .describe("The limit on the number of results to return (1-1000, default: 100)"),
+    q: z
+        .array(z.object({
+        pacticipant: z
+            .string()
+            .describe("Name of the pacticipant (application)"),
         version: z.string().optional().describe("Version number"),
-        branch: z.string().optional().describe("Name of the pacticipant version branch"),
-        environment: z.string().optional().describe("The name of the environment that the pacticipant version is deployed to"),
-        latest: z.boolean().optional().describe("Used in conjunction with other properties to indicate whether the selector is describing the latest version from a branch/with a tag/for a pacticipant, or all of them. Note that when used with tags, the 'latest' is calculated using the creation date of the pacticipant version, NOT the creation date of the tag."),
-        tag: z.string().optional().describe("The name of the pacticipant version tag (superseded by branch and environments)"),
-        mainBranch: z.boolean().optional().describe("Whether or not the version(s) described are from the main branch of the pacticipant, as set in the mainBranch property of the pacticipant resource."),
-    })).min(1).max(2)
+        branch: z
+            .string()
+            .optional()
+            .describe("Name of the pacticipant version branch"),
+        environment: z
+            .string()
+            .optional()
+            .describe("The name of the environment that the pacticipant version is deployed to"),
+        latest: z
+            .boolean()
+            .optional()
+            .describe("Used in conjunction with other properties to indicate whether the selector is describing the latest version from a branch/with a tag/for a pacticipant, or all of them. Note that when used with tags, the 'latest' is calculated using the creation date of the pacticipant version, NOT the creation date of the tag."),
+        tag: z
+            .string()
+            .optional()
+            .describe("The name of the pacticipant version tag (superseded by branch and environments)"),
+        mainBranch: z
+            .boolean()
+            .optional()
+            .describe("Whether or not the version(s) described are from the main branch of the pacticipant, as set in the mainBranch property of the pacticipant resource."),
+    }))
+        .min(1)
+        .max(2),
 });

package/dist/pactflow/client/prompts.js

@@ -116,18 +116,16 @@ export const PROMPTS = [
                 openAPI: z.string(),
             },
         },
-        callback: function ({ openAPI }) {
-            return {
-                messages: [
-                    {
-                        role: "user",
-                        content: {
-                            type: "text",
-                            text: OADMatcherPrompt.replace("{0}", openAPI),
-                        },
+        callback: ({ openAPI }) => ({
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: OADMatcherPrompt.replace("{0}", openAPI),
                     },
-                ],
-            };
-        },
+                },
+            ],
+        }),
     },
 ];

package/dist/pactflow/client/tools.js

@@ -10,7 +10,7 @@
  * and registered with their corresponding handler.
  */
 import { z } from "zod";
-import { GenerationInputSchema, RefineInputSchema, } from "./ai.js";
+import { GenerationInputSchema, RefineInputSchema } from "./ai.js";
 import { CanIDeploySchema, MatrixSchema } from "./base.js";
 export const TOOLS = [
     {
@@ -40,11 +40,11 @@ export const TOOLS = [
                 name: "provider",
                 type: z.string(),
                 description: "name of the provider to retrieve states for",
-                required: true
-            }
+                required: true,
+            },
         ],
         handler: "getProviderStates",
-        clients: ["pactflow", "pact_broker"]
+        clients: ["pactflow", "pact_broker"],
     },
     {
         title: "Can I Deploy",
@@ -52,7 +52,7 @@ export const TOOLS = [
         purpose: "To serve as a deployment safety check within the PactBroker and PactFlow ecosystem, leveraging contract testing results to validate whether a specific service / pacticipant version is compatible with all integrated services. This feature prevents unsafe releases, reduces integration risks, and enables teams to confidently automate deployments across environments with a clear, auditable record of verification results.",
         zodSchema: CanIDeploySchema,
         handler: "canIDeploy",
-        clients: ["pactflow", "pact_broker"]
+        clients: ["pactflow", "pact_broker"],
     },
     {
         title: "Matrix",
@@ -64,11 +64,11 @@ export const TOOLS = [
             "Visualize the overall contract compatibility across two pacticipants / services.",
             "Perform advanced queries using selectors to understand compatibility within specific branches, environments, or version ranges.",
             "Support informed deployment decisions by answering 'can I deploy version X of this service to production?'",
-            "Expose contract verification details to non-frequent API users in a more accessible format."
+            "Expose contract verification details to non-frequent API users in a more accessible format.",
         ],
         zodSchema: MatrixSchema,
         handler: "getMatrix",
-        clients: ["pactflow", "pact_broker"]
+        clients: ["pactflow", "pact_broker"],
     },
     {
         title: "PactFlow AI Status",
@@ -79,9 +79,9 @@ export const TOOLS = [
             "Monitor remaining and consumed AI credits to manage usage and avoid unexpected disruptions",
             "Detect entitlement or permission issues when a user tries to access AI features and guide corrective actions",
             "Integrate into deployment pipelines to ensure the environment is correctly configured with necessary entitlements and sufficient credits before executing AI-driven tasks",
-            "Fetches usage and entitlement reports for auditing, budgeting, and compliance purposes"
+            "Fetches usage and entitlement reports for auditing, budgeting, and compliance purposes",
         ],
         handler: "getAIStatus",
-        clients: ["pactflow"]
-    }
+        clients: ["pactflow"],
+    },
 ];

package/dist/pactflow/client/utils.js

@@ -1,7 +1,7 @@
-import { RemoteOpenAPIDocumentSchema, } from "./ai.js";
 import yaml from "js-yaml";
 // @ts-expect-error missing type declarations
 import Swagger from "swagger-client";
+import { RemoteOpenAPIDocumentSchema, } from "./ai.js";
 /**
  * Resolve the OpenAPI specification from the provided input.
  *

package/dist/pactflow/client.js

@@ -1,7 +1,7 @@
 import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../common/info.js";
-import { TOOLS } from "./client/tools.js";
-import { getOADMatcherRecommendations, getUserMatcherSelection } from "./client/prompt-utils.js";
+import { getOADMatcherRecommendations, getUserMatcherSelection, } from "./client/prompt-utils.js";
 import { PROMPTS } from "./client/prompts.js";
+import { TOOLS } from "./client/tools.js";
 // Tool definitions for PactFlow AI API client
 export class PactflowClient {
     name = "Contract Testing";
@@ -51,7 +51,9 @@ export class PactflowClient {
      * @throws Error if the HTTP request fails or the operation times out.
      */
     async generate(toolInput, getInput) {
-        if (toolInput.openapi?.document && (!toolInput.openapi?.matcher || Object.keys(toolInput.openapi.matcher).length === 0)) {
+        if (toolInput.openapi?.document &&
+            (!toolInput.openapi?.matcher ||
+                Object.keys(toolInput.openapi.matcher).length === 0)) {
             const matcherResponse = await getOADMatcherRecommendations(toolInput.openapi.document, this.server);
             const userSelection = await getUserMatcherSelection(matcherResponse, getInput);
             toolInput.openapi.matcher = userSelection;
@@ -77,7 +79,9 @@ export class PactflowClient {
      * @throws Error if the HTTP request fails or the operation times out.
      */
     async review(toolInput, getInput) {
-        if (toolInput.openapi?.document && (!toolInput.openapi?.matcher || Object.keys(toolInput.openapi.matcher).length === 0)) {
+        if (toolInput.openapi?.document &&
+            (!toolInput.openapi?.matcher ||
+                Object.keys(toolInput.openapi.matcher).length === 0)) {
             const matcherResponse = await getOADMatcherRecommendations(toolInput.openapi.document, this.server);
             const userSelection = await getUserMatcherSelection(matcherResponse, getInput);
             toolInput.openapi.matcher = userSelection;
@@ -130,6 +134,9 @@ export class PactflowClient {
             isComplete: response.status === 200,
         };
     }
+    get requestHeaders() {
+        return this.headers;
+    }
     async getResult(resultUrl) {
         const response = await fetch(resultUrl, {
             method: "GET",
@@ -161,7 +168,7 @@ export class PactflowClient {
         throw new Error(`${operationName} timed out after ${timeout / 1000} seconds`);
     }
     // PactFlow / Pact_Broker client methods
-    async getProviderStates({ provider }) {
+    async getProviderStates({ provider, }) {
         const uri_encoded_provider_name = encodeURIComponent(provider);
         const response = await fetch(`${this.baseUrl}/pacts/provider/${uri_encoded_provider_name}/provider-states`, {
             method: "GET",
@@ -249,7 +256,7 @@ export class PactflowClient {
                 queryParts.push(`q[]mainBranch=${selector.mainBranch}`);
             }
         });
-        const url = `${this.baseUrl}/matrix?${queryParts.join('&')}`;
+        const url = `${this.baseUrl}/matrix?${queryParts.join("&")}`;
         try {
             const response = await fetch(url, {
                 method: "GET",
@@ -273,8 +280,8 @@ export class PactflowClient {
      * @param getInput - The function used to get input for tools.
      */
     registerTools(register, getInput) {
-        for (const tool of TOOLS.filter(t => t.clients.includes(this.clientType))) {
-            const { handler, clients: _, formatResponse, ...toolparams } = tool; // eslint-disable-line @typescript-eslint/no-unused-vars
+        for (const tool of TOOLS.filter((t) => t.clients.includes(this.clientType))) {
+            const { handler, clients: _, formatResponse, ...toolparams } = tool;
             register(toolparams, async (args, _extra) => {
                 const handler_fn = this[handler];
                 if (typeof handler_fn !== "function") {
@@ -304,7 +311,7 @@ export class PactflowClient {
      * @param register - The function used to register prompts.
      */
     registerPrompts(register) {
-        PROMPTS.forEach(prompt => {
+        PROMPTS.forEach((prompt) => {
             register(prompt.name, prompt.params, prompt.callback);
         });
     }

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

@@ -0,0 +1,39 @@
+import { MCP_SERVER_NAME, MCP_SERVER_VERSION } from "../../../common/info.js";
+import { QMETRY_DEFAULTS } from "../../config/constants.js";
+export async function qmetryRequest({ method = "GET", path, token, project, baseUrl, body, }) {
+    const url = `${baseUrl}${path}`;
+    const headers = {
+        apikey: token,
+        project: project || QMETRY_DEFAULTS.PROJECT_KEY,
+        "User-Agent": `${MCP_SERVER_NAME}/${MCP_SERVER_VERSION}`,
+    };
+    if (body) {
+        headers["Content-Type"] = "application/json";
+    }
+    const init = {
+        method,
+        headers,
+    };
+    if (body && ["POST", "PUT", "PATCH"].includes(method)) {
+        init.body = JSON.stringify(body);
+    }
+    const res = await fetch(url, init);
+    if (!res.ok) {
+        let errorText;
+        try {
+            const contentType = res.headers.get("content-type");
+            if (contentType?.includes("application/json")) {
+                const json = await res.json();
+                errorText = JSON.stringify(json);
+            }
+            else {
+                errorText = await res.text();
+            }
+        }
+        catch {
+            errorText = res.statusText;
+        }
+        throw new Error(`QMetry API request failed (${res.status}): ${errorText}`);
+    }
+    return (await res.json());
+}

package/dist/qmetry/client/handlers.js

@@ -0,0 +1,11 @@
+import { QMetryToolsHandlers } from "../config/constants.js";
+import { getProjectInfo } from "./project.js";
+import { fetchTestCaseDetails, fetchTestCaseSteps, fetchTestCases, fetchTestCaseVersionDetails, } from "./testcase.js";
+export const QMETRY_HANDLER_MAP = {
+    [QMetryToolsHandlers.SET_PROJECT_INFO]: getProjectInfo,
+    [QMetryToolsHandlers.FETCH_PROJECT_INFO]: getProjectInfo,
+    [QMetryToolsHandlers.FETCH_TEST_CASES]: fetchTestCases,
+    [QMetryToolsHandlers.FETCH_TEST_CASE_DETAILS]: fetchTestCaseDetails,
+    [QMetryToolsHandlers.FETCH_TEST_CASE_VERSION_DETAILS]: fetchTestCaseVersionDetails,
+    [QMetryToolsHandlers.FETCH_TEST_CASE_STEPS]: fetchTestCaseSteps,
+};

package/dist/qmetry/client/project.js

@@ -0,0 +1,27 @@
+import { QMETRY_DEFAULTS } from "../config/constants.js";
+import { QMETRY_PATHS } from "../config/rest-endpoints.js";
+import { qmetryRequest } from "./api/client-api.js";
+/**
+ * Retrieves project information from QMetry
+ *
+ * This function serves dual purpose:
+ * 1. SET_PROJECT_INFO - Sets/switches the current project context
+ * 2. FETCH_PROJECT_INFO - Retrieves project details and configuration
+ *
+ * Both operations use the same API endpoint as QMetry handles project context
+ * switching and information retrieval through the same GET request.
+ *
+ * @param token - QMetry API authentication token
+ * @param baseUrl - QMetry instance base URL (defaults to configured URL)
+ * @param project - Project key to retrieve info for (defaults to configured project)
+ * @returns Promise resolving to project information including viewIds, folders, and configuration
+ */
+export async function getProjectInfo(token, baseUrl, project) {
+    return qmetryRequest({
+        method: "GET",
+        path: QMETRY_PATHS.PROJECT.GET_INFO,
+        token,
+        baseUrl: baseUrl || QMETRY_DEFAULTS.BASE_URL,
+        project: project || QMETRY_DEFAULTS.PROJECT_KEY,
+    });
+}

package/dist/qmetry/client/testcase.js

@@ -0,0 +1,104 @@
+import { QMETRY_DEFAULTS } from "../config/constants.js";
+import { QMETRY_PATHS } from "../config/rest-endpoints.js";
+import { DEFAULT_FETCH_TESTCASE_DETAILS_PAYLOAD, DEFAULT_FETCH_TESTCASE_STEPS_PAYLOAD, DEFAULT_FETCH_TESTCASE_VERSION_DETAILS_PAYLOAD, DEFAULT_FETCH_TESTCASES_PAYLOAD, } from "../types/testcase.js";
+import { qmetryRequest } from "./api/client-api.js";
+function resolveDefaults(baseUrl, project) {
+    return {
+        resolvedBaseUrl: baseUrl || QMETRY_DEFAULTS.BASE_URL,
+        resolvedProject: project || QMETRY_DEFAULTS.PROJECT_KEY,
+    };
+}
+/**
+ * Fetches a list of test cases.
+ * @throws If `viewId` or `folderPath` are missing/invalid.
+ */
+export async function fetchTestCases(token, baseUrl, project, payload) {
+    const { resolvedBaseUrl, resolvedProject } = resolveDefaults(baseUrl, project);
+    const body = {
+        ...DEFAULT_FETCH_TESTCASES_PAYLOAD,
+        ...payload,
+    };
+    if (typeof body.viewId !== "number") {
+        throw new Error("[fetchTestCases] Missing or invalid required parameter: 'viewId'.");
+    }
+    if (typeof body.folderPath !== "string") {
+        throw new Error("[fetchTestCases] Missing or invalid required parameter: 'folderPath'.");
+    }
+    return qmetryRequest({
+        method: "POST",
+        path: QMETRY_PATHS.TESTCASE.GET_TC_LIST,
+        token,
+        project: resolvedProject,
+        baseUrl: resolvedBaseUrl,
+        body,
+    });
+}
+/**
+ * Fetches a test case details.
+ * @throws If `tcID` is missing/invalid.
+ */
+export async function fetchTestCaseDetails(token, baseUrl, project, payload) {
+    const { resolvedBaseUrl, resolvedProject } = resolveDefaults(baseUrl, project);
+    const body = {
+        ...DEFAULT_FETCH_TESTCASE_DETAILS_PAYLOAD,
+        ...payload,
+    };
+    if (typeof body.tcID !== "number") {
+        throw new Error("[fetchTestCaseDetails] Missing or invalid required parameter: 'tcID'.");
+    }
+    return qmetryRequest({
+        method: "POST",
+        path: QMETRY_PATHS.TESTCASE.GET_TC_DETAILS,
+        token,
+        project: resolvedProject,
+        baseUrl: resolvedBaseUrl,
+        body,
+    });
+}
+/**
+ * Fetches a test case details by version.
+ * @throws If `id` is missing/invalid.
+ */
+export async function fetchTestCaseVersionDetails(token, baseUrl, project, payload) {
+    const { resolvedBaseUrl, resolvedProject } = resolveDefaults(baseUrl, project);
+    const body = {
+        ...DEFAULT_FETCH_TESTCASE_VERSION_DETAILS_PAYLOAD,
+        ...payload,
+    };
+    if (!body.id) {
+        throw new Error("[fetchTestCaseVersionDetails] Missing or invalid required parameter: 'id'.");
+    }
+    if (typeof body.version !== "number") {
+        throw new Error("[fetchTestCaseVersionDetails] Missing or invalid required parameter: 'version'.");
+    }
+    return qmetryRequest({
+        method: "POST",
+        path: QMETRY_PATHS.TESTCASE.GET_TC_DETAILS_BY_VERSION,
+        token,
+        project: resolvedProject,
+        baseUrl: resolvedBaseUrl,
+        body,
+    });
+}
+/**
+ * Fetches a test case steps.
+ * @throws If `id` is missing/invalid.
+ */
+export async function fetchTestCaseSteps(token, baseUrl, project, payload) {
+    const { resolvedBaseUrl, resolvedProject } = resolveDefaults(baseUrl, project);
+    const body = {
+        ...DEFAULT_FETCH_TESTCASE_STEPS_PAYLOAD,
+        ...payload,
+    };
+    if (typeof body.id !== "number") {
+        throw new Error("[fetchTestCaseSteps] Missing or invalid required parameter: 'id'.");
+    }
+    return qmetryRequest({
+        method: "POST",
+        path: QMETRY_PATHS.TESTCASE.GET_TC_STEPS,
+        token,
+        project: resolvedProject,
+        baseUrl: resolvedBaseUrl,
+        body,
+    });
+}