@dev-blinq/cucumber_client 1.0.1744-dev → 1.0.1745-dev

package/bin/client/code_cleanup/utils.js

@@ -14,6 +14,40 @@ import socketLogger, { getErrorMessage } from "../utils/socket_logger.js";
 
 const STEP_KEYWORDS = new Set(["Given", "When", "Then"]);
 
+/**
+ * @typedef {Object} StepDefinitionParseError
+ * @property {"STEP_DEFINITION_PARSE_ERROR"} code
+ * @property {string} message
+ * @property {string} filePath
+ * @property {number | null} line
+ * @property {number | null} column
+ * @property {Error} cause
+ */
+
+/**
+ * Create a structured parse error for step definition files.
+ * @param {string} filePath
+ * @param {unknown} error
+ * @returns {Error & StepDefinitionParseError}
+ */
+export function createStepDefinitionParseError(filePath, error) {
+  const err = error instanceof Error ? error : new Error(String(error));
+  const loc = /** @type {any} */ (error)?.loc || /** @type {any} */ (error)?.location;
+  const line = loc?.line ?? null;
+  const column = loc?.column ?? null;
+  const message = err.message || "Failed to parse step definition file";
+
+  const parseError = new Error(
+    `Step definition parse failed in ${filePath}${line ? `:${line}${column !== null ? `:${column}` : ""}` : ""}: ${message}`
+  );
+  /** @type {Error & StepDefinitionParseError} */ (parseError).code = "STEP_DEFINITION_PARSE_ERROR";
+  /** @type {Error & StepDefinitionParseError} */ (parseError).filePath = filePath;
+  /** @type {Error & StepDefinitionParseError} */ (parseError).line = line;
+  /** @type {Error & StepDefinitionParseError} */ (parseError).column = column;
+  /** @type {Error & StepDefinitionParseError} */ (parseError).cause = err;
+  return /** @type {Error & StepDefinitionParseError} */ (parseError);
+}
+
 /**
  * Parse a step definitions file and return its AST.
  * @param {string} filePath
@@ -21,12 +55,15 @@ const STEP_KEYWORDS = new Set(["Given", "When", "Then"]);
  */
 export async function parse(filePath) {
   const code = await fs.readFile(filePath, "utf-8");
-  const ast = babelParse(code, {
-    sourceType: "module",
-
-    // plugins: ["jsx", "typescript"],
-  });
-  return ast;
+  try {
+    const ast = babelParse(code, {
+      sourceType: "module",
+      // plugins: ["jsx", "typescript"],
+    });
+    return ast;
+  } catch (error) {
+    throw createStepDefinitionParseError(filePath, error);
+  }
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dev-blinq/cucumber_client",
-  "version": "1.0.1744-dev",
+  "version": "1.0.1745-dev",
   "description": " ",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",