@modyo/mcp 0.1.0 → 0.1.2

package/build/shared/helpers/deprecation.d.ts

@@ -1,76 +0,0 @@
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-/**
- * Metadata about a deprecated tool
- */
-export interface DeprecationMetadata {
-    /** Version when this tool was deprecated (e.g., "2.0.0") */
-    since: string;
-    /** Name of the replacement tool */
-    replacement: string;
-    /** Brief example of how to use the replacement */
-    example: string;
-    /** Version when this tool will be removed (e.g., "3.0.0") */
-    removalVersion: string;
-    /** URL to migration documentation */
-    documentationUrl: string;
-}
-/**
- * Logs a deprecation warning to console when a deprecated tool is used
- *
- * @param toolName - Name of the deprecated tool
- * @param metadata - Deprecation metadata
- *
- * @example
- * ```typescript
- * logDeprecationWarning("entry-create", {
- *   since: "2.0.0",
- *   replacement: "entries-manage",
- *   example: "Use entries-manage with action='manage' and entry creation fields",
- *   removalVersion: "3.0.0",
- *   documentationUrl: "modyo://docs/migration/entries#create"
- * });
- * ```
- */
-export declare function logDeprecationWarning(toolName: string, metadata: DeprecationMetadata): void;
-/**
- * Creates a CallToolResult with deprecation metadata included
- *
- * @param content - The actual tool response data
- * @param metadata - Deprecation metadata to include
- * @returns CallToolResult with _meta field containing deprecation info
- *
- * @example
- * ```typescript
- * const result = await this.repository.create(params);
- * return createDeprecationResponse(result, this.deprecationMetadata);
- * ```
- */
-export declare function createDeprecationResponse(content: unknown, metadata: DeprecationMetadata): CallToolResult;
-/**
- * Class decorator to mark a tool as deprecated
- *
- * Automatically adds deprecation metadata to the tool's config and ensures
- * the tool logs warnings when used.
- *
- * @param metadata - Deprecation metadata
- * @returns Class decorator function
- *
- * @example
- * ```typescript
- * @markAsDeprecated({
- *   since: "2.0.0",
- *   replacement: "entries-manage",
- *   example: "Use entries-manage with action='manage'",
- *   removalVersion: "3.0.0",
- *   documentationUrl: "modyo://docs/migration/entries#create"
- * })
- * export class EntryCreateTool extends ToolBase<ParamsSchema> {
- *   protected config = {
- *     name: "entry-create",
- *     description: "Creates a new entry",
- *   };
- * }
- * ```
- */
-export declare function markAsDeprecated(metadata: DeprecationMetadata): <T extends new (...args: any[]) => any>(TargetClass: T) => T;
-//# sourceMappingURL=deprecation.d.ts.map

package/build/shared/helpers/deprecation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deprecation.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/deprecation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAQN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,mBAAmB,GAC5B,cAAc,CA2BhB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,IAC3C,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,aAAa,CAAC,KAAG,CAAC,CAS3E"}

package/build/shared/helpers/deprecation.js

@@ -1,97 +0,0 @@
-/**
- * Logs a deprecation warning to console when a deprecated tool is used
- *
- * @param toolName - Name of the deprecated tool
- * @param metadata - Deprecation metadata
- *
- * @example
- * ```typescript
- * logDeprecationWarning("entry-create", {
- *   since: "2.0.0",
- *   replacement: "entries-manage",
- *   example: "Use entries-manage with action='manage' and entry creation fields",
- *   removalVersion: "3.0.0",
- *   documentationUrl: "modyo://docs/migration/entries#create"
- * });
- * ```
- */
-export function logDeprecationWarning(toolName, metadata) {
-    console.warn(`[DEPRECATION WARNING] Tool "${toolName}" is deprecated since v${metadata.since}.\n` +
-        `  → Use "${metadata.replacement}" instead.\n` +
-        `  → Example: ${metadata.example}\n` +
-        `  → Will be removed in v${metadata.removalVersion}\n` +
-        `  → See: ${metadata.documentationUrl}`);
-}
-/**
- * Creates a CallToolResult with deprecation metadata included
- *
- * @param content - The actual tool response data
- * @param metadata - Deprecation metadata to include
- * @returns CallToolResult with _meta field containing deprecation info
- *
- * @example
- * ```typescript
- * const result = await this.repository.create(params);
- * return createDeprecationResponse(result, this.deprecationMetadata);
- * ```
- */
-export function createDeprecationResponse(content, metadata) {
-    // Convert content to object if it's not already
-    const contentObj = typeof content === "object" && content !== null ? content : {};
-    return {
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify({
-                    ...contentObj,
-                    _meta: {
-                        deprecated: true,
-                        deprecatedSince: metadata.since,
-                        replacement: metadata.replacement,
-                        removalVersion: metadata.removalVersion,
-                        documentationUrl: metadata.documentationUrl,
-                    },
-                }, null, 2),
-            },
-        ],
-        isError: false,
-    };
-}
-/**
- * Class decorator to mark a tool as deprecated
- *
- * Automatically adds deprecation metadata to the tool's config and ensures
- * the tool logs warnings when used.
- *
- * @param metadata - Deprecation metadata
- * @returns Class decorator function
- *
- * @example
- * ```typescript
- * @markAsDeprecated({
- *   since: "2.0.0",
- *   replacement: "entries-manage",
- *   example: "Use entries-manage with action='manage'",
- *   removalVersion: "3.0.0",
- *   documentationUrl: "modyo://docs/migration/entries#create"
- * })
- * export class EntryCreateTool extends ToolBase<ParamsSchema> {
- *   protected config = {
- *     name: "entry-create",
- *     description: "Creates a new entry",
- *   };
- * }
- * ```
- */
-export function markAsDeprecated(metadata) {
-    return function (TargetClass) {
-        return class extends TargetClass {
-            config = {
-                ...(super.config || this.config),
-                isDeprecated: true,
-                deprecationMetadata: metadata,
-            };
-        };
-    };
-}
-//# sourceMappingURL=deprecation.js.map

package/build/shared/helpers/deprecation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deprecation.js","sourceRoot":"","sources":["../../../src/shared/helpers/deprecation.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,QAA6B;IAE7B,OAAO,CAAC,IAAI,CACV,+BAA+B,QAAQ,0BAA0B,QAAQ,CAAC,KAAK,KAAK;QAClF,YAAY,QAAQ,CAAC,WAAW,cAAc;QAC9C,gBAAgB,QAAQ,CAAC,OAAO,IAAI;QACpC,2BAA2B,QAAQ,CAAC,cAAc,IAAI;QACtD,YAAY,QAAQ,CAAC,gBAAgB,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAgB,EAChB,QAA6B;IAE7B,gDAAgD;IAChD,MAAM,UAAU,GACd,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,GAAG,UAAU;oBACb,KAAK,EAAE;wBACL,UAAU,EAAE,IAAI;wBAChB,eAAe,EAAE,QAAQ,CAAC,KAAK;wBAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;wBACjC,cAAc,EAAE,QAAQ,CAAC,cAAc;wBACvC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;qBAC5C;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;QACD,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA6B;IAC5D,OAAO,UAAiD,WAAc;QACpE,OAAO,KAAM,SAAQ,WAAW;YAC9B,MAAM,GAAQ;gBACZ,GAAG,CAAC,KAAK,CAAC,MAAM,IAAK,IAAY,CAAC,MAAM,CAAC;gBACzC,YAAY,EAAE,IAAI;gBAClB,mBAAmB,EAAE,QAAQ;aAC9B,CAAC;SACa,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/build/shared/test-utils/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./toolTestUtils.js";
-//# sourceMappingURL=index.d.ts.map

package/build/shared/test-utils/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/test-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/build/shared/test-utils/index.js

@@ -1,2 +0,0 @@
-export * from "./toolTestUtils.js";
-//# sourceMappingURL=index.js.map

package/build/shared/test-utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/test-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/build/shared/test-utils/toolTestUtils.d.ts

@@ -1,191 +0,0 @@
-import { type Mock, vi } from "vitest";
-import type { Logger } from "../types/Logger.js";
-/**
- * Test utilities for MCP tool testing
- *
- * These utilities provide common mocking patterns for testing MCP tools,
- * reducing boilerplate and ensuring consistency across tests.
- *
- * Features:
- * - Mock creators for server, organizations, logger
- * - Result extractors and parsers
- * - Parametrized test case helpers
- * - Test fixtures via test.extend pattern
- */
-export { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from "vitest";
-export interface MockServer {
-    registerTool: Mock;
-    server: {
-        elicitInput: Mock;
-    };
-}
-/**
- * Creates a mock MCP server with registerTool spy
- */
-export declare function createMockServer(): MockServer;
-/**
- * Creates a mock logger function
- */
-export declare function createMockLogger(): Logger;
-/**
- * Creates a mock repository with specified methods
- */
-export declare function createMockRepository<T extends Record<string, unknown>>(methods: {
-    [K in keyof T]: T[K] extends (...args: unknown[]) => unknown ? ReturnType<typeof vi.fn> : never;
-}): T;
-/**
- * Extracts the tool handler function from a mock server's registerTool calls
- */
-export declare function extractToolHandler(mockServer: MockServer, callIndex?: number): (params: unknown) => Promise<unknown>;
-/**
- * Extracts tool metadata from registerTool call
- */
-export declare function extractToolMetadata(mockServer: MockServer, callIndex?: number): {
-    name: string;
-    description: unknown;
-    inputSchema: unknown;
-    annotations: unknown;
-};
-/**
- * Helper to assert CallToolResult structure
- */
-export declare function isCallToolResult(result: unknown): boolean;
-/**
- * Helper to extract text content from CallToolResult
- */
-export declare function extractResultText(result: unknown): string;
-/**
- * Helper to parse JSON from CallToolResult text
- */
-export declare function parseResultJSON<T = unknown>(result: unknown): T;
-export interface ToolTestSetup {
-    server: MockServer;
-    logger: Logger;
-    extractHandler: (callIndex?: number) => (params: unknown) => Promise<unknown>;
-    extractMetadata: (callIndex?: number) => {
-        name: string;
-        description: unknown;
-        inputSchema: unknown;
-        annotations: unknown;
-    };
-}
-/**
- * Creates a complete test setup with all common mocks
- */
-export declare function setupToolTest(): ToolTestSetup;
-/**
- * Test case type for validation tests
- */
-export interface ValidationTestCase {
-    name: string;
-    input: Record<string, unknown>;
-    expectedError?: string;
-}
-/**
- * Test case type for query parameter tests
- */
-export interface QueryParamTestCase {
-    description: string;
-    params: Record<string, unknown>;
-    expectedCall?: Record<string, unknown>;
-}
-/**
- * Test case type for ID iteration tests
- */
-export interface IdIterationTestCase<T = unknown> {
-    id: number;
-    expectedResult?: T;
-    description?: string;
-}
-/**
- * Standard pagination test cases for reuse across tests
- */
-export declare const STANDARD_PAGINATION_CASES: QueryParamTestCase[];
-/**
- * Standard ID iteration test cases
- */
-export declare const STANDARD_ID_CASES: number[];
-/**
- * Standard query filter test cases
- */
-export declare const STANDARD_QUERY_CASES: QueryParamTestCase[];
-/**
- * Combines pagination and query cases for comprehensive list testing
- */
-export declare const STANDARD_LIST_CASES: QueryParamTestCase[];
-/**
- * Standard status filter cases for job/task filtering
- */
-export declare const STANDARD_STATUS_CASES: ({
-    status: "pending";
-    description: string;
-} | {
-    status: "processing";
-    description: string;
-} | {
-    status: "completed";
-    description: string;
-} | {
-    status: "failed";
-    description: string;
-})[];
-/**
- * Standard action test cases for CRUD operations
- */
-export declare const STANDARD_ACTION_CASES: ({
-    action: "list";
-    description: string;
-} | {
-    action: "get";
-    description: string;
-} | {
-    action: "create";
-    description: string;
-} | {
-    action: "update";
-    description: string;
-} | {
-    action: "delete";
-    description: string;
-})[];
-/**
- * Test fixtures interface for type-safe fixture access
- */
-export interface ToolTestFixtures {
-    /** Pre-configured mock MCP server */
-    server: MockServer;
-    /** Pre-configured mock logger */
-    logger: Logger;
-    /** Complete test setup with extractors */
-    testSetup: ToolTestSetup;
-}
-/**
- * Extended test with common fixtures for MCP tool testing.
- * Use this instead of base `test` when you need server and logger fixtures.
- *
- * @example
- * ```typescript
- * import { test, expect, describe } from "./index.js";
- *
- * describe("MyTool", () => {
- *   test("should register tool", async ({ server, logger }) => {
- *     MyTool.registerTool(server, "mcp-test", logger);
- *     expect(server.registerTool).toHaveBeenCalled();
- *   });
- *
- *   // Or use the complete testSetup
- *   test("should handle request", async ({ testSetup }) => {
- *     MyTool.registerTool(testSetup.server, "mcp-test", testSetup.logger);
- *     const handler = testSetup.extractHandler();
- *     const result = await handler({ action: "list" });
- *     expect(result).toBeDefined();
- *   });
- * });
- * ```
- */
-export declare const test: import("vitest").TestAPI<{
-    server: MockServer;
-    logger: Logger;
-    testSetup: ToolTestSetup;
-}>;
-//# sourceMappingURL=toolTestUtils.d.ts.map

package/build/shared/test-utils/toolTestUtils.d.ts.map

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

package/build/shared/test-utils/toolTestUtils.js

@@ -1,304 +0,0 @@
-import { test as baseTest, vi } from "vitest";
-/**
- * Test utilities for MCP tool testing
- *
- * These utilities provide common mocking patterns for testing MCP tools,
- * reducing boilerplate and ensuring consistency across tests.
- *
- * Features:
- * - Mock creators for server, organizations, logger
- * - Result extractors and parsers
- * - Parametrized test case helpers
- * - Test fixtures via test.extend pattern
- */
-// Re-export vitest utilities for convenience
-export { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi, } from "vitest";
-// ============================================
-// MOCK CREATORS
-// ============================================
-/**
- * Creates a mock MCP server with registerTool spy
- */
-export function createMockServer() {
-    return {
-        registerTool: vi.fn(),
-        server: {
-            elicitInput: vi.fn(),
-        },
-    };
-}
-/**
- * Creates a mock logger function
- */
-export function createMockLogger() {
-    return vi.fn();
-}
-/**
- * Creates a mock repository with specified methods
- */
-export function createMockRepository(methods) {
-    return methods;
-}
-// ============================================
-// EXTRACTORS
-// ============================================
-/**
- * Extracts the tool handler function from a mock server's registerTool calls
- */
-export function extractToolHandler(mockServer, callIndex = 0) {
-    const calls = mockServer.registerTool.mock.calls;
-    if (calls.length === 0) {
-        throw new Error("registerTool was not called on the mock server");
-    }
-    if (callIndex >= calls.length) {
-        throw new Error(`Call index ${callIndex} out of bounds (${calls.length} calls made)`);
-    }
-    const handler = calls[callIndex]?.[2];
-    if (!handler || typeof handler !== "function") {
-        throw new Error("Handler function not found in registerTool call");
-    }
-    return handler;
-}
-/**
- * Extracts tool metadata from registerTool call
- */
-export function extractToolMetadata(mockServer, callIndex = 0) {
-    const calls = mockServer.registerTool.mock.calls;
-    if (calls.length === 0 || callIndex >= calls.length) {
-        throw new Error("Invalid call index or no calls made");
-    }
-    const [name, metadata] = calls[callIndex];
-    return {
-        name,
-        description: metadata.description,
-        inputSchema: metadata.inputSchema,
-        annotations: metadata.annotations,
-    };
-}
-// ============================================
-// RESULT HELPERS
-// ============================================
-/**
- * Helper to assert CallToolResult structure
- */
-export function isCallToolResult(result) {
-    if (!result || typeof result !== "object")
-        return false;
-    const r = result;
-    return (Array.isArray(r.content) &&
-        r.content.every((item) => typeof item === "object" &&
-            item !== null &&
-            "type" in item &&
-            "text" in item));
-}
-/**
- * Helper to extract text content from CallToolResult
- */
-export function extractResultText(result) {
-    if (!result || typeof result !== "object") {
-        throw new Error("Invalid result object");
-    }
-    const r = result;
-    if (!Array.isArray(r.content)) {
-        throw new Error("Result does not have content array");
-    }
-    return r.content.map((item) => item.text ?? "").join("\n");
-}
-/**
- * Helper to parse JSON from CallToolResult text
- */
-export function parseResultJSON(result) {
-    const text = extractResultText(result);
-    try {
-        return JSON.parse(text);
-    }
-    catch (error) {
-        throw new Error(`Failed to parse result JSON: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-/**
- * Creates a complete test setup with all common mocks
- */
-export function setupToolTest() {
-    const server = createMockServer();
-    const logger = createMockLogger();
-    return {
-        server,
-        logger,
-        extractHandler: (callIndex = 0) => extractToolHandler(server, callIndex),
-        extractMetadata: (callIndex = 0) => extractToolMetadata(server, callIndex),
-    };
-}
-/**
- * Standard pagination test cases for reuse across tests
- */
-export const STANDARD_PAGINATION_CASES = [
-    {
-        description: "page only",
-        params: {
-            page: 2,
-        },
-        expectedCall: {
-            page: 2,
-        },
-    },
-    {
-        description: "per_page only",
-        params: {
-            per_page: 50,
-        },
-        expectedCall: {
-            per_page: 50,
-        },
-    },
-    {
-        description: "page and per_page",
-        params: {
-            page: 3,
-            per_page: 25,
-        },
-        expectedCall: {
-            page: 3,
-            per_page: 25,
-        },
-    },
-];
-/**
- * Standard ID iteration test cases
- */
-export const STANDARD_ID_CASES = [
-    1,
-    42,
-    999,
-];
-/**
- * Standard query filter test cases
- */
-export const STANDARD_QUERY_CASES = [
-    {
-        description: "search query",
-        params: {
-            query: "test-search",
-        },
-        expectedCall: {
-            query: "test-search",
-        },
-    },
-    {
-        description: "sorting ascending",
-        params: {
-            sort_by: "name",
-            order: "asc",
-        },
-        expectedCall: {
-            sort_by: "name",
-            order: "asc",
-        },
-    },
-    {
-        description: "sorting descending",
-        params: {
-            sort_by: "created_at",
-            order: "desc",
-        },
-        expectedCall: {
-            sort_by: "created_at",
-            order: "desc",
-        },
-    },
-];
-/**
- * Combines pagination and query cases for comprehensive list testing
- */
-export const STANDARD_LIST_CASES = [
-    ...STANDARD_PAGINATION_CASES,
-    ...STANDARD_QUERY_CASES,
-];
-/**
- * Standard status filter cases for job/task filtering
- */
-export const STANDARD_STATUS_CASES = [
-    {
-        status: "pending",
-        description: "pending items",
-    },
-    {
-        status: "processing",
-        description: "processing items",
-    },
-    {
-        status: "completed",
-        description: "completed items",
-    },
-    {
-        status: "failed",
-        description: "failed items",
-    },
-];
-/**
- * Standard action test cases for CRUD operations
- */
-export const STANDARD_ACTION_CASES = [
-    {
-        action: "list",
-        description: "list action",
-    },
-    {
-        action: "get",
-        description: "get action",
-    },
-    {
-        action: "create",
-        description: "create action",
-    },
-    {
-        action: "update",
-        description: "update action",
-    },
-    {
-        action: "delete",
-        description: "delete action",
-    },
-];
-/**
- * Extended test with common fixtures for MCP tool testing.
- * Use this instead of base `test` when you need server and logger fixtures.
- *
- * @example
- * ```typescript
- * import { test, expect, describe } from "./index.js";
- *
- * describe("MyTool", () => {
- *   test("should register tool", async ({ server, logger }) => {
- *     MyTool.registerTool(server, "mcp-test", logger);
- *     expect(server.registerTool).toHaveBeenCalled();
- *   });
- *
- *   // Or use the complete testSetup
- *   test("should handle request", async ({ testSetup }) => {
- *     MyTool.registerTool(testSetup.server, "mcp-test", testSetup.logger);
- *     const handler = testSetup.extractHandler();
- *     const result = await handler({ action: "list" });
- *     expect(result).toBeDefined();
- *   });
- * });
- * ```
- */
-export const test = baseTest.extend({
-    // biome-ignore lint/correctness/noEmptyPattern: Required by Vitest extend API
-    server: async ({}, use) => {
-        const mockServer = createMockServer();
-        await use(mockServer);
-    },
-    // biome-ignore lint/correctness/noEmptyPattern: Required by Vitest extend API
-    logger: async ({}, use) => {
-        const mockLogger = createMockLogger();
-        await use(mockLogger);
-    },
-    // biome-ignore lint/correctness/noEmptyPattern: Required by Vitest extend API
-    testSetup: async ({}, use) => {
-        const setup = setupToolTest();
-        await use(setup);
-    },
-});
-//# sourceMappingURL=toolTestUtils.js.map