@alternative-path/qa-path-mcp 1.0.0

package/dist/api-client.js

@@ -0,0 +1,285 @@
+import axios from "axios";
+import { CookieJar } from "tough-cookie";
+import { wrapper } from "axios-cookiejar-support";
+import { API_URL, API_KEY } from "./constants.js";
+export class ApiClient {
+    client;
+    loginClient; // Separate client for login to bypass interceptor
+    projectId;
+    cookieJar;
+    isAuthenticated = false;
+    userId; // Store user ID after login
+    /** When set, 401 responses trigger one retry via apiTokenLogin then re-request */
+    apiToken;
+    constructor(baseUrl, apiKey) {
+        this.apiToken = apiKey; // API token for api-token-login
+        this.cookieJar = new CookieJar();
+        // Use API root for all requests so paths like /project/getProjects resolve to /api/project/getProjects.
+        // If baseUrl is the auth path (e.g. .../api/auth), normalize to .../api.
+        const baseURL = baseUrl.replace(/\/auth\/?$/, "") || baseUrl;
+        // Create axios instance with cookie jar support (session cookies set by apiTokenLogin)
+        const baseAxiosConfig = {
+            baseURL,
+            timeout: 30000,
+            jar: this.cookieJar,
+            headers: {
+                "Content-Type": "application/json",
+            },
+            withCredentials: true, // Important for session-based auth
+        };
+        this.client = wrapper(axios.create(baseAxiosConfig));
+        // Create a separate client for login that doesn't have the error interceptor
+        // Login returns 403 for invalid credentials, which the interceptor would convert to "Permission denied"
+        this.loginClient = wrapper(axios.create(baseAxiosConfig));
+        // Helper function to get XSRF-TOKEN from cookie jar
+        const getXSRFToken = async (requestUrl) => {
+            try {
+                // Try multiple URL formats to find the cookie
+                const urlsToTry = [];
+                if (requestUrl) {
+                    urlsToTry.push(requestUrl);
+                }
+                // Add base URL variations
+                urlsToTry.push(baseURL);
+                // Try protocol + host only
+                try {
+                    const urlObj = new URL(baseURL);
+                    urlsToTry.push(`${urlObj.protocol}//${urlObj.host}`);
+                    urlsToTry.push(`${urlObj.protocol}//${urlObj.host}/`);
+                }
+                catch (e) {
+                    // Ignore URL parsing errors
+                }
+                // Try each URL until we find the cookie
+                for (const url of urlsToTry) {
+                    try {
+                        const cookies = await this.cookieJar.getCookies(url);
+                        const xsrfCookie = cookies.find((cookie) => cookie.key.toLowerCase() === "xsrf-token");
+                        if (xsrfCookie) {
+                            return xsrfCookie.value;
+                        }
+                    }
+                    catch (e) {
+                        // Continue to next URL
+                        continue;
+                    }
+                }
+                return undefined;
+            }
+            catch (error) {
+                return undefined;
+            }
+        };
+        // Request interceptor to add XSRF-TOKEN header and handle project ID
+        const requestInterceptor = async (config) => {
+            // Ensure headers object exists
+            if (!config.headers) {
+                config.headers = {};
+            }
+            // For POST/PUT/DELETE/PATCH requests, ensure CSRF token is available
+            const method = config.method?.toLowerCase();
+            if (method && !['get', 'head', 'options'].includes(method)) {
+                const requestUrl = config.url ? `${config.baseURL || baseURL}${config.url}` : baseURL;
+                let xsrfToken = await getXSRFToken(requestUrl);
+                if (!xsrfToken) {
+                    try {
+                        await this.client.get("/healthcheck");
+                        await new Promise(resolve => setTimeout(resolve, 100));
+                        xsrfToken = await getXSRFToken(requestUrl);
+                        if (!xsrfToken) {
+                            xsrfToken = await getXSRFToken(baseURL);
+                        }
+                    }
+                    catch (e) {
+                        // Ignore healthcheck errors
+                    }
+                }
+                if (xsrfToken) {
+                    config.headers["X-CSRF-Token"] = xsrfToken;
+                }
+                else {
+                    console.warn(`[ApiClient] CSRF token not found for ${method.toUpperCase()} ${config.url}. Request may fail with CSRF_TOKEN_MISSING error.`);
+                }
+            }
+            else {
+                // For GET requests, try to get token but don't require it
+                const requestUrl = config.url ? `${config.baseURL || baseURL}${config.url}` : baseURL;
+                const xsrfToken = await getXSRFToken(requestUrl);
+                if (xsrfToken) {
+                    config.headers["X-CSRF-Token"] = xsrfToken;
+                }
+            }
+            // Check if x-project-id was explicitly set to null/undefined to remove it
+            if (config.headers["x-project-id"] === null || config.headers["x-project-id"] === undefined) {
+                delete config.headers["x-project-id"];
+            }
+            else if (this.projectId && !config.headers["x-project-id"]) {
+                // Only add project ID if it's not already set and projectId is configured
+                config.headers["x-project-id"] = this.projectId;
+            }
+            return config;
+        };
+        // Add request interceptor to both clients
+        this.client.interceptors.request.use(requestInterceptor);
+        this.loginClient.interceptors.request.use(requestInterceptor);
+        // Add response interceptor for error handling
+        this.client.interceptors.response.use((response) => response, (error) => {
+            if (error.response) {
+                const status = error.response.status;
+                const data = error.response.data;
+                let errorMessage;
+                if (status === 401) {
+                    // One-time retry via api-token-login when API token is configured
+                    const config = error.config;
+                    if (this.apiToken && config && !config._401Retried) {
+                        config._401Retried = true;
+                        return this.apiTokenLogin(this.apiToken)
+                            .then(() => this.client.request(config))
+                            .catch(() => {
+                            throw new Error("Authentication failed. Please check your API key (QA_PATH_API_KEY).");
+                        });
+                    }
+                    throw new Error("Authentication failed. Please check your API key (QA_PATH_API_KEY).");
+                }
+                if (status === 403) {
+                    errorMessage = `Permission denied: ${data?.message || "You don't have permission to perform this action"}`;
+                }
+                else if (status === 404) {
+                    errorMessage = `Resource not found: ${data?.message || "The requested resource does not exist"}`;
+                }
+                else if (status >= 500) {
+                    errorMessage = `Server error: ${data?.error || data?.message || "An internal server error occurred"}`;
+                }
+                else {
+                    errorMessage = data?.error || data?.message || `Request failed with status ${status}`;
+                }
+                // Create error and attach original axios error structure
+                // This allows error mappers to extract status code and response data
+                const customError = new Error(errorMessage);
+                customError.response = error.response;
+                customError.status = status;
+                throw customError;
+            }
+            if (error.request) {
+                throw new Error(`Network error: Unable to connect to the API server. Please check your ${API_URL} and check.`);
+            }
+            throw error;
+        });
+    }
+    setProjectId(projectId) {
+        this.projectId = projectId;
+        this.client.defaults.headers["x-project-id"] = projectId;
+    }
+    getProjectId() {
+        return this.projectId;
+    }
+    /**
+     * Log in using an API token (POST /api/auth/api-token-login).
+     * Session cookies are stored in the cookie jar; subsequent requests use them.
+     */
+    async apiTokenLogin(token) {
+        const t = token?.trim();
+        if (!t) {
+            this.isAuthenticated = false;
+            throw new Error("API token is required for api-token-login.");
+        }
+        try {
+            const baseURL = this.loginClient.defaults.baseURL;
+            const origin = new URL(baseURL).origin;
+            await this.loginClient.get(`${origin}/api/healthcheck`);
+            const response = await this.loginClient.post("auth/api-token-login", undefined, {
+                headers: {
+                    Authorization: `Bearer ${t}`,
+                },
+            });
+            this.isAuthenticated = true;
+            this.userId = response.data.data?.user?.id;
+            return response.data;
+        }
+        catch (error) {
+            this.isAuthenticated = false;
+            if (error.response) {
+                const status = error.response.status;
+                const data = error.response.data;
+                if (status === 401) {
+                    throw new Error(data?.message || `Invalid or expired token. Please check ${API_KEY}.`);
+                }
+                throw new Error(data?.message || data?.error || `api-token-login failed with status ${status}`);
+            }
+            throw error;
+        }
+    }
+    getIsAuthenticated() {
+        return this.isAuthenticated;
+    }
+    /**
+     * Get cookie header string for a given URL (and optionally the API base URL).
+     * Used to forward session cookies to the automation agent WebSocket.
+     */
+    async getCookieStringForUrl(url) {
+        const urlsToTry = [url];
+        const baseUrl = this.client.defaults.baseURL;
+        if (baseUrl && !urlsToTry.includes(baseUrl)) {
+            urlsToTry.push(baseUrl);
+            try {
+                const u = new URL(baseUrl);
+                urlsToTry.push(`${u.protocol}//${u.host}`);
+            }
+            catch (_) { }
+        }
+        const seen = new Set();
+        const parts = [];
+        for (const u of urlsToTry) {
+            try {
+                const cookies = await this.cookieJar.getCookies(u);
+                if (Array.isArray(cookies)) {
+                    for (const c of cookies) {
+                        if (c && typeof c.key === "string" && !seen.has(c.key)) {
+                            seen.add(c.key);
+                            parts.push(`${c.key}=${c.value || ""}`);
+                        }
+                    }
+                }
+            }
+            catch (_) {
+                continue;
+            }
+        }
+        return parts.join("; ");
+    }
+    getUserId() {
+        return this.userId;
+    }
+    async get(url, config) {
+        const response = await this.client.get(url, config);
+        return response.data;
+    }
+    async post(url, data, config) {
+        const response = await this.client.post(url, data, config);
+        return response.data;
+    }
+    async put(url, data, config) {
+        const response = await this.client.put(url, data, config);
+        return response.data;
+    }
+    async patch(url, data, config) {
+        const response = await this.client.patch(url, data, config);
+        return response.data;
+    }
+    async delete(url, config) {
+        const response = await this.client.delete(url, config);
+        return response.data;
+    }
+    // Helper for file uploads
+    async postFormData(url, formData, config) {
+        const response = await this.client.post(url, formData, {
+            ...config,
+            headers: {
+                ...config?.headers,
+                "Content-Type": "multipart/form-data",
+            },
+        });
+        return response.data;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Environment variable names for QA Path MCP server.
+ * Only the required/primary vars are centralized; optional ones are inlined where used.
+ */
+export declare const API_URL: string;
+export declare const API_KEY: string | undefined;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO,QAAkE,CAAC;AAEvF,eAAO,MAAM,OAAO,oBAA8B,CAAC"}

package/dist/constants.js

@@ -0,0 +1,7 @@
+/**
+ * Environment variable names for QA Path MCP server.
+ * Only the required/primary vars are centralized; optional ones are inlined where used.
+ */
+export const API_URL = process.env.QA_PATH_API_URL || "http://localhost:3000/api/auth";
+export const API_KEY = process.env.QA_PATH_API_KEY;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,gCAAgC,CAAC;AAEvF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { ApiClient } from "./api-client.js";
+import { getTestPlannerPromptDefinition, getTestPlannerMessages, X_TEST_PLANNER_NAME, } from "./agents/test-planner-prompt.js";
+import { ModuleTools } from "./tools/module-tools.js";
+import { TestCaseTools } from "./tools/testcase-tools.js";
+import { ExportImportTools } from "./tools/export-import-tools.js";
+import { ProjectTools } from "./tools/project-tools.js";
+import { AuthTools } from "./tools/auth-tools.js";
+import { AutomationTools } from "./tools/automation-tools.js";
+import { TestGroupLaunchTools } from "./tools/testgroup-launch-tools.js";
+import { QueryTools } from "./tools/query-tools.js";
+import { ProjectContextTools } from "./tools/project-context-tools.js";
+import { ProjectContextService } from "./services/project-context-service.js";
+import { API_URL, API_KEY } from "./constants.js";
+class QAPathServer {
+    server;
+    apiClient;
+    projectContext;
+    moduleTools;
+    testCaseTools;
+    exportImportTools;
+    projectTools;
+    authTools;
+    automationTools;
+    testGroupLaunchTools;
+    queryTools;
+    projectContextTools;
+    apiKey;
+    constructor() {
+        this.server = new Server({
+            name: "qa-path",
+            version: "1.0.0",
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                prompts: {},
+            },
+        });
+        const apiBaseUrl = API_URL;
+        this.apiKey = API_KEY;
+        if (!apiBaseUrl) {
+            throw new Error(`${API_URL} environment variable is required`);
+        }
+        // Initialize API client (project will be set via set_active_project or QA_PATH_PROJECT_ID)
+        this.apiClient = new ApiClient(apiBaseUrl, this.apiKey);
+        // Initialize project context service
+        this.projectContext = new ProjectContextService();
+        // Initialize tools (pass projectContext to tools that need it)
+        this.projectContextTools = new ProjectContextTools(this.apiClient, this.projectContext);
+        this.moduleTools = new ModuleTools(this.apiClient, this.projectContext);
+        this.testCaseTools = new TestCaseTools(this.apiClient, this.projectContext);
+        this.exportImportTools = new ExportImportTools(this.apiClient, this.projectContext);
+        this.projectTools = new ProjectTools(this.apiClient);
+        this.authTools = new AuthTools(this.apiClient);
+        this.automationTools = new AutomationTools(this.apiClient, this.projectContext);
+        this.testGroupLaunchTools = new TestGroupLaunchTools(this.apiClient, this.projectContext);
+        this.queryTools = new QueryTools(this.apiClient, this.projectContext);
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    ...this.authTools.getTools(),
+                    ...this.projectContextTools.getTools(),
+                    ...this.moduleTools.getTools(),
+                    ...this.testCaseTools.getTools(),
+                    // ...this.exportImportTools.getTools(), // export tool commented out
+                    ...this.projectTools.getTools(),
+                    ...this.automationTools.getTools(),
+                    ...this.testGroupLaunchTools.getTools(),
+                    ...this.queryTools.getTools(),
+                ],
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                // Route to appropriate tool handler
+                if (this.authTools.handles(name)) {
+                    return await this.authTools.handle(name, args);
+                }
+                if (this.projectContextTools.handles(name)) {
+                    return await this.projectContextTools.handle(name, args);
+                }
+                if (this.moduleTools.handles(name)) {
+                    return await this.moduleTools.handle(name, args);
+                }
+                if (this.testCaseTools.handles(name)) {
+                    return await this.testCaseTools.handle(name, args);
+                }
+                // if (this.exportImportTools.handles(name)) {
+                //   return await this.exportImportTools.handle(name, args);
+                // }
+                if (this.projectTools.handles(name)) {
+                    return await this.projectTools.handle(name, args);
+                }
+                if (this.automationTools.handles(name)) {
+                    return await this.automationTools.handle(name, args);
+                }
+                if (this.testGroupLaunchTools.handles(name)) {
+                    return await this.testGroupLaunchTools.handle(name, args);
+                }
+                if (this.queryTools.handles(name)) {
+                    return await this.queryTools.handle(name, args);
+                }
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            catch (error) {
+                // Format error message to be more actionable for AI
+                const errorMessage = error.message || String(error);
+                // If error contains ACTION_REQUIRED or WORKFLOW markers, preserve them
+                // These help the AI understand what steps to take
+                const formattedError = errorMessage.includes("ACTION_REQUIRED") || errorMessage.includes("WORKFLOW")
+                    ? errorMessage
+                    : `Error: ${errorMessage}`;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: formattedError,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // List resources (optional - for future use)
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            return {
+                resources: [],
+            };
+        });
+        // List prompts (x-test-planner agent)
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            return {
+                prompts: [getTestPlannerPromptDefinition()],
+            };
+        });
+        // Get prompt (x-test-planner agent)
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            if (name !== X_TEST_PLANNER_NAME) {
+                throw new Error(`Unknown prompt: ${name}`);
+            }
+            return getTestPlannerMessages(args);
+        });
+    }
+    async ensureAuth() {
+        if (!this.apiKey?.trim()) {
+            throw new Error(`${API_KEY} is required.`);
+        }
+        await this.apiClient.apiTokenLogin(this.apiKey);
+        console.error("QA-Path: API token login successful");
+    }
+    async run() {
+        await this.ensureAuth();
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error("QA-Path server running on stdio");
+    }
+}
+// Start the server
+const server = new QAPathServer();
+server.run().catch((error) => {
+    console.error("Fatal error in QA-Path server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/services/project-context-service.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Service for managing active project context
+ * Maintains the active project ID that persists for the lifetime of the MCP server process
+ */
+export declare class ProjectContextService {
+    private activeProjectId?;
+    setActiveProjectId(projectId: string): void;
+    getActiveProjectId(): string | undefined;
+    /**
+     * Resolve project ID from args or active project
+     * Throws error if neither is available with actionable guidance for the AI
+     */
+    resolveProjectId(args: any, toolName: string): string;
+}
+//# sourceMappingURL=project-context-service.d.ts.map

package/dist/services/project-context-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-service.d.ts","sourceRoot":"","sources":["../../src/services/project-context-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,eAAe,CAAC,CAAS;IAEjC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C,kBAAkB,IAAI,MAAM,GAAG,SAAS;IAIxC;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAuBtD"}

package/dist/services/project-context-service.js

@@ -0,0 +1,36 @@
+/**
+ * Service for managing active project context
+ * Maintains the active project ID that persists for the lifetime of the MCP server process
+ */
+export class ProjectContextService {
+    activeProjectId;
+    setActiveProjectId(projectId) {
+        this.activeProjectId = projectId;
+    }
+    getActiveProjectId() {
+        return this.activeProjectId;
+    }
+    /**
+     * Resolve project ID from args or active project
+     * Throws error if neither is available with actionable guidance for the AI
+     */
+    resolveProjectId(args, toolName) {
+        const argProjectId = args?.projectId;
+        const activeProjectId = this.activeProjectId;
+        if (argProjectId) {
+            return argProjectId; // Explicit projectId takes precedence
+        }
+        if (activeProjectId) {
+            return activeProjectId; // Use active project
+        }
+        // Enhanced error message that guides the AI to ask the user
+        throw new Error(`PROJECT_ID_REQUIRED: A project ID is required to use ${toolName}. ` +
+            `ACTION_REQUIRED: You need to either:\n` +
+            `1. Ask the user which project they want to use, then call 'list_projects' to show available projects, ` +
+            `   and once the user selects a project (by name), extract the projectId (UUID) from the list_projects response ` +
+            `   and call 'set_active_project' with that projectId, OR\n` +
+            `2. If the user provides a projectId (UUID) directly, use it as the 'projectId' parameter in this tool call.\n` +
+            `WORKFLOW: The recommended flow is: list_projects → ask user to select (by name) → extract projectId from response → set_active_project → retry original operation.`);
+    }
+}
+//# sourceMappingURL=project-context-service.js.map

package/dist/services/project-context-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context-service.js","sourceRoot":"","sources":["../../src/services/project-context-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACxB,eAAe,CAAU;IAEjC,kBAAkB,CAAC,SAAiB;QAClC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;IACnC,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,IAAS,EAAE,QAAgB;QAC1C,MAAM,YAAY,GAAG,IAAI,EAAE,SAAS,CAAC;QACrC,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QAE7C,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC,CAAC,sCAAsC;QAC7D,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,eAAe,CAAC,CAAC,qBAAqB;QAC/C,CAAC;QAED,4DAA4D;QAC5D,MAAM,IAAI,KAAK,CACb,wDAAwD,QAAQ,IAAI;YACpE,wCAAwC;YACxC,wGAAwG;YACxG,iHAAiH;YACjH,4DAA4D;YAC5D,+GAA+G;YAC/G,oKAAoK,CACrK,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/auth-tools.d.ts

@@ -0,0 +1,16 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ApiClient } from "../api-client.js";
+export declare class AuthTools {
+    private apiClient;
+    constructor(apiClient: ApiClient);
+    getTools(): Tool[];
+    handles(name: string): boolean;
+    handle(name: string, args: any): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    private checkAuthStatus;
+}
+//# sourceMappingURL=auth-tools.d.ts.map

package/dist/tools/auth-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-tools.d.ts","sourceRoot":"","sources":["../../src/tools/auth-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,qBAAa,SAAS;IACR,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAExC,QAAQ,IAAI,IAAI,EAAE;IAclB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;;;;;;YAOtB,eAAe;CAoD9B"}