@dupecom/botcha-cli 0.1.0

package/README.md

@@ -0,0 +1,102 @@
+# @dupecom/botcha-cli
+
+> CLI tool for testing and debugging BOTCHA-protected endpoints
+
+## Installation
+
+```bash
+npm install -g @dupecom/botcha-cli
+# or use directly with npx
+npx botcha <command>
+```
+
+## Commands
+
+### Test an Endpoint
+
+Check if an endpoint is BOTCHA-protected and test verification:
+
+```bash
+botcha test https://api.example.com/agent-only
+```
+
+Options:
+- `--json` - Output as JSON
+- `-v, --verbose` - Show detailed output
+- `-q, --quiet` - Minimal output
+
+### Solve Challenges
+
+Solve a specific challenge type:
+
+```bash
+# Get a token
+botcha solve token --url https://botcha.ai/v1/token
+
+# Solve a speed challenge
+botcha solve speed --url https://botcha.ai/api/speed-challenge
+```
+
+Options:
+- `--url <url>` - URL to solve challenge from (required)
+- `--json` - Output as JSON
+- `-v, --verbose` - Show detailed output
+- `-q, --quiet` - Minimal output
+
+### Benchmark
+
+Test performance and reliability:
+
+```bash
+botcha benchmark https://api.example.com/agent-only --iterations 100
+```
+
+Options:
+- `-n, --iterations <number>` - Number of iterations (default: 10)
+- `--json` - Output as JSON
+- `-v, --verbose` - Show each iteration result
+- `-q, --quiet` - Minimal output
+
+### Check Headers
+
+Inspect BOTCHA headers on any URL:
+
+```bash
+botcha headers https://botcha.ai/api
+```
+
+Options:
+- `--json` - Output as JSON
+- `-v, --verbose` - Show all headers (not just BOTCHA)
+- `-q, --quiet` - Minimal output
+
+## Examples
+
+### CI/CD Integration
+
+```yaml
+# GitHub Actions
+- name: Test BOTCHA Protection
+  run: |
+    npx botcha test ${{ env.API_URL }}/protected
+    npx botcha benchmark ${{ env.API_URL }}/protected --iterations 10
+```
+
+### Debugging
+
+```bash
+# See detailed information about challenge solving
+botcha test https://api.example.com/endpoint --verbose
+```
+
+### Scripting
+
+```bash
+# Get token and use in other commands
+TOKEN=$(botcha solve token --url https://botcha.ai/v1/token --json | jq -r '.token')
+curl -H "Authorization: Bearer $TOKEN" https://botcha.ai/agent-only
+```
+
+## License
+
+MIT

package/bin/botcha.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/commands/benchmark.d.ts

@@ -0,0 +1,8 @@
+export interface BenchmarkOptions {
+    iterations?: number;
+    json?: boolean;
+    verbose?: boolean;
+    quiet?: boolean;
+}
+export declare function benchmarkCommand(url: string, options: BenchmarkOptions): Promise<void>;
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/commands/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../src/commands/benchmark.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AASD,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6F5F"}

package/dist/commands/benchmark.js

@@ -0,0 +1,89 @@
+/**
+ * Benchmark command - Test performance and reliability
+ */
+import { BotchaClient } from '@dupecom/botcha/client';
+import { Output } from '../lib/output.js';
+export async function benchmarkCommand(url, options) {
+    const output = new Output(options);
+    const iterations = options.iterations || 10;
+    output.header(`\n🏃 Running ${iterations} iterations...\n`);
+    const client = new BotchaClient({ baseUrl: new URL(url).origin });
+    const results = [];
+    const startTime = Date.now();
+    for (let i = 0; i < iterations; i++) {
+        const spinner = output.spinner(`Iteration ${i + 1}/${iterations}...`);
+        const iterStart = Date.now();
+        try {
+            const response = await client.fetch(url);
+            const timeMs = Date.now() - iterStart;
+            results.push({
+                iteration: i + 1,
+                success: response.ok,
+                timeMs,
+            });
+            spinner.stop();
+            if (options.verbose) {
+                const status = response.ok ? '✅' : '❌';
+                output.info(`${status} Iteration ${i + 1}: ${timeMs}ms (${response.status})`);
+            }
+        }
+        catch (error) {
+            const timeMs = Date.now() - iterStart;
+            results.push({
+                iteration: i + 1,
+                success: false,
+                timeMs,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            spinner.stop();
+            if (options.verbose) {
+                output.error(`❌ Iteration ${i + 1}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    const totalTime = Date.now() - startTime;
+    const successCount = results.filter(r => r.success).length;
+    const successRate = (successCount / iterations) * 100;
+    const times = results.filter(r => r.success).map(r => r.timeMs);
+    if (times.length === 0) {
+        output.error('All iterations failed!');
+        process.exit(1);
+    }
+    const avgTime = times.reduce((a, b) => a + b, 0) / times.length;
+    const minTime = Math.min(...times);
+    const maxTime = Math.max(...times);
+    // Calculate P95
+    const sortedTimes = [...times].sort((a, b) => a - b);
+    const p95Index = Math.ceil(sortedTimes.length * 0.95) - 1;
+    const p95Time = sortedTimes[p95Index] || sortedTimes[sortedTimes.length - 1];
+    if (options.json) {
+        output.json({
+            url,
+            iterations,
+            successRate,
+            successCount,
+            failureCount: iterations - successCount,
+            avgTimeMs: Math.round(avgTime),
+            minTimeMs: minTime,
+            maxTimeMs: maxTime,
+            p95TimeMs: p95Time,
+            totalTimeMs: totalTime,
+            requestsPerSec: (iterations / (totalTime / 1000)).toFixed(2),
+            results,
+        });
+    }
+    else {
+        console.log('\n' + '─'.repeat(50));
+        output.header('Results:');
+        output.section('Success Rate', `${successRate.toFixed(1)}% (${successCount}/${iterations})`);
+        output.section('Avg Time', `${Math.round(avgTime)}ms`);
+        output.section('Min Time', `${minTime}ms`);
+        output.section('Max Time', `${maxTime}ms`);
+        output.section('P95 Time', `${p95Time}ms`);
+        console.log();
+        output.section('Total Time', `${(totalTime / 1000).toFixed(2)}s`);
+        output.section('Requests/sec', (iterations / (totalTime / 1000)).toFixed(2));
+        console.log();
+    }
+}
+//# sourceMappingURL=benchmark.js.map

package/dist/commands/benchmark.js.map

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

package/dist/commands/headers.d.ts

@@ -0,0 +1,7 @@
+export interface HeadersOptions {
+    json?: boolean;
+    verbose?: boolean;
+    quiet?: boolean;
+}
+export declare function headersCommand(url: string, options: HeadersOptions): Promise<void>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/commands/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/commands/headers.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmExF"}

package/dist/commands/headers.js

@@ -0,0 +1,68 @@
+/**
+ * Headers command - Show BOTCHA headers from a URL
+ */
+import { Output, formatUrl } from '../lib/output.js';
+export async function headersCommand(url, options) {
+    const output = new Output(options);
+    output.header(`\n🔍 Fetching headers from ${formatUrl(url)}...\n`);
+    try {
+        const response = await fetch(url, {
+            method: 'HEAD',
+        });
+        const botchaHeaders = {};
+        const allHeaders = {};
+        response.headers.forEach((value, key) => {
+            allHeaders[key] = value;
+            if (key.toLowerCase().startsWith('x-botcha-')) {
+                botchaHeaders[key] = value;
+            }
+        });
+        if (options.json) {
+            output.json({
+                url,
+                statusCode: response.status,
+                botchaHeaders,
+                allHeaders: options.verbose ? allHeaders : undefined,
+            });
+            return;
+        }
+        if (Object.keys(botchaHeaders).length === 0) {
+            output.warn('No BOTCHA headers found');
+            if (options.verbose) {
+                console.log('\nAll headers:');
+                for (const [key, value] of Object.entries(allHeaders)) {
+                    console.log(`  ${key}: ${value}`);
+                }
+            }
+        }
+        else {
+            output.success('BOTCHA headers found:');
+            console.log();
+            for (const [key, value] of Object.entries(botchaHeaders)) {
+                console.log(`  ${key}: ${value}`);
+            }
+            if (options.verbose) {
+                console.log('\nAll headers:');
+                for (const [key, value] of Object.entries(allHeaders)) {
+                    if (!key.toLowerCase().startsWith('x-botcha-')) {
+                        console.log(`  ${key}: ${value}`);
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        if (options.json) {
+            output.json({
+                url,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        else {
+            output.error(`Failed to fetch headers: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=headers.js.map

package/dist/commands/headers.js.map

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

package/dist/commands/solve.d.ts

@@ -0,0 +1,8 @@
+export interface SolveOptions {
+    url: string;
+    json?: boolean;
+    verbose?: boolean;
+    quiet?: boolean;
+}
+export declare function solveCommand(type: string, options: SolveOptions): Promise<void>;
+//# sourceMappingURL=solve.d.ts.map

package/dist/commands/solve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solve.d.ts","sourceRoot":"","sources":["../../src/commands/solve.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ErF"}

package/dist/commands/solve.js

@@ -0,0 +1,78 @@
+/**
+ * Solve command - Solve BOTCHA challenges and output tokens
+ */
+import { BotchaClient } from '@dupecom/botcha/client';
+import { Output } from '../lib/output.js';
+export async function solveCommand(type, options) {
+    const output = new Output(options);
+    if (!options.url) {
+        output.error('--url is required');
+        process.exit(1);
+    }
+    const client = new BotchaClient({ baseUrl: new URL(options.url).origin });
+    const startTime = Date.now();
+    try {
+        switch (type.toLowerCase()) {
+            case 'speed': {
+                output.debug('Solving speed challenge...');
+                const { id, answers } = await client.solveChallenge();
+                const solveTime = Date.now() - startTime;
+                if (options.json) {
+                    output.json({
+                        type: 'speed',
+                        challengeId: id,
+                        answers,
+                        solveTimeMs: solveTime,
+                    });
+                }
+                else {
+                    output.success(`Solved in ${solveTime}ms!`);
+                    output.section('Challenge ID', id);
+                    output.section('Answers', answers.length);
+                    if (options.verbose) {
+                        console.log('\nAnswers:', answers);
+                    }
+                }
+                break;
+            }
+            case 'token': {
+                output.debug('Getting token...');
+                const token = await client.getToken();
+                const solveTime = Date.now() - startTime;
+                if (options.json) {
+                    output.json({
+                        type: 'token',
+                        token,
+                        solveTimeMs: solveTime,
+                    });
+                }
+                else {
+                    output.success(`Token acquired in ${solveTime}ms!`);
+                    console.log('\nToken:');
+                    console.log(token);
+                    console.log('\nUse with:');
+                    console.log(`  Authorization: Bearer ${token}`);
+                }
+                break;
+            }
+            default:
+                output.error(`Unknown challenge type: ${type}`);
+                output.info('Supported types: speed, token');
+                process.exit(1);
+        }
+    }
+    catch (error) {
+        if (options.json) {
+            output.json({
+                type,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        else {
+            output.error(`Solve failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=solve.js.map

package/dist/commands/solve.js.map

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

package/dist/commands/test.d.ts

@@ -0,0 +1,7 @@
+export interface TestOptions {
+    json?: boolean;
+    verbose?: boolean;
+    quiet?: boolean;
+}
+export declare function testCommand(url: string, options: TestOptions): Promise<void>;
+//# sourceMappingURL=test.d.ts.map

package/dist/commands/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFlF"}

package/dist/commands/test.js

@@ -0,0 +1,80 @@
+/**
+ * Test command - Check if URL is BOTCHA-protected and test verification
+ */
+import { BotchaClient } from '@dupecom/botcha/client';
+import { Output, formatUrl } from '../lib/output.js';
+export async function testCommand(url, options) {
+    const output = new Output(options);
+    output.header(`\n🔍 Testing ${formatUrl(url)}...\n`);
+    const client = new BotchaClient({ baseUrl: new URL(url).origin });
+    const startTime = Date.now();
+    try {
+        // First, make a request to see if BOTCHA is required
+        output.debug('Making initial request...');
+        const response = await client.fetch(url);
+        const totalTime = Date.now() - startTime;
+        // Check for BOTCHA headers
+        const botchaHeaders = {};
+        response.headers.forEach((value, key) => {
+            if (key.toLowerCase().startsWith('x-botcha-')) {
+                botchaHeaders[key] = value;
+            }
+        });
+        const hasBotcha = Object.keys(botchaHeaders).length > 0;
+        if (options.json) {
+            const result = {
+                url,
+                protected: hasBotcha,
+                statusCode: response.status,
+                success: response.ok,
+                headers: botchaHeaders,
+                totalTimeMs: totalTime,
+            };
+            output.json(result);
+            return;
+        }
+        if (hasBotcha) {
+            output.success('BOTCHA Detected!');
+            if (botchaHeaders['x-botcha-version']) {
+                output.section('Version', botchaHeaders['x-botcha-version']);
+            }
+            if (botchaHeaders['x-botcha-methods']) {
+                output.section('Methods', botchaHeaders['x-botcha-methods']);
+            }
+        }
+        else {
+            output.warn('No BOTCHA protection detected');
+        }
+        console.log();
+        if (response.ok) {
+            output.success(`Access Granted! (${response.status})`);
+            output.timing('Total Time', totalTime);
+            // Try to show response body
+            const contentType = response.headers.get('content-type') || '';
+            if (contentType.includes('application/json')) {
+                const data = await response.json();
+                console.log('\nResponse:');
+                console.log(JSON.stringify(data, null, 2));
+            }
+        }
+        else {
+            output.error(`Access Denied! (${response.status} ${response.statusText})`);
+            output.timing('Total Time', totalTime);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        if (options.json) {
+            output.json({
+                url,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        else {
+            output.error(`Test failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/commands/test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * BOTCHA CLI - Test, debug, and interact with BOTCHA from the command line
+ */
+import { Command } from 'commander';
+import { testCommand } from './commands/test.js';
+import { solveCommand } from './commands/solve.js';
+import { benchmarkCommand } from './commands/benchmark.js';
+import { headersCommand } from './commands/headers.js';
+const program = new Command();
+program
+    .name('botcha')
+    .description('CLI tool for testing and debugging BOTCHA-protected endpoints')
+    .version('0.1.0');
+// Test command
+program
+    .command('test <url>')
+    .description('Check if URL is BOTCHA-protected and test verification')
+    .option('--json', 'Output as JSON')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('-q, --quiet', 'Minimal output')
+    .action(testCommand);
+// Solve command
+program
+    .command('solve <type>')
+    .description('Solve a BOTCHA challenge (types: speed, token)')
+    .requiredOption('--url <url>', 'URL to solve challenge from')
+    .option('--json', 'Output as JSON')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('-q, --quiet', 'Minimal output')
+    .action(solveCommand);
+// Benchmark command
+program
+    .command('benchmark <url>')
+    .description('Test performance and reliability')
+    .option('-n, --iterations <number>', 'Number of iterations to run', '10')
+    .option('--json', 'Output as JSON')
+    .option('-v, --verbose', 'Show detailed output')
+    .option('-q, --quiet', 'Minimal output')
+    .action((url, options) => {
+    benchmarkCommand(url, {
+        ...options,
+        iterations: parseInt(options.iterations, 10),
+    });
+});
+// Headers command
+program
+    .command('headers <url>')
+    .description('Show BOTCHA headers from a URL')
+    .option('--json', 'Output as JSON')
+    .option('-v, --verbose', 'Show all headers')
+    .option('-q, --quiet', 'Minimal output')
+    .action(headersCommand);
+// Parse and execute
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,+DAA+D,CAAC;KAC5E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,eAAe;AACf,OAAO;KACJ,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,wDAAwD,CAAC;KACrE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;KACvC,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,gBAAgB;AAChB,OAAO;KACJ,OAAO,CAAC,cAAc,CAAC;KACvB,WAAW,CAAC,gDAAgD,CAAC;KAC7D,cAAc,CAAC,aAAa,EAAE,6BAA6B,CAAC;KAC5D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;KACvC,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,oBAAoB;AACpB,OAAO;KACJ,OAAO,CAAC,iBAAiB,CAAC;KAC1B,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,EAAE,IAAI,CAAC;KACxE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC;KAC/C,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;KACvC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;IACvB,gBAAgB,CAAC,GAAG,EAAE;QACpB,GAAG,OAAO;QACV,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,kBAAkB;AAClB,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC;KAC3C,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;KACvC,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,oBAAoB;AACpB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,26 @@
+export interface OutputOptions {
+    json?: boolean;
+    verbose?: boolean;
+    quiet?: boolean;
+}
+export declare class Output {
+    private options;
+    constructor(options?: OutputOptions);
+    private suppressNonJson;
+    success(message: string): void;
+    error(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    debug(message: string): void;
+    header(message: string): void;
+    section(label: string, value: string | number): void;
+    json(data: unknown): void;
+    table(headers: string[], rows: string[][]): void;
+    spinner(message: string): {
+        stop: (finalMessage?: string) => void;
+    };
+    timing(label: string, ms: number): void;
+}
+export declare function formatUrl(url: string): string;
+export declare function formatHeaders(headers: Record<string, string>): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,MAAM;IACL,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,aAAkB;IAE/C,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpD,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAiBhD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE;IA4BnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAMxC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAOnE"}

package/dist/lib/output.js

@@ -0,0 +1,107 @@
+/**
+ * Terminal output utilities with colored and formatted output
+ */
+import chalk from 'chalk';
+export class Output {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    suppressNonJson() {
+        return Boolean(this.options.quiet || this.options.json);
+    }
+    success(message) {
+        if (this.suppressNonJson())
+            return;
+        console.log(chalk.green('✅'), message);
+    }
+    error(message) {
+        if (this.suppressNonJson())
+            return;
+        console.error(chalk.red('❌'), message);
+    }
+    info(message) {
+        if (this.suppressNonJson())
+            return;
+        console.log(chalk.blue('ℹ️ '), message);
+    }
+    warn(message) {
+        if (this.suppressNonJson())
+            return;
+        console.warn(chalk.yellow('⚠️ '), message);
+    }
+    debug(message) {
+        if (this.suppressNonJson() || !this.options.verbose)
+            return;
+        console.log(chalk.gray('DEBUG:'), message);
+    }
+    header(message) {
+        if (this.suppressNonJson())
+            return;
+        console.log(chalk.bold.cyan(message));
+    }
+    section(label, value) {
+        if (this.suppressNonJson())
+            return;
+        console.log(`   ${chalk.dim(label)}: ${value}`);
+    }
+    json(data) {
+        console.log(JSON.stringify(data, null, 2));
+    }
+    table(headers, rows) {
+        if (this.suppressNonJson())
+            return;
+        const colWidths = headers.map((h, i) => {
+            const values = [h, ...rows.map(r => r[i] || '')];
+            return Math.max(...values.map(v => v.length));
+        });
+        const formatRow = (row) => {
+            return row.map((cell, i) => cell.padEnd(colWidths[i])).join('  ');
+        };
+        console.log(chalk.bold(formatRow(headers)));
+        console.log(chalk.dim('─'.repeat(colWidths.reduce((a, b) => a + b + 2, 0))));
+        rows.forEach(row => console.log(formatRow(row)));
+    }
+    spinner(message) {
+        if (this.suppressNonJson()) {
+            return { stop: () => { } };
+        }
+        const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+        let i = 0;
+        let stopped = false;
+        const interval = setInterval(() => {
+            if (!stopped) {
+                process.stdout.write(`\r${chalk.cyan(frames[i])} ${message}`);
+                i = (i + 1) % frames.length;
+            }
+        }, 80);
+        return {
+            stop: (finalMessage) => {
+                stopped = true;
+                clearInterval(interval);
+                process.stdout.write('\r' + ' '.repeat(message.length + 2) + '\r');
+                if (finalMessage) {
+                    console.log(finalMessage);
+                }
+            },
+        };
+    }
+    timing(label, ms) {
+        if (this.suppressNonJson())
+            return;
+        const color = ms < 100 ? chalk.green : ms < 500 ? chalk.yellow : chalk.red;
+        console.log(`   ${chalk.dim(label)}: ${color(`${ms}ms`)}`);
+    }
+}
+export function formatUrl(url) {
+    return chalk.underline.blue(url);
+}
+export function formatHeaders(headers) {
+    console.log(chalk.bold('\nHeaders:'));
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase().startsWith('x-botcha-')) {
+            console.log(`  ${chalk.cyan(key)}: ${value}`);
+        }
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@dupecom/botcha-cli",
+  "version": "0.1.0",
+  "description": "CLI tool for testing and debugging BOTCHA-protected endpoints",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "botcha": "./bin/botcha.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "botcha",
+    "cli",
+    "bot",
+    "ai",
+    "agent",
+    "testing",
+    "debug"
+  ],
+  "author": "Ramin <ramin@dupe.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/i8ramin/botcha"
+  },
+  "homepage": "https://botcha.ai",
+  "dependencies": {
+    "@dupecom/botcha": "^0.4.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}