@checkview/mcp-server 1.1.0

package/dist/tools/update-settings.js

@@ -0,0 +1,97 @@
+import { z } from "zod";
+import { ApiError, idempotencyKey } from "../api-client.js";
+const SECTIONS = [
+    "schedule",
+    "usage",
+    "device",
+    "plugins",
+    "auto-retry",
+    "variables",
+];
+export function registerUpdateSettingsTool(server, client) {
+    server.registerTool("checkview_update_settings", {
+        description: `Update an organization setting by section. Sections:
+- schedule: { days: number[], time: "HH:MM:SS", timezone: "America/New_York" }
+- usage: { monthly_test_limit: number }
+- device: { device_type: "desktop" | "mobile", honor_robot_rules?: boolean }
+- plugins: { hide_helper_plugin: boolean, hide_helper_plugin_updating?: boolean }
+- auto-retry: { autoRetryFailedTests: true | false }
+- variables: { woo_variables: {...}, form_variables: {...} }`,
+        inputSchema: {
+            section: z.enum(SECTIONS).describe("The settings section to update"),
+            value: z
+                .record(z.unknown())
+                .describe("The settings value object to send as the request body"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async (args, extra) => {
+        try {
+            const { section, value } = args;
+            const path = `/settings/${section}`;
+            const idemKey = idempotencyKey(`update-settings:${section}:${JSON.stringify(value)}`);
+            try {
+                await client.put(path, value, idemKey, extra.signal);
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    if (error.status === 400) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: `Invalid settings value: ${error.detail}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (error.status === 403) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: "Forbidden: admin role required to update settings.",
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    if (error.isReplay && error.status >= 400) {
+                        const freshKey = idempotencyKey(`update-settings:${section}:${Date.now()}`);
+                        await client.put(path, value, freshKey, extra.signal);
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Settings updated: **${section}** section saved successfully.`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to update settings: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-settings.js.map

package/dist/tools/update-settings.js.map

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

package/dist/tools/update-team-member.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ApiClient } from "../api-client.js";
+export declare function registerUpdateTeamMemberTool(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=update-team-member.d.ts.map

package/dist/tools/update-team-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-team-member.d.ts","sourceRoot":"","sources":["../../src/tools/update-team-member.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE5E,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CAuHN"}

package/dist/tools/update-team-member.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { ApiError, idempotencyKey } from "../api-client.js";
+export function registerUpdateTeamMemberTool(server, client) {
+    server.registerTool("checkview_update_team_member", {
+        description: "Update a team member's role, active status, and website access permissions.",
+        inputSchema: {
+            user_id: z
+                .string()
+                .uuid()
+                .describe("The user ID of the team member to update"),
+            roleTypeId: z
+                .enum(["admin", "collaborator"])
+                .optional()
+                .describe("Role type for the team member"),
+            allowAccessToAllWebsites: z
+                .boolean()
+                .optional()
+                .describe("Whether the member can access all websites"),
+            websites: z
+                .array(z.string().uuid())
+                .optional()
+                .describe("List of website IDs the member can access (when allowAccessToAllWebsites is false)"),
+            active: z
+                .boolean()
+                .optional()
+                .describe("Whether the team member is active"),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async (args, extra) => {
+        try {
+            const body = {};
+            if (args.roleTypeId !== undefined)
+                body.roleTypeId = args.roleTypeId;
+            if (args.allowAccessToAllWebsites !== undefined)
+                body.allowAccessToAllWebsites = args.allowAccessToAllWebsites;
+            if (args.websites !== undefined)
+                body.websites = args.websites;
+            if (args.active !== undefined)
+                body.active = args.active;
+            if (Object.keys(body).length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No fields to update. Provide at least one field (roleTypeId, allowAccessToAllWebsites, websites, active).",
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const idemKey = idempotencyKey(`update:team-member:${args.user_id}:${JSON.stringify(body)}`);
+            try {
+                await client.put(`/team/${args.user_id}`, body, idemKey, extra.signal);
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    if (error.isReplay && error.status >= 400) {
+                        const freshKey = idempotencyKey(`update:team-member:${args.user_id}:${JSON.stringify(body)}:${Date.now()}`);
+                        await client.put(`/team/${args.user_id}`, body, freshKey, extra.signal);
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            const changes = [];
+            if (args.roleTypeId)
+                changes.push(`Role: ${args.roleTypeId}`);
+            if (args.allowAccessToAllWebsites !== undefined)
+                changes.push(`All websites: ${args.allowAccessToAllWebsites ? "yes" : "no"}`);
+            if (args.active !== undefined)
+                changes.push(`Active: ${args.active ? "yes" : "no"}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Team member updated successfully.\n${changes.join(" | ")}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to update team member: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-team-member.js.map

package/dist/tools/update-team-member.js.map

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

package/dist/tools/update-test-flow-steps.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ApiClient } from "../api-client.js";
+export declare function registerUpdateTestFlowStepsTool(server: McpServer, client: ApiClient): void;
+//# sourceMappingURL=update-test-flow-steps.d.ts.map

package/dist/tools/update-test-flow-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-test-flow-steps.d.ts","sourceRoot":"","sources":["../../src/tools/update-test-flow-steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAia5E,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CAgGN"}

package/dist/tools/update-test-flow-steps.js

@@ -0,0 +1,440 @@
+import { z } from "zod";
+import { ApiError, idempotencyKey } from "../api-client.js";
+const STEP_TYPES = [
+    "goto",
+    "click",
+    "assign",
+    "assign_date",
+    "select",
+    "check",
+    "uncheck",
+    "hover",
+    "press_key",
+    "pause",
+    "scroll_to_selector",
+    "scroll_around_page",
+    "refresh",
+    "assert_element_visible",
+    "assert_element_not_visible",
+    "assert_element_present",
+    "assert_element_not_present",
+    "assert_element_text_equal",
+    "assert_element_text_not_equal",
+    "assert_element_text_contain",
+    "assert_element_text_not_contain",
+    "assert_email_received",
+    "assert_form_submitted",
+    "assert_order_placed",
+    "assert_product_in_cart",
+    "upload_file",
+];
+const SELECTOR_REQUIRED_TYPES = new Set([
+    "click",
+    "assign",
+    "assign_date",
+    "select",
+    "check",
+    "uncheck",
+    "hover",
+    "upload_file",
+    "scroll_to_selector",
+    "assert_element_visible",
+    "assert_element_not_visible",
+    "assert_element_present",
+    "assert_element_not_present",
+    "assert_element_text_equal",
+    "assert_element_text_not_equal",
+    "assert_element_text_contain",
+    "assert_element_text_not_contain",
+]);
+const RUNWITH_TYPES = new Set([
+    "click",
+    "assign",
+    "select",
+    "check",
+    "uncheck",
+    "hover",
+    "scroll_to_selector",
+    "assert_element_visible",
+    "assert_element_not_visible",
+    "assert_element_present",
+    "assert_element_not_present",
+    "assert_element_text_equal",
+    "assert_element_text_not_equal",
+    "assert_element_text_contain",
+    "assert_element_text_not_contain",
+]);
+const REGEX_RANGE_TYPES = new Set([
+    "assert_element_text_equal",
+    "assert_element_text_not_equal",
+]);
+const StepSchema = z
+    .object({
+    type: z.enum(STEP_TYPES).describe("Step type"),
+    selector: z
+        .string()
+        .max(2000)
+        .optional()
+        .describe("CSS selector for the target element (required for click, assign, select, check, hover, scroll_to_selector, and assert_element_* steps)"),
+    value: z
+        .string()
+        .max(5000)
+        .optional()
+        .describe("Value for assign/select/assert_element_text_* steps"),
+    url: z
+        .string()
+        .max(2048)
+        .optional()
+        .describe("URL for goto steps (required for goto)"),
+    optional: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("If true, step failure does not fail the test"),
+    key: z
+        .string()
+        .max(100)
+        .optional()
+        .describe('Key name for press_key steps (e.g. "Enter", "Tab"). Defaults to "Enter"'),
+    duration: z
+        .number()
+        .min(0)
+        .max(60000)
+        .optional()
+        .describe("Duration in ms for pause steps (max 60000)"),
+    count: z
+        .number()
+        .int()
+        .min(0)
+        .max(99)
+        .optional()
+        .describe("Number of times to press the key (press_key only, default: 1)"),
+    position: z
+        .object({
+        x: z.number().int().min(-9999).max(9999),
+        y: z.number().int().min(-9999).max(9999),
+    })
+        .optional()
+        .describe("Click at specific pixel offset from element top-left corner (click only)"),
+    runWith: z
+        .object({
+        method: z.literal("frameLocator"),
+        args: z.array(z.string().max(500)).length(1),
+    })
+        .optional()
+        .describe('Execute step inside an iframe. Example: { method: "frameLocator", args: ["iframe[src*=\'jotform\']"] }'),
+    secureCredentialField: z
+        .enum(["username", "password"])
+        .optional()
+        .describe('Use stored credentials instead of a literal value (assign only). Value must be empty ("") when using this.'),
+    valueIsRegex: z
+        .boolean()
+        .optional()
+        .describe("Treat value as a regex pattern (assert_element_text_equal/not_equal only)"),
+    regexOptions: z
+        .string()
+        .regex(/^[gimsuy]*$/)
+        .max(6)
+        .refine((val) => new Set(val).size === val.length, "Duplicate regex flags are not allowed")
+        .optional()
+        .describe('Regex flags e.g. "i" for case-insensitive (requires valueIsRegex: true)'),
+    valueIsRange: z
+        .boolean()
+        .optional()
+        .describe("Use range-based numeric assertion instead of text match (assert_element_text_equal/not_equal only)"),
+    rangeMin: z
+        .number()
+        .optional()
+        .describe("Minimum value for range assertion (inclusive, requires valueIsRange: true)"),
+    rangeMax: z
+        .number()
+        .optional()
+        .describe("Maximum value for range assertion (inclusive, requires valueIsRange: true)"),
+    notes: z
+        .string()
+        .max(1000)
+        .optional()
+        .describe("Human-readable note or description for this step"),
+})
+    .superRefine((step, ctx) => {
+    if (step.type === "goto" && !step.url) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "url is required for goto steps",
+            path: ["url"],
+        });
+    }
+    if (SELECTOR_REQUIRED_TYPES.has(step.type) && !step.selector) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `selector is required for ${step.type} steps`,
+            path: ["selector"],
+        });
+    }
+    if (step.position && step.type !== "click") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "position is only valid for click steps",
+            path: ["position"],
+        });
+    }
+    if (step.count !== undefined && step.type !== "press_key") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "count is only valid for press_key steps",
+            path: ["count"],
+        });
+    }
+    if (step.secureCredentialField) {
+        if (step.type !== "assign") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "secureCredentialField is only valid for assign steps",
+                path: ["secureCredentialField"],
+            });
+        }
+        if (step.value && step.value.trim() !== "") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'value must be empty ("") when using secureCredentialField',
+                path: ["value"],
+            });
+        }
+    }
+    if ((step.valueIsRegex || step.regexOptions) &&
+        !REGEX_RANGE_TYPES.has(step.type)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "valueIsRegex/regexOptions only valid for assert_element_text_equal or not_equal",
+            path: ["valueIsRegex"],
+        });
+    }
+    if ((step.valueIsRange ||
+        step.rangeMin !== undefined ||
+        step.rangeMax !== undefined) &&
+        !REGEX_RANGE_TYPES.has(step.type)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "valueIsRange/rangeMin/rangeMax only valid for assert_element_text_equal or not_equal",
+            path: ["valueIsRange"],
+        });
+    }
+    if (step.regexOptions && !step.valueIsRegex) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "regexOptions requires valueIsRegex: true",
+            path: ["regexOptions"],
+        });
+    }
+    if ((step.rangeMin !== undefined || step.rangeMax !== undefined) &&
+        !step.valueIsRange) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "rangeMin/rangeMax requires valueIsRange: true",
+            path: ["rangeMin"],
+        });
+    }
+    if (step.valueIsRegex && step.valueIsRange) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "valueIsRegex and valueIsRange are mutually exclusive",
+            path: ["valueIsRegex"],
+        });
+    }
+    if (step.runWith && !RUNWITH_TYPES.has(step.type)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `runWith is not valid for ${step.type} steps`,
+            path: ["runWith"],
+        });
+    }
+});
+/**
+ * Build the API metadata object from step input.
+ * Mirrors the buildMetadata in create-test-flow.ts.
+ */
+function buildMetadata(step) {
+    const meta = {};
+    switch (step.type) {
+        case "goto":
+            meta.url = step.url ?? "";
+            break;
+        case "assign":
+            meta.selector = step.selector ?? "";
+            meta.value = step.value ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            if (step.secureCredentialField)
+                meta.secureCredentialField = step.secureCredentialField;
+            break;
+        case "assign_date":
+            meta.selector = step.selector ?? "";
+            meta.value = "latest";
+            meta.customSelector = true;
+            break;
+        case "click":
+            meta.selector = step.selector ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            if (step.position)
+                meta.position = step.position;
+            break;
+        case "hover":
+        case "scroll_to_selector":
+            meta.selector = step.selector ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            break;
+        case "check":
+        case "uncheck":
+            meta.selector = step.selector ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            break;
+        case "select":
+            meta.selector = step.selector ?? "";
+            meta.value = step.value ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            break;
+        case "press_key":
+            meta.key = step.key ?? "Enter";
+            meta.count = step.count ?? 1;
+            break;
+        case "pause":
+            meta.duration = Math.min(step.duration ?? 2000, 60000);
+            break;
+        case "refresh":
+        case "scroll_around_page":
+            break;
+        case "assert_element_visible":
+        case "assert_element_not_visible":
+        case "assert_element_present":
+        case "assert_element_not_present":
+            meta.selector = step.selector ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            break;
+        case "assert_element_text_equal":
+        case "assert_element_text_not_equal":
+            meta.selector = step.selector ?? "";
+            meta.value = step.value ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            if (step.valueIsRegex)
+                meta.valueIsRegex = step.valueIsRegex;
+            if (step.regexOptions)
+                meta.regexOptions = step.regexOptions;
+            if (step.valueIsRange)
+                meta.valueIsRange = step.valueIsRange;
+            if (step.rangeMin !== undefined)
+                meta.rangeMin = step.rangeMin;
+            if (step.rangeMax !== undefined)
+                meta.rangeMax = step.rangeMax;
+            break;
+        case "assert_element_text_contain":
+        case "assert_element_text_not_contain":
+            meta.selector = step.selector ?? "";
+            meta.value = step.value ?? "";
+            meta.customSelector = true;
+            if (step.runWith)
+                meta.runWith = step.runWith;
+            break;
+        case "upload_file":
+            meta.selector = step.selector ?? "";
+            meta.customSelector = true;
+            meta.accept = null;
+            meta.runWith = null;
+            break;
+        case "assert_email_received":
+        case "assert_form_submitted":
+        case "assert_order_placed":
+        case "assert_product_in_cart":
+            break;
+    }
+    if (step.notes) {
+        meta.notes = step.notes;
+    }
+    return meta;
+}
+export function registerUpdateTestFlowStepsTool(server, client) {
+    server.registerTool("checkview_update_test_flow_steps", {
+        description: "Replace all steps of a test flow with a new ordered list. This is an idempotent full replacement — all existing steps are removed and replaced with the provided steps.",
+        inputSchema: {
+            test_flow_id: z
+                .string()
+                .uuid()
+                .describe("The test flow ID to update steps for"),
+            steps: z
+                .array(StepSchema)
+                .min(1)
+                .max(100)
+                .describe("Ordered list of test steps (max 100). Replaces all existing steps."),
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+    }, async (args, extra) => {
+        try {
+            const apiSteps = args.steps.map((step, index) => ({
+                type: step.type,
+                metadata: buildMetadata(step),
+                index,
+                optional: step.optional ?? false,
+            }));
+            const idemKey = idempotencyKey(`update-steps:${args.test_flow_id}:${JSON.stringify(apiSteps)}`);
+            let createdSteps;
+            try {
+                const result = await client.patch(`/test-flows/${args.test_flow_id}/steps`, { steps: apiSteps }, idemKey, extra.signal);
+                createdSteps = result.body;
+            }
+            catch (error) {
+                if (error instanceof ApiError) {
+                    if (error.isReplay && error.status >= 400) {
+                        const freshKey = idempotencyKey(`update-steps:${args.test_flow_id}:${JSON.stringify(apiSteps)}:${Date.now()}`);
+                        const retryResult = await client.patch(`/test-flows/${args.test_flow_id}/steps`, { steps: apiSteps }, freshKey, extra.signal);
+                        createdSteps = retryResult.body;
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            const stepsSummary = args.steps
+                .map((s, i) => `${i + 1}. ${s.type}${s.selector ? ` → ${s.selector}` : ""}${s.url ? ` → ${s.url}` : ""}${s.value ? ` = "${s.value}"` : ""}${s.optional ? " (optional)" : ""}`)
+                .join("\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Test flow steps updated (${createdSteps.length} steps)\n\nTest flow ID: ${args.test_flow_id}\n\n### Steps\n${stepsSummary}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to update test flow steps: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=update-test-flow-steps.js.map