@engjts/nexus 0.1.0

package/dist/core/router/index.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Router implementation with schema validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFileRoutes = exports.createFileRouter = exports.FileRouter = exports.Router = void 0;
+const radix_tree_1 = require("./radix-tree");
+/**
+ * Router class
+ */
+class Router {
+    trees = new Map();
+    routes = [];
+    constructor() {
+        // Initialize trees for each HTTP method
+        const methods = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'];
+        for (const method of methods) {
+            this.trees.set(method, new radix_tree_1.RadixTree());
+        }
+    }
+    /**
+     * Register a route
+     */
+    addRoute(config) {
+        const { method, path, handler, middlewares = [], schema, meta } = config;
+        const tree = this.trees.get(method);
+        if (!tree) {
+            throw new Error(`Unsupported HTTP method: ${method}`);
+        }
+        // Wrap handler with schema validation if provided
+        const wrappedHandler = schema ? this.wrapWithValidation(handler, schema) : handler;
+        tree.insert(path, wrappedHandler, middlewares);
+        // Store for introspection (including schema and meta for documentation)
+        this.routes.push({
+            method,
+            path,
+            config: { handler: wrappedHandler, middlewares, schema, meta }
+        });
+    }
+    /**
+     * Find a matching route
+     */
+    match(method, path) {
+        const tree = this.trees.get(method);
+        if (!tree) {
+            return null;
+        }
+        const result = tree.search(path);
+        if (!result) {
+            return null;
+        }
+        return {
+            handler: result.handler,
+            params: result.params,
+            middlewares: result.middlewares,
+            schema: undefined // Schema already applied in wrapped handler
+        };
+    }
+    /**
+     * Get all registered routes with full metadata
+     */
+    getRoutes() {
+        return this.routes.map(r => ({
+            method: r.method,
+            path: r.path,
+            schema: r.config.schema,
+            meta: r.config.meta
+        }));
+    }
+    /**
+     * Convenience methods for HTTP verbs
+     */
+    get(path, handler, options) {
+        this.addRoute({ method: 'GET', path, handler, ...options });
+    }
+    post(path, handler, options) {
+        this.addRoute({ method: 'POST', path, handler, ...options });
+    }
+    put(path, handler, options) {
+        this.addRoute({ method: 'PUT', path, handler, ...options });
+    }
+    delete(path, handler, options) {
+        this.addRoute({ method: 'DELETE', path, handler, ...options });
+    }
+    patch(path, handler, options) {
+        this.addRoute({ method: 'PATCH', path, handler, ...options });
+    }
+    /**
+     * Wrap handler with schema validation
+     */
+    wrapWithValidation(handler, schema) {
+        return async (ctx) => {
+            try {
+                // Validate params
+                if (schema.params) {
+                    ctx.params = await schema.params.parseAsync(ctx.params);
+                }
+                // Validate query
+                if (schema.query) {
+                    ctx.query = await schema.query.parseAsync(ctx.query);
+                }
+                // Validate body
+                if (schema.body) {
+                    ctx.body = await schema.body.parseAsync(ctx.body);
+                }
+                // Validate headers
+                if (schema.headers) {
+                    ctx.headers = await schema.headers.parseAsync(ctx.headers);
+                }
+                // Call original handler with validated data
+                return handler(ctx, {});
+            }
+            catch (error) {
+                // Zod validation error
+                if (error.name === 'ZodError') {
+                    // Use custom error handler if provided
+                    if (schema.onValidationError) {
+                        const customResponse = schema.onValidationError(error.errors, ctx);
+                        // If it's already a Response object, return it
+                        if (customResponse?.statusCode) {
+                            return customResponse;
+                        }
+                        // Otherwise wrap it as JSON response
+                        return ctx.json(customResponse, 400);
+                    }
+                    // Default error response - extract first error message
+                    const firstError = error.errors[0];
+                    const message = firstError?.message || 'Validation failed';
+                    return ctx.json({
+                        success: false,
+                        message
+                    }, 400);
+                }
+                throw error;
+            }
+        };
+    }
+}
+exports.Router = Router;
+// Re-export file router
+var file_router_1 = require("./file-router");
+Object.defineProperty(exports, "FileRouter", { enumerable: true, get: function () { return file_router_1.FileRouter; } });
+Object.defineProperty(exports, "createFileRouter", { enumerable: true, get: function () { return file_router_1.createFileRouter; } });
+Object.defineProperty(exports, "useFileRoutes", { enumerable: true, get: function () { return file_router_1.useFileRoutes; } });
+//# sourceMappingURL=index.js.map

package/dist/core/router/index.js.map

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

package/dist/core/router/radix-tree.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Radix Tree implementation for efficient routing
+ * Provides O(log n) route lookup performance
+ */
+import { Handler, Middleware } from '../types';
+/**
+ * Node in the radix tree
+ */
+export declare class RadixNode {
+    segment: string;
+    fullPath: string;
+    handler: Handler | null;
+    middlewares: Middleware[];
+    children: RadixNode[];
+    type: 'static' | 'param' | 'wildcard';
+    paramName?: string;
+    constructor(segment: string, fullPath: string);
+    /**
+     * Add a child node
+     */
+    addChild(node: RadixNode): void;
+    /**
+     * Find a child by segment
+     */
+    findChild(segment: string): RadixNode | null;
+    /**
+     * Get type priority for ordering (lower = higher priority)
+     */
+    private getTypePriority;
+}
+/**
+ * Radix tree for route storage and matching
+ */
+export declare class RadixTree {
+    private root;
+    constructor();
+    /**
+     * Insert a route into the tree
+     */
+    insert(path: string, handler: Handler, middlewares?: Middleware[]): void;
+    /**
+     * Search for a route match
+     */
+    search(path: string): {
+        handler: Handler;
+        params: Record<string, string>;
+        middlewares: Middleware[];
+    } | null;
+    /**
+     * Recursively search nodes
+     */
+    private searchNode;
+    /**
+     * Split path into segments
+     */
+    private splitPath;
+    /**
+     * Get all routes (for debugging/introspection)
+     */
+    getAllRoutes(): Array<{
+        path: string;
+        hasHandler: boolean;
+    }>;
+    /**
+     * Recursively collect all routes
+     */
+    private collectRoutes;
+}
+//# sourceMappingURL=radix-tree.d.ts.map

package/dist/core/router/radix-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radix-tree.d.ts","sourceRoot":"","sources":["../../../src/core/router/radix-tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,qBAAa,SAAS;IAElB,OAAO,EAAE,MAAM,CAAC;IAGhB,QAAQ,EAAE,MAAM,CAAC;IAGjB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAQ;IAG/B,WAAW,EAAE,UAAU,EAAE,CAAM;IAG/B,QAAQ,EAAE,SAAS,EAAE,CAAM;IAG3B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAY;IAGjD,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAc7C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAmB/B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAS5C;;OAEG;IACH,OAAO,CAAC,eAAe;CAO1B;AAED;;GAEG;AACH,qBAAa,SAAS;IAClB,OAAO,CAAC,IAAI,CAAY;;IAMxB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAE,UAAU,EAAO,GAAG,IAAI;IAsB5E;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,EAAE,UAAU,EAAE,CAAA;KAAE,GAAG,IAAI;IAiB5G;;OAEG;IACH,OAAO,CAAC,UAAU;IA6ClB;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAM5D;;OAEG;IACH,OAAO,CAAC,aAAa;CASxB"}

package/dist/core/router/radix-tree.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * Radix Tree implementation for efficient routing
+ * Provides O(log n) route lookup performance
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RadixTree = exports.RadixNode = void 0;
+/**
+ * Node in the radix tree
+ */
+class RadixNode {
+    // The path segment this node represents
+    segment;
+    // Full path for this node (used for debugging)
+    fullPath;
+    // Handler if this is a terminal node
+    handler = null;
+    // Middleware for this route
+    middlewares = [];
+    // Child nodes
+    children = [];
+    // Pattern type: 'static', 'param', or 'wildcard'
+    type = 'static';
+    // Parameter name for param nodes
+    paramName;
+    constructor(segment, fullPath) {
+        this.segment = segment;
+        this.fullPath = fullPath;
+        // Detect node type
+        if (segment.startsWith(':')) {
+            this.type = 'param';
+            this.paramName = segment.slice(1);
+        }
+        else if (segment === '*' || segment.startsWith('*')) {
+            this.type = 'wildcard';
+            this.paramName = segment.length > 1 ? segment.slice(1) : 'wildcard';
+        }
+    }
+    /**
+     * Add a child node
+     */
+    addChild(node) {
+        // Insert maintaining order: static > param > wildcard
+        const priority = this.getTypePriority(node.type);
+        let inserted = false;
+        for (let i = 0; i < this.children.length; i++) {
+            const childPriority = this.getTypePriority(this.children[i].type);
+            if (priority < childPriority) {
+                this.children.splice(i, 0, node);
+                inserted = true;
+                break;
+            }
+        }
+        if (!inserted) {
+            this.children.push(node);
+        }
+    }
+    /**
+     * Find a child by segment
+     */
+    findChild(segment) {
+        for (const child of this.children) {
+            if (child.segment === segment) {
+                return child;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get type priority for ordering (lower = higher priority)
+     */
+    getTypePriority(type) {
+        switch (type) {
+            case 'static': return 0;
+            case 'param': return 1;
+            case 'wildcard': return 2;
+        }
+    }
+}
+exports.RadixNode = RadixNode;
+/**
+ * Radix tree for route storage and matching
+ */
+class RadixTree {
+    root;
+    constructor() {
+        this.root = new RadixNode('', '/');
+    }
+    /**
+     * Insert a route into the tree
+     */
+    insert(path, handler, middlewares = []) {
+        const segments = this.splitPath(path);
+        let current = this.root;
+        for (let i = 0; i < segments.length; i++) {
+            const segment = segments[i];
+            let child = current.findChild(segment);
+            if (!child) {
+                const fullPath = '/' + segments.slice(0, i + 1).join('/');
+                child = new RadixNode(segment, fullPath);
+                current.addChild(child);
+            }
+            current = child;
+        }
+        // Set handler and middleware at terminal node
+        current.handler = handler;
+        current.middlewares = middlewares;
+    }
+    /**
+     * Search for a route match
+     */
+    search(path) {
+        const segments = this.splitPath(path);
+        const params = {};
+        const result = this.searchNode(this.root, segments, 0, params);
+        if (result) {
+            return {
+                handler: result.handler,
+                params,
+                middlewares: result.middlewares
+            };
+        }
+        return null;
+    }
+    /**
+     * Recursively search nodes
+     */
+    searchNode(node, segments, index, params) {
+        // Reached end of path
+        if (index === segments.length) {
+            return node.handler ? node : null;
+        }
+        const segment = segments[index];
+        // Try children in priority order
+        for (const child of node.children) {
+            if (child.type === 'static') {
+                // Exact match required
+                if (child.segment === segment) {
+                    const result = this.searchNode(child, segments, index + 1, params);
+                    if (result)
+                        return result;
+                }
+            }
+            else if (child.type === 'param') {
+                // Parameter match - capture value
+                const oldValue = params[child.paramName];
+                params[child.paramName] = segment;
+                const result = this.searchNode(child, segments, index + 1, params);
+                if (result)
+                    return result;
+                // Backtrack
+                if (oldValue === undefined) {
+                    delete params[child.paramName];
+                }
+                else {
+                    params[child.paramName] = oldValue;
+                }
+            }
+            else if (child.type === 'wildcard') {
+                // Wildcard match - capture remaining path
+                params[child.paramName] = segments.slice(index).join('/');
+                return child;
+            }
+        }
+        return null;
+    }
+    /**
+     * Split path into segments
+     */
+    splitPath(path) {
+        // Remove leading/trailing slashes and split
+        const normalized = path.replace(/^\/+|\/+$/g, '');
+        return normalized ? normalized.split('/') : [];
+    }
+    /**
+     * Get all routes (for debugging/introspection)
+     */
+    getAllRoutes() {
+        const routes = [];
+        this.collectRoutes(this.root, routes);
+        return routes;
+    }
+    /**
+     * Recursively collect all routes
+     */
+    collectRoutes(node, routes) {
+        if (node.handler) {
+            routes.push({ path: node.fullPath, hasHandler: true });
+        }
+        for (const child of node.children) {
+            this.collectRoutes(child, routes);
+        }
+    }
+}
+exports.RadixTree = RadixTree;
+//# sourceMappingURL=radix-tree.js.map

package/dist/core/router/radix-tree.js.map

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

package/dist/core/store/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ContextStore System
+ * State management inspired by Flutter's Provider pattern
+ *
+ * Two types of stores:
+ * - ContextStore: Global singleton, persists across all requests
+ * - RequestStore: Per-request scoped, disposed after response
+ */
+export { ContextStore } from './types';
+export { RequestStore } from './request-store';
+export type { StoreListener, DisposeCallback, StoreConstructor, StateOf, StoreOptions } from './types';
+export type { RequestStoreConstructor, RequestStateOf } from './request-store';
+export { StoreRegistry, createStoreRegistry } from './registry';
+export { RequestStoreRegistry } from './request-store';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/store/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,YAAY,EACR,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,YAAY,EACf,MAAM,SAAS,CAAC;AAEjB,YAAY,EACR,uBAAuB,EACvB,cAAc,EACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/store/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * ContextStore System
+ * State management inspired by Flutter's Provider pattern
+ *
+ * Two types of stores:
+ * - ContextStore: Global singleton, persists across all requests
+ * - RequestStore: Per-request scoped, disposed after response
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestStoreRegistry = exports.createStoreRegistry = exports.StoreRegistry = exports.RequestStore = exports.ContextStore = void 0;
+// Core store classes
+var types_1 = require("./types");
+Object.defineProperty(exports, "ContextStore", { enumerable: true, get: function () { return types_1.ContextStore; } });
+var request_store_1 = require("./request-store");
+Object.defineProperty(exports, "RequestStore", { enumerable: true, get: function () { return request_store_1.RequestStore; } });
+// Registries
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "StoreRegistry", { enumerable: true, get: function () { return registry_1.StoreRegistry; } });
+Object.defineProperty(exports, "createStoreRegistry", { enumerable: true, get: function () { return registry_1.createStoreRegistry; } });
+var request_store_2 = require("./request-store");
+Object.defineProperty(exports, "RequestStoreRegistry", { enumerable: true, get: function () { return request_store_2.RequestStoreRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/core/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/store/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,qBAAqB;AACrB,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAgBrB,aAAa;AACb,uCAAgE;AAAvD,yGAAA,aAAa,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAC3C,iDAAuD;AAA9C,qHAAA,oBAAoB,OAAA"}

package/dist/core/store/registry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * StoreRegistry - Global store container
+ * Manages all ContextStore instances at application level
+ */
+import { ContextStore, StoreConstructor, StoreRegistryOptions } from './types';
+/**
+ * StoreRegistry manages all stores in the application
+ * Ensures singleton instances and handles lifecycle
+ */
+export declare class StoreRegistry {
+    private stores;
+    private options;
+    constructor(options?: StoreRegistryOptions);
+    /**
+     * Register a store class
+     * Creates instance immediately
+     *
+     * @param StoreClass - Store constructor class
+     * @returns The created store instance
+     */
+    register<T extends ContextStore<any>>(StoreClass: StoreConstructor<T>): T;
+    /**
+     * Register multiple stores at once
+     *
+     * @param storeClasses - Array of store constructor classes
+     */
+    registerAll(storeClasses: StoreConstructor<any>[]): void;
+    /**
+     * Get a store instance by its class
+     * Throws if store is not registered
+     *
+     * @param StoreClass - Store constructor class
+     * @returns Store instance
+     */
+    get<T extends ContextStore<any>>(StoreClass: StoreConstructor<T>): T;
+    /**
+     * Check if a store is registered
+     *
+     * @param StoreClass - Store constructor class
+     */
+    has<T extends ContextStore<any>>(StoreClass: StoreConstructor<T>): boolean;
+    /**
+     * Get a store instance, or register it if not exists
+     * Useful for lazy initialization
+     *
+     * @param StoreClass - Store constructor class
+     * @returns Store instance
+     */
+    getOrRegister<T extends ContextStore<any>>(StoreClass: StoreConstructor<T>): T;
+    /**
+     * Remove a store from registry and dispose it
+     *
+     * @param StoreClass - Store constructor class
+     */
+    unregister<T extends ContextStore<any>>(StoreClass: StoreConstructor<T>): void;
+    /**
+     * Get all registered store classes
+     */
+    getRegisteredStores(): StoreConstructor<any>[];
+    /**
+     * Get store count
+     */
+    get size(): number;
+    /**
+     * Dispose all stores and clear registry
+     */
+    dispose(): void;
+    /**
+     * Get debug info about all stores
+     */
+    getDebugInfo(): Record<string, {
+        listenerCount: number;
+        isInitialized: boolean;
+    }>;
+}
+/**
+ * Create a new store registry
+ */
+export declare function createStoreRegistry(options?: StoreRegistryOptions): StoreRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/store/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/store/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/E;;;GAGG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAA4D;IAC1E,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,GAAE,oBAAyB;IAI9C;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC;IA0BzE;;;;OAIG;IACH,WAAW,CAAC,YAAY,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI;IAIxD;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC;IAapE;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO;IAI1E;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC;IAO9E;;;;OAIG;IACH,UAAU,CAAC,CAAC,SAAS,YAAY,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAa9E;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE;IAI9C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI;IAgBf;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;CAYpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAEjF"}