@mastra/elysia 0.0.0-knowledge-org-scope-20260902233451

package/LICENSE.md

@@ -0,0 +1,32 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named `ee/` within this
+  repository, including but not limited to:
+  - `@mastra/core/auth/ee`
+  - `@mastra/core/agent-builder/ee`
+  - `@mastra/editor/ee`
+
+  is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,33 @@
+# @mastra/elysia
+
+`@mastra/elysia` mounts Mastra's agent, workflow, tool, memory, and streaming APIs on an Elysia application. Use it when Elysia is already your HTTP server and you want Mastra endpoints in the same process.
+
+## Installation
+
+```bash
+npm install @mastra/elysia
+```
+
+## Usage
+
+```typescript
+import { Elysia } from 'elysia';
+import { MastraServer } from '@mastra/elysia';
+import { mastra } from './mastra';
+
+const app = new Elysia();
+const server = new MastraServer({ app, mastra });
+await server.init();
+```
+
+## Documentation
+
+- [Reference: Elysia adapter](https://mastra.ai/reference/server/elysia-adapter)
+
+## Changelog
+
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/server-adapters/elysia/CHANGELOG.md) for version history and release notes.
+
+## Support
+
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/__tests__/helpers.d.ts

@@ -0,0 +1,12 @@
+import type { Server } from 'node:http';
+import type Elysia from 'elysia';
+/**
+ * Starts a real Node HTTP server that delegates requests to an Elysia app's fetch method.
+ * This is needed for tests that use `fetch()` directly (multipart, OpenAPI, custom routes, MCP transport).
+ */
+export declare function startElysiaServer(app: Elysia): Promise<{
+    baseUrl: string;
+    cleanup: () => Promise<void>;
+    server: Server;
+}>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/__tests__/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/__tests__/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,MAAM,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAiFD"}

package/dist/auth-middleware.d.ts

@@ -0,0 +1,7 @@
+import type { Mastra } from '@mastra/core/mastra';
+export interface ElysiaAuthMiddlewareOptions {
+    mastra: Mastra;
+    requiresAuth?: boolean;
+}
+export declare function createAuthMiddleware({ mastra, requiresAuth, }: ElysiaAuthMiddlewareOptions): (ctx: any) => Promise<globalThis.Response | void>;
+//# sourceMappingURL=auth-middleware.d.ts.map

package/dist/auth-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-middleware.d.ts","sourceRoot":"","sources":["../src/auth-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,MAAM,EACN,YAAmB,GACpB,EAAE,2BAA2B,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,CA8CjF"}

package/dist/helper.d.ts

@@ -0,0 +1,60 @@
+import type { MastraServer } from './index.js';
+/**
+ * Get OpenAPI documentation from a MastraServer instance, formatted for Elysia's openapi plugin.
+ *
+ * This function:
+ * - Extracts all Mastra routes with their Zod schemas
+ * - Converts them to OpenAPI 3.1.0 format
+ * - Merges custom routes if registered
+ * - Applies the configured route prefix to all paths
+ * - Caches the result for performance
+ *
+ * @param server - The MastraServer instance (must be initialized with init())
+ * @param options - Optional configuration for OpenAPI metadata
+ * @returns OpenAPI documentation with paths, components, and info
+ *
+ * @example
+ * ```typescript
+ * import { getMastraOpenAPIDoc } from '@mastra/elysia';
+ *
+ * const srv = new MastraServer({ mastra, app, prefix: '/api' });
+ * await srv.init();
+ *
+ * const openAPIDoc = getMastraOpenAPIDoc(srv, {
+ *   title: 'My Mastra API',
+ *   version: '1.0.0',
+ *   description: 'API with weather agent'
+ * });
+ *
+ * app.use(openapi({
+ *   documentation: {
+ *     info: openAPIDoc.info,
+ *     paths: openAPIDoc.paths,
+ *     components: openAPIDoc.components
+ *   }
+ * }));
+ * ```
+ */
+export declare function getMastraOpenAPIDoc(server: MastraServer, options?: {
+    title?: string;
+    version?: string;
+    description?: string;
+    clearCache?: boolean;
+}): {
+    paths: Record<string, any>;
+    components?: Record<string, any>;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+};
+/**
+ * Clear the OpenAPI documentation cache.
+ * Call this if routes are added dynamically after initialization.
+ *
+ * `@param` server - The MastraServer instance to clear cache for.
+ * Note: WeakMap does not support clearing all entries. Pass the specific server instance whose cache should be invalidated.
+ */
+export declare function clearMastraOpenAPICache(server?: MastraServer): void;
+//# sourceMappingURL=helper.d.ts.map

package/dist/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAe5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GACA;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE,CA8DA;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAKnE"}