@tezx/devtools 1.0.9 → 1.0.11

package/html/env.js

@@ -0,0 +1,165 @@
+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><code>${safeKey}</code></td>
+            <td><code>${value}</code></td>
+            <td>
+              <button class="copy-btn" onclick="copyRowEnv('${safeKey}', \`${safeValue}\`)" title="Copy">
+                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" viewBox="0 0 16 16">
+                  <path d="M10 1.5A1.5 1.5 0 0 1 11.5 3v1h-1V3a.5.5 0 0 0-.5-.5H4A1.5 1.5 0 0 0 2.5 4v8A1.5 1.5 0 0 0 4 13.5H5v1H4A2.5 2.5 0 0 1 1.5 12V4A2.5 2.5 0 0 1 4 1.5h6z"/>
+                  <path d="M5.5 5A1.5 1.5 0 0 0 4 6.5v7A1.5 1.5 0 0 0 5.5 15h6A1.5 1.5 0 0 0 13 13.5v-7A1.5 1.5 0 0 0 11.5 5h-6zM5 6.5A.5.5 0 0 1 5.5 6h6a.5.5 0 0 1 .5.5v7a.5.5 0 0 1-.5.5h-6a.5.5 0 0 1-.5-.5v-7z"/>
+                </svg>
+              </button>
+            </td>
+          </tr>`;
+        })
+            .join("")
+        : `
+    <tr>
+      <td colspan="4">
+        <p>⚠️ <strong>No environment variables found.</strong></p>
+        <pre class="code-block">
+const env = loadEnv();
+
+export const app = new TezX({
+  env: env,
+  debugMode: true,
+  allowDuplicateMw: true,
+});
+        </pre>
+      </td>
+    </tr>`;
+    return `
+  <style>
+    .tabs {
+      margin-bottom: 1rem;
+    }
+    .tabs a {
+      display: inline-block;
+      margin-right: 1rem;
+      text-decoration: none;
+      font-weight: 500;
+      color: #0f172a;
+      cursor: pointer;
+    }
+
+    table {
+      width: 100%;
+      border-collapse: collapse;
+    }
+
+    table th, table td {
+      padding: 0.5rem;
+      border: 1px solid #e2e8f0;
+      text-align: left;
+    }
+
+    table td button.copy-btn {
+      background: #f8fafc;
+      border: none;
+      padding: 0.3rem 0.4rem;
+      border-radius: 0.375rem;
+      cursor: pointer;
+      color: #334155;
+      transition: background 0.2s ease;
+    }
+
+    .search-container {
+      margin-bottom: 1rem;
+    }
+
+    .search-container input {
+      padding: 0.5rem;
+      width: 100%;
+      max-width: 400px;
+      border: 1px solid #cbd5e1;
+      border-radius: 0.375rem;
+    }
+
+    .code-block {
+      background: #f1f5f9;
+      padding: 1rem;
+      border-radius: 0.5rem;
+      font-size: 0.875rem;
+    }
+
+  </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(() => {
+        showToast('✅ All environment variables copied!');
+      }).catch(err => {
+        alert('❌ Failed to copy: ' + err);
+      });
+    }
+
+    function copyRowEnv(key, value) {
+      const text = \`\${key}=\${value}\`;
+      navigator.clipboard.writeText(text).then(() => {
+        showToast(\`✅ Copied: \${key}\`);
+      }).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') || '';
+        row.style.display = (key.includes(input) || value.includes(input)) ? '' : 'none';
+      });
+    }
+  </script>
+`;
+}

package/html/index.d.ts

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

package/html/index.js

@@ -0,0 +1,33 @@
+import { CookiesInspector } from "./cookies.js";
+import { EnvInspector } from "./env.js";
+import { Routes } from "./routes.js";
+import { StaticFile } from "./StaticFile.js";
+export function html(ctx, app) {
+    let tabDb = [
+        {
+            doc_title: "DevTools - Route Inspector",
+            label: "Routes",
+            tab: "routes",
+            content: Routes(ctx, app),
+        },
+        {
+            doc_title: "Static File",
+            label: "Static File",
+            tab: "static-file",
+            content: StaticFile(ctx, app),
+        },
+        {
+            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/routes.d.ts

@@ -0,0 +1,2 @@
+import { Context, TezX } from "tezx";
+export declare function Routes(ctx: Context, app: TezX): string;

package/html/routes.js

@@ -0,0 +1,157 @@
+export function Routes(ctx, app) {
+    const routeMap = app.route.reduce((acc, curr) => {
+        const { pattern, method, handlers } = curr;
+        if (!acc[pattern])
+            acc[pattern] = {};
+        acc[pattern][method] = handlers;
+        return acc;
+    }, {});
+    const allRoutes = Object.entries(routeMap).map(([pattern, middlewareMap]) => ({
+        pattern,
+        handlers: Object.entries(middlewareMap).map(([method, handlers]) => ({
+            method,
+            handlerNames: handlers.map((fn) => fn.name || "[anonymous]"),
+        })),
+    }));
+    const rawJSON = JSON.stringify(allRoutes, null, 2);
+    const toCSV = (data) => {
+        const headers = ["Path", "Middleware", "Handler"];
+        const rows = data.flatMap((route) => route.handlers.flatMap((mw) => mw.handlerNames.map((h) => [
+            JSON.stringify(route.pattern),
+            JSON.stringify(mw.method),
+            JSON.stringify(h),
+        ])));
+        return [headers.join(","), ...rows.map((r) => r.join(","))].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;
+    }
+
+    .router-title {
+      font-size: 1.25rem;
+      margin-bottom: 0.5rem;
+      font-weight: 600;
+      color: #334155;
+    }
+  </style>
+
+  <div class="tabs toolbar">
+    <a class="tab-btn active" onclick="showTab('routes')">📋 Routes (${allRoutes.flat(2)?.length})</a>
+    <a class="tab-btn" onclick="showTab('json')">🧾 Raw JSON</a>
+    <a class="tab-btn" onclick="showTab('export')">📤 Export</a>
+  </div>
+    <h2 class="router-title">📌 Router: <span class="router-name">${app.router.name}</span></h2>
+  <div id="searchBar">
+    <input type="text" id="search" placeholder="Filter by path or middleware..." />
+  </div>
+
+  <div id="routesTab" class="table-container">
+    <table id="routesTable">
+      <thead>
+        <tr>
+          <th>#</th>
+          <th>Path</th>
+          <th>Middleware</th>
+          <th>Handlers</th>
+        </tr>
+      </thead>
+      <tbody>
+        ${allRoutes.flatMap((r, i) => r.handlers.map((hn) => `
+              <tr>
+                <td>${i + 1}</td>
+                <td>${r.pattern}</td>
+                <td>
+                  ${hn.method === "ALL"
+        ? `<span style="
+                          display: inline-block;
+                          background-color: var(--accent);
+                          color: #fff;
+                          padding: 4px 10px;
+                          border-radius: 6px;
+                          font-weight: 500;
+                          font-size: 13px;
+                          box-shadow: 0 1px 4px rgba(0,0,0,0.15);
+                        ">${hn.method} <small style="opacity: 0.8;">(middleware)</small></span>`
+        : `<span style="
+                          font-size: 14px;
+                          color: #333;
+                        ">${hn.method}</span>`}
+                </td>
+                <td>${hn.handlerNames.join(", ")}</td>
+              </tr>
+            `))
+        .join("")}
+      </tbody>
+    </table>
+  </div>
+
+  <div id="jsonTab" style="display:none">
+    <div class="json-view"><pre>${rawJSON}</pre></div>
+  </div>
+
+  <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>
+    </div>
+  </div>
+
+  <script>
+    const tabs = ['routes', 'json', 'export'];
+    const tabBtns = document.querySelectorAll('.tab-btn');
+
+    function showTab(tab) {
+      tabs.forEach(t => {
+        document.getElementById(t + 'Tab').style.display = t === tab ? 'block' : 'none';
+      });
+      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';
+      });
+    });
+  </script>
+  `;
+}

package/index.d.ts

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