@morojs/moro 1.6.8 → 1.7.0

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export type { RuntimeType, RuntimeAdapter, RuntimeConfig, RuntimeHttpResponse, }
 export { NodeRuntimeAdapter, VercelEdgeAdapter, AWSLambdaAdapter, CloudflareWorkersAdapter, createRuntimeAdapter, createNodeHandler, createEdgeHandler, createLambdaHandler, createWorkerHandler, } from './core/runtime/index.js';
 export type { LambdaEvent, LambdaContext, LambdaResponse, } from './core/runtime/aws-lambda-adapter.js';
 export type { WorkersEnv, WorkersContext } from './core/runtime/cloudflare-workers-adapter.js';
-export { MoroHttpServer, UWebSocketsHttpServer, middleware as httpMiddleware, } from './core/http/index.js';
+export { MoroHttpServer, UWebSocketsHttpServer } from './core/http/index.js';
 export { builtInMiddleware, simpleMiddleware } from './core/middleware/built-in/index.js';
 export { WebSocketManager, ServiceRegistry } from './core/networking/index.js';
 export type { ServiceInfo, ServiceDiscoveryOptions } from './core/networking/service-discovery.js';
@@ -56,3 +56,10 @@ 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';
+export type { GrpcOptions, GrpcCall, GrpcCallback, GrpcMetadata, GrpcError, GrpcStatusCode, GrpcCredentials, GrpcServer, GrpcClient, GrpcClientOptions, GrpcInterceptor, ServiceImplementation, ServiceDefinition, ServiceRegistration, MethodDefinition, UnaryHandler, ServerStreamingHandler, ClientStreamingHandler, BidirectionalStreamingHandler, GrpcHandler, GrpcStats, HealthCheckStatus, HealthCheckResponse, ProtoLoadOptions, } from './core/grpc/types.js';
+export type { GrpcAdapter } from './core/grpc/grpc-adapter.js';
+export { GrpcJsAdapter } from './core/grpc/adapters/index.js';
+export { grpcAuth, grpcRequirePermission, grpcRequireRole, extractTokenFromMetadata, grpcLogger, grpcSimpleLogger, grpcDetailedLogger, grpcValidate, grpcValidateHandler, } from './core/grpc/index.js';
+export type { MailConfig, MailOptions, MailResult, MailAdapter, MailAdapterType, EmailAddress, EmailAttachment, TemplateConfig, TemplateEngine, MailQueueConfig, NodemailerConnection, SendGridConnection, SESConnection, ResendConnection, } from './core/mail/types.js';
+export { BaseMailAdapter } from './core/mail/mail-adapter.js';
+export { ConsoleAdapter, NodemailerAdapter, SendGridAdapter, SESAdapter, ResendAdapter, } from './core/mail/adapters/index.js';

package/dist/index.js

@@ -6,7 +6,7 @@ export { createAuthMiddleware, MoroJSAuth } from './core/auth/morojs-adapter.js'
 export { auth, providers } from './core/middleware/built-in/auth/index.js';
 export { NodeRuntimeAdapter, VercelEdgeAdapter, AWSLambdaAdapter, CloudflareWorkersAdapter, createRuntimeAdapter, createNodeHandler, createEdgeHandler, createLambdaHandler, createWorkerHandler, } from './core/runtime/index.js';
 // Core exports
-export { MoroHttpServer, UWebSocketsHttpServer, middleware as httpMiddleware, } from './core/http/index.js';
+export { MoroHttpServer, UWebSocketsHttpServer } from './core/http/index.js';
 export { builtInMiddleware, simpleMiddleware } from './core/middleware/built-in/index.js';
 // Networking System
 export { WebSocketManager, ServiceRegistry } from './core/networking/index.js';
@@ -43,4 +43,9 @@ export { MiddlewareManager } from './core/middleware/index.js';
 export * from './core/middleware/built-in/cache/adapters/index.js';
 export * from './core/middleware/built-in/cdn/adapters/index.js';
 export * from './core/database/adapters/index.js';
+export { GrpcJsAdapter } from './core/grpc/adapters/index.js';
+// gRPC Middleware
+export { grpcAuth, grpcRequirePermission, grpcRequireRole, extractTokenFromMetadata, grpcLogger, grpcSimpleLogger, grpcDetailedLogger, grpcValidate, grpcValidateHandler, } from './core/grpc/index.js';
+export { BaseMailAdapter } from './core/mail/mail-adapter.js';
+export { ConsoleAdapter, NodemailerAdapter, SendGridAdapter, SESAdapter, ResendAdapter, } from './core/mail/adapters/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/moro.d.ts

@@ -10,7 +10,10 @@ import { EventEmitter } from 'events';
 import { type AppConfig } from './core/config/index.js';
 import { RuntimeAdapter, RuntimeType } from './core/runtime/index.js';
 import type { JobSchedule, SimpleJobOptions, JobFunction, JobMetrics, SchedulerStats, JobHealth } from './core/jobs/index.js';
+import { WorkerThreadsFacade, type WorkerTask } from './core/workers/index.js';
 import type { GraphQLOptions } from './core/graphql/types.js';
+import type { GrpcOptions, ServiceImplementation, GrpcClient, GrpcClientOptions } from './core/grpc/types.js';
+import type { MailConfig, MailOptions, MailResult } from './core/mail/types.js';
 export declare class Moro extends EventEmitter {
     private coreFramework;
     private routes;
@@ -39,6 +42,19 @@ export declare class Moro extends EventEmitter {
     private graphqlCore?;
     private graphqlSubscriptionManager?;
     private graphqlInitPromise?;
+    private graphqlConfig?;
+    private grpcManager?;
+    private grpcInitPromise?;
+    private grpcStarted;
+    private grpcConfig?;
+    private queueManager?;
+    private queueInitialized;
+    private queueInitPromise?;
+    private queueConfigs;
+    private workerFacade;
+    private mailManager?;
+    private mailInitialized;
+    private mailConfig?;
     constructor(options?: MoroOptions);
     /**
      * Get configuration object
@@ -141,13 +157,6 @@ export declare class Moro extends EventEmitter {
     private clusterWorkers;
     private startWithClustering;
     private handleWorkerMessage;
-    /**
-     * uWebSockets Worker Thread Clustering Implementation
-     * Uses worker threads with acceptor pattern for maximum performance
-     */
-    private startWithUWSClustering;
-    private startUWSAcceptor;
-    private startUWSWorker;
     /**
      * Gracefully close the application and clean up resources
      * This should be called in tests and during shutdown
@@ -225,14 +234,14 @@ export declare class Moro extends EventEmitter {
      */
     private startJobScheduler;
     /**
-     * Configure GraphQL endpoint with schema, resolvers, and options
+     * Configure GraphQL endpoint (synchronous, lazy initialization)
      *
      * @param options - GraphQL configuration options
      *
      * @example
      * ```ts
      * // Using type definitions and resolvers
-     * app.graphql({
+     * app.graphqlInit({
      *   typeDefs: `
      *     type Query {
      *       hello: String
@@ -261,12 +270,16 @@ export declare class Moro extends EventEmitter {
      *   })
      * });
      *
-     * app.graphql({
+     * app.graphqlInit({
      *   pothosSchema: builder
      * });
      * ```
      */
-    graphql(options: GraphQLOptions): this;
+    graphqlInit(options: GraphQLOptions): this;
+    /**
+     * Lazy initialize GraphQL system
+     */
+    private ensureGraphQLInitialized;
     /**
      * Initialize GraphQL system asynchronously
      */
@@ -286,11 +299,330 @@ export declare class Moro extends EventEmitter {
     /**
      * Get GraphQL schema (if configured)
      */
-    getGraphQLSchema(): any | undefined;
+    getGraphQLSchema(): Promise<any | undefined>;
+    /**
+     * Execute a task on worker threads (CPU-intensive operations)
+     * @param task - Task to execute
+     * @returns Promise resolving to task result
+     *
+     * @example
+     * ```ts
+     * // JWT verification (CPU-intensive)
+     * const payload = await app.executeOnWorker({
+     *   id: 'jwt-verify-123',
+     *   type: 'jwt:verify',
+     *   data: { token, secret }
+     * });
+     *
+     * // Heavy computation
+     * const result = await app.executeOnWorker({
+     *   id: 'compute-456',
+     *   type: 'computation:heavy',
+     *   data: { iterations: 1000000 }
+     * });
+     * ```
+     */
+    executeOnWorker<T = any>(task: WorkerTask): Promise<T>;
+    /**
+     * Get worker manager instance for advanced usage
+     */
+    getWorkerManager(): Promise<WorkerThreadsFacade>;
+    /**
+     * Get worker thread statistics
+     */
+    getWorkerStats(): Promise<import("./core/workers/facade.js").WorkerStats | null>;
+    /**
+     * JWT operations using worker threads (prevents event loop blocking)
+     */
+    getJwtWorker(): Promise<{
+        verify: import("./core/workers/facade.js").WorkerHelpers["verifyJWT"];
+        sign: import("./core/workers/facade.js").WorkerHelpers["signJWT"];
+    } | null>;
+    /**
+     * Crypto operations using worker threads
+     */
+    getCryptoWorker(): Promise<{
+        hash: import("./core/workers/facade.js").WorkerHelpers["hash"];
+    } | null>;
+    /**
+     * Heavy computation operations using worker threads
+     */
+    getComputeWorker(): Promise<{
+        heavy: import("./core/workers/facade.js").WorkerHelpers["heavyComputation"];
+        transformJSON: import("./core/workers/facade.js").WorkerHelpers["transformJSON"];
+    } | null>;
     /**
      * Get GraphQL stats
      */
-    getGraphQLStats(): any;
+    getGraphQLStats(): Promise<any>;
+    /**
+     * Configure gRPC server (synchronous, lazy initialization)
+     *
+     * @example
+     * ```typescript
+     * app.grpcInit({
+     *   port: 50051,
+     *   host: '0.0.0.0',
+     *   adapter: 'grpc-js',
+     *   enableHealthCheck: true,
+     *   enableReflection: true
+     * });
+     * ```
+     */
+    grpcInit(options?: GrpcOptions): this;
+    /**
+     * Lazy initialize gRPC system
+     */
+    private ensureGrpcInitialized;
+    /**
+     * Register a gRPC service from a proto file
+     *
+     * @example
+     * ```typescript
+     * app.grpcService('./proto/users.proto', 'UserService', {
+     *   getUser: async (call, callback) => {
+     *     const user = await db.users.findById(call.request.id);
+     *     callback(null, user);
+     *   },
+     *   listUsers: async (call) => {
+     *     for (const user of users) {
+     *       call.write(user);
+     *     }
+     *     call.end();
+     *   }
+     * });
+     * ```
+     */
+    grpcService(protoPath: string, serviceName: string, implementation: ServiceImplementation, packageName?: string): Promise<void>;
+    /**
+     * Start gRPC server
+     * Called automatically by listen() if gRPC is configured
+     */
+    startGrpc(): Promise<void>;
+    /**
+     * Stop gRPC server gracefully
+     */
+    stopGrpc(): Promise<void>;
+    /**
+     * Create a gRPC client for calling remote services
+     *
+     * @example
+     * ```typescript
+     * const client = await app.createGrpcClient(
+     *   './proto/users.proto',
+     *   'UserService',
+     *   'localhost:50051'
+     * );
+     *
+     * const user = await client.getUser({ id: '123' });
+     * ```
+     */
+    createGrpcClient(protoPath: string, serviceName: string, address: string, options?: Partial<GrpcClientOptions>): Promise<GrpcClient>;
+    /**
+     * Get gRPC statistics
+     */
+    getGrpcStats(): any;
+    /**
+     * Get list of registered gRPC services
+     */
+    getGrpcServices(): any;
+    /**
+     * Initialize queue system (synchronous for first queue, subsequent queues added immediately)
+     *
+     * @example
+     * ```typescript
+     * app.queueInit('emails', {
+     *   adapter: 'bull',
+     *   connection: {
+     *     host: 'localhost',
+     *     port: 6379
+     *   },
+     *   concurrency: 5
+     * });
+     * ```
+     */
+    queueInit(name: string, options: any): this;
+    /**
+     * Ensure queue system is initialized
+     */
+    private ensureQueueInitialized;
+    /**
+     * @deprecated Use queueInit() instead
+     */
+    queue(name: string, options: any): Promise<void>;
+    /**
+     * Add a job to a queue
+     *
+     * @example
+     * ```typescript
+     * await app.addToQueue('emails', {
+     *   to: 'user@example.com',
+     *   subject: 'Welcome'
+     * }, {
+     *   priority: 10,
+     *   delay: 5000
+     * });
+     * ```
+     */
+    addToQueue<T = any>(queueName: string, data: T, options?: any): Promise<any>;
+    /**
+     * Add multiple jobs to a queue in bulk
+     *
+     * @example
+     * ```typescript
+     * await app.addBulkToQueue('emails', [
+     *   { data: { to: 'user1@example.com' }, options: { priority: 1 } },
+     *   { data: { to: 'user2@example.com' }, options: { priority: 2 } }
+     * ]);
+     * ```
+     */
+    addBulkToQueue<T = any>(queueName: string, jobs: Array<{
+        data: T;
+        options?: any;
+    }>): Promise<any[]>;
+    /**
+     * Register a processor for a queue
+     *
+     * @example
+     * ```typescript
+     * // Simple processor
+     * app.processQueue('emails', async (job) => {
+     *   await sendEmail(job.data);
+     * });
+     *
+     * // With concurrency
+     * app.processQueue('images', 3, async (job) => {
+     *   await processImage(job.data);
+     * });
+     * ```
+     */
+    processQueue<R = any>(queueName: string, concurrencyOrHandler: number | ((job: any) => Promise<R>), handler?: (job: any) => Promise<R>): Promise<void>;
+    /**
+     * Get queue status
+     */
+    getQueueStatus(queueName: string): Promise<any>;
+    /**
+     * Get a specific job from a queue
+     */
+    getJob(queueName: string, jobId: string): Promise<any>;
+    /**
+     * Get jobs from a queue by status
+     */
+    getJobs(queueName: string, status?: 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused', start?: number, end?: number): Promise<any[]>;
+    /**
+     * Remove a job from a queue
+     */
+    removeJob(queueName: string, jobId: string): Promise<void>;
+    /**
+     * Retry a failed job
+     */
+    retryJob(queueName: string, jobId: string): Promise<void>;
+    /**
+     * Pause a queue
+     */
+    pauseQueue(queueName: string): Promise<void>;
+    /**
+     * Resume a paused queue
+     */
+    resumeQueue(queueName: string): Promise<void>;
+    /**
+     * Clean old jobs from a queue
+     */
+    cleanQueue(queueName: string, gracePeriod: number, status?: 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused'): Promise<void>;
+    /**
+     * Get all registered queue names
+     */
+    getQueueNames(): string[];
+    /**
+     * Check if a queue is registered
+     */
+    hasQueue(queueName: string): boolean;
+    /**
+     * Configure mail system (synchronous, lazy initialization)
+     *
+     * @example
+     * ```typescript
+     * // Using Nodemailer (SMTP) - chainable, no await needed!
+     * app.mailInit({
+     *   adapter: 'nodemailer',
+     *   from: { name: 'My App', email: 'noreply@myapp.com' },
+     *   connection: {
+     *     host: 'smtp.gmail.com',
+     *     port: 587,
+     *     secure: false,
+     *     auth: { user: process.env.EMAIL_USER, pass: process.env.EMAIL_PASSWORD }
+     *   },
+     *   templates: { path: './emails', engine: 'moro', cache: true }
+     * });
+     *
+     * // Using SendGrid
+     * app.mailInit({
+     *   adapter: 'sendgrid',
+     *   from: 'noreply@myapp.com',
+     *   connection: { apiKey: process.env.SENDGRID_API_KEY }
+     * });
+     * ```
+     */
+    mailInit(config: MailConfig): this;
+    /**
+     * Lazy initialize mail system on first use
+     */
+    private ensureMailInitialized;
+    /**
+     * Send an email
+     *
+     * @example
+     * ```typescript
+     * // Simple email
+     * await app.sendMail({
+     *   to: 'user@example.com',
+     *   subject: 'Welcome',
+     *   text: 'Welcome to our app!'
+     * });
+     *
+     * // With template
+     * await app.sendMail({
+     *   to: 'user@example.com',
+     *   subject: 'Password Reset',
+     *   template: 'password-reset',
+     *   data: { name: 'John', resetUrl: 'https://myapp.com/reset/token123' }
+     * });
+     *
+     * // With attachments
+     * await app.sendMail({
+     *   to: 'user@example.com',
+     *   subject: 'Invoice',
+     *   template: 'invoice',
+     *   data: { invoice },
+     *   attachments: [{ filename: 'invoice.pdf', content: pdfBuffer }]
+     * });
+     * ```
+     */
+    sendMail(options: MailOptions): Promise<MailResult>;
+    /**
+     * Send multiple emails in bulk
+     *
+     * @example
+     * ```typescript
+     * await app.sendBulkMail([
+     *   { to: 'user1@example.com', subject: 'Hello', text: 'Hi!' },
+     *   { to: 'user2@example.com', subject: 'Hello', text: 'Hi!' }
+     * ]);
+     * ```
+     */
+    sendBulkMail(options: MailOptions[]): Promise<MailResult[]>;
+    /**
+     * Verify mail adapter connection
+     */
+    verifyMail(): Promise<boolean>;
+    /**
+     * Get mail template engine for advanced usage
+     */
+    getMailTemplateEngine(): any;
+    /**
+     * Check if mail system is configured
+     */
+    hasMailSystem(): boolean;
 }
 export declare function createApp(options?: MoroOptions): Moro;
 export declare function createAppNode(options?: Omit<MoroOptions, 'runtime'>): Moro;