@engjts/nexus 0.1.6 → 0.1.8

package/BENCHMARK_REPORT.md

@@ -0,0 +1,343 @@
+# 📊 Benchmark Report: Nexus vs Express vs Fastify
+
+**Tanggal Test:** 7 Desember 2025  
+**Environment:** macOS  
+**Node.js Runtime:** tsx (TypeScript execution)
+
+---
+
+## ⚙️ Konfigurasi Benchmark
+
+| Parameter | Value |
+|-----------|-------|
+| Duration | 10 detik per test |
+| Connections | 100 concurrent |
+| Pipelining | 10 requests per connection |
+| Tool | autocannon v7.15.0 |
+
+---
+
+## 🏆 Hasil Overall
+
+| Rank | Server | Avg Req/sec | Avg Latency | Total Errors |
+|------|--------|-------------|-------------|--------------|
+| 🥇 | **Fastify** | 71,578 | 16.5 ms | 0 |
+| 🥈 | **Nexus** | 49,313 | 19.2 ms | 910 |
+| 🥉 | **Express** | 20,277 | 51.6 ms | 0 |
+
+---
+
+## 📌 Hasil Per Endpoint
+
+### 1. Simple JSON Response (`GET /json`)
+
+Response: `{ "message": "Hello, World!" }`
+
+| Server | Req/sec | Latency (avg) | Latency (p99) | Throughput |
+|--------|---------|---------------|---------------|------------|
+| **Fastify** | 98,004 | 9.69 ms | 16 ms | 18.51 MB/s |
+| **Nexus** | 96,131 | 9.99 ms | 15 ms | 16.69 MB/s |
+| Express | 27,071 | 36.42 ms | 74 ms | 6.76 MB/s |
+
+**🏆 Winner:** Fastify (+1.9% vs Nexus)
+
+> ✅ **Nexus sangat kompetitif!** Hanya 1.9% lebih lambat dari Fastify untuk simple JSON.
+
+---
+
+### 2. Echo with Query Parameter (`GET /echo?name=Benchmark`)
+
+Response: `{ "echo": "Hello, Benchmark!" }`
+
+| Server | Req/sec | Latency (avg) | Latency (p99) | Throughput |
+|--------|---------|---------------|---------------|------------|
+| **Fastify** | 92,023 | 10.44 ms | 19 ms | 17.47 MB/s |
+| **Nexus** | 71,066 | 13.70 ms | 23 ms | 12.40 MB/s |
+| Express | 22,747 | 43.39 ms | 87 ms | 5.71 MB/s |
+
+**🏆 Winner:** Fastify (+29.5% vs Nexus)
+
+> ⚠️ **Gap mulai terlihat** saat ada query parameter parsing.
+
+---
+
+### 3. Large Array Response (`GET /users`)
+
+Response: Array of 100 user objects
+
+| Server | Req/sec | Latency (avg) | Latency (p99) | Throughput |
+|--------|---------|---------------|---------------|------------|
+| **Fastify** | 31,896 | 30.83 ms | 54 ms | 218.99 MB/s |
+| **Nexus** | 30,047 | 32.75 ms | 68 ms | 205.84 MB/s |
+| Express | 15,349 | 64.47 ms | 127 ms | 106.37 MB/s |
+
+**🏆 Winner:** Fastify (+6.2% vs Nexus)
+
+> ✅ **Nexus performs well** untuk payload besar, hanya 6% lebih lambat.
+
+---
+
+### 4. POST with JSON Body (`POST /data`)
+
+Request Body: `{ "test": "data", "numbers": [1,2,3,4,5] }`
+
+| Server | Req/sec | Latency (avg) | Latency (p99) | Errors |
+|--------|---------|---------------|---------------|--------|
+| **Fastify** | 64,388 | 15.03 ms | 28 ms | 0 |
+| Express | 15,941 | 62.10 ms | 103 ms | 0 |
+| Nexus | 8 | 20.44 ms | 27 ms | **910** |
+
+**🏆 Winner:** Fastify
+
+> 🚨 **CRITICAL ISSUE:** Nexus mengalami 910 timeout errors dan hanya mampu handle 8 req/sec!
+
+---
+
+## 🐛 Issue Analysis: Nexus POST Body Parsing
+
+### Problem yang Ditemukan
+
+Saat benchmark POST endpoint, Nexus mengalami:
+- **910 timeout errors**
+- **0 successful 2xx responses** (82 non-2xx responses)
+- Throughput drop dari ~70k req/s ke **8 req/s**
+
+### Root Cause Analysis
+
+Berdasarkan kode server Nexus yang kita gunakan:
+
+```typescript
+app.post('/data', async (ctx) => {
+  const body = await ctx.body();  // ← Potential bottleneck
+  return ctx.json({ received: body, processed: true });
+});
+```
+
+**Kemungkinan penyebab:**
+
+1. **Async Body Parsing Bottleneck**
+   - `ctx.body()` mungkin tidak di-optimize untuk high concurrency
+   - Setiap request harus wait untuk body stream selesai di-parse
+   - Dengan 100 connections × 10 pipelining = 1000 concurrent requests, ini bisa cause blocking
+
+2. **Stream Handling Issue**
+   - Body parsing mungkin tidak properly buffer incoming data
+   - Potential memory pressure saat banyak request bersamaan
+
+3. **Missing Content-Type Handling**
+   - Mungkin perlu explicit JSON parser middleware
+
+4. **Connection Pool Exhaustion**
+   - Async operations yang pending bisa exhaust available resources
+
+### Rekomendasi untuk Nexus
+
+```typescript
+// Option 1: Pre-parse body dengan middleware
+app.use(async (ctx, next) => {
+  if (ctx.method === 'POST' || ctx.method === 'PUT') {
+    ctx.parsedBody = await ctx.body();
+  }
+  return next();
+});
+
+// Option 2: Gunakan built-in JSON middleware jika ada
+app.use(nexus.json()); // seperti express.json()
+
+// Option 3: Batasi concurrent body parsing
+import { Semaphore } from 'async-mutex';
+const bodySemaphore = new Semaphore(50);
+
+app.post('/data', async (ctx) => {
+  const [, release] = await bodySemaphore.acquire();
+  try {
+    const body = await ctx.body();
+    return ctx.json({ received: body, processed: true });
+  } finally {
+    release();
+  }
+});
+```
+
+---
+
+## 📈 Performance Gap Analysis: Mengapa Nexus Kalah dari Fastify?
+
+### 1. JSON Serialization
+
+**Fastify** menggunakan `fast-json-stringify` yang pre-compile JSON schema:
+
+```javascript
+// Fastify internal - schema-based serialization
+const stringify = fastJson({
+  type: 'object',
+  properties: {
+    message: { type: 'string' }
+  }
+});
+// Output langsung tanpa JSON.stringify overhead
+```
+
+**Improvement untuk Nexus:**
+- Implement schema-based JSON serialization
+- Cache stringify functions per route
+- Gunakan library seperti `fast-json-stringify` atau `@msgpack/msgpack`
+
+---
+
+### 2. Router Performance
+
+**Fastify** menggunakan `find-my-way`, radix tree-based router yang O(log n):
+
+```
+/users/:id → Radix tree lookup (sangat cepat)
+```
+
+**Improvement untuk Nexus:**
+- Evaluate current router implementation
+- Consider menggunakan `find-my-way` atau `trek-router`
+- Implement route caching untuk static routes
+- Pre-compile regex patterns saat startup
+
+---
+
+### 3. Request/Response Object Overhead
+
+**Fastify** minimize object creation dan property access:
+
+```javascript
+// Fastify - minimal wrapper
+reply.send({ data }); // Direct write ke socket
+```
+
+**Improvement untuk Nexus:**
+- Reduce Context object properties
+- Lazy-load properties yang jarang dipakai
+- Pool dan reuse context objects
+- Avoid spread operators di hot paths
+
+---
+
+### 4. Body Parsing Strategy
+
+**Fastify** parse body secara lazy dan streaming:
+
+```javascript
+// Hanya parse jika diperlukan
+fastify.addContentTypeParser('application/json', 
+  { parseAs: 'buffer' }, 
+  (req, body, done) => {
+    // Efficient buffer-based parsing
+  }
+);
+```
+
+**Improvement untuk Nexus:**
+- Implement streaming body parser
+- Add body size limits untuk prevent DoS
+- Cache parsed bodies
+- Support different content types efficiently
+
+---
+
+### 5. Middleware Chain Optimization
+
+**Improvement untuk Nexus:**
+```typescript
+// Instead of array-based middleware
+// Use compiled function chain
+const compiledHandler = compileMiddleware([
+  middleware1,
+  middleware2,
+  routeHandler
+]);
+
+function compileMiddleware(middlewares) {
+  return middlewares.reduceRight(
+    (next, mw) => (ctx) => mw(ctx, next),
+    (ctx) => ctx
+  );
+}
+```
+
+---
+
+### 6. HTTP Header Handling
+
+**Improvement untuk Nexus:**
+- Pre-allocate common headers
+- Use header caching
+- Minimize header parsing overhead
+
+```typescript
+// Cache static headers
+const COMMON_HEADERS = {
+  'content-type': 'application/json; charset=utf-8',
+  'x-powered-by': 'Nexus'
+};
+
+// Apply once, not per-request
+response.writeHead(200, COMMON_HEADERS);
+```
+
+---
+
+## 🎯 Priority Improvements untuk Nexus
+
+### High Priority (Impact Besar)
+
+| # | Improvement | Expected Gain | Effort |
+|---|-------------|---------------|--------|
+| 1 | Fix POST body parsing | +10,000% untuk POST | Medium |
+| 2 | Schema-based JSON stringify | +15-25% | Medium |
+| 3 | Optimize router | +10-20% | High |
+
+### Medium Priority
+
+| # | Improvement | Expected Gain | Effort |
+|---|-------------|---------------|--------|
+| 4 | Query string parser optimization | +5-15% | Low |
+| 5 | Context object pooling | +5-10% | Medium |
+| 6 | Header caching | +3-5% | Low |
+
+### Low Priority (Nice to Have)
+
+| # | Improvement | Expected Gain | Effort |
+|---|-------------|---------------|--------|
+| 7 | HTTP/2 support | Varies | High |
+| 8 | Cluster mode built-in | Linear scaling | Medium |
+| 9 | Native addon for hot paths | +20-30% | Very High |
+
+---
+
+## 📋 Summary
+
+### Kelebihan Nexus Saat Ini
+- ✅ Performa GET request sangat bagus (hampir setara Fastify)
+- ✅ Simple JSON response hanya 1.9% lebih lambat dari Fastify
+- ✅ Large payload handling bagus (6% gap)
+- ✅ Developer Experience yang baik
+
+### Area yang Perlu Diperbaiki
+- 🔴 **CRITICAL:** POST body parsing broken under load
+- 🟡 Query parameter parsing bisa lebih cepat (+29% gap)
+- 🟡 JSON serialization bisa di-optimize
+
+### Rekomendasi Utama
+1. **Immediate:** Fix body parsing untuk POST/PUT requests
+2. **Short-term:** Implement schema-based JSON serialization
+3. **Medium-term:** Optimize router dengan radix tree
+4. **Long-term:** Consider V8 fast-path optimizations
+
+---
+
+## 🔗 Resources
+
+- [Fastify Benchmarks](https://fastify.dev/benchmarks/)
+- [fast-json-stringify](https://github.com/fastify/fast-json-stringify)
+- [find-my-way Router](https://github.com/delvedor/find-my-way)
+- [Node.js Performance Best Practices](https://nodejs.org/en/docs/guides/dont-block-the-event-loop/)
+
+---
+
+*Report generated by benchmark suite on December 7, 2025*

package/dist/advanced/playground/generatePlaygroundHTML.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generatePlaygroundHTML.d.ts","sourceRoot":"","sources":["../../../src/advanced/playground/generatePlaygroundHTML.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI3C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAozDxF"}
+{"version":3,"file":"generatePlaygroundHTML.d.ts","sourceRoot":"","sources":["../../../src/advanced/playground/generatePlaygroundHTML.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI3C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA+5DxF"}

package/dist/advanced/playground/generatePlaygroundHTML.js

@@ -515,6 +515,39 @@ function generatePlaygroundHTML(config, baseUrl) {
             line-height: 1.5;
         }
 
+        .info-curl-section {
+            margin-bottom: 16px;
+        }
+
+        .info-curl-btn {
+            width: 100%;
+            padding: 10px 16px;
+            background: var(--bg-tertiary);
+            color: var(--text-primary);
+            border: 1px solid var(--border-color);
+            border-radius: 6px;
+            font-size: 12px;
+            font-weight: 500;
+            cursor: pointer;
+            transition: all 0.2s;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            gap: 8px;
+        }
+
+        .info-curl-btn:hover {
+            background: var(--accent-color);
+            border-color: var(--accent-color);
+            color: #fff;
+        }
+
+        .info-curl-btn.copied {
+            background: var(--success-color);
+            border-color: var(--success-color);
+            color: #fff;
+        }
+
         /* Resizer */
         .resizer {
             height: 6px;
@@ -1400,6 +1433,13 @@ function generatePlaygroundHTML(config, baseUrl) {
             html += '<span class="path">' + ep.path + '</span>';
             html += '</div>';
 
+            // Copy as CURL button
+            html += '<div class="info-curl-section">';
+            html += '<button class="info-curl-btn" onclick="copyAsCurl()" id="curlCopyBtn">';
+            html += '<span>📋</span> Copy as CURL';
+            html += '</button>';
+            html += '</div>';
+
             // Deprecated warning
             if (ep.deprecated) {
                 html += '<div class="info-section">';
@@ -1549,6 +1589,73 @@ function generatePlaygroundHTML(config, baseUrl) {
             saveCurrentTabState();
         }
 
+        function copyAsCurl() {
+            const method = document.getElementById('methodSelect').value;
+            const url = document.getElementById('urlInput').value;
+            const body = requestEditor ? requestEditor.getValue() : '{}';
+            
+            // Build CURL command
+            let curl = 'curl';
+            
+            // Add method
+            if (method !== 'GET') {
+                curl += ' -X ' + method;
+            }
+            
+            // Add URL (with query params)
+            let fullUrl = url;
+            const enabledParams = params.filter(p => p.enabled && p.key);
+            if (enabledParams.length > 0) {
+                const queryString = enabledParams
+                    .map(p => encodeURIComponent(p.key) + '=' + encodeURIComponent(p.value))
+                    .join('&');
+                fullUrl += (fullUrl.includes('?') ? '&' : '?') + queryString;
+            }
+            curl += " '" + fullUrl + "'";
+            
+            // Add headers
+            headers.filter(h => h.enabled && h.key).forEach(h => {
+                curl += " -H '" + h.key + ": " + h.value + "'";
+            });
+            
+            // Add body for non-GET requests
+            if (method !== 'GET' && method !== 'DELETE') {
+                try {
+                    // Check if body is valid JSON and not empty
+                    const parsedBody = JSON.parse(body);
+                    if (Object.keys(parsedBody).length > 0) {
+                        // Escape single quotes in body for shell
+                        const escapedBody = body.replace(/'/g, "'\\''");
+                        curl += " -d '" + escapedBody + "'";
+                    }
+                } catch (e) {
+                    // If not valid JSON but has content, still include it
+                    if (body && body.trim() !== '' && body.trim() !== '{}') {
+                        const escapedBody = body.replace(/'/g, "'\\''");
+                        curl += " -d '" + escapedBody + "'";
+                    }
+                }
+            }
+            
+            // Copy to clipboard
+            navigator.clipboard.writeText(curl).then(() => {
+                // Visual feedback
+                const btn = document.getElementById('curlCopyBtn');
+                if (btn) {
+                    const originalText = btn.innerHTML;
+                    btn.innerHTML = '<span>✓</span> Copied!';
+                    btn.classList.add('copied');
+                    setTimeout(() => {
+                        btn.innerHTML = originalText;
+                        btn.classList.remove('copied');
+                    }, 2000);
+                }
+            }).catch(err => {
+                console.error('Failed to copy CURL:', err);
+                alert('Failed to copy CURL to clipboard');
+            });
+        }
+
         function switchTab(tab) {
             document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
             document.querySelectorAll('.editor-wrapper').forEach(w => w.classList.remove('active'));

package/dist/advanced/playground/generatePlaygroundHTML.js.map

@@ -1 +1 @@
-{"version":3,"file":"generatePlaygroundHTML.js","sourceRoot":"","sources":["../../../src/advanced/playground/generatePlaygroundHTML.ts"],"names":[],"mappings":";;AAIA,wDAozDC;AApzDD,SAAgB,sBAAsB,CAAC,MAAwB,EAAE,OAAe;IAC5E,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC;IAEvC,OAAO;;;;;aAKE,MAAM,CAAC,KAAK;;;;;;4BAMG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;8BAC5B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;6BAC/B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;8BAC7B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gCAC5B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;4BAClC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;8BAC5B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAqtBtC,MAAM,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;4GAwB0E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAoF1F,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DAgHgC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DAsGX,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAuKvB,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAiFzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAghB5B,CAAC;AACT,CAAC"}
+{"version":3,"file":"generatePlaygroundHTML.js","sourceRoot":"","sources":["../../../src/advanced/playground/generatePlaygroundHTML.ts"],"names":[],"mappings":"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"}

package/dist/advanced/playground/playground.d.ts

@@ -1,4 +1,23 @@
 import { Plugin } from '../../core/types';
 import { PlaygroundConfig } from './types';
+/**
+ * API Playground Plugin
+ * Provides an interactive API explorer with authentication and development-mode security
+ *
+ * @param config - Configuration options for the playground
+ * @returns Plugin instance
+ *
+ * @example
+ * ```typescript
+ * app.use(playground({
+ *   path: '/playground',
+ *   developmentOnly: true,
+ *   auth: {
+ *     username: 'admin',
+ *     password: 'secret123'
+ *   }
+ * }));
+ * ```
+ */
 export declare function playground(config?: PlaygroundConfig): Plugin;
 //# sourceMappingURL=playground.d.ts.map

package/dist/advanced/playground/playground.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../../src/advanced/playground/playground.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoC,MAAM,EAA2B,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAGxD,wBAAgB,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,MAAM,CA6GhE"}
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../../src/advanced/playground/playground.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoC,MAAM,EAA2B,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAe,MAAM,SAAS,CAAC;AAGxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,gBAAqB,GAAG,MAAM,CA0KhE"}

package/dist/advanced/playground/playground.js

@@ -7,6 +7,25 @@ const zodToExample_1 = require("./zodToExample");
 const getTagFromPath_1 = require("./getTagFromPath");
 const generateSummary_1 = require("./generateSummary");
 const generatePlaygroundHTML_1 = require("./generatePlaygroundHTML");
+/**
+ * API Playground Plugin
+ * Provides an interactive API explorer with authentication and development-mode security
+ *
+ * @param config - Configuration options for the playground
+ * @returns Plugin instance
+ *
+ * @example
+ * ```typescript
+ * app.use(playground({
+ *   path: '/playground',
+ *   developmentOnly: true,
+ *   auth: {
+ *     username: 'admin',
+ *     password: 'secret123'
+ *   }
+ * }));
+ * ```
+ */
 function playground(config = {}) {
     const resolvedConfig = {
         path: '/playground',
@@ -15,6 +34,7 @@ function playground(config = {}) {
         enableHistory: true,
         maxHistory: 50,
         enableVariables: true,
+        developmentOnly: true,
         defaultHeaders: { 'Content-Type': 'application/json' },
         variables: { baseUrl: 'http://localhost:3000', token: '' },
         ...config
@@ -26,6 +46,11 @@ function playground(config = {}) {
         name: 'playground',
         version: '1.0.0',
         install(app) {
+            // Check if playground should be disabled in production
+            if (resolvedConfig.developmentOnly && process.env.NODE_ENV === 'production') {
+                console.warn('⚠️  API Playground is disabled in production mode');
+                return;
+            }
             appInstance = app;
             const originalRoute = app.route.bind(app);
             const originalGet = app.get.bind(app);
@@ -71,7 +96,48 @@ function playground(config = {}) {
             app.delete = wrapMethod('DELETE', originalDelete);
             app.patch = wrapMethod('PATCH', originalPatch);
             const basePath = resolvedConfig.path;
+            /**
+             * Authentication middleware for playground routes
+             * Implements HTTP Basic Authentication when auth config is provided
+             */
+            const authMiddleware = (ctx) => {
+                if (!resolvedConfig.auth) {
+                    return true; // No auth required
+                }
+                const authHeader = ctx.raw?.req?.headers?.authorization || ctx.headers?.get?.('authorization');
+                if (!authHeader || !authHeader.startsWith('Basic ')) {
+                    return false;
+                }
+                try {
+                    const base64Credentials = authHeader.substring(6);
+                    const credentials = Buffer.from(base64Credentials, 'base64').toString('utf-8');
+                    const [username, password] = credentials.split(':');
+                    return (username === resolvedConfig.auth.username &&
+                        password === resolvedConfig.auth.password);
+                }
+                catch (error) {
+                    return false;
+                }
+            };
+            /**
+             * Returns 401 Unauthorized response with WWW-Authenticate header
+             * This triggers the browser's native authentication dialog
+             */
+            const unauthorizedResponse = () => {
+                return {
+                    statusCode: 401,
+                    headers: {
+                        'WWW-Authenticate': 'Basic realm="API Playground"',
+                        'Content-Type': 'text/plain'
+                    },
+                    body: 'Unauthorized'
+                };
+            };
             originalGet(basePath, async (ctx) => {
+                // Check authentication
+                if (!authMiddleware(ctx)) {
+                    return unauthorizedResponse();
+                }
                 if (!detectedBaseUrl && ctx.raw?.req) {
                     const req = ctx.raw.req;
                     const protocol = req.headers['x-forwarded-proto'] || 'http';
@@ -85,6 +151,10 @@ function playground(config = {}) {
                 };
             });
             originalGet(basePath + '/api/routes', async (ctx) => {
+                // Check authentication
+                if (!authMiddleware(ctx)) {
+                    return unauthorizedResponse();
+                }
                 // Combine intercepted routes with routes from router (for file-based routing)
                 const allRoutes = getAllRoutes(routes, appInstance, basePath);
                 const routesData = allRoutes.map(r => ({

package/dist/advanced/playground/playground.js.map

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

package/dist/advanced/playground/types.d.ts

@@ -1,13 +1,33 @@
 import { HTTPMethod, RouteMeta, SchemaConfig } from "../../core/types";
+/**
+ * Configuration options for the API Playground
+ */
 export interface PlaygroundConfig {
+    /** URL path where the playground will be accessible (default: '/playground') */
     path?: string;
+    /** Title displayed in the playground UI (default: 'API Playground') */
     title?: string;
+    /** Color theme for the playground interface (default: 'dark') */
     theme?: 'dark' | 'light';
+    /** Default HTTP headers to include in API requests */
     defaultHeaders?: Record<string, string>;
+    /** Enable/disable request history tracking (default: true) */
     enableHistory?: boolean;
+    /** Maximum number of requests to keep in history (default: 50) */
     maxHistory?: number;
+    /** Enable/disable variable substitution in requests (default: true) */
     enableVariables?: boolean;
+    /** Predefined variables for use in requests (e.g., {{baseUrl}}, {{token}}) */
     variables?: Record<string, string>;
+    /** Enable only in development mode (default: true) */
+    developmentOnly?: boolean;
+    /** Basic authentication configuration to protect playground access */
+    auth?: {
+        /** Username for basic authentication */
+        username: string;
+        /** Password for basic authentication */
+        password: string;
+    };
 }
 export interface StoredRoute {
     method: HTTPMethod;