@tng-sh/js 0.1.3 → 0.1.5

package/.tmp/tng-clone-data-1770062573900-923.json

@@ -0,0 +1 @@
+{"file_path":"/Users/claudiu/work/tng-inc/js-pie/test_duplicates.js","matches":[{"start1":1,"end1":13,"start2":16,"end2":28,"line_count":13,"node_count":12,"complexity_score":245,"algo":"structural"}]}

package/.tmp/tng-progress-control-1770062573779-154.json

@@ -0,0 +1 @@
+{"type":"step","step":1,"message":"Done!","percent":100}

package/.tmp/tng_sh_js-49dc3b9a.napi_type_def.tmp

@@ -0,0 +1,13 @@
+tng_sh_js:{"kind": "interface", "name": "CloneMatch", "js_doc": "", "def": "start1: number\nend1: number\nstart2: number\nend2: number\nlineCount: number\nnodeCount: number\ncomplexityScore: number\nalgo: string", "original_name": "CloneMatch"}
+tng_sh_js:{"kind": "fn", "name": "getFileOutline", "js_doc": "/**\n * Analyzes a JavaScript/TypeScript file and returns its structural outline as a JSON string.\n * Contains information about classes and methods found in the file.\n */\n", "def": "export declare function getFileOutline(filePath: string): string"}
+tng_sh_js:{"kind": "fn", "name": "getProjectMetadata", "js_doc": "/**\n * Gathers project-wide metadata from package.json and related files.\n * Returns a JSON string containing dependencies, frameworks, and project type.\n */\n", "def": "export declare function getProjectMetadata(projectRoot: string): string"}
+tng_sh_js:{"kind": "fn", "name": "findCallSites", "js_doc": "/**\n * Searches the project for all locations where a specific method is called.\n * Uses ripgrep under the hood for high performance.\n */\n", "def": "export declare function findCallSites(projectRoot: string, methodName: string): string"}
+tng_sh_js:{"kind": "fn", "name": "ping", "js_doc": "/** Pings the TNG API to verify connectivity and API key validity. */\n", "def": "export declare function ping(baseUrl: string, apiKey?: string | undefined | null): string"}
+tng_sh_js:{"kind": "fn", "name": "submitJob", "js_doc": "/** Submits a test generation job to the API and returns the numeric job ID. */\n", "def": "export declare function submitJob(baseUrl: string, apiKey: string, payloadJson: string): number"}
+tng_sh_js:{"kind": "fn", "name": "getUserStats", "js_doc": "/** Fetches usage statistics for the authenticated user from the API. */\n", "def": "export declare function getUserStats(baseUrl: string, apiKey: string): string"}
+tng_sh_js:{"kind": "fn", "name": "runAudit", "js_doc": "/**\n * Orchestrates the code audit process.\n * Analyzes the source, builds context, and streams results via the provided callback.\n */\n", "def": "export declare function runAudit(filePath: string, methodName: string, className: string | undefined | null, testType: string | undefined | null, configJson: string, callback: (...args: any[]) => any): string"}
+tng_sh_js:{"kind": "fn", "name": "applyEdit", "js_doc": "/**\n * Applies a single edit operation to a file.\n * Uses backup and atomic write for safety.\n */\n", "def": "export declare function applyEdit(filePath: string, search: string, replace: string, lineHint?: number | undefined | null): string"}
+tng_sh_js:{"kind": "fn", "name": "applyEditsAtomic", "js_doc": "/**\n * Applies multiple edit operations atomically.\n * All succeed or all fail (with rollback).\n */\n", "def": "export declare function applyEditsAtomic(operationsJson: string): string"}
+tng_sh_js:{"kind": "fn", "name": "generateTest", "js_doc": "/**\n * Orchestrates the test generation process.\n * Analyzes code, submits a job, and polls for the final generated test.\n */\n", "def": "export declare function generateTest(filePath: string, methodName: string, className: string | undefined | null, testType: string | undefined | null, configJson: string, callback: (...args: any[]) => any): string"}
+tng_sh_js:{"kind": "fn", "name": "getSymbolicTrace", "js_doc": "/** Analyzes a method and generates a symbolic execution trace. */\n", "def": "export declare function getSymbolicTrace(filePath: string, methodName: string, className?: string | undefined | null): string"}
+tng_sh_js:{"kind": "fn", "name": "analyzeClones", "js_doc": "/**\n * Analyzes a file for code clones (duplicates).\n * Returns a JSON string containing the matches found.\n */\n", "def": "export declare function analyzeClones(projectRoot: string, filePath: string, level: string): string"}

package/.tmp/tng_sh_js-49dc3b9a.napi_wasi_register.tmp

@@ -0,0 +1,13 @@
+tng_sh_js: __napi_register__CloneMatch_struct_0
+tng_sh_js: __napi_register__get_file_outline_1
+tng_sh_js: __napi_register__get_project_metadata_2
+tng_sh_js: __napi_register__find_call_sites_3
+tng_sh_js: __napi_register__ping_4
+tng_sh_js: __napi_register__submit_job_5
+tng_sh_js: __napi_register__get_user_stats_6
+tng_sh_js: __napi_register__run_audit_7
+tng_sh_js: __napi_register__apply_edit_8
+tng_sh_js: __napi_register__apply_edits_atomic_9
+tng_sh_js: __napi_register__generate_test_10
+tng_sh_js: __napi_register__get_symbolic_trace_11
+tng_sh_js: __napi_register__analyze_clones_12

package/README.md

@@ -4,69 +4,79 @@ High-performance test generation and context analysis for JavaScript/TypeScript,
 
 ## Installation
 
+Install the package as a development dependency in your project:
+
 ```bash
 npm install @tng-sh/js --save-dev
 ```
 
-## Quick Start
+## Usage
 
 ### 1. Initialize
-Run the init command to create a `tng.config.js` configuration file in your project:
+First, run the init command to create a `tng.config.js` configuration file. This file stores your API keys and project settings.
 
 ```bash
-npx -p @tng-sh/js tng init
+npx tng init
 ```
 
-### 2. Generate Tests
-Generate a test for a specific function in a file:
+### 2. Interactive Mode (TUI)
+The most powerful way to use TNG is via the high-performance terminal interface. It provides a guided experience for all analysis tasks.
 
 ```bash
-npx -p @tng-sh/js tng -f path/to/file.js -m functionName -t react_component
+npx tng i
+```
+
+**Capabilities in TUI:**
+*   **Generate Tests**: Guided test creation for methods, components, and utilities.
+*   **Audit Method**: Deep security, performance, and best-practice auditing.
+*   **Trace Method**: Symbolic execution and logic flow visualization.
+*   **X-Ray Method**: Deep dependency and side-effect analysis.
+*   **Check Duplicates**: High-performance clone detection across the codebase.
+*   **Dead Code**: Identify unreachable logic and unused variables/parameters.
+*   **User Stats**: Review your usage metrics and generation history.
+
+### 3. Command Line Interface (CLI) ⚙️
+For direct execution or integration into scripts.
+
+```bash
+# See file outline and method list
+npx tng -f path/to/file.js --outline
+
+# Generate tests for a specific method
+npx tng -f path/to/file.js -m functionName -t react_component
+
+# Check for code clones
+npx tng -f path/to/file.js --clones
 ```
 
 **Supported Types (`-t`):**
-- `react_component`
-- `express_handler`
-- `graphql_resolver`
-- `nest_js` (Service/Controller)
-- `orm_model`
-- `background_job`
-- `mailer`
-- `utility`
-
-### 3. Interactive Mode
-Launch the interactive UI to explore and generate tests visually:
+`react_component`, `express_handler`, `graphql_resolver`, `nest_js`, `orm_model`, `background_job`, `mailer`, `utility`.
+
+### 4. Machine-Readable Output (`--json`) 🤖
+Add the `--json` flag to any command to receive output as structured JSON events. This is ideal for CI/CD pipelines or custom integrations.
 
 ```bash
-npx -p @tng-sh/js tng i
+npx tng -f path/to/file.js --clones --json
 ```
 
 ## Features
 
-- ⚡️ **Fast AST Analysis**: Powered by Rust and the `oxc` parser for blazing fast static analysis.
-- 🖥️ **Interactive UI**: Rich Go-based terminal UI for managing test generation.
-- 🎨 **Prettier Integration**: Automatically formats generated tests to match your project style.
-- 📘 **TypeScript Support**: First-class support for TypeScript analysis.
+-   **Oxc-Powered**: Blazing fast AST analysis using the industry-leading Rust parser.
+-   **Multi-Platform**: Native support for macOS (Intel/ARM) and Linux (x64/ARM64).
+-   **Prettier Integration**: Automatically formats generated code to match your existing style.
+-   **TypeScript Native**: First-class support for `.ts` and `.tsx` analysis and generation.
 
-## Configuration
+## ⚙️ Configuration
 
-The `tng.config.js` file allows you to customize the behavior:
+Your `tng.config.js` allows for full customization:
 
 ```javascript
 module.exports = {
-  // API Configuration
   API_KEY: "your-api-key-here",
   API_URL: "https://app.tng.sh/",
-
-  // Framework Detection
-  // Options: express, nextjs, nestjs, generic
-  FRAMEWORK: "express",
-
-  // Testing Configuration
-  // Options: jest, mocha, vitest
-  TEST_FRAMEWORK: "jest",
-
-  // Test Directory
-  TEST_DIRECTORY: "tests"
+  FRAMEWORK: "express",        // Options: express, nextjs, nestjs, generic
+  TESTS_PATH: "tests",         // Where to save generated tests
+  TEST_FRAMEWORK: "jest"       // Options: jest, mocha, vitest
 };
 ```
+

package/bin/tng.js

@@ -27,8 +27,8 @@ process.on('uncaughtException', (err) => {
 
 program
     .name('tng')
-    .description('TNG - Automated Test Generation, and audit generation for JavaScript')
-    .version('0.1.3');
+    .description('TNG - Automated Test Generation, and Audit generation for JavaScript')
+    .version('0.1.5');
 
 /**
  * @command init
@@ -211,6 +211,8 @@ program
     .option('-t, --type <type>', 'Component type (react_component, express_handler, etc) [required]')
     .option('-a, --audit', 'Run audit mode instead of test generation')
     .option('--trace', 'Run symbolic trace visualization')
+    .option('-c, --clones', 'Run duplicate code detection')
+    .option('-l, --level <level>', 'Set clone detection level (1, 2, or all)', 'all')
     .option('--json', 'Output results as JSON events (machine-readable)')
 
     .action(async (options) => {
@@ -261,12 +263,72 @@ program
             }
             generateTest(options.file, options.method, options.type, options.audit, options.json);
         } else if (options.file && !options.method) {
-            console.log(chalk.yellow('Specify a method with -m, use --outline to see methods, or run "tng i" for full selection.'));
+            if (options.clones) {
+                runClones(options.file, options.level || 'all', options.json);
+            } else {
+                console.log(chalk.yellow('Specify a method with -m, use --outline to see methods, or run "tng i" for full selection.'));
+            }
         } else if (!options.file && !options.method && process.argv.length <= 2) {
             launchInteractive();
         }
     });
 
+/**
+ * Logic to run clone detection
+ */
+async function runClones(filePath, level, jsonMode = false) {
+    const { analyzeClones } = require('../index');
+    const absolutePath = path.resolve(filePath);
+    const projectRoot = process.cwd();
+
+    if (!fs.existsSync(absolutePath)) {
+        console.log(chalk.red(`File not found: ${filePath}`));
+        process.exit(1);
+    }
+
+    const GoUISession = require('../lib/goUiSession');
+    const session = new GoUISession();
+
+    if (jsonMode) {
+        const { JsonSession } = require('../lib/jsonSession');
+        const jsonSession = new JsonSession();
+        jsonSession.start();
+        try {
+            const matchesJson = analyzeClones(projectRoot, absolutePath, level);
+            const matches = JSON.parse(matchesJson);
+            jsonSession.showClones(absolutePath, matches);
+            jsonSession.stop();
+        } catch (e) {
+            jsonSession.displayError(e.message);
+            jsonSession.stop();
+            process.exit(1);
+        }
+        return;
+    }
+
+    console.log(chalk.blue(`🔍 Analyzing clones in ${filePath}...`));
+
+    try {
+        const matches = await session.showProgress('Analyzing clones...', async (progress) => {
+            progress.update('Scanning structures...', { percent: 50 });
+            const matchesJson = analyzeClones(projectRoot, absolutePath, level);
+            const matches = JSON.parse(matchesJson);
+            progress.update('Done!', { percent: 100 });
+
+            // Short delay to let the user see 100%
+            await new Promise(r => setTimeout(r, 100));
+            return matches;
+        });
+
+        if (matches) {
+            session.showClones(absolutePath, matches);
+        }
+    } catch (e) {
+        console.log(chalk.red(`Error: ${e.message}`));
+        process.exit(1);
+    }
+}
+
 /**
  * @command fix
  * Apply a specific fix to a file

package/index.d.ts

@@ -3,6 +3,16 @@
 
 /* auto-generated by NAPI-RS */
 
+export interface CloneMatch {
+  start1: number
+  end1: number
+  start2: number
+  end2: number
+  lineCount: number
+  nodeCount: number
+  complexityScore: number
+  algo: string
+}
 /**
  * Analyzes a JavaScript/TypeScript file and returns its structural outline as a JSON string.
  * Contains information about classes and methods found in the file.
@@ -46,3 +56,8 @@ export declare function applyEditsAtomic(operationsJson: string): string
 export declare function generateTest(filePath: string, methodName: string, className: string | undefined | null, testType: string | undefined | null, configJson: string, callback: (...args: any[]) => any): string
 /** Analyzes a method and generates a symbolic execution trace. */
 export declare function getSymbolicTrace(filePath: string, methodName: string, className?: string | undefined | null): string
+/**
+ * Analyzes a file for code clones (duplicates).
+ * Returns a JSON string containing the matches found.
+ */
+export declare function analyzeClones(projectRoot: string, filePath: string, level: string): string

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { getFileOutline, getProjectMetadata, findCallSites, ping, submitJob, getUserStats, runAudit, applyEdit, applyEditsAtomic, generateTest, getSymbolicTrace } = nativeBinding
+const { getFileOutline, getProjectMetadata, findCallSites, ping, submitJob, getUserStats, runAudit, applyEdit, applyEditsAtomic, generateTest, getSymbolicTrace, analyzeClones } = nativeBinding
 
 module.exports.getFileOutline = getFileOutline
 module.exports.getProjectMetadata = getProjectMetadata
@@ -323,3 +323,4 @@ module.exports.applyEdit = applyEdit
 module.exports.applyEditsAtomic = applyEditsAtomic
 module.exports.generateTest = generateTest
 module.exports.getSymbolicTrace = getSymbolicTrace
+module.exports.analyzeClones = analyzeClones

package/lib/generateTestsUi.js

@@ -40,6 +40,9 @@ class GenerateTestsUI {
             } else if (choice === 'trace') {
                 const result = await this._showFileSelection(false, false, true);
                 if (result === 'exit') return 'exit';
+            } else if (choice === 'clones') {
+                const result = await this._showClonesSelection();
+                if (result === 'exit') return 'exit';
             } else if (choice === 'stats') {
                 await this._showStats();
             } else if (choice === 'about') {
@@ -708,6 +711,62 @@ class GenerateTestsUI {
             console.error(chalk.red(`Trace error: ${e.message}`));
         }
     }
+
+    async _showClonesSelection() {
+        const files = await this._getUserFiles();
+
+        if (files.length === 0) {
+            console.log(chalk.yellow('\nNo JavaScript or TypeScript files found in your project.\n'));
+            return 'back';
+        }
+
+        const cwd = process.cwd();
+        const items = files.map(file => ({
+            name: path.relative(cwd, file),
+            path: path.dirname(file)
+        }));
+
+        const selectedName = this.goUiSession.showListView('Select File for Duplicate Detection', items);
+
+        if (selectedName === 'back') return 'back';
+        if (!selectedName || selectedName === 'exit') return 'exit';
+
+        const selectedFile = path.resolve(cwd, selectedName);
+
+        // Show level selection
+        const level = this.goUiSession.showCloneMenu();
+        if (level === 'back') return this._showClonesSelection();
+
+        await this._runClones(selectedFile, level);
+        return 'main_menu';
+    }
+
+    async _runClones(filePath, level) {
+        const { analyzeClones } = require('../index');
+        const absolutePath = path.resolve(filePath);
+        const projectRoot = process.cwd();
+
+        console.log(chalk.blue(`🔍 Analyzing clones in ${path.relative(projectRoot, filePath)}...`));
+
+        try {
+            const matches = await this.goUiSession.showProgress('Analyzing clones...', async (progress) => {
+                progress.update('Scanning structures...', { percent: 50 });
+                const matchesJson = analyzeClones(projectRoot, absolutePath, level);
+                const matches = JSON.parse(matchesJson);
+                progress.update('Done!', { percent: 100 });
+
+                // Short delay to let the user see 100%
+                await new Promise(r => setTimeout(r, 100));
+                return matches;
+            });
+
+            if (matches) {
+                this.goUiSession.showClones(absolutePath, matches);
+            }
+        } catch (e) {
+            console.log(chalk.red(`Error: ${e.message}`));
+        }
+    }
 }
 
 module.exports = GenerateTestsUI;

package/lib/goUiSession.js

@@ -78,6 +78,30 @@ class GoUISession {
         }
     }
 
+    showCloneMenu() {
+        const outputFile = this._trackTempFile(this._createTempFile('clone-menu-output', '.txt'));
+
+        try {
+            const result = spawnSync(this._binaryPath, ['clone-menu', '--output', outputFile], {
+                stdio: 'inherit'
+            });
+
+            if (result.error) throw result.error;
+
+            if (!fs.existsSync(outputFile) || fs.statSync(outputFile).size === 0) {
+                return 'back';
+            }
+
+            const choice = fs.readFileSync(outputFile, 'utf8').trim();
+            return choice || 'back';
+        } catch (error) {
+            console.error('Clone Menu error:', error.message);
+            return 'back';
+        } finally {
+            this._cleanupTempFile(outputFile);
+        }
+    }
+
     showListView(title, items) {
         const dataJson = JSON.stringify({ title, items });
         const outputFile = this._trackTempFile(this._createTempFile('list-view-output', '.txt'));
@@ -148,6 +172,22 @@ class GoUISession {
         }
     }
 
+    showSystemStatus(statusData) {
+        const dataJson = JSON.stringify(statusData);
+        const inputFile = this._trackTempFile(this._createTempFile('system-status', '.json'));
+
+        try {
+            fs.writeFileSync(inputFile, dataJson);
+            spawnSync(this._binaryPath, ['system-status', '--file', inputFile], {
+                stdio: 'inherit'
+            });
+        } catch (error) {
+            console.error('System status error:', error.message);
+        } finally {
+            this._cleanupTempFile(inputFile);
+        }
+    }
+
     showAbout() {
         try {
             spawnSync(this._binaryPath, ['about'], {
@@ -311,6 +351,24 @@ class GoUISession {
         }
     }
 
+    async showClones(filePath, results) {
+        const dataJson = JSON.stringify({ file_path: filePath, matches: results });
+        const inputFile = this._trackTempFile(this._createTempFile('clone-data', '.json'));
+
+        try {
+            fs.writeFileSync(inputFile, dataJson);
+
+            spawnSync(this._binaryPath, ['clones', '--file', inputFile], {
+                stdio: 'inherit',
+                env: process.env
+            });
+        } catch (error) {
+            console.error('Clone results display error:', error.message);
+        } finally {
+            this._cleanupTempFile(inputFile);
+        }
+    }
+
     async showStreamingAuditResults(methodName, className, sourceCode) {
         const outputFile = this._trackTempFile(this._createTempFile('audit-choice', '.txt'));
 
@@ -374,6 +432,27 @@ class GoUISession {
         }
     }
 
+    showAuthError(message = 'Authentication failed') {
+        try {
+            spawnSync(this._binaryPath, ['auth-error', '--message', message], {
+                stdio: 'inherit'
+            });
+        } catch (error) {
+            console.error('Auth error:', error.message);
+        }
+    }
+
+    showConfigError(missing = []) {
+        try {
+            const dataJson = JSON.stringify({ missing });
+            spawnSync(this._binaryPath, ['config-error', '--data', dataJson], {
+                stdio: 'inherit'
+            });
+        } catch (error) {
+            console.error('Config error:', error.message);
+        }
+    }
+
     _findGoUiBinary() {
         const platform = process.platform;
         const arch = process.arch;
@@ -397,8 +476,20 @@ class GoUISession {
 
     _createTempFile(prefix, suffix) {
         const tmpDir = os.tmpdir();
-        const filePath = path.join(tmpDir, `tng-${prefix}-${Date.now()}-${Math.floor(Math.random() * 1000)}${suffix}`);
-        fs.writeFileSync(filePath, '');
+        const fileName = `tng-${prefix}-${Date.now()}-${Math.floor(Math.random() * 1000)}${suffix}`;
+        let filePath = path.join(tmpDir, fileName);
+
+        try {
+            fs.writeFileSync(filePath, '');
+        } catch (e) {
+            // Fallback to local directory if system tmp is not writable
+            const localTmp = path.join(process.cwd(), '.tng-tmp');
+            if (!fs.existsSync(localTmp)) {
+                fs.mkdirSync(localTmp, { recursive: true });
+            }
+            filePath = path.join(localTmp, fileName);
+            fs.writeFileSync(filePath, '');
+        }
         return filePath;
     }
 

package/lib/jsonSession.js

@@ -66,6 +66,10 @@ class JsonSession {
         this.emitEvent('result', auditResult || {});
     }
 
+    showClones(filePath, results) {
+        this.emitEvent('clones', { file_path: filePath, matches: results });
+    }
+
     showTestResults(title, passed, failed, errors, total, results = []) {
         this.emitEvent('test_results', {
             title: title || 'Test Results',
@@ -105,7 +109,7 @@ class JsonSession {
 
     emitEvent(type, data = {}) {
         try {
-            const event = { type, ...data, timestamp: Date.now() };
+            const event = { type, ...data };
             console.log(JSON.stringify(event));
         } catch (e) {
             // If serialization fails (e.g. circular ref), emit minimal error

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tng-sh/js",
-    "version": "0.1.3",
+    "version": "0.1.5",
     "description": "TNG JavaScript CLI",
     "repository": {
         "type": "git",