@supacloud/elysia 0.8.0 → 0.8.1

package/README.md

@@ -26,7 +26,8 @@ Runtime adapter that turns `@supacloud/compiler` output into a production-ready
   performed.
 - **Public error mapping**: transforms framework / application errors via
   `errorMapper` with standard `ApplicationError` envelope support, preserving
-  Elysia's default behavior (422) for schema validation errors.
+  HTTP 422 for request validation and HTTP 500 / `RESPONSE_VALIDATION_ERROR`
+  for invalid handler output, without exposing payloads or schema internals.
 
 ## Installation
 
@@ -83,8 +84,15 @@ sandbox.reset();
 
 Route `body`, `params`, `query`, and `response` schemas are enforced by
 Elysia before and after the handler. Invalid input returns the standard `422`
-validation response; invalid handler output is rejected before it reaches the
-client.
+validation response; invalid structured handler output returns HTTP 500 with
+`RESPONSE_VALIDATION_ERROR`. A response validation failure can occur **after a
+command has committed**; it does not imply rollback and must not trigger a blind
+write retry. Confirm the outcome using the application's durable receipt or
+read-back protocol. A custom `errorMapper` can override this public envelope.
+
+Native `Response` objects are passed through by Elysia, including JSON responses.
+Handlers returning a native `Response` must validate their JSON payload before
+constructing it. The adapter does not consume or parse binary/streaming responses.
 
 Jobs are executed explicitly with `executeJob(compiledModule, services, job,
 input, requestContext)`. The asynchronous compiler-generated job scope is

package/dist/index.js

@@ -572,6 +572,15 @@ function createModulePlugin(compiled, services, ctxFactory = defaultRequestConte
     requestContexts.set(request, requestContext);
     return { requestContext };
   });
+  plugin.onError(async ({ code, error, request }) => {
+    const context = {
+      request,
+      requestContext: requestContexts.get(request),
+      frameworkCode: code
+    };
+    const mapped = await options.errorMapper?.(error, context);
+    return mapped ?? defaultErrorResponse(error, code);
+  });
   for (const controller of compiled.controllers) {
     for (const route of controller.routes) {
       const path = joinPaths(controller.path, route.path);
@@ -683,15 +692,6 @@ function createModulePlugin(compiled, services, ctxFactory = defaultRequestConte
       }
     }
   }
-  plugin.onError({ as: "global" }, async ({ code, error, request }) => {
-    const context = {
-      request,
-      requestContext: requestContexts.get(request),
-      frameworkCode: code
-    };
-    const mapped = await options.errorMapper?.(error, context);
-    return mapped ?? defaultErrorResponse(error, code);
-  });
   return plugin;
 }
 async function executeJob(compiled, services, job, input, requestContext, imported = {}, executor) {
@@ -738,6 +738,13 @@ function defaultErrorResponse(error, frameworkCode) {
     }, { status: error.status });
   }
   if (frameworkCode === "VALIDATION") {
+    if (isRecord(error) && error.type === "response") {
+      return Response.json({
+        ok: false,
+        code: "RESPONSE_VALIDATION_ERROR",
+        message: "Response validation failed"
+      }, { status: 500 });
+    }
     return Response.json({
       ok: false,
       code: "VALIDATION_ERROR",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/elysia",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Elysia runtime adapter for SupaCloud compiled modules: application/request scopes, route registration and validation",
   "type": "module",
   "main": "./dist/index.js",