npm - @engjts/nexus - Versions diffs - 0.1.8 → 0.1.10 - Mend

@engjts/nexus 0.1.8 → 0.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (221) hide show

package/dist/advanced/playground/playground.js.map +1 -1
package/dist/advanced/static/generateDirectoryListing.d.ts +1 -1
package/dist/advanced/static/generateDirectoryListing.d.ts.map +1 -1
package/dist/advanced/static/generateDirectoryListing.js +12 -6
package/dist/advanced/static/generateDirectoryListing.js.map +1 -1
package/dist/advanced/static/index.d.ts +2 -0
package/dist/advanced/static/index.d.ts.map +1 -1
package/dist/advanced/static/index.js +4 -1
package/dist/advanced/static/index.js.map +1 -1
package/dist/advanced/static/serveStatic.d.ts.map +1 -1
package/dist/advanced/static/serveStatic.js +7 -1
package/dist/advanced/static/serveStatic.js.map +1 -1
package/dist/index.d.ts +1 -1
package/dist/index.d.ts.map +1 -1
package/dist/index.js +3 -1
package/dist/index.js.map +1 -1
package/package.json +1 -1
package/BENCHMARK_REPORT.md +0 -343
package/documentation/01-getting-started.md +0 -240
package/documentation/02-context.md +0 -335
package/documentation/03-routing.md +0 -397
package/documentation/04-middleware.md +0 -483
package/documentation/05-validation.md +0 -514
package/documentation/06-error-handling.md +0 -465
package/documentation/07-performance.md +0 -364
package/documentation/08-adapters.md +0 -470
package/documentation/09-api-reference.md +0 -548
package/documentation/10-examples.md +0 -582
package/documentation/11-deployment.md +0 -477
package/documentation/12-sentry.md +0 -620
package/documentation/13-sentry-data-storage.md +0 -996
package/documentation/14-sentry-data-reference.md +0 -457
package/documentation/15-sentry-summary.md +0 -409
package/documentation/16-alerts-system.md +0 -745
package/documentation/17-alert-adapters.md +0 -696
package/documentation/18-alerts-implementation-summary.md +0 -385
package/documentation/19-class-based-routing.md +0 -840
package/documentation/20-websocket-realtime.md +0 -813
package/documentation/21-cache-system.md +0 -510
package/documentation/22-job-queue.md +0 -772
package/documentation/23-sentry-plugin.md +0 -551
package/documentation/24-testing-utilities.md +0 -1287
package/documentation/25-api-versioning.md +0 -533
package/documentation/26-context-store.md +0 -607
package/documentation/27-dependency-injection.md +0 -329
package/documentation/28-lifecycle-hooks.md +0 -521
package/documentation/29-package-structure.md +0 -196
package/documentation/30-plugin-system.md +0 -414
package/documentation/31-jwt-authentication.md +0 -597
package/documentation/32-cli.md +0 -268
package/documentation/ALERTS-COMPLETE-SUMMARY.md +0 -429
package/documentation/ALERTS-INDEX.md +0 -330
package/documentation/ALERTS-QUICK-REFERENCE.md +0 -286
package/documentation/README.md +0 -178
package/documentation/index.html +0 -34
package/modern_framework_paper.md +0 -1870
package/public/css/style.css +0 -87
package/public/index.html +0 -34
package/public/js/app.js +0 -27
package/src/advanced/cache/InMemoryCacheStore.ts +0 -68
package/src/advanced/cache/MultiTierCache.ts +0 -194
package/src/advanced/cache/RedisCacheStore.ts +0 -341
package/src/advanced/cache/index.ts +0 -5
package/src/advanced/cache/types.ts +0 -40
package/src/advanced/graphql/SimpleDataLoader.ts +0 -42
package/src/advanced/graphql/index.ts +0 -22
package/src/advanced/graphql/server.ts +0 -252
package/src/advanced/graphql/types.ts +0 -42
package/src/advanced/jobs/InMemoryQueueStore.ts +0 -68
package/src/advanced/jobs/JobQueue.ts +0 -556
package/src/advanced/jobs/RedisQueueStore.ts +0 -367
package/src/advanced/jobs/index.ts +0 -5
package/src/advanced/jobs/types.ts +0 -70
package/src/advanced/observability/APMManager.ts +0 -163
package/src/advanced/observability/AlertManager.ts +0 -109
package/src/advanced/observability/MetricRegistry.ts +0 -151
package/src/advanced/observability/ObservabilityCenter.ts +0 -304
package/src/advanced/observability/StructuredLogger.ts +0 -154
package/src/advanced/observability/TracingManager.ts +0 -117
package/src/advanced/observability/adapters.ts +0 -304
package/src/advanced/observability/createObservabilityMiddleware.ts +0 -63
package/src/advanced/observability/index.ts +0 -11
package/src/advanced/observability/types.ts +0 -174
package/src/advanced/playground/extractPathParams.ts +0 -6
package/src/advanced/playground/generateFieldExample.ts +0 -31
package/src/advanced/playground/generatePlaygroundHTML.ts +0 -1956
package/src/advanced/playground/generateSummary.ts +0 -19
package/src/advanced/playground/getTagFromPath.ts +0 -9
package/src/advanced/playground/index.ts +0 -8
package/src/advanced/playground/playground.ts +0 -250
package/src/advanced/playground/types.ts +0 -49
package/src/advanced/playground/zodToExample.ts +0 -16
package/src/advanced/playground/zodToParams.ts +0 -15
package/src/advanced/postman/buildAuth.ts +0 -31
package/src/advanced/postman/buildBody.ts +0 -15
package/src/advanced/postman/buildQueryParams.ts +0 -27
package/src/advanced/postman/buildRequestItem.ts +0 -36
package/src/advanced/postman/buildResponses.ts +0 -11
package/src/advanced/postman/buildUrl.ts +0 -33
package/src/advanced/postman/capitalize.ts +0 -4
package/src/advanced/postman/generateCollection.ts +0 -59
package/src/advanced/postman/generateEnvironment.ts +0 -34
package/src/advanced/postman/generateExampleFromZod.ts +0 -21
package/src/advanced/postman/generateFieldExample.ts +0 -45
package/src/advanced/postman/generateName.ts +0 -20
package/src/advanced/postman/generateUUID.ts +0 -11
package/src/advanced/postman/getTagFromPath.ts +0 -10
package/src/advanced/postman/index.ts +0 -28
package/src/advanced/postman/postman.ts +0 -156
package/src/advanced/postman/slugify.ts +0 -7
package/src/advanced/postman/types.ts +0 -140
package/src/advanced/realtime/index.ts +0 -18
package/src/advanced/realtime/websocket.ts +0 -231
package/src/advanced/sentry/index.ts +0 -1236
package/src/advanced/sentry/types.ts +0 -355
package/src/advanced/static/generateDirectoryListing.ts +0 -47
package/src/advanced/static/generateETag.ts +0 -7
package/src/advanced/static/getMimeType.ts +0 -9
package/src/advanced/static/index.ts +0 -32
package/src/advanced/static/isSafePath.ts +0 -13
package/src/advanced/static/publicDir.ts +0 -21
package/src/advanced/static/serveStatic.ts +0 -225
package/src/advanced/static/spa.ts +0 -24
package/src/advanced/static/types.ts +0 -159
package/src/advanced/swagger/SwaggerGenerator.ts +0 -66
package/src/advanced/swagger/buildOperation.ts +0 -61
package/src/advanced/swagger/buildParameters.ts +0 -61
package/src/advanced/swagger/buildRequestBody.ts +0 -21
package/src/advanced/swagger/buildResponses.ts +0 -54
package/src/advanced/swagger/capitalize.ts +0 -5
package/src/advanced/swagger/convertPath.ts +0 -9
package/src/advanced/swagger/createSwagger.ts +0 -12
package/src/advanced/swagger/generateOperationId.ts +0 -21
package/src/advanced/swagger/generateSpec.ts +0 -105
package/src/advanced/swagger/generateSummary.ts +0 -24
package/src/advanced/swagger/generateSwaggerUI.ts +0 -70
package/src/advanced/swagger/generateThemeCss.ts +0 -53
package/src/advanced/swagger/index.ts +0 -25
package/src/advanced/swagger/swagger.ts +0 -237
package/src/advanced/swagger/types.ts +0 -206
package/src/advanced/swagger/zodFieldToOpenAPI.ts +0 -94
package/src/advanced/swagger/zodSchemaToOpenAPI.ts +0 -50
package/src/advanced/swagger/zodToOpenAPI.ts +0 -22
package/src/advanced/testing/factory.ts +0 -509
package/src/advanced/testing/harness.ts +0 -612
package/src/advanced/testing/index.ts +0 -430
package/src/advanced/testing/load-test.ts +0 -618
package/src/advanced/testing/mock-server.ts +0 -498
package/src/advanced/testing/mock.ts +0 -670
package/src/cli/bin.ts +0 -9
package/src/cli/cli.ts +0 -158
package/src/cli/commands/add.ts +0 -178
package/src/cli/commands/build.ts +0 -73
package/src/cli/commands/create.ts +0 -166
package/src/cli/commands/dev.ts +0 -85
package/src/cli/commands/generate.ts +0 -99
package/src/cli/commands/help.ts +0 -95
package/src/cli/commands/init.ts +0 -91
package/src/cli/commands/version.ts +0 -38
package/src/cli/index.ts +0 -6
package/src/cli/templates/generators.ts +0 -359
package/src/cli/templates/index.ts +0 -680
package/src/cli/utils/exec.ts +0 -52
package/src/cli/utils/file-system.ts +0 -78
package/src/cli/utils/logger.ts +0 -111
package/src/core/adapter.ts +0 -88
package/src/core/application.ts +0 -1453
package/src/core/context-pool.ts +0 -79
package/src/core/context.ts +0 -856
package/src/core/index.ts +0 -94
package/src/core/middleware.ts +0 -272
package/src/core/performance/buffer-pool.ts +0 -108
package/src/core/performance/middleware-optimizer.ts +0 -162
package/src/core/plugin/PluginManager.ts +0 -435
package/src/core/plugin/builder.ts +0 -358
package/src/core/plugin/index.ts +0 -50
package/src/core/plugin/types.ts +0 -214
package/src/core/router/file-router.ts +0 -623
package/src/core/router/index.ts +0 -260
package/src/core/router/radix-tree.ts +0 -242
package/src/core/serializer.ts +0 -397
package/src/core/store/index.ts +0 -30
package/src/core/store/registry.ts +0 -178
package/src/core/store/request-store.ts +0 -240
package/src/core/store/types.ts +0 -233
package/src/core/types.ts +0 -616
package/src/database/adapter.ts +0 -35
package/src/database/adapters/index.ts +0 -1
package/src/database/adapters/mysql.ts +0 -669
package/src/database/database.ts +0 -70
package/src/database/dialect.ts +0 -388
package/src/database/index.ts +0 -12
package/src/database/migrations.ts +0 -86
package/src/database/optimizer.ts +0 -125
package/src/database/query-builder.ts +0 -404
package/src/database/realtime.ts +0 -53
package/src/database/schema.ts +0 -71
package/src/database/transactions.ts +0 -56
package/src/database/types.ts +0 -87
package/src/deployment/cluster.ts +0 -471
package/src/deployment/config.ts +0 -454
package/src/deployment/docker.ts +0 -599
package/src/deployment/graceful-shutdown.ts +0 -373
package/src/deployment/index.ts +0 -56
package/src/index.ts +0 -281
package/src/security/adapter.ts +0 -318
package/src/security/auth/JWTPlugin.ts +0 -234
package/src/security/auth/JWTProvider.ts +0 -316
package/src/security/auth/adapter.ts +0 -12
package/src/security/auth/jwt.ts +0 -234
package/src/security/auth/middleware.ts +0 -188
package/src/security/csrf.ts +0 -220
package/src/security/headers.ts +0 -108
package/src/security/index.ts +0 -60
package/src/security/rate-limit/adapter.ts +0 -7
package/src/security/rate-limit/memory.ts +0 -108
package/src/security/rate-limit/middleware.ts +0 -181
package/src/security/sanitization.ts +0 -75
package/src/security/types.ts +0 -240
package/src/security/utils.ts +0 -52
package/tsconfig.json +0 -39

package/public/css/style.css DELETED Viewed

@@ -1,87 +0,0 @@
-/* Nexus Framework - Sample Styles */
-* {
-    box-sizing: border-box;
-    margin: 0;
-    padding: 0;
-}
-body {
-    font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-    background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
-    color: #fff;
-    min-height: 100vh;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-}
-.container {
-    max-width: 800px;
-    padding: 40px;
-    text-align: center;
-}
-h1 {
-    font-size: 3rem;
-    margin-bottom: 20px;
-    background: linear-gradient(90deg, #00d9ff, #00ff88);
-    -webkit-background-clip: text;
-    -webkit-text-fill-color: transparent;
-    background-clip: text;
-}
-p {
-    font-size: 1.2rem;
-    color: #a0a0a0;
-    margin-bottom: 40px;
-}
-.features {
-    display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
-    gap: 20px;
-    margin-top: 40px;
-}
-.feature {
-    background: rgba(255, 255, 255, 0.05);
-    border: 1px solid rgba(255, 255, 255, 0.1);
-    border-radius: 12px;
-    padding: 30px;
-    transition: transform 0.2s, box-shadow 0.2s;
-}
-.feature:hover {
-    transform: translateY(-5px);
-    box-shadow: 0 10px 40px rgba(0, 217, 255, 0.2);
-}
-.feature h3 {
-    font-size: 1.2rem;
-    margin-bottom: 10px;
-    color: #00d9ff;
-}
-.feature p {
-    font-size: 0.9rem;
-    margin-bottom: 0;
-}
-.feature a {
-    color: #00ff88;
-    text-decoration: none;
-}
-.feature a:hover {
-    text-decoration: underline;
-}
-code {
-    background: rgba(0, 217, 255, 0.1);
-    padding: 2px 8px;
-    border-radius: 4px;
-    font-family: 'Monaco', 'Menlo', monospace;
-    font-size: 0.85em;
-    color: #00d9ff;
-}

package/public/index.html DELETED Viewed

@@ -1,34 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Nexus Framework</title>
-    <link rel="stylesheet" href="/css/style.css">
-</head>
-<body>
-    <div class="container">
-        <h1>🚀 Nexus Framework</h1>
-        <p>Static files are working!</p>
-        <div class="features">
-            <div class="feature">
-                <h3>📁 Static Files</h3>
-                <p>This page is served from <code>./public/index.html</code></p>
-            </div>
-            <div class="feature">
-                <h3>📚 API Docs</h3>
-                <p><a href="/docs">View Swagger Documentation</a></p>
-            </div>
-            <div class="feature">
-                <h3>🎮 Playground</h3>
-                <p><a href="/playground">Try the API Playground</a></p>
-            </div>
-        </div>
-    </div>
-    <script src="/js/app.js"></script>
-</body>
-</html>

package/public/js/app.js DELETED Viewed

@@ -1,27 +0,0 @@
-// Nexus Framework - Sample JavaScript
-console.log('🚀 Nexus Framework - Static files loaded!');
-document.addEventListener('DOMContentLoaded', () => {
-    console.log('Page ready!');
-    // Add some interactivity
-    const features = document.querySelectorAll('.feature');
-    features.forEach((feature, index) => {
-        feature.style.animationDelay = `${index * 0.1}s`;
-        feature.classList.add('fade-in');
-    });
-});
-// Add fade-in animation
-const style = document.createElement('style');
-style.textContent = `
-    @keyframes fadeIn {
-        from { opacity: 0; transform: translateY(20px); }
-        to { opacity: 1; transform: translateY(0); }
-    }
-    .fade-in {
-        animation: fadeIn 0.5s ease forwards;
-    }
-`;
-document.head.appendChild(style);

package/src/advanced/cache/InMemoryCacheStore.ts DELETED Viewed

@@ -1,68 +0,0 @@
-import { EventEmitter } from 'events';
-import { CacheStore, CacheEntry } from './types';
-/**
- * Simple in-memory cache store with TTL support
- */
-export class InMemoryCacheStore<Value = unknown> implements CacheStore<Value> {
-    readonly name: string;
-    private store: Map<string, CacheEntry<Value>> = new Map();
-    private emitter = new EventEmitter();
-    private maxSize: number;
-    constructor(name: string, maxSize: number = 10000) {
-        this.name = name;
-        this.maxSize = maxSize;
-    }
-    async get(key: string): Promise<CacheEntry<Value> | undefined> {
-        const entry = this.store.get(key);
-        if (!entry) {
-            return undefined;
-        }
-        if (entry.expiresAt && entry.expiresAt < Date.now()) {
-            await this.delete(key);
-            return undefined;
-        }
-        return entry;
-    }
-    async set(key: string, entry: CacheEntry<Value>): Promise<void> {
-        if (this.store.size >= this.maxSize) {
-            const oldestKey = this.store.keys().next().value;
-            if (oldestKey) {
-                this.store.delete(oldestKey);
-            }
-        }
-        this.store.set(key, entry);
-        this.emitter.emit('set', key, entry);
-    }
-    async delete(key: string): Promise<void> {
-        if (this.store.has(key)) {
-            this.store.delete(key);
-            this.emitter.emit('delete', key);
-        }
-    }
-    async clear(): Promise<void> {
-        this.store.clear();
-        this.emitter.emit('clear');
-    }
-    async keys(pattern?: RegExp): Promise<string[]> {
-        const allKeys = Array.from(this.store.keys());
-        if (!pattern) {
-            return allKeys;
-        }
-        return allKeys.filter(key => pattern.test(key));
-    }
-    on(event: 'set' | 'delete' | 'clear', listener: (...args: any[]) => void) {
-        this.emitter.on(event, listener);
-    }
-}

package/src/advanced/cache/MultiTierCache.ts DELETED Viewed

@@ -1,194 +0,0 @@
-import { CacheTierConfig, TagIndexEntry, CacheSetOptions, CacheEntry, CacheWrapOptions, MemoizeOptions } from './types';
-/**
- * Multi-tier cache orchestrator
- */
-export class MultiTierCache<Value = unknown> {
-    private tiers: CacheTierConfig<Value>[];
-    private tagIndex: Map<string, TagIndexEntry> = new Map();
-    private defaultTTL: number;
-    constructor(tiers: CacheTierConfig<Value>[], defaultTTL: number = 60000) {
-        if (tiers.length === 0) {
-            throw new Error('MultiTierCache requires at least one tier');
-        }
-        this.tiers = tiers;
-        this.defaultTTL = defaultTTL;
-    }
-    /**
-     * Retrieve a value from the tiers starting from the fastest one
-     */
-    async get(key: string): Promise<Value | undefined> {
-        for (let i = 0; i < this.tiers.length; i++) {
-            const tier = this.tiers[i];
-            const entry = await tier.store.get(key);
-            if (entry) {
-                if (i > 0) {
-                    // hydrate higher tiers for faster access next time
-                    await this.promoteToHigherTiers(key, entry, i);
-                }
-                return entry.value;
-            }
-        }
-        return undefined;
-    }
-    /**
-     * Set a cache value across tiers
-     */
-    async set(key: string, value: Value, options: CacheSetOptions<Value> = {}): Promise<void> {
-        const expiresAt = this.calculateExpiry(options.ttl);
-        const entry: CacheEntry<Value> = {
-            value,
-            expiresAt,
-            tags: options.tags,
-            meta: options.meta
-        };
-        await Promise.all(this.tiers.map(async (tier) => {
-            const ttl = tier.ttl ?? options.ttl ?? this.defaultTTL;
-            const tierEntry = {
-                ...entry,
-                expiresAt: this.calculateExpiry(ttl)
-            };
-            await tier.store.set(key, tierEntry);
-        }));
-        if (options.tags?.length) {
-            this.indexTags(key, options.tags, expiresAt);
-        }
-    }
-    /**
-     * Delete a cache key from all tiers
-     */
-    async delete(key: string): Promise<void> {
-        await Promise.all(this.tiers.map(tier => tier.store.delete(key)));
-        for (const entry of this.tagIndex.values()) {
-            entry.keys.delete(key);
-        }
-    }
-    /**
-     * Delete keys matching a wildcard pattern
-     */
-    async deletePattern(pattern: string): Promise<void> {
-        const regex = new RegExp(
-            '^' + pattern.replace(/\*/g, '.*').replace(/\?/g, '.') + '$'
-        );
-        for (const tier of this.tiers) {
-            const keys = tier.store.keys ? await tier.store.keys(regex) : [];
-            await Promise.all(keys.map(key => tier.store.delete(key)));
-        }
-        for (const entry of this.tagIndex.values()) {
-            for (const key of Array.from(entry.keys)) {
-                if (regex.test(key)) {
-                    entry.keys.delete(key);
-                }
-            }
-        }
-    }
-    /**
-     * Invalidate cache entries by tags
-     */
-    async invalidateTags(tags: string[]): Promise<void> {
-        const keysToDelete = new Set<string>();
-        for (const tag of tags) {
-            const entry = this.tagIndex.get(tag);
-            if (!entry) continue;
-            for (const key of entry.keys) {
-                keysToDelete.add(key);
-            }
-            this.tagIndex.delete(tag);
-        }
-        await Promise.all(Array.from(keysToDelete).map(key => this.delete(key)));
-    }
-    /**
-     * Wrap helper for cache-aside pattern
-     */
-    async wrap(
-        key: string,
-        resolver: () => Promise<Value>,
-        options: CacheWrapOptions<Value> = {}
-    ): Promise<Value> {
-        if (!options.refresh) {
-            const cached = await this.get(key);
-            if (cached !== undefined) {
-                return cached;
-            }
-        }
-        const value = await resolver();
-        await this.set(key, value, options);
-        return value;
-    }
-    /**
-     * Memoize async functions
-     */
-    memoize<Func extends (...args: any[]) => Promise<Value>>(
-        fn: Func,
-        options: MemoizeOptions<Value> = {}
-    ): (...args: Parameters<Func>) => Promise<Value> {
-        const resolver = options.keyResolver || ((...args: any[]) => JSON.stringify(args));
-        return async (...args: Parameters<Func>): Promise<Value> => {
-            const key = resolver(...args);
-            return this.wrap(key, () => fn(...args), options);
-        };
-    }
-    /**
-     * Promote cache entry to higher tiers after a miss
-     */
-    private async promoteToHigherTiers(
-        key: string,
-        entry: CacheEntry<Value>,
-        fromIndex: number
-    ): Promise<void> {
-        const tiersToHydrate = this.tiers.slice(0, fromIndex);
-        await Promise.all(
-            tiersToHydrate.map(tier => tier.store.set(key, entry))
-        );
-    }
-    private calculateExpiry(ttl?: number): number | undefined {
-        if (!ttl) {
-            return undefined;
-        }
-        return Date.now() + ttl;
-    }
-    private indexTags(key: string, tags: string[], expiresAt?: number) {
-        for (const tag of tags) {
-            const entry = this.tagIndex.get(tag) || { keys: new Set<string>(), expiresAt };
-            entry.keys.add(key);
-            if (expiresAt) {
-                entry.expiresAt = expiresAt;
-            }
-            this.tagIndex.set(tag, entry);
-        }
-    }
-    /**
-     * Export current metrics for observability or admin UI
-     */
-    getStats() {
-        return {
-            tiers: this.tiers.map(tier => ({ name: tier.store.name })),
-            tags: Array.from(this.tagIndex.keys()),
-            defaultTTL: this.defaultTTL
-        };
-    }
-}