@nivustec/proteus 1.0.1

package/dist/utils.js

@@ -0,0 +1,42 @@
+// Generate a base id for the selected strategy
+export function generateTestId(config, info) {
+    const cleanedFileSlug = info.fileName
+        .replace(/\.(tsx|jsx|ts|js)$/, "")
+        .replace(/[^a-zA-Z0-9]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    const cleanedElement = info.elementName.toLowerCase();
+    const suffixDynamic = (() => {
+        if (info.isDynamic && info.key)
+            return `${info.key}`;
+        if (info.isDynamic && info.index !== undefined)
+            return `${info.index}`;
+        return `L${info.lineNumber}`;
+    })();
+    const qaPrefix = "qa_";
+    if (config.strategy === "functional") {
+        const componentPath = (info.componentPath || [])
+            .filter(Boolean)
+            .join("-")
+            .toLowerCase();
+        const parts = [qaPrefix, componentPath || cleanedFileSlug, cleanedElement, suffixDynamic]
+            .filter(Boolean)
+            .join("-");
+        return parts;
+    }
+    // default to safe-hash
+    const hashInput = `${info.fileName}::${info.elementName}::${info.lineNumber}`;
+    const hash = shortStableHash(hashInput);
+    return `${qaPrefix}${hash}`;
+}
+export function shortStableHash(input) {
+    let h = 5381;
+    for (let i = 0; i < input.length; i++) {
+        h = (h * 33) ^ input.charCodeAt(i);
+    }
+    const unsigned = h >>> 0;
+    return unsigned.toString(36);
+}
+export function normalizePath(path) {
+    return path.replace(/\\/g, "/");
+}

package/dist/watcher.d.ts

@@ -0,0 +1,2 @@
+import { ProteuConfig } from "./types.js";
+export declare function startWatchMode(config: ProteuConfig): void;

package/dist/watcher.js

@@ -0,0 +1,59 @@
+import { watch } from "chokidar";
+import { injectTestIds } from "./injector.js";
+export function startWatchMode(config) {
+    if (!config.injectOnSave) {
+        console.log("ℹ️ injectOnSave is disabled - watch mode inactive");
+        return;
+    }
+    console.log("🔍 Starting development watch mode...");
+    console.log("⚡ Auto-injecting on file save");
+    const watcher = watch(config.include || [
+        "src/**/*.tsx",
+        "src/**/*.jsx",
+    ], {
+        ignored: config.exclude,
+        ignoreInitial: true,
+        persistent: true,
+    });
+    // Debounce map to avoid reacting to our own file writes
+    const lastWrittenAt = {};
+    const isSelfWrite = (filePath) => {
+        const ts = lastWrittenAt[filePath];
+        if (!ts)
+            return false;
+        const now = Date.now();
+        return now - ts < 1000; // 1s window
+    };
+    watcher.on("change", async (filePath) => {
+        if (isSelfWrite(filePath))
+            return; // ignore our own write event
+        console.log(`💾 File saved: ${filePath}`);
+        try {
+            const stats = await injectTestIds(config, [filePath]);
+            if (stats.totalInjected > 0) {
+                console.log(`✅ Auto-injected ${stats.totalInjected} test IDs`);
+                lastWrittenAt[filePath] = Date.now();
+            }
+            else {
+                console.log("💡 All elements already have data-testid");
+            }
+        }
+        catch (error) {
+            console.error(`❌ Auto-injection failed:`, error);
+        }
+    });
+    watcher.on("add", async (filePath) => {
+        console.log(`📁 New file: ${filePath}`);
+        try {
+            const stats = await injectTestIds(config, [filePath]);
+            if (stats.totalInjected > 0) {
+                lastWrittenAt[filePath] = Date.now();
+            }
+        }
+        catch (error) {
+            console.error(`❌ Error processing new file ${filePath}:`, error);
+        }
+    });
+    console.log("👀 Watching for file saves... (Press Ctrl+C to stop)");
+    console.log("💡 Save any React file to auto-inject data-testid");
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@nivustec/proteus",
+  "version": "1.0.1",
+  "type": "module",
+  "description": "Shape-shifting CLI that auto-injects data-testid into React components (JS/TS).",
+  "main": "./dist/cli.js",
+  "bin": {
+    "proteus": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "proteus:pre-commit": "proteus pre-commit"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "proteus",
+    "nivustec",
+    "react",
+    "data-testid",
+    "qa",
+    "testing",
+    "automation",
+    "cli",
+    "test-automation",
+    "javascript",
+    "typescript",
+    "shape-shifter",
+    "code-transformation"
+  ],
+  "author": "Nivustec <contato@nivustec.com.br>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nivustec/proteus"
+  },
+  "homepage": "https://proteus.nivustec.com.br",
+  "bugs": {
+    "url": "https://github.com/nivustec/proteus/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.23.0",
+    "@babel/traverse": "^7.23.0",
+    "@babel/types": "^7.23.0",
+    "chokidar": "^3.5.3",
+    "commander": "^11.1.0",
+    "glob": "^10.3.0"
+  },
+  "devDependencies": {
+    "@types/babel__traverse": "^7.20.1",
+    "@types/node": "^20.8.0",
+    "typescript": "^5.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "npm run proteus:pre-commit"
+    }
+  }
+}