@metamask/client-mcp-core 0.1.0

package/dist/mcp-server/utils/response.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSuccessResponse = createSuccessResponse;
+exports.createErrorResponse = createErrorResponse;
+/**
+ * Creates a standardized success response.
+ *
+ * @param result - The result data to include in the response.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns A success response object.
+ */
+function createSuccessResponse(result, sessionId, startTime) {
+    return {
+        meta: {
+            timestamp: new Date().toISOString(),
+            sessionId,
+            durationMs: startTime ? Date.now() - startTime : 0,
+        },
+        ok: true,
+        result,
+    };
+}
+/**
+ * Creates a standardized error response.
+ *
+ * @param code - The error code identifying the error type.
+ * @param message - Human-readable error message.
+ * @param details - Optional additional error details.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns An error response object.
+ */
+function createErrorResponse(code, message, details, sessionId, startTime) {
+    return {
+        error: {
+            code,
+            message,
+            details,
+        },
+        meta: {
+            timestamp: new Date().toISOString(),
+            sessionId,
+            durationMs: startTime ? Date.now() - startTime : 0,
+        },
+        ok: false,
+    };
+}
+//# sourceMappingURL=response.cjs.map

package/dist/mcp-server/utils/response.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.cjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/response.ts"],"names":[],"mappings":";;AAUA,sDAcC;AAYD,kDAoBC;AAtDD;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,MAAc,EACd,SAAkB,EAClB,SAAkB;IAElB,OAAO;QACL,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS;YACT,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;SACnD;QACD,EAAE,EAAE,IAAI;QACR,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CACjC,IAAe,EACf,OAAe,EACf,OAAiC,EACjC,SAAkB,EAClB,SAAkB;IAElB,OAAO;QACL,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,OAAO;SACR;QACD,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS;YACT,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;SACnD;QACD,EAAE,EAAE,KAAK;KACV,CAAC;AACJ,CAAC","sourcesContent":["import type { SuccessResponse, ErrorResponse, ErrorCode } from '../types';\n\n/**\n * Creates a standardized success response.\n *\n * @param result - The result data to include in the response.\n * @param sessionId - Optional session identifier.\n * @param startTime - Optional start time for duration calculation.\n * @returns A success response object.\n */\nexport function createSuccessResponse<Result>(\n  result: Result,\n  sessionId?: string,\n  startTime?: number,\n): SuccessResponse<Result> {\n  return {\n    meta: {\n      timestamp: new Date().toISOString(),\n      sessionId,\n      durationMs: startTime ? Date.now() - startTime : 0,\n    },\n    ok: true,\n    result,\n  };\n}\n\n/**\n * Creates a standardized error response.\n *\n * @param code - The error code identifying the error type.\n * @param message - Human-readable error message.\n * @param details - Optional additional error details.\n * @param sessionId - Optional session identifier.\n * @param startTime - Optional start time for duration calculation.\n * @returns An error response object.\n */\nexport function createErrorResponse(\n  code: ErrorCode,\n  message: string,\n  details?: Record<string, unknown>,\n  sessionId?: string,\n  startTime?: number,\n): ErrorResponse {\n  return {\n    error: {\n      code,\n      message,\n      details,\n    },\n    meta: {\n      timestamp: new Date().toISOString(),\n      sessionId,\n      durationMs: startTime ? Date.now() - startTime : 0,\n    },\n    ok: false,\n  };\n}\n"]}

package/dist/mcp-server/utils/response.d.cts

@@ -0,0 +1,22 @@
+import type { SuccessResponse, ErrorResponse, ErrorCode } from "../types/index.cjs";
+/**
+ * Creates a standardized success response.
+ *
+ * @param result - The result data to include in the response.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns A success response object.
+ */
+export declare function createSuccessResponse<Result>(result: Result, sessionId?: string, startTime?: number): SuccessResponse<Result>;
+/**
+ * Creates a standardized error response.
+ *
+ * @param code - The error code identifying the error type.
+ * @param message - Human-readable error message.
+ * @param details - Optional additional error details.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns An error response object.
+ */
+export declare function createErrorResponse(code: ErrorCode, message: string, details?: Record<string, unknown>, sessionId?: string, startTime?: number): ErrorResponse;
+//# sourceMappingURL=response.d.cts.map

package/dist/mcp-server/utils/response.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/utils/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,2BAAiB;AAE1E;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAC1C,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,CAAC,MAAM,CAAC,CAUzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,CAcf"}

package/dist/mcp-server/utils/response.d.mts

@@ -0,0 +1,22 @@
+import type { SuccessResponse, ErrorResponse, ErrorCode } from "../types/index.mjs";
+/**
+ * Creates a standardized success response.
+ *
+ * @param result - The result data to include in the response.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns A success response object.
+ */
+export declare function createSuccessResponse<Result>(result: Result, sessionId?: string, startTime?: number): SuccessResponse<Result>;
+/**
+ * Creates a standardized error response.
+ *
+ * @param code - The error code identifying the error type.
+ * @param message - Human-readable error message.
+ * @param details - Optional additional error details.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns An error response object.
+ */
+export declare function createErrorResponse(code: ErrorCode, message: string, details?: Record<string, unknown>, sessionId?: string, startTime?: number): ErrorResponse;
+//# sourceMappingURL=response.d.mts.map

package/dist/mcp-server/utils/response.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/utils/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,2BAAiB;AAE1E;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAC1C,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,CAAC,MAAM,CAAC,CAUzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,CAcf"}

package/dist/mcp-server/utils/response.mjs

@@ -0,0 +1,45 @@
+/**
+ * Creates a standardized success response.
+ *
+ * @param result - The result data to include in the response.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns A success response object.
+ */
+export function createSuccessResponse(result, sessionId, startTime) {
+    return {
+        meta: {
+            timestamp: new Date().toISOString(),
+            sessionId,
+            durationMs: startTime ? Date.now() - startTime : 0,
+        },
+        ok: true,
+        result,
+    };
+}
+/**
+ * Creates a standardized error response.
+ *
+ * @param code - The error code identifying the error type.
+ * @param message - Human-readable error message.
+ * @param details - Optional additional error details.
+ * @param sessionId - Optional session identifier.
+ * @param startTime - Optional start time for duration calculation.
+ * @returns An error response object.
+ */
+export function createErrorResponse(code, message, details, sessionId, startTime) {
+    return {
+        error: {
+            code,
+            message,
+            details,
+        },
+        meta: {
+            timestamp: new Date().toISOString(),
+            sessionId,
+            durationMs: startTime ? Date.now() - startTime : 0,
+        },
+        ok: false,
+    };
+}
+//# sourceMappingURL=response.mjs.map

package/dist/mcp-server/utils/response.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.mjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/response.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,SAAkB,EAClB,SAAkB;IAElB,OAAO;QACL,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS;YACT,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;SACnD;QACD,EAAE,EAAE,IAAI;QACR,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAe,EACf,OAAe,EACf,OAAiC,EACjC,SAAkB,EAClB,SAAkB;IAElB,OAAO;QACL,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;YACP,OAAO;SACR;QACD,IAAI,EAAE;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS;YACT,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;SACnD;QACD,EAAE,EAAE,KAAK;KACV,CAAC;AACJ,CAAC","sourcesContent":["import type { SuccessResponse, ErrorResponse, ErrorCode } from '../types';\n\n/**\n * Creates a standardized success response.\n *\n * @param result - The result data to include in the response.\n * @param sessionId - Optional session identifier.\n * @param startTime - Optional start time for duration calculation.\n * @returns A success response object.\n */\nexport function createSuccessResponse<Result>(\n  result: Result,\n  sessionId?: string,\n  startTime?: number,\n): SuccessResponse<Result> {\n  return {\n    meta: {\n      timestamp: new Date().toISOString(),\n      sessionId,\n      durationMs: startTime ? Date.now() - startTime : 0,\n    },\n    ok: true,\n    result,\n  };\n}\n\n/**\n * Creates a standardized error response.\n *\n * @param code - The error code identifying the error type.\n * @param message - Human-readable error message.\n * @param details - Optional additional error details.\n * @param sessionId - Optional session identifier.\n * @param startTime - Optional start time for duration calculation.\n * @returns An error response object.\n */\nexport function createErrorResponse(\n  code: ErrorCode,\n  message: string,\n  details?: Record<string, unknown>,\n  sessionId?: string,\n  startTime?: number,\n): ErrorResponse {\n  return {\n    error: {\n      code,\n      message,\n      details,\n    },\n    meta: {\n      timestamp: new Date().toISOString(),\n      sessionId,\n      durationMs: startTime ? Date.now() - startTime : 0,\n    },\n    ok: false,\n  };\n}\n"]}

package/dist/mcp-server/utils/targets.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTargetSelection = validateTargetSelection;
+/**
+ * Validates that exactly one target selector is provided.
+ *
+ * @param target - The target selection object to validate.
+ * @returns Validation result with type and value if valid, error if invalid.
+ */
+function validateTargetSelection(target) {
+    const provided = [
+        target.a11yRef ? 'a11yRef' : null,
+        target.testId ? 'testId' : null,
+        target.selector ? 'selector' : null,
+    ].filter(Boolean);
+    if (provided.length === 0) {
+        return {
+            valid: false,
+            error: 'Exactly one of a11yRef, testId, or selector must be provided',
+        };
+    }
+    if (provided.length > 1) {
+        return {
+            valid: false,
+            error: `Multiple targets provided (${provided.join(', ')}). Exactly one must be specified.`,
+        };
+    }
+    const type = provided[0];
+    const value = target[type];
+    return { valid: true, type, value };
+}
+//# sourceMappingURL=targets.cjs.map

package/dist/mcp-server/utils/targets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.cjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/targets.ts"],"names":[],"mappings":";;AA2BA,0DA2BC;AAjCD;;;;;GAKG;AACH,SAAgB,uBAAuB,CACrC,MAAuB;IAEvB,MAAM,QAAQ,GAAG;QACf,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;KACpC,CAAC,MAAM,CAAC,OAAO,CAA0C,CAAC;IAE3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,8DAA8D;SACtE,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,8BAA8B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC;SAC5F,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAW,CAAC;IAErC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC","sourcesContent":["import type { TargetSelection } from '../types';\n\n/**\n * Result of target validation.\n */\nexport type TargetValidationResult =\n  | {\n      /** Whether the target is valid */\n      valid: true;\n      /** The type of target selector */\n      type: 'a11yRef' | 'testId' | 'selector';\n      /** The value of the target selector */\n      value: string;\n    }\n  | {\n      /** Whether the target is valid */\n      valid: false;\n      /** Error message describing the validation failure */\n      error: string;\n    };\n\n/**\n * Validates that exactly one target selector is provided.\n *\n * @param target - The target selection object to validate.\n * @returns Validation result with type and value if valid, error if invalid.\n */\nexport function validateTargetSelection(\n  target: TargetSelection,\n): TargetValidationResult {\n  const provided = [\n    target.a11yRef ? 'a11yRef' : null,\n    target.testId ? 'testId' : null,\n    target.selector ? 'selector' : null,\n  ].filter(Boolean) as ('a11yRef' | 'testId' | 'selector')[];\n\n  if (provided.length === 0) {\n    return {\n      valid: false,\n      error: 'Exactly one of a11yRef, testId, or selector must be provided',\n    };\n  }\n\n  if (provided.length > 1) {\n    return {\n      valid: false,\n      error: `Multiple targets provided (${provided.join(', ')}). Exactly one must be specified.`,\n    };\n  }\n\n  const type = provided[0];\n  const value = target[type] as string;\n\n  return { valid: true, type, value };\n}\n"]}

package/dist/mcp-server/utils/targets.d.cts

@@ -0,0 +1,25 @@
+import type { TargetSelection } from "../types/index.cjs";
+/**
+ * Result of target validation.
+ */
+export type TargetValidationResult = {
+    /** Whether the target is valid */
+    valid: true;
+    /** The type of target selector */
+    type: 'a11yRef' | 'testId' | 'selector';
+    /** The value of the target selector */
+    value: string;
+} | {
+    /** Whether the target is valid */
+    valid: false;
+    /** Error message describing the validation failure */
+    error: string;
+};
+/**
+ * Validates that exactly one target selector is provided.
+ *
+ * @param target - The target selection object to validate.
+ * @returns Validation result with type and value if valid, error if invalid.
+ */
+export declare function validateTargetSelection(target: TargetSelection): TargetValidationResult;
+//# sourceMappingURL=targets.d.cts.map

package/dist/mcp-server/utils/targets.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/utils/targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IACE,kCAAkC;IAClC,KAAK,EAAE,IAAI,CAAC;IACZ,kCAAkC;IAClC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,kCAAkC;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,GACtB,sBAAsB,CAyBxB"}

package/dist/mcp-server/utils/targets.d.mts

@@ -0,0 +1,25 @@
+import type { TargetSelection } from "../types/index.mjs";
+/**
+ * Result of target validation.
+ */
+export type TargetValidationResult = {
+    /** Whether the target is valid */
+    valid: true;
+    /** The type of target selector */
+    type: 'a11yRef' | 'testId' | 'selector';
+    /** The value of the target selector */
+    value: string;
+} | {
+    /** Whether the target is valid */
+    valid: false;
+    /** Error message describing the validation failure */
+    error: string;
+};
+/**
+ * Validates that exactly one target selector is provided.
+ *
+ * @param target - The target selection object to validate.
+ * @returns Validation result with type and value if valid, error if invalid.
+ */
+export declare function validateTargetSelection(target: TargetSelection): TargetValidationResult;
+//# sourceMappingURL=targets.d.mts.map

package/dist/mcp-server/utils/targets.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/utils/targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IACE,kCAAkC;IAClC,KAAK,EAAE,IAAI,CAAC;IACZ,kCAAkC;IAClC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,kCAAkC;IAClC,KAAK,EAAE,KAAK,CAAC;IACb,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,GACtB,sBAAsB,CAyBxB"}

package/dist/mcp-server/utils/targets.mjs

@@ -0,0 +1,29 @@
+/**
+ * Validates that exactly one target selector is provided.
+ *
+ * @param target - The target selection object to validate.
+ * @returns Validation result with type and value if valid, error if invalid.
+ */
+export function validateTargetSelection(target) {
+    const provided = [
+        target.a11yRef ? 'a11yRef' : null,
+        target.testId ? 'testId' : null,
+        target.selector ? 'selector' : null,
+    ].filter(Boolean);
+    if (provided.length === 0) {
+        return {
+            valid: false,
+            error: 'Exactly one of a11yRef, testId, or selector must be provided',
+        };
+    }
+    if (provided.length > 1) {
+        return {
+            valid: false,
+            error: `Multiple targets provided (${provided.join(', ')}). Exactly one must be specified.`,
+        };
+    }
+    const type = provided[0];
+    const value = target[type];
+    return { valid: true, type, value };
+}
+//# sourceMappingURL=targets.mjs.map

package/dist/mcp-server/utils/targets.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.mjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/targets.ts"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAuB;IAEvB,MAAM,QAAQ,GAAG;QACf,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI;QAC/B,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;KACpC,CAAC,MAAM,CAAC,OAAO,CAA0C,CAAC;IAE3D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,8DAA8D;SACtE,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,8BAA8B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC;SAC5F,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAW,CAAC;IAErC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC","sourcesContent":["import type { TargetSelection } from '../types';\n\n/**\n * Result of target validation.\n */\nexport type TargetValidationResult =\n  | {\n      /** Whether the target is valid */\n      valid: true;\n      /** The type of target selector */\n      type: 'a11yRef' | 'testId' | 'selector';\n      /** The value of the target selector */\n      value: string;\n    }\n  | {\n      /** Whether the target is valid */\n      valid: false;\n      /** Error message describing the validation failure */\n      error: string;\n    };\n\n/**\n * Validates that exactly one target selector is provided.\n *\n * @param target - The target selection object to validate.\n * @returns Validation result with type and value if valid, error if invalid.\n */\nexport function validateTargetSelection(\n  target: TargetSelection,\n): TargetValidationResult {\n  const provided = [\n    target.a11yRef ? 'a11yRef' : null,\n    target.testId ? 'testId' : null,\n    target.selector ? 'selector' : null,\n  ].filter(Boolean) as ('a11yRef' | 'testId' | 'selector')[];\n\n  if (provided.length === 0) {\n    return {\n      valid: false,\n      error: 'Exactly one of a11yRef, testId, or selector must be provided',\n    };\n  }\n\n  if (provided.length > 1) {\n    return {\n      valid: false,\n      error: `Multiple targets provided (${provided.join(', ')}). Exactly one must be specified.`,\n    };\n  }\n\n  const type = provided[0];\n  const value = target[type] as string;\n\n  return { valid: true, type, value };\n}\n"]}

package/dist/mcp-server/utils/time.cjs

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFilesafeTimestamp = generateFilesafeTimestamp;
+exports.generateSessionId = generateSessionId;
+let lastTimestampMs = 0;
+/**
+ * Generates a file-safe timestamp string with monotonically increasing values.
+ *
+ * @param date - The date to format, defaults to current time.
+ * @returns A timestamp string in YYYYMMDD-HHMMSS-mmm format.
+ */
+function generateFilesafeTimestamp(date = new Date()) {
+    let timestampMs = date.getTime();
+    if (timestampMs <= lastTimestampMs) {
+        timestampMs = lastTimestampMs + 1;
+    }
+    lastTimestampMs = timestampMs;
+    const normalized = new Date(timestampMs);
+    const year = normalized.getFullYear().toString().padStart(4, '0');
+    const month = (normalized.getMonth() + 1).toString().padStart(2, '0');
+    const day = normalized.getDate().toString().padStart(2, '0');
+    const hours = normalized.getHours().toString().padStart(2, '0');
+    const minutes = normalized.getMinutes().toString().padStart(2, '0');
+    const seconds = normalized.getSeconds().toString().padStart(2, '0');
+    const milliseconds = normalized.getMilliseconds().toString().padStart(3, '0');
+    return `${year}${month}${day}-${hours}${minutes}${seconds}-${milliseconds}`;
+}
+/**
+ * Generates a unique session identifier.
+ *
+ * @param prefix - The prefix for the session ID, defaults to 'mm'.
+ * @returns A unique session ID string.
+ */
+function generateSessionId(prefix = 'mm') {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${prefix}-${timestamp}-${random}`;
+}
+//# sourceMappingURL=time.cjs.map

package/dist/mcp-server/utils/time.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.cjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/time.ts"],"names":[],"mappings":";;AAQA,8DAiBC;AAQD,8CAIC;AArCD,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,OAAa,IAAI,IAAI,EAAE;IAC/D,IAAI,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACjC,IAAI,WAAW,IAAI,eAAe,EAAE,CAAC;QACnC,WAAW,GAAG,eAAe,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,eAAe,GAAG,WAAW,CAAC;IAE9B,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE9E,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,OAAO,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,MAAM,GAAG,IAAI;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;AAC5C,CAAC","sourcesContent":["let lastTimestampMs = 0;\n\n/**\n * Generates a file-safe timestamp string with monotonically increasing values.\n *\n * @param date - The date to format, defaults to current time.\n * @returns A timestamp string in YYYYMMDD-HHMMSS-mmm format.\n */\nexport function generateFilesafeTimestamp(date: Date = new Date()): string {\n  let timestampMs = date.getTime();\n  if (timestampMs <= lastTimestampMs) {\n    timestampMs = lastTimestampMs + 1;\n  }\n  lastTimestampMs = timestampMs;\n\n  const normalized = new Date(timestampMs);\n  const year = normalized.getFullYear().toString().padStart(4, '0');\n  const month = (normalized.getMonth() + 1).toString().padStart(2, '0');\n  const day = normalized.getDate().toString().padStart(2, '0');\n  const hours = normalized.getHours().toString().padStart(2, '0');\n  const minutes = normalized.getMinutes().toString().padStart(2, '0');\n  const seconds = normalized.getSeconds().toString().padStart(2, '0');\n  const milliseconds = normalized.getMilliseconds().toString().padStart(3, '0');\n\n  return `${year}${month}${day}-${hours}${minutes}${seconds}-${milliseconds}`;\n}\n\n/**\n * Generates a unique session identifier.\n *\n * @param prefix - The prefix for the session ID, defaults to 'mm'.\n * @returns A unique session ID string.\n */\nexport function generateSessionId(prefix = 'mm'): string {\n  const timestamp = Date.now().toString(36);\n  const random = Math.random().toString(36).substring(2, 8);\n  return `${prefix}-${timestamp}-${random}`;\n}\n"]}

package/dist/mcp-server/utils/time.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Generates a file-safe timestamp string with monotonically increasing values.
+ *
+ * @param date - The date to format, defaults to current time.
+ * @returns A timestamp string in YYYYMMDD-HHMMSS-mmm format.
+ */
+export declare function generateFilesafeTimestamp(date?: Date): string;
+/**
+ * Generates a unique session identifier.
+ *
+ * @param prefix - The prefix for the session ID, defaults to 'mm'.
+ * @returns A unique session ID string.
+ */
+export declare function generateSessionId(prefix?: string): string;
+//# sourceMappingURL=time.d.cts.map

package/dist/mcp-server/utils/time.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/utils/time.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAiBzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAO,GAAG,MAAM,CAIvD"}

package/dist/mcp-server/utils/time.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Generates a file-safe timestamp string with monotonically increasing values.
+ *
+ * @param date - The date to format, defaults to current time.
+ * @returns A timestamp string in YYYYMMDD-HHMMSS-mmm format.
+ */
+export declare function generateFilesafeTimestamp(date?: Date): string;
+/**
+ * Generates a unique session identifier.
+ *
+ * @param prefix - The prefix for the session ID, defaults to 'mm'.
+ * @returns A unique session ID string.
+ */
+export declare function generateSessionId(prefix?: string): string;
+//# sourceMappingURL=time.d.mts.map

package/dist/mcp-server/utils/time.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/utils/time.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAiBzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAO,GAAG,MAAM,CAIvD"}

package/dist/mcp-server/utils/time.mjs

@@ -0,0 +1,35 @@
+let lastTimestampMs = 0;
+/**
+ * Generates a file-safe timestamp string with monotonically increasing values.
+ *
+ * @param date - The date to format, defaults to current time.
+ * @returns A timestamp string in YYYYMMDD-HHMMSS-mmm format.
+ */
+export function generateFilesafeTimestamp(date = new Date()) {
+    let timestampMs = date.getTime();
+    if (timestampMs <= lastTimestampMs) {
+        timestampMs = lastTimestampMs + 1;
+    }
+    lastTimestampMs = timestampMs;
+    const normalized = new Date(timestampMs);
+    const year = normalized.getFullYear().toString().padStart(4, '0');
+    const month = (normalized.getMonth() + 1).toString().padStart(2, '0');
+    const day = normalized.getDate().toString().padStart(2, '0');
+    const hours = normalized.getHours().toString().padStart(2, '0');
+    const minutes = normalized.getMinutes().toString().padStart(2, '0');
+    const seconds = normalized.getSeconds().toString().padStart(2, '0');
+    const milliseconds = normalized.getMilliseconds().toString().padStart(3, '0');
+    return `${year}${month}${day}-${hours}${minutes}${seconds}-${milliseconds}`;
+}
+/**
+ * Generates a unique session identifier.
+ *
+ * @param prefix - The prefix for the session ID, defaults to 'mm'.
+ * @returns A unique session ID string.
+ */
+export function generateSessionId(prefix = 'mm') {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${prefix}-${timestamp}-${random}`;
+}
+//# sourceMappingURL=time.mjs.map

package/dist/mcp-server/utils/time.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.mjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/time.ts"],"names":[],"mappings":"AAAA,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAa,IAAI,IAAI,EAAE;IAC/D,IAAI,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACjC,IAAI,WAAW,IAAI,eAAe,EAAE,CAAC;QACnC,WAAW,GAAG,eAAe,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,eAAe,GAAG,WAAW,CAAC;IAE9B,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE9E,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,OAAO,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAM,GAAG,IAAI;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;AAC5C,CAAC","sourcesContent":["let lastTimestampMs = 0;\n\n/**\n * Generates a file-safe timestamp string with monotonically increasing values.\n *\n * @param date - The date to format, defaults to current time.\n * @returns A timestamp string in YYYYMMDD-HHMMSS-mmm format.\n */\nexport function generateFilesafeTimestamp(date: Date = new Date()): string {\n  let timestampMs = date.getTime();\n  if (timestampMs <= lastTimestampMs) {\n    timestampMs = lastTimestampMs + 1;\n  }\n  lastTimestampMs = timestampMs;\n\n  const normalized = new Date(timestampMs);\n  const year = normalized.getFullYear().toString().padStart(4, '0');\n  const month = (normalized.getMonth() + 1).toString().padStart(2, '0');\n  const day = normalized.getDate().toString().padStart(2, '0');\n  const hours = normalized.getHours().toString().padStart(2, '0');\n  const minutes = normalized.getMinutes().toString().padStart(2, '0');\n  const seconds = normalized.getSeconds().toString().padStart(2, '0');\n  const milliseconds = normalized.getMilliseconds().toString().padStart(3, '0');\n\n  return `${year}${month}${day}-${hours}${minutes}${seconds}-${milliseconds}`;\n}\n\n/**\n * Generates a unique session identifier.\n *\n * @param prefix - The prefix for the session ID, defaults to 'mm'.\n * @returns A unique session ID string.\n */\nexport function generateSessionId(prefix = 'mm'): string {\n  const timestamp = Date.now().toString(36);\n  const random = Math.random().toString(36).substring(2, 8);\n  return `${prefix}-${timestamp}-${random}`;\n}\n"]}

package/dist/mcp-server/utils/type-guards.cjs

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Type guard functions for runtime type safety.
+ * These provide better TypeScript inference and runtime validation
+ * compared to unsafe `as` type assertions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidTargetSelection = isValidTargetSelection;
+exports.isInvalidTargetSelection = isInvalidTargetSelection;
+/**
+ * Type guard for valid target selection result.
+ * Ensures the result has valid=true and contains type and value properties.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is a valid target selection.
+ */
+function isValidTargetSelection(result) {
+    return (typeof result === 'object' &&
+        result !== null &&
+        'valid' in result &&
+        result.valid &&
+        'type' in result &&
+        'value' in result &&
+        typeof result.type === 'string' &&
+        typeof result.value === 'string');
+}
+/**
+ * Type guard for invalid target selection result.
+ * Ensures the result has valid=false and contains error property.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is an invalid target selection.
+ */
+function isInvalidTargetSelection(result) {
+    return (typeof result === 'object' &&
+        result !== null &&
+        'valid' in result &&
+        !result.valid &&
+        'error' in result &&
+        typeof result.error === 'string');
+}
+//# sourceMappingURL=type-guards.cjs.map

package/dist/mcp-server/utils/type-guards.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.cjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/type-guards.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAWH,wDA2BC;AASD,4DAoBC;AA/DD;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,MAAe;IAKpD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAO,IAAI,MAAM;QAEf,MAGD,CAAC,KAAK;QACP,MAAM,IAAI,MAAM;QAChB,OAAO,IAAI,MAAM;QACjB,OACE,MAGD,CAAC,IAAI,KAAK,QAAQ;QACnB,OACE,MAGD,CAAC,KAAK,KAAK,QAAQ,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CAAC,MAAe;IAItD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAO,IAAI,MAAM;QACjB,CACE,MAGD,CAAC,KAAK;QACP,OAAO,IAAI,MAAM;QACjB,OACE,MAGD,CAAC,KAAK,KAAK,QAAQ,CACrB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Type guard functions for runtime type safety.\n * These provide better TypeScript inference and runtime validation\n * compared to unsafe `as` type assertions.\n */\n\nexport type TargetType = 'a11yRef' | 'testId' | 'selector';\n\n/**\n * Type guard for valid target selection result.\n * Ensures the result has valid=true and contains type and value properties.\n *\n * @param result - The result to check.\n * @returns True if the result is a valid target selection.\n */\nexport function isValidTargetSelection(result: unknown): result is {\n  valid: true;\n  type: TargetType;\n  value: string;\n} {\n  return (\n    typeof result === 'object' &&\n    result !== null &&\n    'valid' in result &&\n    (\n      result as {\n        valid: boolean;\n      }\n    ).valid &&\n    'type' in result &&\n    'value' in result &&\n    typeof (\n      result as {\n        type: unknown;\n      }\n    ).type === 'string' &&\n    typeof (\n      result as {\n        value: unknown;\n      }\n    ).value === 'string'\n  );\n}\n\n/**\n * Type guard for invalid target selection result.\n * Ensures the result has valid=false and contains error property.\n *\n * @param result - The result to check.\n * @returns True if the result is an invalid target selection.\n */\nexport function isInvalidTargetSelection(result: unknown): result is {\n  valid: false;\n  error: string;\n} {\n  return (\n    typeof result === 'object' &&\n    result !== null &&\n    'valid' in result &&\n    !(\n      result as {\n        valid: boolean;\n      }\n    ).valid &&\n    'error' in result &&\n    typeof (\n      result as {\n        error: unknown;\n      }\n    ).error === 'string'\n  );\n}\n"]}

package/dist/mcp-server/utils/type-guards.d.cts

@@ -0,0 +1,30 @@
+/**
+ * Type guard functions for runtime type safety.
+ * These provide better TypeScript inference and runtime validation
+ * compared to unsafe `as` type assertions.
+ */
+export type TargetType = 'a11yRef' | 'testId' | 'selector';
+/**
+ * Type guard for valid target selection result.
+ * Ensures the result has valid=true and contains type and value properties.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is a valid target selection.
+ */
+export declare function isValidTargetSelection(result: unknown): result is {
+    valid: true;
+    type: TargetType;
+    value: string;
+};
+/**
+ * Type guard for invalid target selection result.
+ * Ensures the result has valid=false and contains error property.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is an invalid target selection.
+ */
+export declare function isInvalidTargetSelection(result: unknown): result is {
+    valid: false;
+    error: string;
+};
+//# sourceMappingURL=type-guards.d.cts.map

package/dist/mcp-server/utils/type-guards.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI;IACjE,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAuBA;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI;IACnE,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAiBA"}

package/dist/mcp-server/utils/type-guards.d.mts

@@ -0,0 +1,30 @@
+/**
+ * Type guard functions for runtime type safety.
+ * These provide better TypeScript inference and runtime validation
+ * compared to unsafe `as` type assertions.
+ */
+export type TargetType = 'a11yRef' | 'testId' | 'selector';
+/**
+ * Type guard for valid target selection result.
+ * Ensures the result has valid=true and contains type and value properties.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is a valid target selection.
+ */
+export declare function isValidTargetSelection(result: unknown): result is {
+    valid: true;
+    type: TargetType;
+    value: string;
+};
+/**
+ * Type guard for invalid target selection result.
+ * Ensures the result has valid=false and contains error property.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is an invalid target selection.
+ */
+export declare function isInvalidTargetSelection(result: unknown): result is {
+    valid: false;
+    error: string;
+};
+//# sourceMappingURL=type-guards.d.mts.map

package/dist/mcp-server/utils/type-guards.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI;IACjE,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAuBA;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI;IACnE,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAiBA"}

package/dist/mcp-server/utils/type-guards.mjs

@@ -0,0 +1,38 @@
+/**
+ * Type guard functions for runtime type safety.
+ * These provide better TypeScript inference and runtime validation
+ * compared to unsafe `as` type assertions.
+ */
+/**
+ * Type guard for valid target selection result.
+ * Ensures the result has valid=true and contains type and value properties.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is a valid target selection.
+ */
+export function isValidTargetSelection(result) {
+    return (typeof result === 'object' &&
+        result !== null &&
+        'valid' in result &&
+        result.valid &&
+        'type' in result &&
+        'value' in result &&
+        typeof result.type === 'string' &&
+        typeof result.value === 'string');
+}
+/**
+ * Type guard for invalid target selection result.
+ * Ensures the result has valid=false and contains error property.
+ *
+ * @param result - The result to check.
+ * @returns True if the result is an invalid target selection.
+ */
+export function isInvalidTargetSelection(result) {
+    return (typeof result === 'object' &&
+        result !== null &&
+        'valid' in result &&
+        !result.valid &&
+        'error' in result &&
+        typeof result.error === 'string');
+}
+//# sourceMappingURL=type-guards.mjs.map

package/dist/mcp-server/utils/type-guards.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.mjs","sourceRoot":"","sources":["../../../src/mcp-server/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAe;IAKpD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAO,IAAI,MAAM;QAEf,MAGD,CAAC,KAAK;QACP,MAAM,IAAI,MAAM;QAChB,OAAO,IAAI,MAAM;QACjB,OACE,MAGD,CAAC,IAAI,KAAK,QAAQ;QACnB,OACE,MAGD,CAAC,KAAK,KAAK,QAAQ,CACrB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAe;IAItD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAO,IAAI,MAAM;QACjB,CACE,MAGD,CAAC,KAAK;QACP,OAAO,IAAI,MAAM;QACjB,OACE,MAGD,CAAC,KAAK,KAAK,QAAQ,CACrB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Type guard functions for runtime type safety.\n * These provide better TypeScript inference and runtime validation\n * compared to unsafe `as` type assertions.\n */\n\nexport type TargetType = 'a11yRef' | 'testId' | 'selector';\n\n/**\n * Type guard for valid target selection result.\n * Ensures the result has valid=true and contains type and value properties.\n *\n * @param result - The result to check.\n * @returns True if the result is a valid target selection.\n */\nexport function isValidTargetSelection(result: unknown): result is {\n  valid: true;\n  type: TargetType;\n  value: string;\n} {\n  return (\n    typeof result === 'object' &&\n    result !== null &&\n    'valid' in result &&\n    (\n      result as {\n        valid: boolean;\n      }\n    ).valid &&\n    'type' in result &&\n    'value' in result &&\n    typeof (\n      result as {\n        type: unknown;\n      }\n    ).type === 'string' &&\n    typeof (\n      result as {\n        value: unknown;\n      }\n    ).value === 'string'\n  );\n}\n\n/**\n * Type guard for invalid target selection result.\n * Ensures the result has valid=false and contains error property.\n *\n * @param result - The result to check.\n * @returns True if the result is an invalid target selection.\n */\nexport function isInvalidTargetSelection(result: unknown): result is {\n  valid: false;\n  error: string;\n} {\n  return (\n    typeof result === 'object' &&\n    result !== null &&\n    'valid' in result &&\n    !(\n      result as {\n        valid: boolean;\n      }\n    ).valid &&\n    'error' in result &&\n    typeof (\n      result as {\n        error: unknown;\n      }\n    ).error === 'string'\n  );\n}\n"]}