@tezx/devtools 1.0.4 → 1.0.6

package/html/env.js

@@ -0,0 +1,142 @@
+export function EnvInspector(ctx) {
+    const env = ctx.env;
+    const entries = Object.entries(env);
+    const tableRows = entries.length
+        ? entries
+            .map(([key, value], i) => {
+            const safeKey = key.replace(/"/g, """);
+            const safeValue = value.replace(/`/g, "\\`").replace(/"/g, """);
+            return `
+          <tr data-key="${safeKey.toLowerCase()}" data-value="${value.toLowerCase()}">
+            <td>${i + 1}</td>
+            <td>${safeKey}</td>
+            <td>${value}</td>
+            <td><button onclick="copyRowEnv('${safeKey}', \`${safeValue}\`)">📋</button></td>
+          </tr>
+        `;
+        })
+            .join("")
+        : `
+    <tr>
+      <td colspan="4">
+        <p>⚠️ <strong>No environment variables found.</strong></p>
+        <pre style="margin-top: 1rem; background: #f1f5f9; padding: 1rem; border-radius: 0.5rem;">
+const env = loadEnv();
+
+export const app = new TezX({
+  env: env,
+  debugMode: true,
+  // basePath: 'v1',
+  allowDuplicateMw: true,
+});
+        </pre>
+      </td>
+    </tr>`;
+    return `
+  <style>
+    table td button {
+      background: #e2e8f0;
+      border: none;
+      padding: 0.3rem 0.6rem;
+      border-radius: 0.375rem;
+      cursor: pointer;
+    }
+    table td button:hover {
+      background: #cbd5e1;
+    }
+    pre#json-output {
+      margin-top: 1rem;
+      padding: 1rem;
+      border-radius: 0.5rem;
+      background: #f9fafb;
+      border: 1px solid #e5e7eb;
+      font-size: 0.875rem;
+      overflow-x: auto;
+      display: none;
+    }
+    .search-container {
+      margin-bottom: 1rem;
+    }
+    .search-container input {
+      padding: 0.5rem;
+      width: 100%;
+      max-width: 400px;
+      border: 1px solid #e5e7eb;
+      border-radius: 0.375rem;
+    }
+  </style>
+
+  <div class="tabs">
+    <a onclick="exportEnv()">📤 Export JSON</a>
+    <a onclick="copyAllEnv()">📋 Copy All</a>
+  </div>
+
+  <div class="search-container">
+    <input type="text" id="env-search" placeholder="🔍 Search environment variables..." oninput="filterEnvTable()" />
+  </div>
+
+  <div class="table-container">
+    <table>
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Key</th>
+          <th>Value</th>
+          <th>Copy</th>
+        </tr>
+      </thead>
+      <tbody id="env-body">
+        ${tableRows}
+      </tbody>
+    </table>
+  </div>
+
+  <pre id="json-output">${JSON.stringify(env, null, 2)}</pre>
+
+  <script>
+    function exportEnv() {
+      const output = document.getElementById('json-output');
+      const blob = new Blob([output.textContent], { type: 'application/json' });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement('a');
+      a.href = url;
+      a.download = 'env.json';
+      a.click();
+      URL.revokeObjectURL(url);
+    }
+
+    function copyAllEnv() {
+      const output = document.getElementById('json-output');
+      navigator.clipboard.writeText(output.textContent).then(() => {
+        alert('✅ All environment variables copied!');
+      }).catch(err => {
+        alert('❌ Failed to copy: ' + err);
+      });
+    }
+
+    function copyRowEnv(key, value) {
+      const text = \`\${key}=\${value}\`;
+      navigator.clipboard.writeText(text).then(() => {
+        alert(\`✅ Copied: \${text}\`);
+      }).catch(err => {
+        alert('❌ Failed to copy: ' + err);
+      });
+    }
+
+    function filterEnvTable() {
+      const input = document.getElementById('env-search').value.toLowerCase();
+      const rows = document.querySelectorAll('#env-body tr');
+
+      rows.forEach(row => {
+        const key = row.getAttribute('data-key') || '';
+        const value = row.getAttribute('data-value') || '';
+        if (key.includes(input) || value.includes(input)) {
+          row.style.display = '';
+        } else {
+          row.style.display = 'none';
+        }
+      });
+    }
+  </script>
+`;
+}

package/html/index.d.ts

@@ -1,9 +1,9 @@
 import { Context, TezX } from "tezx";
-export type Tab = ("cookies" | "routes");
+export type Tab = "cookies" | "routes" | ".env" | "middlewares";
 export type TabType = {
     doc_title: string;
     label: string;
-    tab: Tab;
+    tab: Tab | string;
     content: string;
 }[];
 export declare function html(ctx: Context, app: TezX): TabType;

package/html/index.js

@@ -1,19 +1,33 @@
-import { Routes } from "./routes.js";
 import { CookiesInspector } from "./cookies.js";
+import { EnvInspector } from "./env.js";
+import { Middlewares } from "./middlewares.js";
+import { Routes } from "./routes.js";
 export function html(ctx, app) {
     let tabDb = [
         {
             doc_title: "DevTools - Route Inspector",
             label: "Routes",
-            tab: 'routes',
-            content: Routes(ctx, app)
+            tab: "routes",
+            content: Routes(ctx, app),
+        },
+        {
+            doc_title: "DevTools - Middleware Inspector",
+            label: "Middlewares",
+            tab: "middleware",
+            content: Middlewares(ctx, app),
         },
         {
-            tab: 'cookies',
-            label: 'Cookies',
-            doc_title: 'DevTools - Cookie Inspector',
-            content: CookiesInspector(ctx)
-        }
+            tab: "cookies",
+            label: "Cookies",
+            doc_title: "DevTools - Cookie Inspector",
+            content: CookiesInspector(ctx),
+        },
+        {
+            tab: ".env",
+            label: "Environment",
+            doc_title: "DevTools - Environment",
+            content: EnvInspector(ctx),
+        },
     ];
     return tabDb;
 }

package/html/middlewares.d.ts

@@ -0,0 +1,7 @@
+import { Context, TezX } from "tezx";
+export type MiddlewareEntry = {
+    pattern: string;
+    type: "static" | "wildcard" | "optional params" | "dynamic params";
+    appliedMiddlewares: string[];
+};
+export declare function Middlewares(ctx: Context, app: TezX): string;

package/html/middlewares.js

@@ -0,0 +1,181 @@
+import { dumpMiddlewares } from "../devtools/index.js";
+export function Middlewares(ctx, app) {
+    const allRoutes = dumpMiddlewares(app);
+    const totalRoutes = allRoutes.length;
+    const middlewareRoutes = {};
+    for (const route of allRoutes) {
+        for (const mw of route.appliedMiddlewares || []) {
+            (middlewareRoutes[mw] ||= []).push(route);
+        }
+    }
+    const rawJSON = JSON.stringify(allRoutes, null, 2);
+    const toCSV = (data) => {
+        const headers = ["pattern", "type", "appliedMiddlewares"];
+        const csvRows = [
+            headers.join(","),
+            ...data.map((r) => headers.map((h) => JSON.stringify(r[h] ?? "")).join(",")),
+        ];
+        return csvRows.join("\n");
+    };
+    const csvString = toCSV(allRoutes).replace(/"/g, """);
+    return `
+  <style>
+    .download {
+        margin-top: 1rem;
+        display: flex;
+        gap: 1rem;
+    }
+    .download a {
+        padding: 0.5rem 1rem;
+        border: 1px solid var(--accent);
+        color: var(--accent);
+        text-decoration: none;
+        border-radius: 6px;
+    }
+
+    .download a:hover {
+        background: var(--accent);
+        color: white;
+    }
+
+    #searchBar {
+        margin: 1rem 0;
+        display: flex;
+    }
+
+    #searchBar input {
+        flex: 1;
+    }
+
+    table td button {
+      background: #e2e8f0;
+      border: none;
+      padding: 0.2rem 0.5rem;
+      border-radius: 0.375rem;
+      cursor: pointer;
+      margin-left: 0.5rem;
+    }
+
+    table td button:hover {
+      background: #cbd5e1;
+    }
+  </style>
+
+  <div class="tabs toolbar">
+    <a class="tab-btn active counting" data-count="${totalRoutes}" onclick="showTab('routes')">📋 Routes</a>
+    <a class="tab-btn counting" data-count="${Object.keys(middlewareRoutes).length}" onclick="showTab('middlewares')">🧩 Middlewares</a>
+    <a class="tab-btn" onclick="showTab('json')">🧾 Raw JSON</a>
+    <a class="tab-btn" onclick="showTab('export')">📤 Export</a>
+  </div>
+
+  <div id="searchBar">
+    <input type="text" id="search" placeholder="Filter by pattern/type/middleware..." />
+  </div>
+
+  <!-- ROUTES -->
+  <div id="routesTab" class="table-container">
+    <table id="routesTable">
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Pattern</th>
+          <th>Type</th>
+          <th>Middlewares</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${allRoutes
+        .map((r, i) => `
+        <tr>
+          <td>${i + 1}</td>
+          <td>
+            ${r.pattern}
+            <button onclick="copyText(\`${r.pattern}\`)">📋</button>
+          </td>
+          <td>
+            <span style="
+              display: inline-block;
+              padding: 0.2rem 0.5rem;
+              border-radius: 0.375rem;
+              color: white;
+              font-size: 0.75rem;
+              background-color: ${r.type === "static"
+        ? "#16a34a"
+        : r.type === "wildcard"
+            ? "#f97316"
+            : r.type === "optional params"
+                ? "#3b82f6"
+                : r.type === "dynamic params"
+                    ? "#9333ea"
+                    : "#6b7280"};
+            ">
+              ${r.type}
+            </span>
+          </td>
+          <td>${(r.appliedMiddlewares || []).join(", ")}</td>
+        </tr>
+        `)
+        .join("")}
+      </tbody>
+    </table>
+  </div>
+
+  <!-- MIDDLEWARES -->
+  <div id="middlewaresTab" style="display:none">
+    ${Object.entries(middlewareRoutes)
+        .map(([mw, routes]) => `
+      <h3>🔹 ${mw} (${routes.length})</h3>
+      <ul>
+        ${routes.map((r) => `<li><code>${r.pattern}</code> <span>(${r.type})</span></li>`).join("")}
+      </ul>
+    `)
+        .join("")}
+  </div>
+
+  <!-- RAW JSON -->
+  <div id="jsonTab" style="display:none">
+    <div class="json-view"><pre>${rawJSON}</pre></div>
+  </div>
+
+  <!-- EXPORT -->
+  <div id="exportTab" style="display:none">
+    <div class="download">
+      <a href="data:text/json;charset=utf-8,${encodeURIComponent(rawJSON)}" download="middlewares.json">📥 JSON</a>
+      <a href="data:text/csv;charset=utf-8,${csvString}" download="middlewares.csv">📥 CSV</a>
+    </div>
+  </div>
+
+  <script>
+    const tabs = ['routes', 'middlewares', 'json', 'export'];
+    const tabBtns = document.querySelectorAll('.tab-btn');
+
+    function showTab(tab) {
+      tabs.forEach(t => {
+        document.getElementById(t + 'Tab').style.display = t === tab ? 'block' : 'none';
+        document.getElementById(t + 'Tab').classList.toggle('active', t === tab);
+      });
+      tabBtns.forEach(btn => {
+        const active = btn.textContent.toLowerCase().includes(tab);
+        btn.classList.toggle('active', active);
+      });
+      document.getElementById('searchBar').style.display = (tab === 'routes') ? 'flex' : 'none';
+    }
+
+    document.getElementById('search').addEventListener('input', (e) => {
+      const keyword = e.target.value.toLowerCase();
+      const rows = document.querySelectorAll('#routesTable tbody tr');
+      rows.forEach(row => {
+        row.style.display = row.textContent.toLowerCase().includes(keyword) ? '' : 'none';
+      });
+    });
+
+    function copyText(text) {
+      navigator.clipboard.writeText(text).then(() => {
+        alert('✅ Copied: ' + text);
+      }).catch(err => {
+        alert('❌ Failed to copy: ' + err);
+      });
+    }
+  </script>
+  `;
+}

package/html/routes.js

@@ -1,4 +1,4 @@
-import { dumpRoutes } from "../devtools";
+import { dumpRoutes } from "../devtools/index.js";
 export function Routes(ctx, app) {
     const allRoutes = dumpRoutes(app);
     const totalRoutes = allRoutes.length;
@@ -12,14 +12,14 @@ export function Routes(ctx, app) {
     }
     const rawJSON = JSON.stringify(allRoutes, null, 2);
     const toCSV = (data) => {
-        const headers = ['method', 'endpoint', 'pattern', 'appliedMiddlewares'];
+        const headers = ["method", "endpoint", "pattern", "appliedMiddlewares"];
         const csvRows = [
-            headers.join(','),
-            ...data.map(r => headers.map(h => JSON.stringify(r[h] ?? '')).join(','))
+            headers.join(","),
+            ...data.map((r) => headers.map((h) => JSON.stringify(r[h] ?? "")).join(",")),
         ];
-        return csvRows.join('\n');
+        return csvRows.join("\n");
     };
-    const csvString = toCSV(allRoutes).replace(/"/g, '"');
+    const csvString = toCSV(allRoutes).replace(/"/g, """);
     return `
   <style>
     .download {
@@ -49,107 +49,136 @@ export function Routes(ctx, app) {
     #searchBar input {
         flex: 1;
     }
-</style>
 
-<div class="tabs">
+    table td button {
+      background: #e2e8f0;
+      border: none;
+      padding: 0.2rem 0.5rem;
+      border-radius: 0.375rem;
+      cursor: pointer;
+      margin-left: 0.5rem;
+    }
+
+    table td button:hover {
+      background: #cbd5e1;
+    }
+  </style>
+
+  <div class="tabs toolbar">
     <a class="tab-btn active counting" data-count="${totalRoutes}" onclick="showTab('routes')">📋 Routes</a>
-    <a class="tab-btn counting" data-count="${Object.keys(middlewareStats).length}" onclick="showTab('stats')">📈
-        Stats</a>
+    <a class="tab-btn counting" data-count="${Object.keys(middlewareStats).length}" onclick="showTab('stats')">📈 Stats</a>
     <a class="tab-btn" onclick="showTab('middlewares')">🧩 Middlewares</a>
     <a class="tab-btn" onclick="showTab('json')">🧾 Raw JSON</a>
     <a class="tab-btn" onclick="showTab('export')">📤 Export</a>
-</div>
+  </div>
 
-<div id="searchBar" style="display:flex">
+  <div id="searchBar">
     <input type="text" id="search" placeholder="Filter by method/path/middleware..." />
-</div>
+  </div>
 
-<!-- ROUTES -->
-<div id="routesTab">
+  <!-- ROUTES -->
+  <div id="routesTab" class="table-container">
     <table id="routesTable">
-        <thead>
-            <tr>
-                <th>#</th>
-                <th>Method</th>
-                <th>Endpoint</th>
-                <th>Pattern</th>
-                <th>Middlewares</th>
-            </tr>
-        </thead>
-        <tbody>
-            ${allRoutes.map((r, i) => `
-            <tr>
-                <td>${i + 1}</td>
-                <td>${r.method}</td>
-                <td>${r.endpoint}</td>
-                <td>${r.pattern}</td>
-                <td>${(r.appliedMiddlewares || []).join(', ')}</td>
-            </tr>`).join('')}
-        </tbody>
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Method</th>
+          <th>Endpoint</th>
+          <th>Pattern</th>
+          <th>Middlewares</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${allRoutes
+        .map((r, i) => `
+        <tr>
+          <td>${i + 1}</td>
+          <td>${r.method}</td>
+          <td>
+            ${r.endpoint}
+            <button onclick="copyText(\`${r.endpoint}\`)">📋</button>
+          </td>
+          <td>
+            ${r.pattern}
+            <button onclick="copyText(\`${r.pattern}\`)">📋</button>
+          </td>
+          <td>${(r.appliedMiddlewares || []).join(", ")}</td>
+        </tr>
+        `)
+        .join("")}
+      </tbody>
     </table>
-</div>
+  </div>
 
-<!-- STATS -->
-<div id="statsTab" style="display:none">
+  <!-- STATS -->
+  <div id="statsTab" style="display:none">
     <div class="json-view">
-        Total Routes: ${totalRoutes}
-        Middleware Used: ${Object.keys(middlewareStats).length}
-
-        ${Object.entries(middlewareStats).map(([mw, count]) => `- ${mw}: ${count} routes`).join('\n')}
+      Total Routes: ${totalRoutes}<br />
+      Middleware Used: ${Object.keys(middlewareStats).length}<br />
+      <pre>
+${Object.entries(middlewareStats)
+        .map(([mw, count]) => `- ${mw}: ${count} routes`)
+        .join("\n")}
+      </pre>
     </div>
-</div>
-
-<!-- MIDDLEWARES -->
-<div id="middlewaresTab" style="display:none">
-    ${Object.entries(middlewareRoutes).map(([mw, routes]) => `
-    <h3>🔹 ${mw} (${routes.length})</h3>
-    <ul>
-        ${routes.map(r => `<li><code>${r.method} ${r.endpoint}</code></li>`).join('')}
-    </ul>
-    `).join('')}
-</div>
-
-<!-- RAW JSON -->
-<div id="jsonTab" style="display:none">
-    <div class="json-view">${rawJSON}</div>
-</div>
-
-<!-- EXPORT -->
-<div id="exportTab" style="display:none">
+  </div>
+
+  <!-- MIDDLEWARES -->
+  <div id="middlewaresTab" style="display:none">
+    ${Object.entries(middlewareRoutes)
+        .map(([mw, routes]) => `
+      <h3>🔹 ${mw} (${routes.length})</h3>
+      <ul>
+        ${routes.map((r) => `<li><code>${r.method} ${r.endpoint}</code></li>`).join("")}
+      </ul>
+    `)
+        .join("")}
+  </div>
+
+  <!-- RAW JSON -->
+  <div id="jsonTab" style="display:none">
+    <div class="json-view"><pre>${rawJSON}</pre></div>
+  </div>
+
+  <!-- EXPORT -->
+  <div id="exportTab" style="display:none">
     <div class="download">
-        <a href="data:text/json;charset=utf-8,${encodeURIComponent(rawJSON)}" download="routes.json">📥 JSON</a>
-        <a href="data:text/csv;charset=utf-8,${csvString}" download="routes.csv">📥 CSV</a>
+      <a href="data:text/json;charset=utf-8,${encodeURIComponent(rawJSON)}" download="routes.json">📥 JSON</a>
+      <a href="data:text/csv;charset=utf-8,${csvString}" download="routes.csv">📥 CSV</a>
     </div>
-</div>
+  </div>
 
-<script>
+  <script>
     const tabs = ['routes', 'stats', 'middlewares', 'json', 'export'];
     const tabBtns = document.querySelectorAll('.tab-btn');
 
     function showTab(tab) {
-        tabs.forEach(t => {
-            document.getElementById(t + 'Tab').style.display = t === tab ? 'block' : 'none';
-            if (t === tab) {
-                document.getElementById(t + 'Tab').classList.add('active');
-            }
-            else {
-                document.getElementById(t + 'Tab').classList.remove('active');
-            }
-        });
-        tabBtns.forEach(btn => {
-            const active = btn.textContent.toLowerCase().includes(tab);
-            btn.classList.toggle('active', active);
-        });
-        document.getElementById('searchBar').style.display = (tab === 'routes') ? 'flex' : 'none';
+      tabs.forEach(t => {
+        document.getElementById(t + 'Tab').style.display = t === tab ? 'block' : 'none';
+        document.getElementById(t + 'Tab').classList.toggle('active', t === tab);
+      });
+      tabBtns.forEach(btn => {
+        const active = btn.textContent.toLowerCase().includes(tab);
+        btn.classList.toggle('active', active);
+      });
+      document.getElementById('searchBar').style.display = (tab === 'routes') ? 'flex' : 'none';
     }
 
     document.getElementById('search').addEventListener('input', (e) => {
-        const keyword = e.target.value.toLowerCase();
-        const rows = document.querySelectorAll('#routesTable tbody tr');
-        rows.forEach(row => {
-            row.style.display = row.textContent.toLowerCase().includes(keyword) ? '' : 'none';
-        });
+      const keyword = e.target.value.toLowerCase();
+      const rows = document.querySelectorAll('#routesTable tbody tr');
+      rows.forEach(row => {
+        row.style.display = row.textContent.toLowerCase().includes(keyword) ? '' : 'none';
+      });
     });
-</script>
+
+    function copyText(text) {
+      navigator.clipboard.writeText(text).then(() => {
+        alert('✅ Copied: ' + text);
+      }).catch(err => {
+        alert('❌ Failed to copy: ' + err);
+      });
+    }
+  </script>
   `;
 }

package/index.d.ts

@@ -1,7 +1,8 @@
-import { Callback, TezX } from "tezx";
+import { Callback, Context, TezX } from "tezx";
 import { Tab, TabType } from "./html/index.js";
+export { dumpMiddlewares, dumpRoutes } from "./devtools/index.js";
 export type Options = {
-    extraTabs?: TabType;
+    extraTabs?: (ctx: Context) => Promise<TabType> | TabType;
     disableTabs?: Tab[];
 };
 export declare function DevTools(app: TezX<any>, options?: Options): Callback;