@morojs/moro 1.6.5 → 1.6.8

package/dist/moro.d.ts

@@ -9,6 +9,8 @@ import { DocsConfig } from './core/docs/index.js';
 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 type { GraphQLOptions } from './core/graphql/types.js';
 export declare class Moro extends EventEmitter {
     private coreFramework;
     private routes;
@@ -31,6 +33,12 @@ export declare class Moro extends EventEmitter {
     private runtimeType;
     private middlewareManager;
     private queuedWebSocketRegistrations;
+    private jobScheduler?;
+    private jobHealthChecker?;
+    private jobsStarted;
+    private graphqlCore?;
+    private graphqlSubscriptionManager?;
+    private graphqlInitPromise?;
     constructor(options?: MoroOptions);
     /**
      * Get configuration object
@@ -68,7 +76,7 @@ export declare class Moro extends EventEmitter {
     plugin(middleware: any, options?: any): Promise<this>;
     loadModule(moduleOrPath: ModuleConfig | string): Promise<this>;
     database(adapter: any): this;
-    websocket(namespace: string, handlers: Record<string, Function>): this;
+    websocket(namespace: string, handlers: Record<string, CallableFunction>): this;
     private processWebSocketRegistration;
     private processQueuedWebSocketRegistrations;
     listen(callback?: () => void): void;
@@ -133,11 +141,156 @@ 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
      */
     close(): Promise<void>;
+    /**
+     * Register a background job with cron or interval schedule
+     * @param name - Job name (used for identification)
+     * @param schedule - Cron expression, interval string ('5m', '1h'), or schedule object
+     * @param handler - Job function to execute
+     * @param options - Job configuration options
+     * @returns Job ID for management
+     *
+     * @example
+     * // Cron schedule
+     * app.job('cleanup', '0 2 * * *', async () => {
+     *   await cleanupOldData();
+     * });
+     *
+     * // Interval schedule
+     * app.job('health-check', '5m', async (ctx) => {
+     *   console.log('Health check', ctx.executionId);
+     * });
+     *
+     * // Advanced options
+     * app.job('report', '@daily', generateReport, {
+     *   timeout: 60000,
+     *   maxRetries: 3,
+     *   onError: (ctx, error) => console.error('Job failed', error)
+     * });
+     */
+    job(name: string, schedule: string | JobSchedule, handler: JobFunction, options?: SimpleJobOptions): string;
+    /**
+     * Enable or disable a registered job
+     */
+    setJobEnabled(jobId: string, enabled: boolean): boolean;
+    /**
+     * Manually trigger a job execution
+     */
+    triggerJob(jobId: string, metadata?: Record<string, any>): Promise<any>;
+    /**
+     * Unregister a job
+     */
+    unregisterJob(jobId: string): boolean;
+    /**
+     * Get job metrics
+     */
+    getJobMetrics(jobId: string): JobMetrics | null;
+    /**
+     * Get job health status
+     */
+    getJobHealth(jobId?: string): JobHealth | JobHealth[];
+    /**
+     * Get scheduler statistics
+     */
+    getJobStats(): SchedulerStats | null;
+    /**
+     * Get overall scheduler health
+     */
+    getSchedulerHealth(): {
+        status: import("./core/jobs/types.js").JobHealthStatus;
+        stats: SchedulerStats;
+        jobs: JobHealth[];
+        unhealthyJobCount: number;
+        message?: string;
+    } | {
+        status: "unknown";
+        message: string;
+        stats: null;
+        jobs: never[];
+        unhealthyJobCount: number;
+    };
+    /**
+     * Start the job scheduler (called automatically on listen)
+     */
+    private startJobScheduler;
+    /**
+     * Configure GraphQL endpoint with schema, resolvers, and options
+     *
+     * @param options - GraphQL configuration options
+     *
+     * @example
+     * ```ts
+     * // Using type definitions and resolvers
+     * app.graphql({
+     *   typeDefs: `
+     *     type Query {
+     *       hello: String
+     *       users: [User]
+     *     }
+     *     type User {
+     *       id: ID!
+     *       name: String!
+     *     }
+     *   `,
+     *   resolvers: {
+     *     Query: {
+     *       hello: () => 'Hello World!',
+     *       users: () => [{ id: '1', name: 'Alice' }]
+     *     }
+     *   }
+     * });
+     *
+     * // Using Pothos schema builder
+     * import SchemaBuilder from '@pothos/core';
+     *
+     * const builder = new SchemaBuilder();
+     * builder.queryType({
+     *   fields: (t) => ({
+     *     hello: t.string({ resolve: () => 'Hello World!' })
+     *   })
+     * });
+     *
+     * app.graphql({
+     *   pothosSchema: builder
+     * });
+     * ```
+     */
+    graphql(options: GraphQLOptions): this;
+    /**
+     * Initialize GraphQL system asynchronously
+     */
+    private initializeGraphQL;
+    /**
+     * Check if GraphQL package is available
+     */
+    private isGraphQLAvailable;
+    /**
+     * Lazy load GraphQL modules
+     */
+    private loadGraphQLModules;
+    /**
+     * Setup GraphQL subscriptions
+     */
+    private setupGraphQLSubscriptions;
+    /**
+     * Get GraphQL schema (if configured)
+     */
+    getGraphQLSchema(): any | undefined;
+    /**
+     * Get GraphQL stats
+     */
+    getGraphQLStats(): any;
 }
 export declare function createApp(options?: MoroOptions): Moro;
 export declare function createAppNode(options?: Omit<MoroOptions, 'runtime'>): Moro;