@umeshindu222/apisnap 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 umesh induranga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,176 @@
+# 📸 APISnap
+
+> Instant API auto-discovery and health-check CLI for Express.js
+
+[![npm version](https://img.shields.io/npm/v/apisnap.svg)](https://www.npmjs.com/package/apisnap)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🤔 Why APISnap?
+
+**The Problem:** Every time you make a change to your Express.js backend, you have to manually open Postman, find every route, and click "Send" one by one. For a project with 20+ endpoints, this is slow, error-prone, and boring.
+
+**The Solution:** APISnap plugs directly into your Express app, **automatically discovers every route you've registered**, and then health-checks all of them in seconds — with zero configuration.
+
+---
+
+## ✨ Features
+
+- 🔍 **Auto Route Discovery** — Scans your Express router stack, no manual config needed
+- 🔒 **Auth Header Support** — Pass JWT tokens or API keys via `--header`
+- ⚠️ **Slow Route Detection** — Flags endpoints that exceed your response time threshold
+- 💾 **JSON Report Export** — Save results to a file for CI/CD pipelines or sharing
+- 🎨 **Beautiful CLI Output** — Color-coded results with spinners and summary table
+- 🔄 **Express v4 & v5** — Compatible with both versions
+
+---
+
+## 🚀 Quick Start
+
+### Step 1: Add the middleware to your Express app
+
+```javascript
+const express = require('express');
+const apisnap = require('apisnap');
+
+const app = express();
+
+// Your routes here
+app.get('/users', (req, res) => res.json({ users: [] }));
+app.post('/users', (req, res) => res.json({ message: 'Created' }));
+
+// Add APISnap — place AFTER your routes
+apisnap.init(app);
+
+app.listen(3000);
+```
+
+### Step 2: Run the health check
+
+```bash
+npx apisnap --port 3000
+```
+
+That's it. APISnap finds and tests every route automatically.
+
+---
+
+## 📋 CLI Usage
+
+```bash
+npx apisnap [options]
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-p, --port <number>` | Port your server is running on | `3000` |
+| `-H, --header <string>` | Custom header for auth (e.g., `"Authorization: Bearer token"`) | — |
+| `-s, --slow <number>` | Response time threshold in ms for slow warnings | `200` |
+| `-e, --export <filename>` | Export results to a JSON file | — |
+| `-V, --version` | Show version number | — |
+| `-h, --help` | Show help | — |
+
+---
+
+## 🧪 Examples
+
+### Basic health check
+```bash
+npx apisnap --port 3000
+```
+
+### With authentication
+```bash
+npx apisnap --port 3000 --header "Authorization: Bearer eyJhbGci..."
+```
+
+### Custom slow threshold (flag routes > 500ms)
+```bash
+npx apisnap --port 3000 --slow 500
+```
+
+### Export report to JSON
+```bash
+npx apisnap --port 3000 --export my-report
+# Creates: my-report.json
+```
+
+### All options together
+```bash
+npx apisnap --port 5000 --header "Authorization: Bearer TOKEN" --slow 300 --export ci-report
+```
+
+---
+
+## 📊 Sample Output
+
+```
+📸 APISnap v1.0.0
+   Slow threshold: 200ms
+
+✔ Connected! Found 6 endpoints.
+
+✔  GET    /health          [200 OK]  3ms
+✔  GET    /users           [200 OK]  12ms
+✔  POST   /users           [200 OK]  8ms
+✔  GET    /users/1         [200 OK]  15ms
+⚠️  GET    /reports         [200 OK]  543ms   ← slow!
+✖  DELETE /users/1         [401]
+
+📊 Summary:
+  ✅ Passed:  5
+  ❌ Failed:  1
+  ⚠️  Slow:    1 (>200ms)
+
+⚠️  Some endpoints are unhealthy!
+```
+
+---
+
+## 💾 JSON Report Format
+
+When using `--export`, a structured JSON file is created:
+
+```json
+{
+  "tool": "APISnap",
+  "generatedAt": "2026-03-06T15:56:20.375Z",
+  "config": { "port": "3000", "slowThreshold": 200 },
+  "summary": { "total": 6, "passed": 5, "failed": 1, "slow": 1 },
+  "results": [
+    { "method": "GET", "path": "/health", "status": 200, "duration": 3, "success": true, "slow": false },
+    { "method": "GET", "path": "/users",  "status": 200, "duration": 12, "success": true, "slow": false }
+  ]
+}
+```
+
+> **Pro tip:** Use this in CI/CD pipelines — parse `summary.failed` and fail the build if it's greater than 0!
+
+---
+
+## 🔧 How It Works
+
+APISnap uses a two-part architecture:
+
+1. **Middleware (The Seeker)** — `apisnap.init(app)` injects a hidden endpoint `/__apisnap_discovery` into your Express app. When called, it recursively walks the Express router stack and returns a map of every registered route.
+
+2. **CLI Runner (The Checker)** — `npx apisnap` calls the discovery endpoint, gets the route map, then "pings" each route using axios — injecting your headers, replacing path params with defaults (`:id` → `1`), and timing each response.
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues and feature requests are welcome!
+
+1. Fork the repo
+2. Create your feature branch: `git checkout -b feat/amazing-feature`
+3. Commit your changes: `git commit -m 'feat: add amazing feature'`
+4. Push to the branch: `git push origin feat/amazing-feature`
+5. Open a Pull Request
+
+---
+
+## 📄 License
+
+MIT © [Umesh Induranga](https://github.com/Umeshinduranga)

package/bin/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+// This tells the OS to run this file with Node.js
+// It points to your compiled TypeScript code
+require('../dist/core/runner.js');

package/dist/core/runner.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/core/runner.d.ts.map

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

package/dist/core/runner.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const axios_1 = __importDefault(require("axios"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const commander_1 = require("commander");
+const program = new commander_1.Command();
+program
+    .name('apisnap')
+    .description('Instant API health-check CLI for Express.js')
+    .version('1.0.0')
+    .option('-p, --port <number>', 'The port your server is running on', '3000')
+    .option('-H, --header <string>', 'Add a custom header (e.g., "Authorization: Bearer token")')
+    .option('-s, --slow <number>', 'Threshold for slow response warning (ms)', '200')
+    .option('-e, --export <filename>', 'Export results to a JSON file (e.g., report.json)')
+    .action(async (options) => {
+    const port = options.port;
+    const slowThreshold = parseInt(options.slow);
+    const discoveryUrl = `http://localhost:${port}/__apisnap_discovery`;
+    const results = []; // Collect all test results here
+    // Parse custom header from CLI flag
+    const customHeaders = {};
+    if (options.header) {
+        const [key, ...value] = options.header.split(':');
+        if (key && value) {
+            customHeaders[key.trim()] = value.join(':').trim();
+        }
+    }
+    console.log(chalk_1.default.bold.cyan(`\n📸 APISnap v1.0.0`));
+    // Show active options
+    if (Object.keys(customHeaders).length > 0) {
+        console.log(chalk_1.default.gray(`   Headers: ${JSON.stringify(customHeaders)}`));
+    }
+    console.log(chalk_1.default.gray(`   Slow threshold: ${slowThreshold}ms`));
+    if (options.export) {
+        console.log(chalk_1.default.gray(`   Export: ${options.export}`));
+    }
+    console.log();
+    const spinner = (0, ora_1.default)('Connecting to your API...').start();
+    try {
+        // 1. Fetch the route map from the middleware
+        const response = await axios_1.default.get(discoveryUrl);
+        const { endpoints } = response.data;
+        spinner.succeed(chalk_1.default.green(`Connected! Found ${endpoints.length} endpoints.\n`));
+        // Summary counters
+        let passed = 0;
+        let failed = 0;
+        let slow = 0;
+        // 2. Loop through each discovered endpoint
+        for (const endpoint of endpoints) {
+            const method = endpoint.methods[0];
+            let path = endpoint.path;
+            // Smart Parameter Replacement — :id, :slug → 1
+            if (path.includes(':')) {
+                path = path.replace(/:[a-zA-Z0-9]+/g, '1');
+            }
+            const fullUrl = `http://localhost:${port}${path}`;
+            const testSpinner = (0, ora_1.default)(`Testing ${chalk_1.default.bold(method)} ${path}`).start();
+            // Step 8: Initialize result object for this endpoint
+            const testResult = {
+                method,
+                path,
+                fullUrl,
+                status: 0,
+                duration: 0,
+                success: false,
+                slow: false,
+            };
+            try {
+                const startTime = Date.now();
+                const res = await (0, axios_1.default)({
+                    method: method,
+                    url: fullUrl,
+                    headers: {
+                        ...customHeaders,
+                        'User-Agent': 'APISnap/1.0.0',
+                    },
+                    timeout: 5000,
+                });
+                const duration = Date.now() - startTime;
+                // Step 8: Populate result
+                testResult.duration = duration;
+                testResult.status = res.status;
+                testResult.success = true;
+                // Step 7: Performance threshold check
+                let statusIcon = chalk_1.default.green('✔');
+                let durationColor = chalk_1.default.gray;
+                if (duration > slowThreshold) {
+                    statusIcon = chalk_1.default.yellow('⚠️ ');
+                    durationColor = chalk_1.default.yellow.bold;
+                    testResult.slow = true;
+                    slow++;
+                }
+                testSpinner.succeed(`${statusIcon} ${chalk_1.default.bold(method)} ${chalk_1.default.white(path)} ` +
+                    `${chalk_1.default.green(`[${res.status} OK]`)} ` +
+                    `${durationColor(`${duration}ms`)}`);
+                passed++;
+            }
+            catch (err) {
+                testResult.status = err.response?.status || 500;
+                testResult.success = false;
+                const status = err.response?.status || 'FAIL';
+                testSpinner.fail(`${chalk_1.default.bold(method)} ${chalk_1.default.white(path)} ` +
+                    `${chalk_1.default.red(`[${status}]`)}`);
+                failed++;
+            }
+            results.push(testResult); // Step 8: Save result to list
+        }
+        // Summary Statistics
+        console.log(chalk_1.default.bold('\n📊 Summary:'));
+        console.log(chalk_1.default.green(`  ✅ Passed:  ${passed}`));
+        console.log(chalk_1.default.red(`  ❌ Failed:  ${failed}`));
+        console.log(chalk_1.default.yellow(`  ⚠️  Slow:    ${slow} (>${slowThreshold}ms)`));
+        if (failed > 0) {
+            console.log(chalk_1.default.red.bold('\n⚠️  Some endpoints are unhealthy!'));
+        }
+        else if (slow > 0) {
+            console.log(chalk_1.default.yellow.bold('\n🐢 All endpoints alive, but some are slow!'));
+        }
+        else {
+            console.log(chalk_1.default.green.bold('\n✨ All systems nominal!'));
+        }
+        // Step 8: Export report to JSON file
+        if (options.export) {
+            const filePath = options.export.endsWith('.json')
+                ? options.export
+                : `${options.export}.json`;
+            const reportData = {
+                tool: 'APISnap',
+                generatedAt: new Date().toISOString(),
+                config: {
+                    port,
+                    slowThreshold,
+                    headers: customHeaders,
+                },
+                summary: {
+                    total: endpoints.length,
+                    passed,
+                    failed,
+                    slow,
+                },
+                results,
+            };
+            fs_1.default.writeFileSync(filePath, JSON.stringify(reportData, null, 2));
+            console.log(chalk_1.default.cyan.bold(`\n💾 Report saved to: ${chalk_1.default.white(filePath)}`));
+        }
+    }
+    catch (error) {
+        spinner.fail(chalk_1.default.red(`Failed to connect to ${discoveryUrl}`));
+        console.log(chalk_1.default.yellow('Is your server running? Make sure apisnap.init(app) is added.\n'));
+        process.exit(1);
+    }
+});
+program.parse(process.argv);
+//# sourceMappingURL=runner.js.map

package/dist/core/runner.js.map

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

package/dist/middleware/index.d.ts

@@ -0,0 +1,2 @@
+export declare const init: (app: any) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,GAAI,KAAK,GAAG,SAwD5B,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = void 0;
+const init = (app) => {
+    const DISCOVERY_PATH = '/__apisnap_discovery';
+    // Recursive function to find ALL routes, even in sub-routers
+    const splitRoutes = (stack, prefix = '') => {
+        let routes = [];
+        stack.forEach((layer) => {
+            if (layer.route) {
+                // Simple direct route
+                const path = prefix + layer.route.path;
+                const methods = Object.keys(layer.route.methods).map((m) => m.toUpperCase());
+                routes.push({ path: path.replace('//', '/'), methods });
+            }
+            else if (layer.handle && layer.handle.stack) {
+                // Nested Router - GO DEEPER
+                // Extract the prefix from the regexp (e.g. /api)
+                const match = layer.regexp
+                    .toString()
+                    .match(/^\/\^\\?(.*?)\\?\/?(?:\(\?=\\\/\|\$\))?\//);
+                const routerPrefix = match
+                    ? match[1].replace(/\\\//g, '/')
+                    : '';
+                routes = routes.concat(splitRoutes(layer.handle.stack, prefix + '/' + routerPrefix));
+            }
+        });
+        return routes;
+    };
+    app.get(DISCOVERY_PATH, (req, res) => {
+        try {
+            // Express v5 uses app.router, Express v4 uses app._router
+            const router = app.router || app._router;
+            if (!router) {
+                res.status(500).json({ error: 'Router not initialized yet' });
+                return;
+            }
+            const allRoutes = splitRoutes(router.stack);
+            res.json({
+                name: 'APISnap Discovery',
+                timestamp: new Date().toISOString(),
+                total: allRoutes.length,
+                endpoints: allRoutes,
+            });
+        }
+        catch (e) {
+            res.status(500).json({ error: 'Failed to parse routes', detail: e.message });
+        }
+    });
+    console.log(`\x1b[32m%s\x1b[0m`, `✅ [APISnap] Discovery active at ${DISCOVERY_PATH}`);
+};
+exports.init = init;
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":";;;AAEO,MAAM,IAAI,GAAG,CAAC,GAAQ,EAAE,EAAE;IAC7B,MAAM,cAAc,GAAG,sBAAsB,CAAC;IAE9C,6DAA6D;IAC7D,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,MAAM,GAAG,EAAE,EAAS,EAAE;QACrD,IAAI,MAAM,GAAU,EAAE,CAAC;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC,KAAU,EAAE,EAAE;YACzB,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,sBAAsB;gBACtB,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;gBACvC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACvD,CAAC,CAAC,WAAW,EAAE,CAClB,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC5C,4BAA4B;gBAC5B,iDAAiD;gBACjD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM;qBACrB,QAAQ,EAAE;qBACV,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBACxD,MAAM,YAAY,GAAG,KAAK;oBACtB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;oBAChC,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,GAAG,MAAM,CAAC,MAAM,CAClB,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,YAAY,CAAC,CAC/D,CAAC;YACN,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;IAEF,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACpD,IAAI,CAAC;YACD,0DAA0D;YAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC,CAAC;gBAC9D,OAAO;YACX,CAAC;YACD,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC;gBACL,IAAI,EAAE,mBAAmB;gBACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,SAAS,CAAC,MAAM;gBACvB,SAAS,EAAE,SAAS;aACvB,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACjF,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CACP,mBAAmB,EACnB,mCAAmC,cAAc,EAAE,CACtD,CAAC;AACN,CAAC,CAAC;AAxDW,QAAA,IAAI,QAwDf"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@umeshindu222/apisnap",
+  "version": "1.0.0",
+  "description": "Instant API auto-discovery and health-check CLI for Express.js",
+  "main": "dist/middleware/index.js",
+  "types": "dist/middleware/index.d.ts",
+  "bin": {
+    "apisnap": "bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "express",
+    "api",
+    "testing",
+    "health-check",
+    "cli",
+    "automation"
+  ],
+  "author": "Umesh Induranga",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.13.6",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "ora": "^9.3.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.3.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}