@aponiajs/platform-elysia 0.3.16 → 0.3.18

package/README.md

@@ -20,12 +20,12 @@ The first Elysia platform slice for Aponia:
 - `handle`, `listen`, and `close` application methods.
 
 This package intentionally does not yet implement request scopes, lifecycle
-enhancers, schema aggregation, or the complete native-plugin compatibility
+enhancers, schema aggregation, or the complete module-level native-plugin
 contract from the roadmap.
 
-The decorator API is the default application authoring surface. The
-`defineElysiaController` API remains available as a low-level escape hatch for
-composing existing Elysia plugins without rewriting them.
+The decorator API is the default application authoring surface.
+`defineElysiaController` remains available as a low-level escape hatch for
+controller factories.
 
 See `docs/logging.md` for logger configuration, JSON output, level filtering,
 and custom logger integration.
@@ -41,5 +41,27 @@ const application = await AponiaFactory.create(AppModule);
 await application.listen(3000);
 ```
 
+## Native Elysia plugins
+
+Use existing Elysia plugins without an Aponia adapter:
+
+```bash
+bun add @elysiajs/cors
+```
+
+```ts
+import { cors } from "@elysiajs/cors";
+
+const application = await AponiaFactory.create(AppModule, {
+  configureNative: (elysia) => elysia.use(cors()),
+});
+```
+
+`configureNative` receives the real Elysia application before Aponia mounts its
+controllers. Use Elysia's own `.use()` API for instance, functional, array, and
+lazy plugins; no adapter or route copying is involved. Return the same
+application so Elysia's plugin types remain available from
+`application.getNativeApplication()`.
+
 [npm package](https://www.npmjs.com/package/@aponiajs/platform-elysia) ·
 [complete package catalog](../../docs/packages.md)

package/dist/index.d.mts

@@ -5,19 +5,24 @@ type AponiaRootModule = ModuleClass | ModuleDefinition;
 declare function compileRootModule(rootModule: AponiaRootModule): ModuleDefinition;
 //#endregion
 //#region src/application.d.ts
-declare class AponiaElysiaApplication {
+declare class AponiaElysiaApplication<TNativeApplication extends AnyElysia = Elysia> {
   #private;
-  constructor(nativeApplication: Elysia, logger: LoggerService | undefined);
-  getNativeApplication(): Elysia;
+  constructor(nativeApplication: TNativeApplication, logger: LoggerService | undefined);
+  getNativeApplication(): TNativeApplication;
   handle(request: Request): Response | Promise<Response>;
   listen(port: number): Promise<void>;
   getUrl(): string;
   close(): Promise<void>;
 }
+type NativeElysiaConfigurator<TNativeApplication extends AnyElysia> = (application: Elysia) => TNativeApplication;
 interface AponiaApplicationOptions {
   readonly logger?: false | LoggerService | readonly LogLevel[];
 }
+interface ConfiguredAponiaApplicationOptions<TNativeApplication extends AnyElysia> extends AponiaApplicationOptions {
+  readonly configureNative: NativeElysiaConfigurator<TNativeApplication>;
+}
 declare class AponiaFactory {
+  static create<const TNativeApplication extends AnyElysia>(rootModule: AponiaRootModule, options: ConfiguredAponiaApplicationOptions<TNativeApplication>): Promise<AponiaElysiaApplication<TNativeApplication>>;
   static create(rootModule: AponiaRootModule, options?: AponiaApplicationOptions): Promise<AponiaElysiaApplication>;
 }
 //#endregion
@@ -34,4 +39,4 @@ declare function defineElysiaController<TController, const TDependencies extends
   readonly buildPlugin: (controller: TController) => TPlugin;
 }): ElysiaControllerDefinition<TController, TDependencies, TPlugin>;
 //#endregion
-export { type AponiaApplicationOptions, AponiaElysiaApplication, AponiaFactory, type AponiaRootModule, ELYSIA_CONTROLLER, type ElysiaControllerDefinition, compileRootModule, defineElysiaController };
+export { type AponiaApplicationOptions, AponiaElysiaApplication, AponiaFactory, type AponiaRootModule, type ConfiguredAponiaApplicationOptions, ELYSIA_CONTROLLER, type ElysiaControllerDefinition, type NativeElysiaConfigurator, compileRootModule, defineElysiaController };

package/dist/index.mjs

@@ -127,7 +127,10 @@ var AponiaFactory = class {
 		logger?.log("Starting Aponia application...", "AponiaFactory");
 		const compiledRootModule = compileRootModule(rootModule);
 		const container = createContainer(compiledRootModule);
-		const nativeApplication = new Elysia({ name: compiledRootModule.id });
+		const baseApplication = new Elysia({ name: compiledRootModule.id });
+		const configureNative = "configureNative" in options ? options.configureNative : void 0;
+		const nativeApplication = configureNative ? configureNative(baseApplication) : baseApplication;
+		if (nativeApplication !== baseApplication) throw new AponiaError("INVALID_NATIVE_APPLICATION", "configureNative must return the Elysia application it receives.");
 		for (const module of container.graph.modules) {
 			container.initializeModule(module);
 			logger?.log(`${module.id} dependencies initialized`, "InstanceLoader");
@@ -146,10 +149,12 @@ var AponiaFactory = class {
 				module: module.id,
 				controller: tokenName(controller.token)
 			});
-			const controllerName = tokenName(controller.token);
-			const controllerPath = controller.path ?? inferControllerPath(plugin);
-			logger?.log(`${controllerName} {${controllerPath}}:`, "RoutesResolver");
-			for (const route of plugin.routes) logger?.log(`Mapped {${route.path}, ${String(route.method).toUpperCase()}} route`, "RouterExplorer");
+			if (logger) {
+				const controllerName = tokenName(controller.token);
+				const controllerPath = controller.path ?? inferControllerPath(plugin);
+				logger.log(`${controllerName} {${controllerPath}}:`, "RoutesResolver");
+				for (const route of plugin.routes) logger.log(`Mapped {${route.path}, ${String(route.method).toUpperCase()}} route`, "RouterExplorer");
+			}
 			nativeApplication.use(plugin);
 		}
 		await nativeApplication.modules;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aponiajs/platform-elysia",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "Minimal Elysia application platform for Aponia modules and controllers.",
   "homepage": "https://github.com/aponiajs/aponiajs#readme",
   "bugs": {
@@ -33,8 +33,8 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@aponiajs/common": "0.3.11",
-    "@aponiajs/core": "0.3.11"
+    "@aponiajs/common": "0.3.18",
+    "@aponiajs/core": "0.3.18"
   },
   "devDependencies": {
     "elysia": "^1.4.29"