@engjts/nexus 0.1.8 → 0.1.9

package/src/advanced/sentry/types.ts

@@ -1,355 +0,0 @@
-// ============================================
-// Types & Interfaces
-// ============================================
-
-import { Context } from "../../core/types";
-
-export type SeverityLevel = 'fatal' | 'error' | 'warning' | 'info' | 'debug';
-
-
-export interface SentryUser {
-    id?: string;
-    email?: string;
-    username?: string;
-    ip_address?: string;
-    [key: string]: any;
-}
-
-export interface SentryBreadcrumb {
-    type?: 'default' | 'http' | 'navigation' | 'error' | 'debug' | 'query' | 'info';
-    category?: string;
-    message?: string;
-    data?: Record<string, any>;
-    level?: SeverityLevel;
-    timestamp?: number;
-}
-
-export interface SentryException {
-    type: string;
-    value: string;
-    stacktrace?: {
-        frames: SentryStackFrame[];
-    };
-    mechanism?: {
-        type: string;
-        handled: boolean;
-    };
-}
-
-export interface SentryStackFrame {
-    filename?: string;
-    function?: string;
-    module?: string;
-    lineno?: number;
-    colno?: number;
-    abs_path?: string;
-    context_line?: string;
-    pre_context?: string[];
-    post_context?: string[];
-    in_app?: boolean;
-}
-
-export interface SentryEvent {
-    event_id: string;
-    timestamp: number;
-    platform: string;
-    level: SeverityLevel;
-    logger?: string;
-    transaction?: string;
-    server_name?: string;
-    release?: string;
-    environment?: string;
-    message?: string;
-    exception?: {
-        values: SentryException[];
-    };
-    user?: SentryUser;
-    tags?: Record<string, string>;
-    extra?: Record<string, any>;
-    contexts?: Record<string, any>;
-    breadcrumbs?: SentryBreadcrumb[];
-    request?: {
-        url?: string;
-        method?: string;
-        headers?: Record<string, string>;
-        query_string?: string;
-        data?: any;
-    };
-    fingerprint?: string[];
-}
-
-export interface SentryTransaction {
-    trace_id: string;
-    span_id: string;
-    parent_span_id?: string;
-    name: string;
-    op: string;
-    status: 'ok' | 'cancelled' | 'unknown' | 'invalid_argument' | 'deadline_exceeded' | 
-            'not_found' | 'already_exists' | 'permission_denied' | 'resource_exhausted' |
-            'failed_precondition' | 'aborted' | 'out_of_range' | 'unimplemented' |
-            'internal_error' | 'unavailable' | 'data_loss' | 'unauthenticated';
-    start_timestamp: number;
-    timestamp?: number;
-    tags?: Record<string, string>;
-    data?: Record<string, any>;
-    spans?: SentrySpan[];
-}
-
-export interface SentrySpan {
-    trace_id: string;
-    span_id: string;
-    parent_span_id?: string;
-    op: string;
-    description?: string;
-    status?: string;
-    start_timestamp: number;
-    timestamp?: number;
-    tags?: Record<string, string>;
-    data?: Record<string, any>;
-}
-
-/**
- * APM (Application Performance Monitoring) Options
- * Integrated into Sentry for unified monitoring
- */
-export interface APMOptions {
-    /**
-     * Enable APM features
-     * @default true when Sentry is enabled
-     */
-    enabled?: boolean;
-
-    /**
-     * Slow query threshold in milliseconds
-     * @default 1000
-     */
-    slowQueryThreshold?: number;
-
-    /**
-     * Maximum slow queries to store
-     * @default 100
-     */
-    maxSlowQueries?: number;
-
-    /**
-     * Memory leak detection options
-     */
-    memoryLeakDetection?: {
-        /**
-         * Enable memory monitoring
-         * @default true
-         */
-        enabled?: boolean;
-
-        /**
-         * Check interval in milliseconds
-         * @default 60000 (1 minute)
-         */
-        interval?: number;
-
-        /**
-         * Growth threshold to trigger warning (0.5 = 50%)
-         * @default 0.5
-         */
-        growthThreshold?: number;
-
-        /**
-         * Number of snapshots to keep
-         * @default 60
-         */
-        maxSnapshots?: number;
-    };
-
-    /**
-     * Callback when memory leak is detected
-     */
-    onMemoryLeak?: (stats: MemoryLeakStats) => void;
-
-    /**
-     * Callback when slow query is detected
-     */
-    onSlowQuery?: (query: SlowQueryRecord) => void;
-}
-
-export interface MemoryLeakStats {
-    growth: number;
-    growthPercent: string;
-    fromMB: string;
-    toMB: string;
-    snapshots: MemorySnapshot[];
-}
-
-export interface MemorySnapshot {
-    timestamp: number;
-    heapUsed: number;
-    heapTotal: number;
-}
-
-export interface SlowQueryRecord {
-    query: string;
-    duration: number;
-    timestamp: number;
-}
-
-export interface SentryOptions {
-    /**
-     * Sentry DSN (Data Source Name)
-     * Format: https://<key>@<organization>.ingest.sentry.io/<project>
-     */
-    dsn: string;
-
-    /**
-     * Environment name (e.g., 'production', 'staging', 'development')
-     */
-    environment?: string;
-
-    /**
-     * Release version
-     */
-    release?: string;
-
-    /**
-     * Server name for identification
-     */
-    serverName?: string;
-
-    /**
-     * Sample rate for error events (0.0 to 1.0)
-     * @default 1.0 (100%)
-     */
-    sampleRate?: number;
-
-    /**
-     * Sample rate for performance/transaction events (0.0 to 1.0)
-     * @default 0.1 (10%)
-     */
-    tracesSampleRate?: number;
-
-    /**
-     * Enable performance monitoring
-     * @default true
-     */
-    enableTracing?: boolean;
-
-    /**
-     * Maximum breadcrumbs to store
-     * @default 100
-     */
-    maxBreadcrumbs?: number;
-
-    /**
-     * Debug mode - logs Sentry operations
-     * @default false
-     */
-    debug?: boolean;
-
-    /**
-     * Attach stack traces to all messages
-     * @default false
-     */
-    attachStacktrace?: boolean;
-
-    /**
-     * Send default PII (Personally Identifiable Information)
-     * @default false
-     */
-    sendDefaultPii?: boolean;
-
-    /**
-     * Before send hook - allows modifying or dropping events
-     */
-    beforeSend?: (event: SentryEvent, hint?: { originalException?: Error }) => SentryEvent | null;
-
-    /**
-     * Before send transaction hook
-     */
-    beforeSendTransaction?: (transaction: SentryTransaction) => SentryTransaction | null;
-
-    /**
-     * Tags to add to all events
-     */
-    tags?: Record<string, string>;
-
-    /**
-     * Extra context to add to all events
-     */
-    extra?: Record<string, any>;
-
-    /**
-     * Paths to ignore (no error reporting)
-     */
-    ignorePaths?: string[];
-
-    /**
-     * Error types to ignore
-     */
-    ignoreErrors?: (string | RegExp)[];
-
-    /**
-     * Request timeout in ms
-     * @default 5000
-     */
-    timeout?: number;
-
-    /**
-     * Integrations to enable
-     */
-    integrations?: {
-        http?: boolean;
-        console?: boolean;
-        unhandledRejection?: boolean;
-        uncaughtException?: boolean;
-    };
-
-    /**
-     * APM (Application Performance Monitoring) options
-     * Includes memory leak detection and slow query tracking
-     */
-    apm?: APMOptions;
-}
-
-export interface ParsedDSN {
-    protocol: string;
-    publicKey: string;
-    host: string;
-    projectId: string;
-}
-
-
-// ============================================
-// Nexus Middleware Integration
-// ============================================
-
-export interface SentryMiddlewareOptions {
-    /**
-     * Include request body in error reports
-     * @default false
-     */
-    includeRequestBody?: boolean;
-
-    /**
-     * Include request headers
-     * @default true
-     */
-    includeHeaders?: boolean;
-
-    /**
-     * Headers to exclude (e.g., 'authorization', 'cookie')
-     */
-    excludeHeaders?: string[];
-
-    /**
-     * Paths to ignore
-     */
-    ignorePaths?: string[];
-
-    /**
-     * Extract user from context
-     */
-    extractUser?: (ctx: Context) => SentryUser | null;
-
-    /**
-     * Extract transaction name
-     */
-    getTransactionName?: (ctx: Context) => string;
-}

package/src/advanced/static/generateDirectoryListing.ts

@@ -1,47 +0,0 @@
-import { readdir } from 'fs/promises';
-import { join } from 'path/posix';
-
-/**
- * Generate HTML for directory listing
- */
-
-export async function generateDirectoryListing(
-    dirPath: string,
-    urlPath: string
-): Promise<string> {
-    const entries = await readdir(dirPath, { withFileTypes: true });
-
-    const items = entries
-        .filter(e => !e.name.startsWith('.'))
-        .map(entry => {
-            const isDir = entry.isDirectory();
-            const name = isDir ? `${entry.name}/` : entry.name;
-            const href = join(urlPath, entry.name);
-            const icon = isDir ? '📁' : '📄';
-            return `<li><a href="${href}">${icon} ${name}</a></li>`;
-        })
-        .join('\n');
-
-    return `<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Index of ${urlPath}</title>
-    <style>
-        body { font-family: system-ui, sans-serif; max-width: 800px; margin: 40px auto; padding: 20px; }
-        h1 { color: #333; border-bottom: 1px solid #eee; padding-bottom: 10px; }
-        ul { list-style: none; padding: 0; }
-        li { padding: 8px 0; border-bottom: 1px solid #f0f0f0; }
-        a { color: #0066cc; text-decoration: none; }
-        a:hover { text-decoration: underline; }
-        .parent { margin-bottom: 20px; }
-    </style>
-</head>
-<body>
-    <h1>Index of ${urlPath}</h1>
-    ${urlPath !== '/' ? `<div class="parent"><a href="${join(urlPath, '..')}">📁 ..</a></div>` : ''}
-    <ul>${items}</ul>
-</body>
-</html>`;
-}

package/src/advanced/static/generateETag.ts

@@ -1,7 +0,0 @@
-/**
- * Generate ETag from file stats
- */
-
-export function generateETag(stats: { size: number; mtimeMs: number; }): string {
-    return `"${stats.size.toString(16)}-${stats.mtimeMs.toString(16)}"`;
-}

package/src/advanced/static/getMimeType.ts

@@ -1,9 +0,0 @@
-import { MIME_TYPES } from './types';
-
-/**
- * Get MIME type for a file extension
- */
-
-export function getMimeType(ext: string): string {
-    return MIME_TYPES[ext.toLowerCase()] || MIME_TYPES[''];
-}

package/src/advanced/static/index.ts

@@ -1,32 +0,0 @@
-/**
- * Static File Serving Feature
- * 
- * Serve static files from a directory (public folder)
- * 
- * @example
- * ```typescript
- * import { createApp, serveStatic } from 'nexus';
- * 
- * const app = createApp();
- * 
- * // Basic usage - serve from ./public
- * app.plugin(serveStatic());
- * 
- * // Custom directory
- * app.plugin(serveStatic({ root: './assets' }));
- * 
- * // With prefix
- * app.plugin(serveStatic({ 
- *   root: './public',
- *   prefix: '/static'  // /static/image.png → ./public/image.png
- * }));
- * ```
- */
-
-import { serveStatic } from './serveStatic';
-
-/**
- * Alias for serveStatic
- */
-export const staticFiles = serveStatic;
-

package/src/advanced/static/isSafePath.ts

@@ -1,13 +0,0 @@
-import { normalize, resolve } from 'path/posix';
-
-/**
- * Check if path is safe (no directory traversal)
- */
-
-export function isSafePath(requestPath: string, root: string): boolean {
-    const normalizedPath = normalize(requestPath);
-    const fullPath = resolve(root, normalizedPath);
-    const normalizedRoot = resolve(root);
-
-    return fullPath.startsWith(normalizedRoot);
-}

package/src/advanced/static/publicDir.ts

@@ -1,21 +0,0 @@
-import { Plugin } from '../../core/types';
-import { serveStatic } from './serveStatic';
-
-/**
- * Create a public directory feature with sensible defaults
- *
- * @example
- * ```typescript
- * app.plugin(publicDir());           // ./public
- * app.plugin(publicDir('./assets')); // ./assets
- * ```
- */
-
-export function publicDir(root = './public'): Plugin {
-    return serveStatic({
-        root,
-        maxAge: 86400,
-        etag: true,
-        lastModified: true
-    });
-}