@mastra/nestjs 0.0.0

package/dist/interceptors/index.d.ts

@@ -0,0 +1,3 @@
+export { StreamingInterceptor } from './streaming.interceptor.js';
+export { RequestTrackingInterceptor } from './request-tracking.interceptor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/interceptors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interceptors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/interceptors/request-tracking.interceptor.d.ts

@@ -0,0 +1,13 @@
+import type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { ShutdownService } from '../services/shutdown.service.js';
+/**
+ * Interceptor that tracks requests for graceful shutdown.
+ * Also rejects new requests during shutdown.
+ */
+export declare class RequestTrackingInterceptor implements NestInterceptor {
+    private readonly shutdownService;
+    constructor(shutdownService: ShutdownService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+//# sourceMappingURL=request-tracking.interceptor.d.ts.map

package/dist/interceptors/request-tracking.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-tracking.interceptor.d.ts","sourceRoot":"","sources":["../../src/interceptors/request-tracking.interceptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,EAAE,UAAU,EAAmB,MAAM,MAAM,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;GAGG;AACH,qBACa,0BAA2B,YAAW,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAAf,eAAe,EAAE,eAAe;IAEtF,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAwB7E"}

package/dist/interceptors/streaming.interceptor.d.ts

@@ -0,0 +1,40 @@
+import type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import type { MastraModuleOptions } from '../mastra.module.js';
+import { ShutdownService } from '../services/shutdown.service.js';
+/**
+ * Interceptor that handles streaming responses and MCP transports.
+ * Converts ReadableStream results to chunked HTTP responses.
+ */
+export declare class StreamingInterceptor implements NestInterceptor {
+    private readonly options;
+    private readonly shutdownService;
+    private readonly logger;
+    private readonly normalizedPrefix;
+    private readonly heartbeatMs;
+    constructor(options: MastraModuleOptions, shutdownService: ShutdownService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    /**
+     * Determine the response type of a handler result, or null if it's not
+     * a recognized RouteHandlerResult.
+     */
+    private getResultType;
+    private handleJsonNull;
+    /**
+     * Handle streaming response - write chunks to response.
+     */
+    private handleStreaming;
+    /**
+     * Handle datastream response (AI SDK Response).
+     */
+    private handleDatastream;
+    /**
+     * Handle MCP HTTP transport response.
+     */
+    private handleMcpHttp;
+    /**
+     * Handle MCP SSE transport response.
+     */
+    private handleMcpSse;
+}
+//# sourceMappingURL=streaming.interceptor.d.ts.map

package/dist/interceptors/streaming.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.interceptor.d.ts","sourceRoot":"","sources":["../../src/interceptors/streaming.interceptor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,EAAE,UAAU,EAAuB,MAAM,MAAM,CAAC;AAGvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;GAGG;AACH,qBACa,oBAAqB,YAAW,eAAe;IAMhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAN3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;gBAGD,OAAO,EAAE,mBAAmB,EAC3B,eAAe,EAAE,eAAe;IAuB5E,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IA2B5E;;;OAGG;IACH,OAAO,CAAC,aAAa;YAyBP,cAAc;IAQ5B;;OAEG;YACW,eAAe;IA2E7B;;OAEG;YACW,gBAAgB;IA4B9B;;OAEG;YACW,aAAa;IAuC3B;;OAEG;YACW,YAAY;CA+B3B"}

package/dist/interceptors/tracing.interceptor.d.ts

@@ -0,0 +1,12 @@
+import type { CallHandler, ExecutionContext, NestInterceptor } from '@nestjs/common';
+import { Observable } from 'rxjs';
+import type { MastraModuleOptions } from '../mastra.module.js';
+import { RouteHandlerService } from '../services/route-handler.service.js';
+export declare class TracingInterceptor implements NestInterceptor {
+    private readonly options;
+    private readonly routeHandler;
+    private readonly logger;
+    constructor(options: MastraModuleOptions, routeHandler: RouteHandlerService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+//# sourceMappingURL=tracing.interceptor.d.ts.map

package/dist/interceptors/tracing.interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.interceptor.d.ts","sourceRoot":"","sources":["../../src/interceptors/tracing.interceptor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAIlC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AA6CxE,qBACa,kBAAmB,YAAW,eAAe;IAI9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;gBAGnB,OAAO,EAAE,mBAAmB,EACvB,YAAY,EAAE,mBAAmB;IAGjF,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAoD7E"}

package/dist/mastra-server.adapter.d.ts

@@ -0,0 +1,10 @@
+import { MastraServerBase } from '@mastra/core/server';
+import type { Application } from 'express';
+/**
+ * Minimal Mastra server adapter wrapper for NestJS.
+ * Provides MastraServerBase compatibility so getServerApp() works.
+ */
+export declare class NestMastraServer extends MastraServerBase<Application> {
+    constructor(app: Application);
+}
+//# sourceMappingURL=mastra-server.adapter.d.ts.map

package/dist/mastra-server.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mastra-server.adapter.d.ts","sourceRoot":"","sources":["../src/mastra-server.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB,CAAC,WAAW,CAAC;gBACrD,GAAG,EAAE,WAAW;CAG7B"}

package/dist/mastra.module.d.ts

@@ -0,0 +1,173 @@
+import type { ToolsInput } from '@mastra/core/agent';
+import type { Mastra } from '@mastra/core/mastra';
+import type { InMemoryTaskStore } from '@mastra/server/a2a/store';
+import type { DynamicModule, MiddlewareConsumer, NestModule, Type } from '@nestjs/common';
+/**
+ * Options for MastraModule configuration.
+ */
+export interface MastraModuleOptions {
+    /** The Mastra instance to register */
+    mastra: Mastra;
+    /** Route prefix (default: '/api') */
+    prefix?: string;
+    /** Request body size limits */
+    bodyLimitOptions?: {
+        /** Max body size in bytes (default: 10MB) */
+        maxSize?: number;
+        /** Max per-file size in bytes (default: 50MB) */
+        maxFileSize?: number;
+        /** Temp directory for file uploads */
+        tempDir?: string;
+        /** Allowed MIME types for file uploads */
+        allowedMimeTypes?: string[];
+    };
+    /**
+     * Rate limiting options.
+     * Rate limiting is ON by default - set enabled: false to disable.
+     */
+    rateLimitOptions?: {
+        /** Enable/disable rate limiting (default: true) */
+        enabled?: boolean;
+        /** Default requests per window (default: 100) */
+        defaultLimit?: number;
+        /** Window size in ms (default: 60000 = 1 minute) */
+        windowMs?: number;
+        /** Stricter limit for /generate endpoints (default: 10) */
+        generateLimit?: number;
+    };
+    /** Graceful shutdown options */
+    shutdownOptions?: {
+        /** Max wait time for in-flight requests in ms (default: 30000) */
+        timeoutMs?: number;
+        /** Send shutdown event to SSE clients (default: true) */
+        notifyClients?: boolean;
+    };
+    /** Observability options */
+    tracingOptions?: {
+        /** Enable tracing (default: auto-detect @opentelemetry/api) */
+        enabled?: boolean;
+        /** Service name for spans */
+        serviceName?: string;
+    };
+    /** Context parsing options */
+    contextOptions?: {
+        /** Fail on parse errors (default: false) */
+        strict?: boolean;
+        /** Log parse warnings (default: true) */
+        logWarnings?: boolean;
+    };
+    /** Additional tools to register */
+    tools?: ToolsInput;
+    /** Task store for async operations */
+    taskStore?: InMemoryTaskStore;
+    /** Mastra-internal authentication configuration. Disabled by default.
+     *  Most NestJS apps have their own global auth guards -- Mastra defers to those.
+     *  Enable this only if you want Mastra's built-in token auth. */
+    auth?: {
+        /** Enable Mastra's internal auth (default: false) */
+        enabled?: boolean;
+        /** Allow `?apiKey=` query auth for backward compatibility (default: false) */
+        allowQueryApiKey?: boolean;
+    };
+    /** Per-route auth configuration */
+    customRouteAuthConfig?: Map<string, boolean>;
+    /** Streaming configuration */
+    streamOptions?: {
+        /** Redact sensitive data from streams (default: true) */
+        redact?: boolean;
+        /** Send SSE heartbeats every N ms (default: disabled). Set <= 0 to disable. */
+        heartbeatMs?: number;
+    };
+    /** MCP transport options */
+    mcpOptions?: {
+        /** Run in serverless mode */
+        serverless?: boolean;
+        /** Custom session ID generator */
+        sessionIdGenerator?: () => string;
+    };
+}
+/**
+ * Options for async module configuration.
+ */
+export interface MastraModuleAsyncOptions {
+    /** Modules to import for dependency injection */
+    imports?: any[];
+    /** Factory function to create module options */
+    useFactory?: (...args: any[]) => Promise<MastraModuleOptions> | MastraModuleOptions;
+    /** Dependencies to inject into the factory function */
+    inject?: any[];
+    /** Use an existing provider */
+    useExisting?: Type<MastraModuleOptionsFactory>;
+    /** Use a class to create options */
+    useClass?: Type<MastraModuleOptionsFactory>;
+}
+/**
+ * Interface for async options factory.
+ */
+export interface MastraModuleOptionsFactory {
+    createMastraOptions(): Promise<MastraModuleOptions> | MastraModuleOptions;
+}
+/**
+ * NestJS module for integrating Mastra into your application.
+ *
+ * @example
+ * Basic registration:
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     MastraModule.register({
+ *       mastra: new Mastra({ agents: { ... } }),
+ *       prefix: '/api',
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example
+ * With rate limiting disabled:
+ * ```typescript
+ * MastraModule.register({
+ *   mastra,
+ *   rateLimitOptions: { enabled: false },
+ * })
+ * ```
+ *
+ * @example
+ * Async registration:
+ * ```typescript
+ * MastraModule.registerAsync({
+ *   imports: [ConfigModule],
+ *   useFactory: (config: ConfigService) => ({
+ *     mastra: new Mastra({ ... }),
+ *     prefix: config.get('MASTRA_PREFIX', '/api'),
+ *   }),
+ *   inject: [ConfigService],
+ * })
+ * ```
+ */
+export declare class MastraModule implements NestModule {
+    /**
+     * Register Mastra with the NestJS application.
+     *
+     * @param options - Configuration options including the Mastra instance
+     * @returns Dynamic module configuration
+     */
+    static register(options: MastraModuleOptions): DynamicModule;
+    /**
+     * Register Mastra asynchronously for when configuration depends on other services.
+     *
+     * @param options - Async configuration options
+     * @returns Dynamic module configuration
+     */
+    static registerAsync(options: MastraModuleAsyncOptions): DynamicModule;
+    /**
+     * Configure middleware for the module.
+     * Order matters: body limit must run BEFORE JSON parsing.
+     *
+     * Middleware is scoped to MastraController to avoid affecting other routes
+     * in the user's NestJS application.
+     */
+    configure(consumer: MiddlewareConsumer): void;
+}
+//# sourceMappingURL=mastra.module.d.ts.map

package/dist/mastra.module.d.ts.map

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

package/dist/mastra.service.d.ts

@@ -0,0 +1,51 @@
+import type { Mastra } from '@mastra/core/mastra';
+import { HttpAdapterHost } from '@nestjs/core';
+import type { MastraModuleOptions } from './mastra.module.js';
+import { ShutdownService } from './services/shutdown.service.js';
+/**
+ * Injectable service for accessing Mastra and managing lifecycle.
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * export class MyService {
+ *   constructor(private readonly mastraService: MastraService) {}
+ *
+ *   async runAgent() {
+ *     const mastra = this.mastraService.getMastra();
+ *     const agent = mastra.getAgent('my-agent');
+ *     return agent.generate({ messages: [{ role: 'user', content: 'Hello' }] });
+ *   }
+ * }
+ * ```
+ */
+export declare class MastraService {
+    private readonly mastra;
+    private readonly options;
+    private readonly shutdownService;
+    private readonly httpAdapterHost;
+    private readonly logger;
+    private serverAdapter?;
+    constructor(mastra: Mastra, options: MastraModuleOptions, shutdownService: ShutdownService, httpAdapterHost: HttpAdapterHost);
+    /**
+     * Get the Mastra instance.
+     */
+    getMastra(): Mastra;
+    /**
+     * Get module options.
+     */
+    getOptions(): MastraModuleOptions;
+    /**
+     * Get an agent by ID.
+     */
+    getAgent(agentId: string): import("@mastra/core/agent").Agent<any, import("@mastra/core/agent").ToolsInput, undefined, unknown>;
+    /**
+     * Get a workflow by ID.
+     */
+    getWorkflow(workflowId: string): import("@mastra/core/workflows").AnyWorkflow;
+    /**
+     * Check if the service is shutting down.
+     */
+    get isShuttingDown(): boolean;
+}
+//# sourceMappingURL=mastra.service.d.ts.map

package/dist/mastra.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mastra.service.d.ts","sourceRoot":"","sources":["../src/mastra.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,aAAa;IAKN,OAAO,CAAC,QAAQ,CAAC,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAP3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,aAAa,CAAC,CAAmB;gBAGN,MAAM,EAAE,MAAM,EACN,OAAO,EAAE,mBAAmB,EAC3B,eAAe,EAAE,eAAe,EAChC,eAAe,EAAE,eAAe;IAoB5E;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,UAAU,IAAI,mBAAmB;IAIjC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM;IAIxB;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM;IAI9B;;OAEG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;CACF"}

package/dist/middleware/body-limit.middleware.d.ts

@@ -0,0 +1,24 @@
+import type { NestMiddleware } from '@nestjs/common';
+import type { Request, Response, NextFunction } from 'express';
+import type { MastraModuleOptions } from '../mastra.module.js';
+/**
+ * Middleware that enforces body size limits via Content-Length header.
+ *
+ * This middleware runs BEFORE body parsers and provides early rejection
+ * of oversized payloads based on the Content-Length header.
+ *
+ * Note: JSON body size limits are also enforced by JsonBodyMiddleware's
+ * express.json({ limit: ... }) configuration, which handles both
+ * Content-Length validation and streaming body parsing.
+ *
+ * For multipart requests, size limits are enforced by Busboy in the
+ * route handler service.
+ */
+export declare class BodyLimitMiddleware implements NestMiddleware {
+    private readonly options;
+    private readonly logger;
+    private readonly maxSize;
+    constructor(options: MastraModuleOptions);
+    use(req: Request, res: Response, next: NextFunction): void;
+}
+//# sourceMappingURL=body-limit.middleware.d.ts.map

package/dist/middleware/body-limit.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-limit.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/body-limit.middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI5D;;;;;;;;;;;;GAYG;AACH,qBACa,mBAAoB,YAAW,cAAc;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEoB,OAAO,EAAE,mBAAmB;IAIjF,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;CAwB3D"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,3 @@
+export { BodyLimitMiddleware } from './body-limit.middleware.js';
+export { JsonBodyMiddleware } from './json-body.middleware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/middleware/json-body.middleware.d.ts

@@ -0,0 +1,17 @@
+import type { NestMiddleware } from '@nestjs/common';
+import type { Request, Response, NextFunction } from 'express';
+import type { MastraModuleOptions } from '../mastra.module.js';
+/**
+ * Middleware that parses JSON request bodies.
+ * Uses express.json() with size limits from configuration.
+ *
+ * This middleware is essential for POST/PUT/PATCH requests to work properly.
+ * NestJS does not automatically parse JSON bodies unless body-parser is configured.
+ */
+export declare class JsonBodyMiddleware implements NestMiddleware {
+    private readonly options;
+    private readonly jsonParser;
+    constructor(options: MastraModuleOptions);
+    use(req: Request, res: Response, next: NextFunction): void;
+}
+//# sourceMappingURL=json-body.middleware.d.ts.map

package/dist/middleware/json-body.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-body.middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/json-body.middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D;;;;;;GAMG;AACH,qBACa,kBAAmB,YAAW,cAAc;IAGnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;gBAER,OAAO,EAAE,mBAAmB;IAUjF,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI;CAgB3D"}

package/dist/services/auth.service.d.ts

@@ -0,0 +1,34 @@
+import type { Mastra } from '@mastra/core/mastra';
+import type { Request } from 'express';
+import type { MastraModuleOptions } from '../mastra.module.js';
+/**
+ * Service that handles authentication for Mastra routes.
+ * Called after route matching to check if auth is required.
+ */
+export declare class AuthService {
+    private readonly mastra;
+    private readonly options;
+    private readonly logger;
+    constructor(mastra: Mastra, options: MastraModuleOptions);
+    /**
+     * Check authentication for a request based on the matched route.
+     * Returns the authenticated user if auth succeeds, undefined if no auth required.
+     * Throws UnauthorizedException or ForbiddenException if auth fails.
+     *
+     * Type assertions (`as any`) are used because `@mastra/server/auth` types
+     * are Hono-centric. The runtime values work with Express requests.
+     */
+    authenticate(request: Request): Promise<unknown>;
+    /**
+     * Check authorization for an authenticated user.
+     * `authConfig` is typed as `any` because `@mastra/server/auth` doesn't
+     * export a standalone type for the auth config object.
+     */
+    private authorize;
+    /**
+     * Extract authentication token from request.
+     * Supports Authorization header (Bearer token) and API key query param.
+     */
+    private extractToken;
+}
+//# sourceMappingURL=auth.service.d.ts.map

package/dist/services/auth.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.service.d.ts","sourceRoot":"","sources":["../../src/services/auth.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAUlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAS5D;;;GAGG;AACH,qBACa,WAAW;IAIJ,OAAO,CAAC,QAAQ,CAAC,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJlD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAGpB,MAAM,EAAE,MAAM,EACN,OAAO,EAAE,mBAAmB;IAGvE;;;;;;;OAOG;IACG,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA4EtD;;;;OAIG;YACW,SAAS;IA0DvB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAuBrB"}

package/dist/services/index.d.ts

@@ -0,0 +1,5 @@
+export { RouteHandlerService, ValidationError, type RouteHandlerParams, type RouteHandlerResult, type RouteMatch, } from './route-handler.service.js';
+export { RequestContextService } from './request-context.service.js';
+export { ShutdownService } from './shutdown.service.js';
+export { AuthService } from './auth.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/services/request-context.service.d.ts

@@ -0,0 +1,52 @@
+import { RequestContext } from '@mastra/core/request-context';
+import type { Request } from 'express';
+import type { MastraModuleOptions } from '../mastra.module.js';
+/**
+ * REQUEST-scoped service that manages request context and abort signaling.
+ * Created fresh for each HTTP request.
+ */
+export declare class RequestContextService {
+    private readonly request;
+    private readonly options;
+    private readonly logger;
+    private readonly abortController;
+    private readonly context;
+    private isAborted;
+    constructor(request: Request, options: MastraModuleOptions);
+    /**
+     * Get the abort signal for this request.
+     * Use this to detect client disconnection.
+     */
+    get abortSignal(): AbortSignal;
+    /**
+     * Get the parsed request context.
+     */
+    get requestContext(): RequestContext;
+    /**
+     * Set the authenticated user on the request context.
+     * Should be called after successful authentication.
+     */
+    setUser(user: unknown): void;
+    /**
+     * Parse request context from body or query parameters.
+     */
+    private parseRequestContext;
+    /**
+     * Parse encoded context from query parameter.
+     * Supports both plain JSON and base64-encoded JSON.
+     */
+    private parseEncodedContext;
+    /**
+     * Merge parsed context values into the RequestContext.
+     */
+    private mergeContext;
+    /**
+     * Setup abort handling for client disconnection.
+     */
+    private setupAbortHandling;
+    /**
+     * Manually trigger abort (e.g., during shutdown).
+     */
+    abort(): void;
+}
+//# sourceMappingURL=request-context.service.d.ts.map

package/dist/services/request-context.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.service.d.ts","sourceRoot":"","sources":["../../src/services/request-context.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,SAAS,CAAC;AAGjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;GAGG;AACH,qBACa,qBAAqB;IAOb,OAAO,CAAC,QAAQ,CAAC,OAAO;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPlD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,SAAS,CAAS;gBAGU,OAAO,EAAE,OAAO,EACT,OAAO,EAAE,mBAAmB;IAOvE;;;OAGG;IACH,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAI5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAUd"}

package/dist/services/route-handler.service.d.ts

@@ -0,0 +1,78 @@
+import type { Mastra } from '@mastra/core/mastra';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { ServerRoute } from '@mastra/server/server-adapter';
+import { ZodError } from 'zod';
+import type { MastraModuleOptions } from '../mastra.module.js';
+export interface RouteMatch {
+    route: ServerRoute;
+    pathParams: Record<string, string>;
+}
+export interface RouteHandlerParams {
+    /** URL path parameters (e.g., { agentId: '123' }) */
+    pathParams: Record<string, string>;
+    /** Query string parameters */
+    queryParams: Record<string, unknown>;
+    /** Request body (for POST/PUT/PATCH) */
+    body: unknown;
+    /** Request context (user, session, etc.) */
+    requestContext: RequestContext;
+    /** Abort signal for request cancellation */
+    abortSignal: AbortSignal;
+}
+export interface RouteHandlerResult {
+    /** The result data from the handler */
+    data: unknown;
+    /** Response type determines how to send the response */
+    responseType: 'json' | 'stream' | 'datastream-response' | 'mcp-http' | 'mcp-sse';
+    /** Stream format (only for 'stream' responseType) */
+    streamFormat?: 'sse' | 'stream';
+}
+/**
+ * Service that bridges NestJS controllers to Mastra route handlers.
+ * Handles parameter validation and invokes the appropriate handler.
+ */
+export declare class RouteHandlerService {
+    private readonly mastra;
+    private readonly options;
+    private readonly logger;
+    private readonly routeMap;
+    private readonly reservedParamKeys;
+    constructor(mastra: Mastra, options: MastraModuleOptions);
+    /**
+     * Find a route by exact method and path pattern.
+     * Use matchRoute() for parameterized path matching.
+     */
+    findRoute(method: string, path: string): ServerRoute | undefined;
+    /**
+     * Match a request method and path against registered routes.
+     * Handles both exact matches and parameterized path patterns.
+     *
+     * @param method - HTTP method (GET, POST, etc.)
+     * @param path - Request path to match
+     * @returns Route match with path parameters, or null if no match
+     */
+    matchRoute(method: string, path: string): RouteMatch | null;
+    /**
+     * Get all routes (for dynamic controller generation).
+     */
+    getAllRoutes(): readonly ServerRoute[];
+    /**
+     * Match a path against a route pattern.
+     * Returns path parameters if matched, null otherwise.
+     */
+    private matchPath;
+    /**
+     * Execute a route handler with the given parameters.
+     */
+    executeHandler(route: ServerRoute, params: RouteHandlerParams): Promise<RouteHandlerResult>;
+    private getRouteKey;
+    private omitReservedKeys;
+}
+/**
+ * Error class for validation failures with Zod error details.
+ */
+export declare class ValidationError extends Error {
+    readonly zodError: ZodError;
+    constructor(message: string, zodError: ZodError);
+}
+//# sourceMappingURL=route-handler.service.d.ts.map

package/dist/services/route-handler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-handler.service.d.ts","sourceRoot":"","sources":["../../src/services/route-handler.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAG/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAc5D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,4CAA4C;IAC5C,cAAc,EAAE,cAAc,CAAC;IAC/B,4CAA4C;IAC5C,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,qBAAqB,GAAG,UAAU,GAAG,SAAS,CAAC;IACjF,qDAAqD;IACrD,YAAY,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CACjC;AAED;;;GAGG;AACH,qBACa,mBAAmB;IAaZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;IAblD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAO/B;gBAGgC,MAAM,EAAE,MAAM,EACN,OAAO,EAAE,mBAAmB;IAUvE;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAKhE;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IA4B3D;;OAEG;IACH,YAAY,IAAI,SAAS,WAAW,EAAE;IAItC;;;OAGG;IACH,OAAO,CAAC,SAAS;IAsCjB;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiEjG,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,gBAAgB;CAgBzB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,QAAQ,EAAE,QAAQ;gBADlC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,QAAQ;CAKrC"}

package/dist/services/shutdown.service.d.ts

@@ -0,0 +1,54 @@
+import type { OnApplicationShutdown, OnModuleDestroy } from '@nestjs/common';
+import type { Response } from 'express';
+import type { MastraModuleOptions } from '../mastra.module.js';
+/**
+ * Service that manages graceful shutdown.
+ * Tracks in-flight requests and waits for them to complete before shutdown.
+ */
+export declare class ShutdownService implements OnModuleDestroy, OnApplicationShutdown {
+    private readonly options;
+    private readonly logger;
+    private readonly activeRequests;
+    private readonly sseClients;
+    private isShuttingDown;
+    private shutdownResolve;
+    constructor(options: MastraModuleOptions);
+    /**
+     * Check if the service is shutting down.
+     * Use this to reject new requests during shutdown.
+     */
+    get shuttingDown(): boolean;
+    /**
+     * Get the number of active requests.
+     */
+    get activeRequestCount(): number;
+    /**
+     * Register a new request.
+     * Returns a unique request ID for tracking.
+     */
+    registerRequest(path: string): string;
+    /**
+     * Mark a request as complete.
+     */
+    completeRequest(requestId: string): void;
+    /**
+     * Register an SSE client for shutdown notifications.
+     * Returns an unregister function.
+     */
+    registerSseClient(response: Response): () => void;
+    /**
+     * Notify all connected SSE clients about shutdown.
+     */
+    notifySseClients(): void;
+    /**
+     * Called when the module is being destroyed.
+     * Marks the service as shutting down.
+     */
+    onModuleDestroy(): void;
+    /**
+     * Called when the application is shutting down.
+     * Waits for in-flight requests to complete.
+     */
+    onApplicationShutdown(signal?: string): Promise<void>;
+}
+//# sourceMappingURL=shutdown.service.d.ts.map

package/dist/services/shutdown.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.service.d.ts","sourceRoot":"","sources":["../../src/services/shutdown.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;GAGG;AACH,qBACa,eAAgB,YAAW,eAAe,EAAE,qBAAqB;IAOxC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0D;IACzF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAA6B;gBAEC,OAAO,EAAE,mBAAmB;IAEjF;;;OAGG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IASrC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASxC;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IASjD;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAkBxB;;;OAGG;IACH,eAAe,IAAI,IAAI;IAKvB;;;OAGG;IACG,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoD5D"}