@morojs/moro 1.5.16 → 1.6.0

package/src/core/routing/app-integration.ts

@@ -8,9 +8,9 @@ import {
   createRoute,
   defineRoute,
   HttpMethod,
-} from './index';
-import { HttpRequest, HttpResponse } from '../http';
-import { createFrameworkLogger } from '../logger';
+} from './index.js';
+import { HttpRequest, HttpResponse } from '../http/index.js';
+import { createFrameworkLogger } from '../logger/index.js';
 
 const logger = createFrameworkLogger('AppIntegration');
 

package/src/core/routing/index.ts

@@ -1,9 +1,9 @@
 // Intelligent Routing System for Moro Framework
 // Schema-first with automatic middleware ordering and chainable API
 
-import { ValidationSchema } from '../validation/schema-interface';
-import { HttpRequest, HttpResponse } from '../http';
-import { createFrameworkLogger } from '../logger';
+import { ValidationSchema } from '../validation/schema-interface.js';
+import { HttpRequest, HttpResponse } from '../http/index.js';
+import { createFrameworkLogger } from '../logger/index.js';
 
 const logger = createFrameworkLogger('IntelligentRouting');
 

package/src/core/runtime/aws-lambda-adapter.ts

@@ -1,7 +1,7 @@
 // AWS Lambda runtime adapter
-import { BaseRuntimeAdapter } from './base-adapter';
-import { HttpRequest, HttpResponse } from '../../types/http';
-import { RuntimeHttpResponse } from '../../types/runtime';
+import { BaseRuntimeAdapter } from './base-adapter.js';
+import { HttpRequest, HttpResponse } from '../../types/http.js';
+import { RuntimeHttpResponse } from '../../types/runtime.js';
 
 export interface LambdaEvent {
   httpMethod: string;

package/src/core/runtime/base-adapter.ts

@@ -1,6 +1,6 @@
 // Base runtime adapter with common functionality
-import { RuntimeAdapter, RuntimeType, RuntimeHttpResponse } from '../../types/runtime';
-import { HttpRequest, HttpResponse } from '../../types/http';
+import { RuntimeAdapter, RuntimeType, RuntimeHttpResponse } from '../../types/runtime.js';
+import { HttpRequest, HttpResponse } from '../../types/http.js';
 import { randomBytes } from 'crypto';
 
 export abstract class BaseRuntimeAdapter implements RuntimeAdapter {

package/src/core/runtime/cloudflare-workers-adapter.ts

@@ -1,7 +1,7 @@
 // Cloudflare Workers runtime adapter
-import { BaseRuntimeAdapter } from './base-adapter';
-import { HttpRequest, HttpResponse } from '../../types/http';
-import { RuntimeHttpResponse } from '../../types/runtime';
+import { BaseRuntimeAdapter } from './base-adapter.js';
+import { HttpRequest, HttpResponse } from '../../types/http.js';
+import { RuntimeHttpResponse } from '../../types/runtime.js';
 
 export interface WorkersEnv {
   [key: string]: any;

package/src/core/runtime/index.ts

@@ -1,9 +1,9 @@
 // Runtime adapters export
-export { BaseRuntimeAdapter } from './base-adapter';
-export { NodeRuntimeAdapter } from './node-adapter';
-export { VercelEdgeAdapter } from './vercel-edge-adapter';
-export { AWSLambdaAdapter } from './aws-lambda-adapter';
-export { CloudflareWorkersAdapter } from './cloudflare-workers-adapter';
+export { BaseRuntimeAdapter } from './base-adapter.js';
+export { NodeRuntimeAdapter } from './node-adapter.js';
+export { VercelEdgeAdapter } from './vercel-edge-adapter.js';
+export { AWSLambdaAdapter } from './aws-lambda-adapter.js';
+export { CloudflareWorkersAdapter } from './cloudflare-workers-adapter.js';
 
 // Re-export types
 export type {
@@ -12,18 +12,18 @@ export type {
   RuntimeConfig,
   RuntimeMoroOptions,
   RuntimeHttpResponse,
-} from '../../types/runtime';
+} from '../../types/runtime.js';
 
 // Re-export specific runtime types
-export type { LambdaEvent, LambdaContext, LambdaResponse } from './aws-lambda-adapter';
-export type { WorkersEnv, WorkersContext } from './cloudflare-workers-adapter';
+export type { LambdaEvent, LambdaContext, LambdaResponse } from './aws-lambda-adapter.js';
+export type { WorkersEnv, WorkersContext } from './cloudflare-workers-adapter.js';
 
 // Runtime factory functions
-import { NodeRuntimeAdapter } from './node-adapter';
-import { VercelEdgeAdapter } from './vercel-edge-adapter';
-import { AWSLambdaAdapter } from './aws-lambda-adapter';
-import { CloudflareWorkersAdapter } from './cloudflare-workers-adapter';
-import { RuntimeType, RuntimeAdapter } from '../../types/runtime';
+import { NodeRuntimeAdapter } from './node-adapter.js';
+import { VercelEdgeAdapter } from './vercel-edge-adapter.js';
+import { AWSLambdaAdapter } from './aws-lambda-adapter.js';
+import { CloudflareWorkersAdapter } from './cloudflare-workers-adapter.js';
+import { RuntimeType, RuntimeAdapter } from '../../types/runtime.js';
 
 export function createRuntimeAdapter(type: RuntimeType): RuntimeAdapter {
   switch (type) {

package/src/core/runtime/node-adapter.ts

@@ -1,9 +1,9 @@
 // Node.js runtime adapter
 import { IncomingMessage, ServerResponse } from 'http';
-import { BaseRuntimeAdapter } from './base-adapter';
-import { HttpRequest, HttpResponse } from '../../types/http';
-import { RuntimeHttpResponse } from '../../types/runtime';
-import { MoroHttpServer } from '../http/http-server';
+import { BaseRuntimeAdapter } from './base-adapter.js';
+import { HttpRequest, HttpResponse } from '../../types/http.js';
+import { RuntimeHttpResponse } from '../../types/runtime.js';
+import { MoroHttpServer } from '../http/http-server.js';
 
 export class NodeRuntimeAdapter extends BaseRuntimeAdapter {
   readonly type = 'node' as const;

package/src/core/runtime/vercel-edge-adapter.ts

@@ -1,7 +1,7 @@
 // Vercel Edge runtime adapter
-import { BaseRuntimeAdapter } from './base-adapter';
-import { HttpRequest, HttpResponse } from '../../types/http';
-import { RuntimeHttpResponse } from '../../types/runtime';
+import { BaseRuntimeAdapter } from './base-adapter.js';
+import { HttpRequest, HttpResponse } from '../../types/http.js';
+import { RuntimeHttpResponse } from '../../types/runtime.js';
 
 export class VercelEdgeAdapter extends BaseRuntimeAdapter {
   readonly type = 'vercel-edge' as const;

package/src/core/utilities/hooks.ts

@@ -1,7 +1,7 @@
 // Hook System for Moro
 import { EventEmitter } from 'events';
-import { HookFunction, HookContext, MoroMiddleware } from '../../types/hooks';
-import { createFrameworkLogger } from '../logger';
+import { HookFunction, HookContext, MoroMiddleware } from '../../types/hooks.js';
+import { createFrameworkLogger } from '../logger/index.js';
 
 export const HOOK_EVENTS = {
   BEFORE_REQUEST: 'before:request',
@@ -139,4 +139,4 @@ export class HookManager extends EventEmitter {
 }
 
 // Built-in middleware - now organized in individual files
-export { simpleMiddleware as middleware } from '../middleware/index';
+export { simpleMiddleware as middleware } from '../middleware/index.js';

package/src/core/utilities/index.ts

@@ -8,9 +8,10 @@ export {
   withCaching,
   withRetry,
   withTimeout,
-} from './container';
-export { CircuitBreaker } from './circuit-breaker';
-export { HookManager, HOOK_EVENTS } from './hooks';
+} from './container.js';
+export { CircuitBreaker } from './circuit-breaker.js';
+export { HookManager, HOOK_EVENTS } from './hooks.js';
+export { isPackageAvailable, resolveUserPackage, createUserRequire } from './package-utils.js';
 
 // Re-export middleware from hooks
-export { middleware } from './hooks';
+export { middleware } from './hooks.js';

package/src/core/utilities/package-utils.ts

@@ -0,0 +1,59 @@
+// Package and Module Resolution Utilities
+// ESM-compatible helpers for detecting and resolving optional dependencies
+
+import { createRequire } from 'module';
+import { join } from 'path';
+
+/**
+ * Check if a package is available in the user's node_modules
+ * Uses ESM-compatible module resolution from the user's working directory
+ *
+ * @param packageName - The name of the package to check (e.g., 'socket.io', 'zod')
+ * @returns true if the package is installed, false otherwise
+ *
+ * @example
+ * if (isPackageAvailable('socket.io')) {
+ *   // socket.io is installed, safe to import
+ *   const { Server } = await import('socket.io');
+ * }
+ */
+export function isPackageAvailable(packageName: string): boolean {
+  try {
+    const userRequire = createRequire(join(process.cwd(), 'package.json'));
+    userRequire.resolve(packageName);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Resolve a package path from the user's node_modules
+ * Uses ESM-compatible module resolution from the user's working directory
+ *
+ * @param packageName - The name of the package to resolve
+ * @returns The resolved package path
+ * @throws Error if the package is not found
+ *
+ * @example
+ * const socketIOPath = resolveUserPackage('socket.io');
+ * const { Server } = await import(socketIOPath);
+ */
+export function resolveUserPackage(packageName: string): string {
+  const userRequire = createRequire(join(process.cwd(), 'package.json'));
+  return userRequire.resolve(packageName);
+}
+
+/**
+ * Create a require function for the user's working directory
+ * Useful for resolving packages installed by the user, not in Moro's dependencies
+ *
+ * @returns A require function scoped to the user's working directory
+ *
+ * @example
+ * const userRequire = createUserRequire();
+ * const packagePath = userRequire.resolve('some-package');
+ */
+export function createUserRequire() {
+  return createRequire(join(process.cwd(), 'package.json'));
+}

package/src/core/validation/adapters.ts

@@ -1,7 +1,7 @@
 // Validation Library Adapters for Moro Framework
 // Makes Joi, Yup, and other libraries compatible with ValidationSchema interface
 
-import { ValidationSchema, ValidationError, normalizeValidationError } from './schema-interface';
+import { ValidationSchema, ValidationError, normalizeValidationError } from './schema-interface.js';
 
 /**
  * Zod Compatibility Check

package/src/core/validation/index.ts

@@ -1,20 +1,78 @@
 // Universal Validation System for Moro Framework
 // Works with Zod, Joi, Yup, and any validation library via adapters
 
-import { HttpRequest, HttpResponse } from '../http';
-import { createFrameworkLogger } from '../logger';
+import { HttpRequest, HttpResponse } from '../http/index.js';
+import { createFrameworkLogger } from '../logger/index.js';
+import { createUserRequire, isPackageAvailable } from '../utilities/package-utils.js';
 import {
   ValidationSchema,
-  ValidationError,
   normalizeValidationError,
   InferSchemaType,
-} from './schema-interface';
-
-// Re-export zod if available (for backward compatibility)
-// The dynamic import is handled in the main index.ts
+  ValidationError,
+} from './schema-interface.js';
 
 const logger = createFrameworkLogger('Validation');
 
+// Convenience re-export of Zod (optional - only works if zod is installed)
+// Lazy-loads Zod synchronously on first access
+// If zod is not installed, z will throw a helpful error
+let zodModule: any = null;
+let zodLoadAttempted = false;
+
+function loadZodSync() {
+  if (zodLoadAttempted) {
+    return zodModule;
+  }
+
+  zodLoadAttempted = true;
+
+  try {
+    if (!isPackageAvailable('zod')) {
+      zodModule = null;
+      return zodModule;
+    }
+
+    // Use synchronous require for immediate availability
+    const userRequire = createUserRequire();
+    zodModule = userRequire('zod');
+  } catch {
+    // Zod not installed or failed to load
+    zodModule = null;
+  }
+
+  return zodModule;
+}
+
+export const z = new Proxy({} as any, {
+  get(_target, prop) {
+    const zod = loadZodSync();
+
+    if (!zod) {
+      throw new Error(
+        'Zod is not installed. Please install it with: npm install zod\n' +
+          'Or use an alternative validation library (joi, yup, class-validator) via adapters.'
+      );
+    }
+
+    if (!zod.z) {
+      throw new Error(
+        'Zod module loaded but z export not found. This may be a version compatibility issue.'
+      );
+    }
+
+    return zod.z[prop];
+  },
+  apply(_target, thisArg, args) {
+    const zod = loadZodSync();
+
+    if (!zod?.z) {
+      throw new Error('Zod is not installed. Please install it with: npm install zod');
+    }
+
+    return zod.z.apply(thisArg, args);
+  },
+});
+
 // Universal validation configuration interface
 export interface ValidationConfig {
   body?: ValidationSchema;
@@ -195,12 +253,6 @@ export function combineSchemas(schemas: ValidationConfig): ValidationConfig {
 }
 
 // Re-export common validation tools
-export {
-  ValidationSchema,
-  ValidationError,
-  normalizeValidationError,
-  InferSchemaType,
-} from './schema-interface';
-export { joi, yup, fn as customValidator, classValidator } from './adapters';
-
-// Note: z is re-exported from main index.ts with dynamic import
+export { ValidationError, normalizeValidationError } from './schema-interface.js';
+export type { ValidationSchema, InferSchemaType } from './schema-interface.js';
+export { joi, yup, fn as customValidator, classValidator } from './adapters.js';

package/src/index.ts

@@ -7,9 +7,9 @@ export {
   createAppEdge,
   createAppLambda,
   createAppWorker,
-} from './moro';
+} from './moro.js';
 
-export type { MoroOptions } from './core/framework';
+export type { MoroOptions } from './core/framework.js';
 
 // Export auth types and middleware
 export type {
@@ -29,13 +29,13 @@ export type {
   EmailProvider,
   SignInOptions,
   SignOutOptions,
-} from './types/auth';
+} from './types/auth.js';
 
 // Export native @auth/morojs adapter
-export { createAuthMiddleware, MoroJSAuth } from './core/auth/morojs-adapter';
+export { createAuthMiddleware, MoroJSAuth } from './core/auth/morojs-adapter.js';
 
 // Export Auth.js middleware and providers
-export { auth, providers } from './core/middleware/built-in/auth';
+export { auth, providers } from './core/middleware/built-in/auth.js';
 
 // Runtime system exports
 export type {
@@ -43,7 +43,7 @@ export type {
   RuntimeAdapter,
   RuntimeConfig,
   RuntimeHttpResponse,
-} from './types/runtime';
+} from './types/runtime.js';
 
 export {
   NodeRuntimeAdapter,
@@ -55,23 +55,27 @@ export {
   createEdgeHandler,
   createLambdaHandler,
   createWorkerHandler,
-} from './core/runtime';
+} from './core/runtime/index.js';
 
 // Runtime-specific types
-export type { LambdaEvent, LambdaContext, LambdaResponse } from './core/runtime/aws-lambda-adapter';
-export type { WorkersEnv, WorkersContext } from './core/runtime/cloudflare-workers-adapter';
+export type {
+  LambdaEvent,
+  LambdaContext,
+  LambdaResponse,
+} from './core/runtime/aws-lambda-adapter.js';
+export type { WorkersEnv, WorkersContext } from './core/runtime/cloudflare-workers-adapter.js';
 
 // Core exports
-export { MoroHttpServer, middleware as httpMiddleware } from './core/http';
-export { builtInMiddleware, simpleMiddleware } from './core/middleware/built-in';
+export {
+  MoroHttpServer,
+  UWebSocketsHttpServer,
+  middleware as httpMiddleware,
+} from './core/http/index.js';
+export { builtInMiddleware, simpleMiddleware } from './core/middleware/built-in/index.js';
 
 // Networking System
-export {
-  WebSocketManager,
-  ServiceRegistry,
-  ServiceInfo,
-  ServiceDiscoveryOptions,
-} from './core/networking';
+export { WebSocketManager, ServiceRegistry } from './core/networking/index.js';
+export type { ServiceInfo, ServiceDiscoveryOptions } from './core/networking/service-discovery.js';
 
 // Utilities and Container System
 export {
@@ -87,10 +91,13 @@ export {
   HookManager,
   HOOK_EVENTS,
   middleware,
-} from './core/utilities';
+  isPackageAvailable,
+  resolveUserPackage,
+  createUserRequire,
+} from './core/utilities/index.js';
 
 // Event System
-export { MoroEventBus } from './core/events';
+export { MoroEventBus } from './core/events/index.js';
 export type {
   EventContext,
   EventPayload,
@@ -100,38 +107,29 @@ export type {
   EventMetrics,
   SystemEvents,
   EventHandler,
-} from './types/events';
+} from './types/events.js';
 
 // Logger System
-export { createFrameworkLogger, logger } from './core/logger';
+export { createFrameworkLogger, logger } from './core/logger/index.js';
 
 // Universal Validation System
-export { validate, body, query, params, combineSchemas } from './core/validation';
-
-// Dynamic Zod export (optional dependency)
-let z: any;
-try {
-  z = require('zod').z;
-} catch {
-  // Zod not available - that's fine!
-  z = undefined;
-}
-export { z };
+export { validate, body, query, params, combineSchemas, z } from './core/validation/index.js';
+
 export type {
   ValidationConfig,
   ValidationResult,
   ValidationErrorDetail,
   ValidatedRequest,
-} from './core/validation';
+} from './core/validation/index.js';
 
-// Universal Validation Interfaces and Adapters
+// Validation Interfaces and Adapters
 export type {
   ValidationSchema,
   ValidationError,
   InferSchemaType,
-} from './core/validation/schema-interface';
-export { normalizeValidationError } from './core/validation/schema-interface';
-export { joi, yup, fn as customValidator, classValidator } from './core/validation/adapters';
+} from './core/validation/schema-interface.js';
+export { normalizeValidationError } from './core/validation/schema-interface.js';
+export { joi, yup, fn as customValidator, classValidator } from './core/validation/adapters.js';
 
 // Module System
 export {
@@ -139,8 +137,8 @@ export {
   ModuleLoader,
   ModuleDiscovery,
   autoDiscoverModuleDirectories,
-} from './core/modules';
-export type { ModuleDefinition, ModuleRoute, ModuleSocket, ModuleConfig } from './types/module';
+} from './core/modules/index.js';
+export type { ModuleDefinition, ModuleRoute, ModuleSocket, ModuleConfig } from './types/module.js';
 
 // WebSocket Adapter System
 export type {
@@ -151,14 +149,18 @@ export type {
   WebSocketEmitter,
   WebSocketMiddleware,
   WebSocketEventHandler,
-} from './core/networking/websocket-adapter';
+} from './core/networking/websocket-adapter.js';
 
 // Built-in WebSocket Adapters
-export { SocketIOAdapter, WSAdapter } from './core/networking/adapters';
+export {
+  SocketIOAdapter,
+  WSAdapter,
+  UWebSocketsAdapter,
+} from './core/networking/adapters/index.js';
 
 // Intelligent Routing System
-export { createRoute, defineRoute, EXECUTION_PHASES } from './core/routing';
-export { IntelligentRoutingManager, RouteRegistry } from './core/routing/app-integration';
+export { createRoute, defineRoute, EXECUTION_PHASES } from './core/routing/index.js';
+export { IntelligentRoutingManager, RouteRegistry } from './core/routing/app-integration.js';
 export type {
   RouteBuilder,
   RouteSchema,
@@ -169,7 +171,7 @@ export type {
   CacheConfig,
   MiddlewarePhases,
   ExecutionPhase,
-} from './core/routing';
+} from './core/routing/index.js';
 
 // Documentation System
 export {
@@ -177,8 +179,8 @@ export {
   AppDocumentationManager,
   createDocumentationSystem,
   generateDocsFromIntelligentRoutes,
-} from './core/docs';
-export type { DocsConfig } from './core/docs';
+} from './core/docs/index.js';
+export type { DocsConfig } from './core/docs/index.js';
 
 // Configuration utilities
 export {
@@ -193,34 +195,39 @@ export {
   requireEnvVars,
   envVar,
   getConfigValue,
-} from './core/config/utils';
+} from './core/config/utils.js';
 
-export { initializeConfig, getGlobalConfig, isConfigInitialized, resetConfig } from './core/config';
+export {
+  initializeConfig,
+  getGlobalConfig,
+  isConfigInitialized,
+  resetConfig,
+} from './core/config/index.js';
 
 // Export configuration types for TypeScript users
-export type { AppConfig } from './core/config';
+export type { AppConfig } from './core/config/index.js';
 
 // Middleware System
-export { MiddlewareManager } from './core/middleware';
-export type { MiddlewareInterface, MoroMiddleware } from './core/middleware';
+export { MiddlewareManager } from './core/middleware/index.js';
+export type { MiddlewareInterface, MoroMiddleware } from './core/middleware/index.js';
 
 // Types
-export type * from './types/core';
-export type * from './types/http';
-export type * from './types/hooks';
-export type * from './types/cache';
-export type * from './types/cdn';
-export type * from './types/database';
-export type * from './types/logger';
-export type * from './types/session';
-export type * from './types/discovery';
+export type * from './types/core.js';
+export type * from './types/http.js';
+export type * from './types/hooks.js';
+export type * from './types/cache.js';
+export type * from './types/cdn.js';
+export type * from './types/database.js';
+export type * from './types/logger.js';
+export type * from './types/session.js';
+export type * from './types/discovery.js';
 
 // Adapters
-export * from './core/middleware/built-in/adapters';
-export * from './core/database/adapters';
+export * from './core/middleware/built-in/adapters/index.js';
+export * from './core/database/adapters/index.js';
 
 // Re-export commonly used types for convenience
-export type { CacheAdapter, CacheOptions, CacheStrategy } from './types/cache';
-export type { CDNAdapter, CDNOptions } from './types/cdn';
-export type { DatabaseAdapter, DatabaseTransaction, DatabaseConfig } from './types/database';
-export type { CookieOptions } from './types/http';
+export type { CacheAdapter, CacheOptions, CacheStrategy } from './types/cache.js';
+export type { CDNAdapter, CDNOptions } from './types/cdn.js';
+export type { DatabaseAdapter, DatabaseTransaction, DatabaseConfig } from './types/database.js';
+export type { CookieOptions } from './types/http.js';