@qase/mcp-server 1.0.0-beta.1

package/build/utils/errors.js

@@ -0,0 +1,136 @@
+/**
+ * Error Handling Utilities
+ *
+ * Provides comprehensive error handling for Qase API interactions:
+ * - Custom error classes
+ * - Error formatting with user-friendly messages
+ * - Type guards for specific error types
+ * - Integration with neverthrow Result type
+ */
+import { AxiosError } from 'axios';
+import { ResultAsync } from 'neverthrow';
+/**
+ * Custom error class for Qase API errors
+ */
+export class QaseApiError extends Error {
+    statusCode;
+    errorCode;
+    details;
+    constructor(message, statusCode, errorCode, details) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.details = details;
+        this.name = 'QaseApiError';
+        Object.setPrototypeOf(this, QaseApiError.prototype);
+    }
+}
+/**
+ * Format API error into a user-friendly message
+ *
+ * @param error - The error to format
+ * @returns Formatted error message
+ */
+export function formatApiError(error) {
+    // Handle Axios errors (most common from API calls)
+    const axiosError = error;
+    if (axiosError.isAxiosError || error instanceof AxiosError) {
+        const status = axiosError.response?.status;
+        const data = axiosError.response?.data;
+        const message = data?.errorMessage || data?.message || axiosError.message;
+        // Format based on HTTP status code
+        switch (status) {
+            case 401:
+                return `Authentication failed: ${message}. Please check your QASE_API_TOKEN environment variable.`;
+            case 403:
+                return `Access forbidden: ${message}. You don't have permission to perform this action.`;
+            case 404:
+                return `Resource not found: ${message}`;
+            case 400:
+                return `Invalid request: ${message}`;
+            case 422:
+                return `Validation error: ${message}`;
+            case 429:
+                return `Rate limit exceeded: ${message}. Please try again later.`;
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                return `Qase API server error: ${message}. Please try again later.`;
+            default:
+                return message || 'Unknown API error occurred';
+        }
+    }
+    // Handle QaseApiError
+    if (error instanceof QaseApiError) {
+        return error.message;
+    }
+    // Handle generic Error
+    if (error instanceof Error) {
+        return error.message;
+    }
+    // Handle unknown error types
+    return String(error);
+}
+/**
+ * Type guard to check if an error is an authentication error (401)
+ *
+ * @param error - The error to check
+ * @returns True if the error is a 401 authentication error
+ */
+export function isAuthenticationError(error) {
+    const axiosError = error;
+    return ((axiosError.isAxiosError || error instanceof AxiosError) && axiosError.response?.status === 401);
+}
+/**
+ * Type guard to check if an error is a not found error (404)
+ *
+ * @param error - The error to check
+ * @returns True if the error is a 404 not found error
+ */
+export function isNotFoundError(error) {
+    const axiosError = error;
+    return ((axiosError.isAxiosError || error instanceof AxiosError) && axiosError.response?.status === 404);
+}
+/**
+ * Type guard to check if an error is a validation error (400 or 422)
+ *
+ * @param error - The error to check
+ * @returns True if the error is a validation error
+ */
+export function isValidationError(error) {
+    const axiosError = error;
+    return ((axiosError.isAxiosError || error instanceof AxiosError) &&
+        (axiosError.response?.status === 400 || axiosError.response?.status === 422));
+}
+/**
+ * Type guard to check if an error is a rate limit error (429)
+ *
+ * @param error - The error to check
+ * @returns True if the error is a rate limit error
+ */
+export function isRateLimitError(error) {
+    const axiosError = error;
+    return ((axiosError.isAxiosError || error instanceof AxiosError) && axiosError.response?.status === 429);
+}
+/**
+ * Helper to wrap promises in neverthrow Result type
+ *
+ * Converts Promise<T> to ResultAsync<T, string> with formatted error messages
+ *
+ * @param promise - The promise to wrap
+ * @returns ResultAsync with formatted error on rejection
+ *
+ * @example
+ * ```typescript
+ * const result = await toResultAsync(apiClient.projects.getProjects());
+ * result.match(
+ *   (projects) => console.log(projects),
+ *   (error) => console.error(error)
+ * );
+ * ```
+ */
+export function toResultAsync(promise) {
+    return ResultAsync.fromPromise(promise, formatApiError);
+}
+//# sourceMappingURL=errors.js.map

package/build/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"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"}

package/build/utils/qql-helpers.d.ts

@@ -0,0 +1,59 @@
+/**
+ * QQL Helper Utilities
+ *
+ * Provides common QQL query patterns and builders for Qase Query Language.
+ */
+/**
+ * Common QQL entity types
+ */
+export declare enum QqlEntity {
+    Case = "case",
+    Defect = "defect",
+    Run = "run",
+    Result = "result",
+    Plan = "plan",
+    Requirement = "requirement"
+}
+/**
+ * QQL query builder for common patterns
+ */
+export declare class QqlQueryBuilder {
+    private parts;
+    /**
+     * Set entity type
+     */
+    entity(entityType: QqlEntity): this;
+    /**
+     * Filter by project
+     */
+    project(projectCode: string): this;
+    /**
+     * Filter by multiple projects
+     */
+    projects(projectCodes: string[]): this;
+    /**
+     * Add custom condition
+     */
+    where(condition: string): this;
+    /**
+     * Order by field
+     */
+    orderBy(field: string, direction?: 'ASC' | 'DESC'): this;
+    /**
+     * Build the final query string
+     */
+    build(): string;
+}
+/**
+ * Common QQL query examples
+ */
+export declare const QqlExamples: {
+    recentFailures: (projectCode: string) => string;
+    blockerDefects: (projectCode: string) => string;
+    flakyTests: (projectCode: string) => string;
+    notAutomated: (projectCode: string) => string;
+    byAuthor: (projectCode: string, author: string) => string;
+    activeRuns: (projectCode: string) => string;
+    byMilestone: (projectCode: string, milestone: string) => string;
+};
+//# sourceMappingURL=qql-helpers.d.ts.map

package/build/utils/qql-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qql-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/qql-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAgB;IAE7B;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,SAAS,GAAG,IAAI;IAKnC;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAMtC;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAK/D;;OAEG;IACH,KAAK,IAAI,MAAM;CAGhB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;kCAEQ,MAAM;kCAIN,MAAM;8BAIV,MAAM;gCAIJ,MAAM;4BAIV,MAAM,UAAU,MAAM;8BAIpB,MAAM;+BAIL,MAAM,aAAa,MAAM;CAErD,CAAC"}

package/build/utils/qql-helpers.js

@@ -0,0 +1,85 @@
+/**
+ * QQL Helper Utilities
+ *
+ * Provides common QQL query patterns and builders for Qase Query Language.
+ */
+/**
+ * Common QQL entity types
+ */
+export var QqlEntity;
+(function (QqlEntity) {
+    QqlEntity["Case"] = "case";
+    QqlEntity["Defect"] = "defect";
+    QqlEntity["Run"] = "run";
+    QqlEntity["Result"] = "result";
+    QqlEntity["Plan"] = "plan";
+    QqlEntity["Requirement"] = "requirement";
+})(QqlEntity || (QqlEntity = {}));
+/**
+ * QQL query builder for common patterns
+ */
+export class QqlQueryBuilder {
+    parts = [];
+    /**
+     * Set entity type
+     */
+    entity(entityType) {
+        this.parts.push(`entity = "${entityType}"`);
+        return this;
+    }
+    /**
+     * Filter by project
+     */
+    project(projectCode) {
+        this.parts.push(`project = "${projectCode}"`);
+        return this;
+    }
+    /**
+     * Filter by multiple projects
+     */
+    projects(projectCodes) {
+        const codes = projectCodes.map((c) => `"${c}"`).join(', ');
+        this.parts.push(`project in [${codes}]`);
+        return this;
+    }
+    /**
+     * Add custom condition
+     */
+    where(condition) {
+        this.parts.push(`(${condition})`);
+        return this;
+    }
+    /**
+     * Order by field
+     */
+    orderBy(field, direction = 'ASC') {
+        this.parts.push(`ORDER BY ${field} ${direction}`);
+        return this;
+    }
+    /**
+     * Build the final query string
+     */
+    build() {
+        return this.parts.join(' and ');
+    }
+}
+/**
+ * Common QQL query examples
+ */
+export const QqlExamples = {
+    // Find all failed test results in last 7 days
+    recentFailures: (projectCode) => `entity = "result" and project = "${projectCode}" and status = "failed" and created >= now("-7d")`,
+    // Find all open blocker defects
+    blockerDefects: (projectCode) => `entity = "defect" and project = "${projectCode}" and severity = "blocker" and status = "open"`,
+    // Find all flaky test cases
+    flakyTests: (projectCode) => `entity = "case" and project = "${projectCode}" and isFlaky = true`,
+    // Find all active test cases not automated
+    notAutomated: (projectCode) => `entity = "case" and project = "${projectCode}" and automation = "Not automated" and status = "Actual"`,
+    // Find test cases created by specific author
+    byAuthor: (projectCode, author) => `entity = "case" and project = "${projectCode}" and author = "${author}"`,
+    // Find test runs in progress
+    activeRuns: (projectCode) => `entity = "run" and project = "${projectCode}" and isStarted = true and isEnded = false`,
+    // Find cases in specific milestone
+    byMilestone: (projectCode, milestone) => `entity = "case" and project = "${projectCode}" and milestone ~ "${milestone}"`,
+};
+//# sourceMappingURL=qql-helpers.js.map

package/build/utils/qql-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qql-helpers.js","sourceRoot":"","sources":["../../src/utils/qql-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,0BAAa,CAAA;IACb,8BAAiB,CAAA;IACjB,wBAAW,CAAA;IACX,8BAAiB,CAAA;IACjB,0BAAa,CAAA;IACb,wCAA2B,CAAA;AAC7B,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,KAAK,GAAa,EAAE,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,UAAqB;QAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,UAAU,GAAG,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,WAAmB;QACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,GAAG,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,YAAsB;QAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,GAAG,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAiB;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa,EAAE,YAA4B,KAAK;QACtD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,8CAA8C;IAC9C,cAAc,EAAE,CAAC,WAAmB,EAAE,EAAE,CACtC,oCAAoC,WAAW,mDAAmD;IAEpG,gCAAgC;IAChC,cAAc,EAAE,CAAC,WAAmB,EAAE,EAAE,CACtC,oCAAoC,WAAW,gDAAgD;IAEjG,4BAA4B;IAC5B,UAAU,EAAE,CAAC,WAAmB,EAAE,EAAE,CAClC,kCAAkC,WAAW,sBAAsB;IAErE,2CAA2C;IAC3C,YAAY,EAAE,CAAC,WAAmB,EAAE,EAAE,CACpC,kCAAkC,WAAW,0DAA0D;IAEzG,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,WAAmB,EAAE,MAAc,EAAE,EAAE,CAChD,kCAAkC,WAAW,mBAAmB,MAAM,GAAG;IAE3E,6BAA6B;IAC7B,UAAU,EAAE,CAAC,WAAmB,EAAE,EAAE,CAClC,iCAAiC,WAAW,4CAA4C;IAE1F,mCAAmC;IACnC,WAAW,EAAE,CAAC,WAAmB,EAAE,SAAiB,EAAE,EAAE,CACtD,kCAAkC,WAAW,sBAAsB,SAAS,GAAG;CAClF,CAAC"}

package/build/utils/registry.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Tool Registry System
+ *
+ * Centralized system for managing MCP tool registration:
+ * - Register tools with Zod schemas
+ * - Convert Zod schemas to JSON Schema automatically
+ * - Store and retrieve tool handlers
+ * - Manage tool lifecycle
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+/**
+ * Tool handler function type
+ * Handlers receive validated arguments and return a promise
+ */
+export type ToolHandler<T = any, R = any> = (args: T) => Promise<R>;
+/**
+ * Tool definition for registration
+ * Contains all information needed to register a tool with the MCP server
+ */
+export interface ToolDefinition<T extends z.ZodType = z.ZodType> {
+    name: string;
+    description: string;
+    schema: T;
+    handler: ToolHandler;
+}
+/**
+ * Tool Registry Class
+ * Manages the lifecycle of MCP tools
+ */
+export declare class ToolRegistry {
+    private tools;
+    private handlers;
+    /**
+     * Register a new tool with the registry
+     *
+     * @param definition - Tool definition including name, description, schema, and handler
+     *
+     * @example
+     * ```typescript
+     * toolRegistry.register({
+     *   name: 'list_projects',
+     *   description: 'Get all projects',
+     *   schema: z.object({ limit: z.number().optional() }),
+     *   handler: async (args) => { ... }
+     * });
+     * ```
+     */
+    register<T extends z.ZodType>(definition: ToolDefinition<T>): void;
+    /**
+     * Get all registered tools
+     * Used by the ListToolsRequestSchema handler
+     *
+     * @returns Array of all registered tools
+     */
+    getTools(): Tool[];
+    /**
+     * Get handler function for a specific tool
+     *
+     * @param name - Tool name
+     * @returns Handler function or undefined if not found
+     */
+    getHandler(name: string): ToolHandler | undefined;
+    /**
+     * Check if a tool exists in the registry
+     *
+     * @param name - Tool name
+     * @returns True if tool is registered
+     */
+    hasTool(name: string): boolean;
+    /**
+     * Get the count of registered tools
+     *
+     * @returns Number of registered tools
+     */
+    getToolCount(): number;
+    /**
+     * Unregister a tool (useful for testing)
+     *
+     * @param name - Tool name to unregister
+     * @returns True if tool was removed, false if not found
+     * @internal
+     */
+    unregister(name: string): boolean;
+    /**
+     * Clear all registered tools (useful for testing)
+     *
+     * @internal
+     */
+    clear(): void;
+}
+/**
+ * Global tool registry instance
+ * Import and use this instance across all operation modules
+ */
+export declare const toolRegistry: ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/build/utils/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IA0ClE;;;;;OAKG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMjC;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/build/utils/registry.js

@@ -0,0 +1,132 @@
+/**
+ * Tool Registry System
+ *
+ * Centralized system for managing MCP tool registration:
+ * - Register tools with Zod schemas
+ * - Convert Zod schemas to JSON Schema automatically
+ * - Store and retrieve tool handlers
+ * - Manage tool lifecycle
+ */
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Tool Registry Class
+ * Manages the lifecycle of MCP tools
+ */
+export class ToolRegistry {
+    tools = new Map();
+    handlers = new Map();
+    /**
+     * Register a new tool with the registry
+     *
+     * @param definition - Tool definition including name, description, schema, and handler
+     *
+     * @example
+     * ```typescript
+     * toolRegistry.register({
+     *   name: 'list_projects',
+     *   description: 'Get all projects',
+     *   schema: z.object({ limit: z.number().optional() }),
+     *   handler: async (args) => { ... }
+     * });
+     * ```
+     */
+    register(definition) {
+        const { name, description, schema, handler } = definition;
+        // Convert Zod schema to JSON Schema for MCP protocol
+        const jsonSchema = zodToJsonSchema(schema, {
+            name: `${name}Input`,
+            $refStrategy: 'none', // Inline all definitions
+        });
+        // Extract the actual schema from definitions if present
+        // zodToJsonSchema sometimes wraps the schema in a $ref even with $refStrategy: 'none'
+        let inputSchema;
+        if (jsonSchema.$ref && jsonSchema.definitions) {
+            // Extract from definitions
+            const definitionKey = Object.keys(jsonSchema.definitions)[0];
+            inputSchema = jsonSchema.definitions[definitionKey];
+        }
+        else if (jsonSchema.type === 'object') {
+            // Use directly
+            inputSchema = jsonSchema;
+        }
+        else {
+            // Fallback: create minimal object schema
+            inputSchema = {
+                type: 'object',
+                properties: {},
+            };
+        }
+        // Store tool definition
+        this.tools.set(name, {
+            name,
+            description,
+            inputSchema,
+        });
+        // Store handler function
+        this.handlers.set(name, handler);
+        // Log registration for debugging (to stderr)
+        console.error(`[Registry] Registered tool: ${name}`);
+    }
+    /**
+     * Get all registered tools
+     * Used by the ListToolsRequestSchema handler
+     *
+     * @returns Array of all registered tools
+     */
+    getTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get handler function for a specific tool
+     *
+     * @param name - Tool name
+     * @returns Handler function or undefined if not found
+     */
+    getHandler(name) {
+        return this.handlers.get(name);
+    }
+    /**
+     * Check if a tool exists in the registry
+     *
+     * @param name - Tool name
+     * @returns True if tool is registered
+     */
+    hasTool(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get the count of registered tools
+     *
+     * @returns Number of registered tools
+     */
+    getToolCount() {
+        return this.tools.size;
+    }
+    /**
+     * Unregister a tool (useful for testing)
+     *
+     * @param name - Tool name to unregister
+     * @returns True if tool was removed, false if not found
+     * @internal
+     */
+    unregister(name) {
+        const hadTool = this.tools.delete(name);
+        this.handlers.delete(name);
+        return hadTool;
+    }
+    /**
+     * Clear all registered tools (useful for testing)
+     *
+     * @internal
+     */
+    clear() {
+        this.tools.clear();
+        this.handlers.clear();
+    }
+}
+/**
+ * Global tool registry instance
+ * Import and use this instance across all operation modules
+ */
+export const toolRegistry = new ToolRegistry();
+//# sourceMappingURL=registry.js.map

package/build/utils/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/utils/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAoBrD;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IACrC,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEvD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAsB,UAA6B;QACzD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;QAE1D,qDAAqD;QACrD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE;YACzC,IAAI,EAAE,GAAG,IAAI,OAAO;YACpB,YAAY,EAAE,MAAM,EAAE,yBAAyB;SAChD,CAAQ,CAAC;QAEV,wDAAwD;QACxD,sFAAsF;QACtF,IAAI,WAAuD,CAAC;QAE5D,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC9C,2BAA2B;YAC3B,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7D,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,aAAa,CAA+C,CAAC;QACpG,CAAC;aAAM,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxC,eAAe;YACf,WAAW,GAAG,UAAU,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,yCAAyC;YACzC,WAAW,GAAG;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;aACf,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE;YACnB,IAAI;YACJ,WAAW;YACX,WAAW;SACZ,CAAC,CAAC;QAEH,yBAAyB;QACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEjC,6CAA6C;QAC7C,OAAO,CAAC,KAAK,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,IAAY;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC"}

package/build/utils/test-helpers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Test Helper Utilities
+ *
+ * Provides mock objects and helper functions for testing.
+ */
+import { QaseApi } from 'qaseio';
+/**
+ * Mock successful API response
+ */
+export declare function mockApiSuccess<T>(data: T): Promise<{
+    data: {
+        status: boolean;
+        result: T;
+    };
+}>;
+/**
+ * Mock API error response
+ */
+export declare function mockApiError(statusCode: number, message: string): Promise<never>;
+/**
+ * Set environment variables for testing
+ */
+export declare function setTestEnv(): void;
+/**
+ * Clear environment variables
+ */
+export declare function clearTestEnv(): void;
+/**
+ * Create mock API client for testing
+ */
+export declare function createMockApiClient(): jest.Mocked<Partial<QaseApi>>;
+//# sourceMappingURL=test-helpers.d.ts.map

package/build/utils/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;;;;;GAOxC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAS/D;AAED;;GAEG;AACH,wBAAgB,UAAU,SAGzB;AAED;;GAEG;AACH,wBAAgB,YAAY,SAG3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAiCnE"}

package/build/utils/test-helpers.js

@@ -0,0 +1,81 @@
+/**
+ * Test Helper Utilities
+ *
+ * Provides mock objects and helper functions for testing.
+ */
+/**
+ * Mock successful API response
+ */
+export function mockApiSuccess(data) {
+    return Promise.resolve({
+        data: {
+            status: true,
+            result: data,
+        },
+    });
+}
+/**
+ * Mock API error response
+ */
+export function mockApiError(statusCode, message) {
+    const error = new Error(message);
+    error.response = {
+        status: statusCode,
+        data: {
+            errorMessage: message,
+        },
+    };
+    return Promise.reject(error);
+}
+/**
+ * Set environment variables for testing
+ */
+export function setTestEnv() {
+    process.env.QASE_API_TOKEN = 'test-token-123';
+    process.env.QASE_API_DOMAIN = 'api.qase.io';
+}
+/**
+ * Clear environment variables
+ */
+export function clearTestEnv() {
+    delete process.env.QASE_API_TOKEN;
+    delete process.env.QASE_API_DOMAIN;
+}
+/**
+ * Create mock API client for testing
+ */
+export function createMockApiClient() {
+    return {
+        projects: {
+            getProjects: jest.fn(),
+            getProject: jest.fn(),
+            createProject: jest.fn(),
+            deleteProject: jest.fn(),
+            grantAccess: jest.fn(),
+            revokeAccess: jest.fn(),
+        },
+        cases: {
+            getCases: jest.fn(),
+            getCase: jest.fn(),
+            createCase: jest.fn(),
+            updateCase: jest.fn(),
+            deleteCase: jest.fn(),
+            bulkCreateCases: jest.fn(),
+        },
+        suites: {
+            getSuites: jest.fn(),
+            getSuite: jest.fn(),
+            createSuite: jest.fn(),
+            updateSuite: jest.fn(),
+            deleteSuite: jest.fn(),
+        },
+        runs: {
+            getRuns: jest.fn(),
+            getRun: jest.fn(),
+            createRun: jest.fn(),
+            deleteRun: jest.fn(),
+            completeRun: jest.fn(),
+        },
+    };
+}
+//# sourceMappingURL=test-helpers.js.map

package/build/utils/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/utils/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAI,IAAO;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,EAAE;YACJ,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,IAAI;SACb;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,OAAe;IAC9D,MAAM,KAAK,GAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,KAAK,CAAC,QAAQ,GAAG;QACf,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE;YACJ,YAAY,EAAE,OAAO;SACtB;KACF,CAAC;IACF,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,gBAAgB,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,aAAa,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,QAAQ,EAAE;YACR,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;YACtB,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE;YACxB,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE;YACxB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;YACtB,YAAY,EAAE,IAAI,CAAC,EAAE,EAAE;SACjB;QACR,KAAK,EAAE;YACL,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;YACnB,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;YAClB,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE;YACrB,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE;SACpB;QACR,MAAM,EAAE;YACN,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;YACpB,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE;YACnB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;YACtB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;YACtB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;SAChB;QACR,IAAI,EAAE;YACJ,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;YAClB,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;YACpB,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE;YACpB,WAAW,EAAE,IAAI,CAAC,EAAE,EAAE;SAChB;KACF,CAAC;AACX,CAAC"}