elysia 2.0.0-exp.46 → 2.0.0-exp.49

package/dist/adapter/web-standard/handler.js

@@ -7,6 +7,7 @@ const require_adapter_default_headers = require('../default-headers.js');
 const require_adapter_utils = require('../utils.js');
 
 //#region src/adapter/web-standard/handler.ts
+const textPlainInit = { headers: { "content-type": "text/plain" } };
 function handleElysiaFile(file, set = { headers: require_utils.nullObject() }, request) {
 	const path = file.path;
 	const contentType = require_universal_file.mime[path.slice(path.lastIndexOf(".") + 1).toLowerCase()];
@@ -20,23 +21,17 @@ function handleElysiaFile(file, set = { headers: require_utils.nullObject() }, r
 	});
 	return require_adapter_utils.handleFile(file.value, set, request);
 }
-function responseTag(response) {
-	if (response === null || response === void 0) return void 0;
-	const proto = Object.getPrototypeOf(response);
-	if (proto === null) return "Object";
-	return proto.constructor?.name;
-}
-function mapResponseWithSet(response, set, request) {
+function mapResponseWithSet(response, set, request, owned) {
 	require_adapter_utils.handleSet(set);
 	const headers = set.headers;
-	switch (responseTag(response)) {
+	switch (response?.constructor?.name) {
 		case "String":
 			if (!require_universal_constants.isBun && !headers["content-type"]) require_adapter_utils.materializeSetHeaders(set)["content-type"] = "text/plain";
 			return new Response(response, set);
 		case "Array": return Response.json(response, set);
 		case "Object":
 			if (response["~ely-form"]) return new Response(require_utils.formToFormData(response), set);
-			if (typeof response?.next === "function") return handleStream(response, set, request);
+			if (typeof response?.next === "function") return handleStream(response, set, request, void 0, owned);
 			return Response.json(response, set);
 		case "Number":
 		case "Boolean": return new Response(response.toString(), set);
@@ -46,32 +41,33 @@ function mapResponseWithSet(response, set, request) {
 		case "ElysiaStatus":
 			set.status = response.code;
 			if (response.headers) Object.assign(require_adapter_utils.materializeSetHeaders(set), response.headers);
-			return mapResponseWithSet(response.response, set, request);
+			return mapResponseWithSet(response.response, set, request, owned);
 		case void 0: return response ? Response.json(response, set) : new Response(null, set);
-		case "Response": return handleResponse(response, set, request);
-		case "Error": return errorToResponse(response, set);
-		case "Promise": return response.then((x) => mapResponseWithSet(x, set, request));
-		case "Function": return mapResponseWithSet(response(), set, request);
+		case "Response": return handleResponse(response, set, request, owned);
+		case "Error": return errorToResponse(response, set, request, owned);
+		case "Promise": return response.then((x) => mapResponseWithSet(x, set, request, owned));
+		case "Function": return mapResponseWithSet(response(), set, request, owned);
 		case "FormData": return new Response(response, set);
-		default: return mapResponseFallback(response, set, request);
+		default: return mapResponseFallback(response, set, request, owned);
 	}
 }
-function mapResponse(response, set, request) {
+function mapResponse(response, set, request, owned) {
 	const headers = set.headers;
-	if (set.status !== void 0 || set.cookie || headers["\0"] === headers || require_utils.isNotEmpty(headers)) return mapResponseWithSet(response, set, request);
+	if (set.status !== void 0 || set.cookie || headers["\0"] === headers || require_utils.isNotEmpty(headers)) return mapResponseWithSet(response, set, request, owned);
 	if (response instanceof require_error.ElysiaStatus) {
 		set.status = response.code;
 		if (response.headers) Object.assign(set.headers, response.headers);
-		return mapResponse(response.response, set, request);
+		return mapResponse(response.response, set, request, owned);
 	}
-	if (response instanceof Response) return response;
-	if (response instanceof Promise) return response.then((x) => mapResponse(x, set, request));
-	if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request);
-	return mapCompactResponse(response, request);
+	if (response instanceof Response) return owned ? handleResponse(response, void 0, request, true) : response;
+	if (response instanceof Promise) return response.then((x) => mapResponse(x, set, request, owned));
+	if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request, void 0, owned);
+	return mapCompactResponse(response, request, owned);
 }
-function mapCompactResponse(response, request) {
-	switch (responseTag(response)) {
-		case "String": return new Response(response, require_universal_constants.isBun ? void 0 : { headers: { "content-type": "text/plain" } });
+const textHeaders = require_universal_constants.isBun ? void 0 : textPlainInit;
+function mapCompactResponse(response, request, owned) {
+	switch (response?.constructor?.name) {
+		case "String": return new Response(response, textHeaders);
 		case "Array": return Response.json(response);
 		case "Object":
 			if (response["~ely-form"]) return new Response(require_utils.formToFormData(response));
@@ -84,22 +80,22 @@ function mapCompactResponse(response, request) {
 		case "ElysiaStatus": return mapResponse(response.response, {
 			status: response.code,
 			headers: response.headers ? Object.assign(require_utils.nullObject(), response.headers) : require_utils.nullObject()
-		});
+		}, request, owned);
 		case void 0: return response ? Response.json(response) : new Response("");
-		case "Response": return response;
-		case "Error": return errorToResponse(response);
-		case "Promise": return response.then((x) => mapCompactResponse(x, request));
-		case "Function": return mapCompactResponse(response(), request);
+		case "Response": return owned ? handleResponse(response, void 0, request, true) : response;
+		case "Error": return errorToResponse(response, void 0, request, owned);
+		case "Promise": return response.then((x) => mapCompactResponse(x, request, owned));
+		case "Function": return mapCompactResponse(response(), request, owned);
 		case "FormData": return new Response(response);
-		default: return mapCompactResponseFallback(response, void 0, request);
+		default: return mapCompactResponseFallback(response, void 0, request, owned);
 	}
 }
-function errorToResponse(error, set) {
+function errorToResponse(error, set, request, owned = false) {
 	if (error?.toResponse) {
 		const targetSet = set ?? { headers: require_utils.nullObject() };
 		const apply = (resolved) => {
 			if (resolved instanceof Response) targetSet.status = resolved.status;
-			return mapResponse(resolved, targetSet);
+			return mapResponse(resolved, targetSet, request, owned);
 		};
 		const raw = error.toResponse();
 		return typeof raw?.then === "function" ? raw.then(apply) : apply(raw);
@@ -115,31 +111,31 @@ function errorToResponse(error, set) {
 	});
 }
 function mapFallback(map) {
-	return (response, set, request) => {
-		if (response instanceof Response) return handleResponse(response, set, request);
-		if (response instanceof Promise) return response.then((x) => map(x, set, request));
-		if (response instanceof Error) return errorToResponse(response, set);
+	return (response, set, request, owned = false) => {
+		if (response instanceof Response) return handleResponse(response, set, request, owned);
+		if (response instanceof Promise) return response.then((x) => map(x, set, request, owned));
+		if (response instanceof Error) return errorToResponse(response, set, request, owned);
 		if (response instanceof require_error.ElysiaStatus) if (set) {
 			set.status = response.code;
 			if (response.headers) set.headers = {
 				...set.headers,
 				...response.headers
 			};
-			return map(response.response, set, request);
+			return map(response.response, set, request, owned);
 		} else return mapResponse(response.response, {
 			status: response.code,
 			headers: response.headers ? { ...response.headers } : {}
-		});
-		if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request);
-		if (typeof response?.then === "function") return response.then((x) => map(x, set, request));
+		}, request, owned);
+		if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request, void 0, owned);
+		if (typeof response?.then === "function") return response.then((x) => map(x, set, request, owned));
 		if (Array.isArray(response)) return Response.json(response);
-		if (typeof response?.toResponse === "function") return map(response.toResponse(), set, request);
+		if (typeof response?.toResponse === "function") return map(response.toResponse(), set, request, owned);
 		if (response?.constructor?.name === "Cookie" && response.jar) return new Response(response.value, set);
 		return new Response(response, set);
 	};
 }
 const mapResponseFallback = mapFallback(mapResponse);
-const mapCompactResponseFallback = mapFallback((response, _, request) => mapCompactResponse(response, request));
+const mapCompactResponseFallback = mapFallback((response, _, request, owned) => mapCompactResponse(response, request, owned));
 const handleResponse = require_adapter_utils.createResponseHandler({
 	mapResponse,
 	mapCompactResponse

package/dist/adapter/web-standard/handler.mjs

@@ -6,6 +6,7 @@ import { defaultHeaders } from "../default-headers.mjs";
 import { createResponseHandler, createStreamHandler, handleFile, handleSet, materializeSetHeaders } from "../utils.mjs";
 
 //#region src/adapter/web-standard/handler.ts
+const textPlainInit = { headers: { "content-type": "text/plain" } };
 function handleElysiaFile(file, set = { headers: nullObject() }, request) {
 	const path = file.path;
 	const contentType = mime[path.slice(path.lastIndexOf(".") + 1).toLowerCase()];
@@ -19,23 +20,17 @@ function handleElysiaFile(file, set = { headers: nullObject() }, request) {
 	});
 	return handleFile(file.value, set, request);
 }
-function responseTag(response) {
-	if (response === null || response === void 0) return void 0;
-	const proto = Object.getPrototypeOf(response);
-	if (proto === null) return "Object";
-	return proto.constructor?.name;
-}
-function mapResponseWithSet(response, set, request) {
+function mapResponseWithSet(response, set, request, owned) {
 	handleSet(set);
 	const headers = set.headers;
-	switch (responseTag(response)) {
+	switch (response?.constructor?.name) {
 		case "String":
 			if (!isBun && !headers["content-type"]) materializeSetHeaders(set)["content-type"] = "text/plain";
 			return new Response(response, set);
 		case "Array": return Response.json(response, set);
 		case "Object":
 			if (response["~ely-form"]) return new Response(formToFormData(response), set);
-			if (typeof response?.next === "function") return handleStream(response, set, request);
+			if (typeof response?.next === "function") return handleStream(response, set, request, void 0, owned);
 			return Response.json(response, set);
 		case "Number":
 		case "Boolean": return new Response(response.toString(), set);
@@ -45,32 +40,33 @@ function mapResponseWithSet(response, set, request) {
 		case "ElysiaStatus":
 			set.status = response.code;
 			if (response.headers) Object.assign(materializeSetHeaders(set), response.headers);
-			return mapResponseWithSet(response.response, set, request);
+			return mapResponseWithSet(response.response, set, request, owned);
 		case void 0: return response ? Response.json(response, set) : new Response(null, set);
-		case "Response": return handleResponse(response, set, request);
-		case "Error": return errorToResponse(response, set);
-		case "Promise": return response.then((x) => mapResponseWithSet(x, set, request));
-		case "Function": return mapResponseWithSet(response(), set, request);
+		case "Response": return handleResponse(response, set, request, owned);
+		case "Error": return errorToResponse(response, set, request, owned);
+		case "Promise": return response.then((x) => mapResponseWithSet(x, set, request, owned));
+		case "Function": return mapResponseWithSet(response(), set, request, owned);
 		case "FormData": return new Response(response, set);
-		default: return mapResponseFallback(response, set, request);
+		default: return mapResponseFallback(response, set, request, owned);
 	}
 }
-function mapResponse(response, set, request) {
+function mapResponse(response, set, request, owned) {
 	const headers = set.headers;
-	if (set.status !== void 0 || set.cookie || headers["\0"] === headers || isNotEmpty(headers)) return mapResponseWithSet(response, set, request);
+	if (set.status !== void 0 || set.cookie || headers["\0"] === headers || isNotEmpty(headers)) return mapResponseWithSet(response, set, request, owned);
 	if (response instanceof ElysiaStatus) {
 		set.status = response.code;
 		if (response.headers) Object.assign(set.headers, response.headers);
-		return mapResponse(response.response, set, request);
+		return mapResponse(response.response, set, request, owned);
 	}
-	if (response instanceof Response) return response;
-	if (response instanceof Promise) return response.then((x) => mapResponse(x, set, request));
-	if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request);
-	return mapCompactResponse(response, request);
+	if (response instanceof Response) return owned ? handleResponse(response, void 0, request, true) : response;
+	if (response instanceof Promise) return response.then((x) => mapResponse(x, set, request, owned));
+	if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request, void 0, owned);
+	return mapCompactResponse(response, request, owned);
 }
-function mapCompactResponse(response, request) {
-	switch (responseTag(response)) {
-		case "String": return new Response(response, isBun ? void 0 : { headers: { "content-type": "text/plain" } });
+const textHeaders = isBun ? void 0 : textPlainInit;
+function mapCompactResponse(response, request, owned) {
+	switch (response?.constructor?.name) {
+		case "String": return new Response(response, textHeaders);
 		case "Array": return Response.json(response);
 		case "Object":
 			if (response["~ely-form"]) return new Response(formToFormData(response));
@@ -83,22 +79,22 @@ function mapCompactResponse(response, request) {
 		case "ElysiaStatus": return mapResponse(response.response, {
 			status: response.code,
 			headers: response.headers ? Object.assign(nullObject(), response.headers) : nullObject()
-		});
+		}, request, owned);
 		case void 0: return response ? Response.json(response) : new Response("");
-		case "Response": return response;
-		case "Error": return errorToResponse(response);
-		case "Promise": return response.then((x) => mapCompactResponse(x, request));
-		case "Function": return mapCompactResponse(response(), request);
+		case "Response": return owned ? handleResponse(response, void 0, request, true) : response;
+		case "Error": return errorToResponse(response, void 0, request, owned);
+		case "Promise": return response.then((x) => mapCompactResponse(x, request, owned));
+		case "Function": return mapCompactResponse(response(), request, owned);
 		case "FormData": return new Response(response);
-		default: return mapCompactResponseFallback(response, void 0, request);
+		default: return mapCompactResponseFallback(response, void 0, request, owned);
 	}
 }
-function errorToResponse(error, set) {
+function errorToResponse(error, set, request, owned = false) {
 	if (error?.toResponse) {
 		const targetSet = set ?? { headers: nullObject() };
 		const apply = (resolved) => {
 			if (resolved instanceof Response) targetSet.status = resolved.status;
-			return mapResponse(resolved, targetSet);
+			return mapResponse(resolved, targetSet, request, owned);
 		};
 		const raw = error.toResponse();
 		return typeof raw?.then === "function" ? raw.then(apply) : apply(raw);
@@ -114,31 +110,31 @@ function errorToResponse(error, set) {
 	});
 }
 function mapFallback(map) {
-	return (response, set, request) => {
-		if (response instanceof Response) return handleResponse(response, set, request);
-		if (response instanceof Promise) return response.then((x) => map(x, set, request));
-		if (response instanceof Error) return errorToResponse(response, set);
+	return (response, set, request, owned = false) => {
+		if (response instanceof Response) return handleResponse(response, set, request, owned);
+		if (response instanceof Promise) return response.then((x) => map(x, set, request, owned));
+		if (response instanceof Error) return errorToResponse(response, set, request, owned);
 		if (response instanceof ElysiaStatus) if (set) {
 			set.status = response.code;
 			if (response.headers) set.headers = {
 				...set.headers,
 				...response.headers
 			};
-			return map(response.response, set, request);
+			return map(response.response, set, request, owned);
 		} else return mapResponse(response.response, {
 			status: response.code,
 			headers: response.headers ? { ...response.headers } : {}
-		});
-		if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request);
-		if (typeof response?.then === "function") return response.then((x) => map(x, set, request));
+		}, request, owned);
+		if (typeof response?.next === "function" || response instanceof ReadableStream) return handleStream(response, set, request, void 0, owned);
+		if (typeof response?.then === "function") return response.then((x) => map(x, set, request, owned));
 		if (Array.isArray(response)) return Response.json(response);
-		if (typeof response?.toResponse === "function") return map(response.toResponse(), set, request);
+		if (typeof response?.toResponse === "function") return map(response.toResponse(), set, request, owned);
 		if (response?.constructor?.name === "Cookie" && response.jar) return new Response(response.value, set);
 		return new Response(response, set);
 	};
 }
 const mapResponseFallback = mapFallback(mapResponse);
-const mapCompactResponseFallback = mapFallback((response, _, request) => mapCompactResponse(response, request));
+const mapCompactResponseFallback = mapFallback((response, _, request, owned) => mapCompactResponse(response, request, owned));
 const handleResponse = createResponseHandler({
 	mapResponse,
 	mapCompactResponse

package/dist/base.d.ts

@@ -1,12 +1,12 @@
 import { ElysiaStatus } from "./error.js";
-import { WSHandlerResponse, WSLocalHook, WSMessageHandler } from "./ws/types.js";
-import { TraceHandler } from "./trace.js";
+import { TraceCapability, TraceHandler } from "./trace.js";
 import { ListenCallback, Serve, Server } from "./universal/server.js";
 import { AddRoute, AddWSRoute, AfterHandler, AfterResponseHandler, AnyErrorConstructor, AnyLocalHook, BodyHandler, CompiledHandler, CreateEden, DefaultEphemeral, DefaultMetadata, DefaultSingleton, DefinitionBase, DocumentDecoration, ElysiaConfig, ElysiaHandlerToResponseSchemaAmbiguous, EphemeralType, ErrorDefinitionEntry, ErrorHandler, EventScope, ExcludeElysiaResponse, ExtractErrorFromHandle, GlobalHookReturn, GracefulHandler, GuardHookSingleton, GuardLocalHook, HTTPMethod, HistoryEntry, HookContextSchema, HookContextSingleton, InlineHandler, InlineHandlerNonMacro, InputSchema, InputSchemaKey, InternalRoute, IntersectIfObjectSchema, JoinPath, LocalHook, LocalHookReturn, Macro, MacroSchemaChannel, MacroToContext, MacroToProperty, MapResponse, MaybeArray, MaybePromise, MergeElysiaInstances, MergeSchema, MergeScopedSchemas, MetadataBase, NonResolvableMacroKey, ObjectMacroDefs, OptionalHandler, PluginHookReturn, PreHandler, Prettify, PublicRoute, ResolveRouteErrors, RouteBase, ScopedHookReturn, ScopedMapDeriveReturn, SingletonBase, StaticMapAliases, TransformHandler, UnionResponseStatus, UnwrapRoute, WrapFn } from "./types.js";
 import { ChainNode } from "./utils.js";
 import { Context, ErrorContext, LifecycleContext } from "./context.js";
 import { AnySchema } from "./type/types.js";
 import { AotFingerprint, CompilerSession, ProgramId } from "./compile/aot.js";
+import { WSCapability, WSHandlerResponse, WSLocalHook, WSMessageHandler, WSOptions, WSOptionsEntry } from "./ws/types.js";
 import { RouteTable } from "./route-table.js";
 import { Generation } from "./generation.js";
 import Memoirist from "memoirist";
@@ -39,8 +39,18 @@ declare class Elysia<const in out BasePath extends string = '', const in out Sco
     hoc?: WrapFn<any>[];
     setup?: GracefulHandler<any>[];
     cleanup?: GracefulHandler<any>[];
+    capability?: {
+      trace?: {
+        provider: TraceCapability;
+      };
+      ws?: {
+        provider: WSCapability;
+        options?: WSOptionsEntry[];
+      };
+    };
   };
   '~hookChain'?: ChainNode;
+  '~wsConfig'?: WSOptions;
   server?: Server;
   get history(): readonly HistoryEntry[];
   get ['~routes'](): readonly InternalRoute[];
@@ -514,6 +524,21 @@ declare class Elysia<const in out BasePath extends string = '', const in out Sco
     parser: Metadata['parser'];
     response: Metadata['response'] & MacroContext['response'] & ElysiaHandlerToResponseSchemaAmbiguous<BeforeHandle> & ElysiaHandlerToResponseSchemaAmbiguous<AfterHandle> & ElysiaHandlerToResponseSchemaAmbiguous<ErrorHandle>;
   }, {}, Ephemeral, Volatile>) => NewElysia): Elysia<BasePath, Scope, Singleton, Definitions, Metadata, Routes & NewElysia['~Routes'], Ephemeral, Volatile>;
+  /**
+   * Single idempotent capability resolver-accessor (README rev 2.1). Reads
+   * the merged `~ext.capability` channel — never mutated during a build — and
+   * throws when a capability is used but its provider was never registered.
+   * For `trace` the resolved view IS the nearest-root provider (merge already
+   * keeps it); for `ws` it additionally resolves the depth-precedence base
+   * options. Called at the start of every router build and by `compileHandler`
+   * before it reads the frozen root, so direct-compiler paths resolve without
+   * a prior seal.
+   */
+  ['~resolvedCapability'](kind: 'trace'): TraceCapability | undefined;
+  ['~resolvedCapability'](kind: 'ws'): {
+    provider: WSCapability;
+    options: WSOptions | undefined;
+  } | undefined;
   /**
    * ### macro
    * Declare a custom route property: applying it on a route or guard folds