@shohaghinfo/aerojs 0.1.0

package/dist/core/error-dashboard.js

@@ -0,0 +1,481 @@
+/**
+ * @file error-dashboard.ts
+ * @description Next.js & Laravel Ignition style Interactive Developer Error Dashboard for AeroJS.
+ * Displays syntax/runtime exceptions with source code snippets, highlighted crash lines,
+ * interactive call stacks, and request context in development mode.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+/**
+ * Parses Node.js Error.stack into structured StackFrames with source code snippets.
+ */
+export function parseStackTrace(stack) {
+    const lines = stack.split('\n').slice(1);
+    const frames = [];
+    for (const rawLine of lines) {
+        const trimmed = rawLine.trim();
+        if (!trimmed.startsWith('at '))
+            continue;
+        // Pattern 1: at MethodName (path/to/file.ts:12:34)
+        // Pattern 2: at path/to/file.ts:12:34
+        // Pattern 3: at async MethodName (path/to/file.ts:12:34)
+        const match = /at (?:async )?(?:(.+?)\s+\((.+?):(\d+):(\d+)\)|(.+?):(\d+):(\d+))/.exec(trimmed);
+        if (match) {
+            const method = match[1] || '<anonymous>';
+            let filePath = match[2] || match[5] || '';
+            const line = parseInt(match[3] || match[6] || '0', 10);
+            const column = parseInt(match[4] || match[7] || '0', 10);
+            // Convert file:// URL to path if necessary
+            if (filePath.startsWith('file://')) {
+                try {
+                    filePath = fileURLToPath(filePath);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            const isNodeInternal = filePath.startsWith('node:') || !filePath.includes('/') && !filePath.includes('\\');
+            const isNodeModules = filePath.includes('node_modules');
+            const isApp = !isNodeInternal && !isNodeModules;
+            const frame = {
+                method,
+                file: filePath,
+                line,
+                column,
+                isApp,
+            };
+            // Extract source code snippet if file exists
+            if (line > 0 && existsSync(filePath)) {
+                try {
+                    const content = readFileSync(filePath, 'utf-8');
+                    const allLines = content.split(/\r?\n/);
+                    const start = Math.max(1, line - 5);
+                    const end = Math.min(allLines.length, line + 5);
+                    const snippetLines = [];
+                    for (let i = start; i <= end; i++) {
+                        snippetLines.push({
+                            num: i,
+                            code: allLines[i - 1] ?? '',
+                            isError: i === line,
+                        });
+                    }
+                    frame.snippet = {
+                        startLine: start,
+                        errorLine: line,
+                        lines: snippetLines,
+                    };
+                }
+                catch {
+                    // File reading error ignored
+                }
+            }
+            frames.push(frame);
+        }
+    }
+    return frames;
+}
+function escapeHtml(str) {
+    if (str === null || str === undefined)
+        return '';
+    return String(str)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
+/**
+ * Renders the Interactive Next.js style Error Dashboard HTML.
+ */
+export function renderErrorDashboard(error, ctx, options = {}) {
+    const status = options.status || 500;
+    const code = options.code || 'INTERNAL_SERVER_ERROR';
+    const errorName = error.name || 'Error';
+    const errorMessage = error.message || 'An unhandled exception occurred in application code.';
+    const stack = error.stack || `${errorName}: ${errorMessage}`;
+    const frames = parseStackTrace(stack);
+    // Find the most relevant frame with source snippet (prefer application frame)
+    const primaryFrame = frames.find((f) => f.isApp && f.snippet) || frames.find((f) => f.snippet) || frames[0];
+    const reqHeaders = ctx.req.headers;
+    const reqQuery = ctx.req.query || {};
+    const reqParams = ctx.req.params || {};
+    const reqBody = ctx.body;
+    const method = ctx.method || 'GET';
+    const url = ctx.url || '/';
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${escapeHtml(errorName)}: ${escapeHtml(errorMessage)} — AeroJS Error Dashboard</title>
+  <style>
+    :root {
+      --bg: #090d16;
+      --card-bg: #111827;
+      --card-header: #162032;
+      --border: #1f2937;
+      --border-focus: #374151;
+      --danger: #ef4444;
+      --danger-soft: rgba(239, 68, 68, 0.15);
+      --danger-border: rgba(239, 68, 68, 0.35);
+      --text: #f9fafb;
+      --text-muted: #9ca3af;
+      --text-subtle: #6b7280;
+      --brand: #38bdf8;
+      --code-bg: #030712;
+      --highlight: rgba(239, 68, 68, 0.22);
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+      background: var(--bg);
+      color: var(--text);
+      line-height: 1.5;
+      padding-bottom: 5rem;
+    }
+    .top-bar {
+      background: #030712;
+      border-bottom: 1px solid var(--border);
+      padding: 0.85rem 1.5rem;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      position: sticky;
+      top: 0;
+      z-index: 50;
+    }
+    .logo-badge {
+      display: flex;
+      align-items: center;
+      gap: 0.75rem;
+    }
+    .badge-error {
+      background: var(--danger-soft);
+      color: #f87171;
+      border: 1px solid var(--danger-border);
+      padding: 0.25rem 0.65rem;
+      border-radius: 9999px;
+      font-size: 0.75rem;
+      font-weight: 700;
+      text-transform: uppercase;
+      letter-spacing: 0.05em;
+    }
+    .req-badge {
+      font-family: ui-monospace, Menlo, Consolas, monospace;
+      font-size: 0.8rem;
+      color: var(--text-muted);
+    }
+    .copy-btn {
+      background: #1f2937;
+      border: 1px solid #374151;
+      color: #e5e7eb;
+      padding: 0.4rem 0.9rem;
+      border-radius: 0.4rem;
+      font-size: 0.8rem;
+      font-weight: 600;
+      cursor: pointer;
+      transition: all 0.2s;
+    }
+    .copy-btn:hover {
+      background: #374151;
+      color: #fff;
+    }
+    .container {
+      max-width: 1200px;
+      margin: 2rem auto;
+      padding: 0 1.5rem;
+    }
+    /* Hero Error Header */
+    .hero-error {
+      margin-bottom: 2rem;
+    }
+    .error-type {
+      font-size: 0.95rem;
+      font-weight: 700;
+      color: #f87171;
+      letter-spacing: 0.02em;
+      margin-bottom: 0.4rem;
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+    }
+    .error-title {
+      font-size: 1.85rem;
+      font-weight: 800;
+      color: #fff;
+      letter-spacing: -0.02em;
+      line-height: 1.25;
+      word-break: break-word;
+    }
+    /* Code Snippet Card */
+    .snippet-card {
+      background: var(--card-bg);
+      border: 1px solid var(--border);
+      border-radius: 0.75rem;
+      overflow: hidden;
+      margin-bottom: 2rem;
+      box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.5);
+    }
+    .snippet-header {
+      background: var(--card-header);
+      padding: 0.75rem 1.25rem;
+      border-bottom: 1px solid var(--border);
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      font-family: ui-monospace, Menlo, monospace;
+      font-size: 0.85rem;
+      color: var(--text-muted);
+    }
+    .snippet-file {
+      color: var(--brand);
+      font-weight: 600;
+    }
+    .code-viewer {
+      background: var(--code-bg);
+      font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+      font-size: 0.85rem;
+      overflow-x: auto;
+      padding: 0.75rem 0;
+    }
+    .code-line {
+      display: flex;
+      padding: 0.15rem 1rem;
+      line-height: 1.6;
+    }
+    .code-line.error-highlight {
+      background: var(--highlight);
+      border-left: 3px solid var(--danger);
+    }
+    .line-number {
+      width: 45px;
+      color: #4b5563;
+      user-select: none;
+      text-align: right;
+      padding-right: 1.25rem;
+    }
+    .code-line.error-highlight .line-number {
+      color: #f87171;
+      font-weight: 700;
+    }
+    .line-content {
+      color: #e5e7eb;
+      white-space: pre;
+    }
+    /* Tabs Section */
+    .tabs-nav {
+      display: flex;
+      gap: 0.5rem;
+      border-bottom: 1px solid var(--border);
+      margin-bottom: 1.5rem;
+    }
+    .tab-btn {
+      background: transparent;
+      border: none;
+      color: var(--text-muted);
+      padding: 0.75rem 1.25rem;
+      font-size: 0.95rem;
+      font-weight: 600;
+      cursor: pointer;
+      border-bottom: 2px solid transparent;
+      transition: all 0.2s;
+    }
+    .tab-btn.active {
+      color: var(--brand);
+      border-bottom-color: var(--brand);
+    }
+    .tab-content {
+      display: none;
+    }
+    .tab-content.active {
+      display: block;
+    }
+    /* Stack Trace List */
+    .stack-list {
+      background: var(--card-bg);
+      border: 1px solid var(--border);
+      border-radius: 0.75rem;
+      overflow: hidden;
+    }
+    .stack-item {
+      padding: 0.75rem 1.25rem;
+      border-bottom: 1px solid var(--border);
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      font-family: ui-monospace, Menlo, monospace;
+      font-size: 0.85rem;
+    }
+    .stack-item:last-child {
+      border-bottom: none;
+    }
+    .stack-item.app-frame {
+      background: rgba(56, 189, 248, 0.04);
+    }
+    .stack-method {
+      color: #fff;
+      font-weight: 600;
+    }
+    .stack-loc {
+      color: var(--text-subtle);
+      font-size: 0.8rem;
+    }
+    .stack-item.app-frame .stack-loc {
+      color: var(--brand);
+    }
+    /* Table inspector */
+    .inspector-table {
+      width: 100%;
+      border-collapse: collapse;
+      background: var(--card-bg);
+      border: 1px solid var(--border);
+      border-radius: 0.75rem;
+      overflow: hidden;
+      margin-bottom: 1.5rem;
+    }
+    .inspector-table th, .inspector-table td {
+      padding: 0.75rem 1.25rem;
+      text-align: left;
+      font-size: 0.88rem;
+      border-bottom: 1px solid var(--border);
+    }
+    .inspector-table th {
+      background: var(--card-header);
+      color: var(--text-muted);
+      width: 25%;
+      font-family: ui-monospace, Menlo, monospace;
+    }
+    .inspector-table td {
+      font-family: ui-monospace, Menlo, monospace;
+      color: #e5e7eb;
+      word-break: break-all;
+    }
+    .inspector-table tr:last-child th, .inspector-table tr:last-child td {
+      border-bottom: none;
+    }
+  </style>
+</head>
+<body>
+  <div class="top-bar">
+    <div class="logo-badge">
+      <span style="font-weight: 800; font-size: 1.1rem; color: #fff;">🚀 AeroJS</span>
+      <span class="badge-error">${escapeHtml(status)} &bull; ${escapeHtml(code)}</span>
+      <span class="req-badge">${escapeHtml(method)} ${escapeHtml(url)}</span>
+    </div>
+    <div>
+      <button class="copy-btn" id="copy-stack-btn">Copy Stack Trace</button>
+    </div>
+  </div>
+
+  <div class="container">
+    <!-- Hero Error Title -->
+    <div class="hero-error">
+      <div class="error-type">
+        <span>⚠️</span> ${escapeHtml(errorName)}
+      </div>
+      <h1 class="error-title">${escapeHtml(errorMessage)}</h1>
+    </div>
+
+    <!-- Code Snippet Box -->
+    ${primaryFrame?.snippet
+        ? `
+    <div class="snippet-card">
+      <div class="snippet-header">
+        <span class="snippet-file">${escapeHtml(primaryFrame.file)}:${escapeHtml(primaryFrame.line)}</span>
+        <span>Line ${escapeHtml(primaryFrame.line)}</span>
+      </div>
+      <div class="code-viewer">
+        ${primaryFrame.snippet.lines
+            .map((l) => `
+          <div class="code-line ${l.isError ? 'error-highlight' : ''}">
+            <span class="line-number">${l.isError ? '→ ' : ''}${l.num}</span>
+            <span class="line-content">${escapeHtml(l.code)}</span>
+          </div>
+        `)
+            .join('')}
+      </div>
+    </div>
+    `
+        : `
+    <div class="snippet-card" style="padding: 1.5rem;">
+      <p style="color: var(--text-muted);">No local source file preview available for this stack frame.</p>
+    </div>
+    `}
+
+    <!-- Tab Navigation -->
+    <div class="tabs-nav">
+      <button class="tab-btn active" onclick="switchTab('stack')">Call Stack (${frames.length})</button>
+      <button class="tab-btn" onclick="switchTab('request')">Request Context</button>
+      <button class="tab-btn" onclick="switchTab('system')">System & Environment</button>
+    </div>
+
+    <!-- Tab 1: Stack Trace -->
+    <div id="tab-stack" class="tab-content active">
+      <div class="stack-list">
+        ${frames
+        .map((f) => `
+          <div class="stack-item ${f.isApp ? 'app-frame' : ''}">
+            <div>
+              <span class="stack-method">${escapeHtml(f.method)}</span>
+            </div>
+            <div class="stack-loc">${escapeHtml(f.file)}:${escapeHtml(f.line)}:${escapeHtml(f.column)}</div>
+          </div>
+        `)
+        .join('')}
+      </div>
+    </div>
+
+    <!-- Tab 2: Request Context -->
+    <div id="tab-request" class="tab-content">
+      <h3 style="margin-bottom: 0.75rem; color: #fff; font-size: 1.1rem;">Request Information</h3>
+      <table class="inspector-table">
+        <tr><th>Method</th><td>${escapeHtml(method)}</td></tr>
+        <tr><th>URL</th><td>${escapeHtml(url)}</td></tr>
+        <tr><th>Path Parameters</th><td>${escapeHtml(JSON.stringify(reqParams))}</td></tr>
+        <tr><th>Query Parameters</th><td>${escapeHtml(JSON.stringify(reqQuery))}</td></tr>
+        <tr><th>Parsed Body</th><td>${escapeHtml(reqBody ? JSON.stringify(reqBody, null, 2) : 'None')}</td></tr>
+      </table>
+
+      <h3 style="margin-bottom: 0.75rem; color: #fff; font-size: 1.1rem;">Request Headers</h3>
+      <table class="inspector-table">
+        ${Object.entries(reqHeaders)
+        .map(([k, v]) => `<tr><th>${escapeHtml(k)}</th><td>${escapeHtml(String(v))}</td></tr>`)
+        .join('')}
+      </table>
+    </div>
+
+    <!-- Tab 3: System & Environment -->
+    <div id="tab-system" class="tab-content">
+      <h3 style="margin-bottom: 0.75rem; color: #fff; font-size: 1.1rem;">Environment</h3>
+      <table class="inspector-table">
+        <tr><th>Node.js Version</th><td>${escapeHtml(process.version)}</td></tr>
+        <tr><th>Platform</th><td>${escapeHtml(process.platform)} (${escapeHtml(process.arch)})</td></tr>
+        <tr><th>Framework</th><td>AeroJS v0.1.0</td></tr>
+        <tr><th>Working Directory</th><td>${escapeHtml(process.cwd())}</td></tr>
+        <tr><th>Process ID (PID)</th><td>${escapeHtml(process.pid)}</td></tr>
+        <tr><th>Memory (Heap Used)</th><td>${Math.round(process.memoryUsage().heapUsed / 1024 / 1024)} MB</td></tr>
+      </table>
+    </div>
+  </div>
+
+  <script>
+    function switchTab(tabName) {
+      document.querySelectorAll('.tab-btn').forEach(btn => btn.classList.remove('active'));
+      document.querySelectorAll('.tab-content').forEach(content => content.classList.remove('active'));
+      document.getElementById('tab-' + tabName).classList.add('active');
+      event.target.classList.add('active');
+    }
+
+    const rawStack = ${JSON.stringify(stack)};
+    document.getElementById('copy-stack-btn').addEventListener('click', () => {
+      navigator.clipboard.writeText(rawStack).then(() => {
+        const btn = document.getElementById('copy-stack-btn');
+        btn.innerText = 'Copied to Clipboard!';
+        setTimeout(() => { btn.innerText = 'Copy Stack Trace'; }, 2000);
+      });
+    });
+  </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=error-dashboard.js.map

package/dist/core/error-dashboard.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @file errors.ts
+ * @description Standard error classes for the Aero framework.
+ */
+/**
+ * Base HTTP and framework error class in Aero.
+ */
+export declare class AeroError extends Error {
+    /**
+     * HTTP status code associated with the error.
+     */
+    readonly status: number;
+    /**
+     * Optional machine-readable error code.
+     */
+    readonly code?: string;
+    /**
+     * Optional contextual details or validation errors.
+     */
+    readonly details?: unknown;
+    /**
+     * Creates an instance of AeroError.
+     *
+     * @param message - Human-readable error message.
+     * @param status - HTTP status code (defaults to 500).
+     * @param code - Optional machine-readable error code.
+     * @param details - Optional additional error details.
+     */
+    constructor(message: string, status?: number, code?: string, details?: unknown);
+}
+/**
+ * HTTP 400 Bad Request error.
+ */
+export declare class BadRequestError extends AeroError {
+    constructor(message?: string, code?: string, details?: unknown);
+}
+/**
+ * HTTP 401 Unauthorized error.
+ */
+export declare class UnauthorizedError extends AeroError {
+    constructor(message?: string, code?: string, details?: unknown);
+}
+/**
+ * HTTP 403 Forbidden error.
+ */
+export declare class ForbiddenError extends AeroError {
+    constructor(message?: string, code?: string, details?: unknown);
+}
+/**
+ * HTTP 404 Not Found error.
+ */
+export declare class NotFoundError extends AeroError {
+    constructor(message?: string, code?: string, details?: unknown);
+}
+/**
+ * HTTP 405 Method Not Allowed error.
+ */
+export declare class MethodNotAllowedError extends AeroError {
+    readonly allowedMethods: readonly string[];
+    constructor(message?: string, allowedMethods?: readonly string[], code?: string);
+}
+/**
+ * HTTP 413 Payload Too Large error.
+ */
+export declare class PayloadTooLargeError extends AeroError {
+    constructor(message?: string, code?: string, details?: unknown);
+}
+/**
+ * HTTP 500 Internal Server Error.
+ */
+export declare class InternalError extends AeroError {
+    constructor(message?: string, code?: string, details?: unknown);
+}
+/**
+ * HTTP 422 Unprocessable Entity error (Validation Error).
+ */
+export declare class UnprocessableEntityError extends AeroError {
+    readonly errors: Record<string, string | string[]>;
+    constructor(message?: string, errors?: Record<string, string | string[]>, code?: string);
+}
+export declare const ValidationError: typeof UnprocessableEntityError;
+export type ValidationError = UnprocessableEntityError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;;OAOG;gBAED,OAAO,EAAE,MAAM,EACf,MAAM,SAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,OAAO;CAYpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAE1C,OAAO,SAAgB,EACvB,IAAI,SAAgB,EACpB,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBAE5C,OAAO,SAAiB,EACxB,IAAI,SAAiB,EACrB,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;gBAEzC,OAAO,SAAc,EACrB,IAAI,SAAc,EAClB,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAExC,OAAO,SAAc,EACrB,IAAI,SAAc,EAClB,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;IAClD,SAAgB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;gBAGhD,OAAO,SAAuB,EAC9B,cAAc,GAAE,SAAS,MAAM,EAAO,EACtC,IAAI,SAAuB;CAM9B;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;gBAE/C,OAAO,SAAsB,EAC7B,IAAI,SAAsB,EAC1B,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAExC,OAAO,SAA0B,EACjC,IAAI,SAA0B,EAC9B,OAAO,CAAC,EAAE,OAAO;CAKpB;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;IACrD,SAAgB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;gBAGxD,OAAO,SAAsB,EAC7B,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAM,EAC9C,IAAI,SAAqB;CAM5B;AAED,eAAO,MAAM,eAAe,iCAA2B,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,wBAAwB,CAAC"}

package/dist/core/errors.js

@@ -0,0 +1,117 @@
+/**
+ * @file errors.ts
+ * @description Standard error classes for the Aero framework.
+ */
+/**
+ * Base HTTP and framework error class in Aero.
+ */
+export class AeroError extends Error {
+    /**
+     * HTTP status code associated with the error.
+     */
+    status;
+    /**
+     * Optional machine-readable error code.
+     */
+    code;
+    /**
+     * Optional contextual details or validation errors.
+     */
+    details;
+    /**
+     * Creates an instance of AeroError.
+     *
+     * @param message - Human-readable error message.
+     * @param status - HTTP status code (defaults to 500).
+     * @param code - Optional machine-readable error code.
+     * @param details - Optional additional error details.
+     */
+    constructor(message, status = 500, code, details) {
+        super(message);
+        this.name = 'AeroError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * HTTP 400 Bad Request error.
+ */
+export class BadRequestError extends AeroError {
+    constructor(message = 'Bad Request', code = 'BAD_REQUEST', details) {
+        super(message, 400, code, details);
+        this.name = 'BadRequestError';
+    }
+}
+/**
+ * HTTP 401 Unauthorized error.
+ */
+export class UnauthorizedError extends AeroError {
+    constructor(message = 'Unauthorized', code = 'UNAUTHORIZED', details) {
+        super(message, 401, code, details);
+        this.name = 'UnauthorizedError';
+    }
+}
+/**
+ * HTTP 403 Forbidden error.
+ */
+export class ForbiddenError extends AeroError {
+    constructor(message = 'Forbidden', code = 'FORBIDDEN', details) {
+        super(message, 403, code, details);
+        this.name = 'ForbiddenError';
+    }
+}
+/**
+ * HTTP 404 Not Found error.
+ */
+export class NotFoundError extends AeroError {
+    constructor(message = 'Not Found', code = 'NOT_FOUND', details) {
+        super(message, 404, code, details);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * HTTP 405 Method Not Allowed error.
+ */
+export class MethodNotAllowedError extends AeroError {
+    allowedMethods;
+    constructor(message = 'Method Not Allowed', allowedMethods = [], code = 'METHOD_NOT_ALLOWED') {
+        super(message, 405, code, { allowed: allowedMethods });
+        this.name = 'MethodNotAllowedError';
+        this.allowedMethods = allowedMethods;
+    }
+}
+/**
+ * HTTP 413 Payload Too Large error.
+ */
+export class PayloadTooLargeError extends AeroError {
+    constructor(message = 'Payload Too Large', code = 'PAYLOAD_TOO_LARGE', details) {
+        super(message, 413, code, details);
+        this.name = 'PayloadTooLargeError';
+    }
+}
+/**
+ * HTTP 500 Internal Server Error.
+ */
+export class InternalError extends AeroError {
+    constructor(message = 'Internal Server Error', code = 'INTERNAL_SERVER_ERROR', details) {
+        super(message, 500, code, details);
+        this.name = 'InternalError';
+    }
+}
+/**
+ * HTTP 422 Unprocessable Entity error (Validation Error).
+ */
+export class UnprocessableEntityError extends AeroError {
+    errors;
+    constructor(message = 'Validation Failed', errors = {}, code = 'VALIDATION_ERROR') {
+        super(message, 422, code, errors);
+        this.name = 'UnprocessableEntityError';
+        this.errors = errors;
+    }
+}
+export const ValidationError = UnprocessableEntityError;
+//# sourceMappingURL=errors.js.map