effect 4.0.0-beta.66 → 4.0.0-beta.68

package/dist/unstable/http/HttpServerError.d.ts

@@ -1,4 +1,24 @@
 /**
+ * Error types and response conversion helpers used by the HTTP server runtime.
+ *
+ * This module models the failure cases that can happen around a server request:
+ * malformed or unreadable requests, unmatched routes, unexpected handler
+ * failures, response construction or delivery failures, and lower-level server
+ * implementation failures. These errors keep the relevant request, and for
+ * response failures the response that was being produced, so applications can
+ * report, inspect, or translate failures without losing HTTP context.
+ *
+ * Most users encounter these errors when decoding request bodies, implementing
+ * fallback routes, adding error reporting, or customizing how handler failures
+ * become responses. Request parse errors become `400` responses, missing routes
+ * become `404` responses and are ignored by the error reporter, and internal or
+ * response errors become `500` responses. A `ResponseError` records the response
+ * involved in the failure, but its default conversion intentionally sends an
+ * empty `500` instead of reusing a response that may already be invalid or
+ * partially failed. Handler causes can also contain respondable failures,
+ * response defects, or interrupts; the conversion helpers preserve those
+ * distinctions, including `499` for client aborts and `503` for server aborts.
+ *
  * @since 4.0.0
  */
 import * as Cause from "../../Cause.ts";
@@ -15,8 +35,14 @@ declare const HttpServerError_base: new <A extends Record<string, any> = {}>(arg
     readonly _tag: "HttpServerError";
 } & Readonly<A>;
 /**
- * @since 4.0.0
+ * Tagged error for failures that occur while handling an HTTP server request.
+ *
+ * It wraps a `HttpServerErrorReason`, exposes the associated request and optional
+ * response, and can be converted to an HTTP response through the `Respondable`
+ * protocol.
+ *
  * @category error
+ * @since 4.0.0
  */
 export declare class HttpServerError extends HttpServerError_base<{
     readonly reason: HttpServerErrorReason;
@@ -36,8 +62,12 @@ declare const RequestParseError_base: new <A extends Record<string, any> = {}>(a
     readonly _tag: "RequestParseError";
 } & Readonly<A>;
 /**
- * @since 4.0.0
+ * Error describing a failure to parse or read an incoming request.
+ *
+ * When converted to a response it produces an empty `400` response.
+ *
  * @category error
+ * @since 4.0.0
  */
 export declare class RequestParseError extends RequestParseError_base<{
     readonly request: Request.HttpServerRequest;
@@ -45,6 +75,8 @@ export declare class RequestParseError extends RequestParseError_base<{
     readonly cause?: unknown;
 }> implements Respondable.Respondable {
     /**
+     * Converts the request error into a `400 Bad Request` response.
+     *
      * @since 4.0.0
      */
     [Respondable.symbol](): Effect.Effect<Response.HttpServerResponse, never, never>;
@@ -55,8 +87,13 @@ declare const RouteNotFound_base: new <A extends Record<string, any> = {}>(args:
     readonly _tag: "RouteNotFound";
 } & Readonly<A>;
 /**
- * @since 4.0.0
+ * Error indicating that no route matched the incoming request.
+ *
+ * When converted to a response it produces an empty `404` response, and it is
+ * ignored by the error reporter.
+ *
  * @category error
+ * @since 4.0.0
  */
 export declare class RouteNotFound extends RouteNotFound_base<{
     readonly request: Request.HttpServerRequest;
@@ -72,8 +109,12 @@ declare const InternalError_base: new <A extends Record<string, any> = {}>(args:
     readonly _tag: "InternalError";
 } & Readonly<A>;
 /**
- * @since 4.0.0
+ * Error describing an unexpected server-side failure while handling a request.
+ *
+ * When converted to a response it produces an empty `500` response.
+ *
  * @category error
+ * @since 4.0.0
  */
 export declare class InternalError extends InternalError_base<{
     readonly request: Request.HttpServerRequest;
@@ -81,6 +122,8 @@ export declare class InternalError extends InternalError_base<{
     readonly cause?: unknown;
 }> implements Respondable.Respondable {
     /**
+     * Converts the server error into a `500 Internal Server Error` response.
+     *
      * @since 4.0.0
      */
     [Respondable.symbol](): Effect.Effect<Response.HttpServerResponse, never, never>;
@@ -88,16 +131,23 @@ export declare class InternalError extends InternalError_base<{
     get message(): string;
 }
 /**
- * @since 4.0.0
+ * Returns `true` when the supplied value is an `HttpServerError`.
+ *
  * @category predicates
+ * @since 4.0.0
  */
 export declare const isHttpServerError: (u: unknown) => u is HttpServerError;
 declare const ResponseError_base: new <A extends Record<string, any> = {}>(args: import("../../Types.ts").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "ResponseError";
 } & Readonly<A>;
 /**
- * @since 4.0.0
+ * Error describing a failure related to an HTTP response.
+ *
+ * It carries the request and response involved in the failure. When converted to
+ * a response it produces an empty `500` response.
+ *
  * @category error
+ * @since 4.0.0
  */
 export declare class ResponseError extends ResponseError_base<{
     readonly request: Request.HttpServerRequest;
@@ -110,21 +160,29 @@ export declare class ResponseError extends ResponseError_base<{
     get message(): string;
 }
 /**
- * @since 4.0.0
+ * Union of errors that are tied directly to an incoming server request.
+ *
  * @category error
+ * @since 4.0.0
  */
 export type RequestError = RequestParseError | RouteNotFound | InternalError;
 /**
- * @since 4.0.0
+ * Reason carried by an `HttpServerError`.
+ *
+ * It is either a request-level error or a response-level error.
+ *
  * @category error
+ * @since 4.0.0
  */
 export type HttpServerErrorReason = RequestError | ResponseError;
 declare const ServeError_base: new <A extends Record<string, any> = {}>(args: import("../../Types.ts").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => Cause.YieldableError & {
     readonly _tag: "ServeError";
 } & Readonly<A>;
 /**
- * @since 4.0.0
+ * Error wrapping a low-level failure from the HTTP server implementation.
+ *
  * @category error
+ * @since 4.0.0
  */
 export declare class ServeError extends ServeError_base<{
     readonly cause: unknown;
@@ -132,21 +190,46 @@ export declare class ServeError extends ServeError_base<{
 }
 declare const ClientAbort_base: Context.ServiceClass<ClientAbort, "effect/http/HttpServerError/ClientAbort", true>;
 /**
+ * Context annotation used to mark an interrupt as caused by the client aborting
+ * the request.
+ *
+ * `causeResponse` uses this annotation to map a pure client abort to a `499`
+ * response instead of a server abort response.
+ *
+ * @category annotations
  * @since 4.0.0
- * @category Annotations
  */
 export declare class ClientAbort extends ClientAbort_base {
     static annotation: Context.Context<Cause.StackTrace | ClientAbort>;
 }
 /**
+ * Converts a failed handler cause into the HTTP response that should be sent and
+ * the cause that should be reported.
+ *
+ * Respondable failures and defects can choose their own response, defects that
+ * are already `HttpServerResponse` values are used directly, and pure interrupts
+ * produce either `499` for client aborts or `503` for server aborts.
+ *
+ * @category error handling
  * @since 4.0.0
  */
 export declare const causeResponse: <E>(cause: Cause.Cause<E>) => Effect.Effect<readonly [Response.HttpServerResponse, Cause.Cause<E>]>;
 /**
+ * Synchronously derives an HTTP response from a failed handler cause.
+ *
+ * If the cause contains a defect that is already an `HttpServerResponse`, that
+ * response is used and removed from the remaining cause. Otherwise the response
+ * defaults to `500`.
+ *
+ * @category error handling
  * @since 4.0.0
  */
 export declare const causeResponseStripped: <E>(cause: Cause.Cause<E>) => readonly [response: Response.HttpServerResponse, cause: Option.Option<Cause.Cause<E>>];
 /**
+ * Extracts the response from a successful handler exit, or derives a response
+ * from the failure cause.
+ *
+ * @category error handling
  * @since 4.0.0
  */
 export declare const exitResponse: <E>(exit: Exit.Exit<Response.HttpServerResponse, E>) => Response.HttpServerResponse;

package/dist/unstable/http/HttpServerError.d.ts.map

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

package/dist/unstable/http/HttpServerError.js

@@ -1,4 +1,24 @@
 /**
+ * Error types and response conversion helpers used by the HTTP server runtime.
+ *
+ * This module models the failure cases that can happen around a server request:
+ * malformed or unreadable requests, unmatched routes, unexpected handler
+ * failures, response construction or delivery failures, and lower-level server
+ * implementation failures. These errors keep the relevant request, and for
+ * response failures the response that was being produced, so applications can
+ * report, inspect, or translate failures without losing HTTP context.
+ *
+ * Most users encounter these errors when decoding request bodies, implementing
+ * fallback routes, adding error reporting, or customizing how handler failures
+ * become responses. Request parse errors become `400` responses, missing routes
+ * become `404` responses and are ignored by the error reporter, and internal or
+ * response errors become `500` responses. A `ResponseError` records the response
+ * involved in the failure, but its default conversion intentionally sends an
+ * empty `500` instead of reusing a response that may already be invalid or
+ * partially failed. Handler causes can also contain respondable failures,
+ * response defects, or interrupts; the conversion helpers preserve those
+ * distinctions, including `499` for client aborts and `503` for server aborts.
+ *
  * @since 4.0.0
  */
 import * as Cause from "../../Cause.js";
@@ -13,8 +33,14 @@ import * as Respondable from "./HttpServerRespondable.js";
 import * as Response from "./HttpServerResponse.js";
 const TypeId = "~effect/http/HttpServerError";
 /**
- * @since 4.0.0
+ * Tagged error for failures that occur while handling an HTTP server request.
+ *
+ * It wraps a `HttpServerErrorReason`, exposes the associated request and optional
+ * response, and can be converted to an HTTP response through the `Respondable`
+ * protocol.
+ *
  * @category error
+ * @since 4.0.0
  */
 export class HttpServerError extends /*#__PURE__*/Data.TaggedError("HttpServerError") {
   constructor(props) {
@@ -46,11 +72,17 @@ export class HttpServerError extends /*#__PURE__*/Data.TaggedError("HttpServerEr
   }
 }
 /**
- * @since 4.0.0
+ * Error describing a failure to parse or read an incoming request.
+ *
+ * When converted to a response it produces an empty `400` response.
+ *
  * @category error
+ * @since 4.0.0
  */
 export class RequestParseError extends /*#__PURE__*/Data.TaggedError("RequestParseError") {
   /**
+   * Converts the request error into a `400 Bad Request` response.
+   *
    * @since 4.0.0
    */
   [Respondable.symbol]() {
@@ -66,8 +98,13 @@ export class RequestParseError extends /*#__PURE__*/Data.TaggedError("RequestPar
   }
 }
 /**
- * @since 4.0.0
+ * Error indicating that no route matched the incoming request.
+ *
+ * When converted to a response it produces an empty `404` response, and it is
+ * ignored by the error reporter.
+ *
  * @category error
+ * @since 4.0.0
  */
 export class RouteNotFound extends /*#__PURE__*/Data.TaggedError("RouteNotFound") {
   [Respondable.symbol]() {
@@ -84,11 +121,17 @@ export class RouteNotFound extends /*#__PURE__*/Data.TaggedError("RouteNotFound"
   }
 }
 /**
- * @since 4.0.0
+ * Error describing an unexpected server-side failure while handling a request.
+ *
+ * When converted to a response it produces an empty `500` response.
+ *
  * @category error
+ * @since 4.0.0
  */
 export class InternalError extends /*#__PURE__*/Data.TaggedError("InternalError") {
   /**
+   * Converts the server error into a `500 Internal Server Error` response.
+   *
    * @since 4.0.0
    */
   [Respondable.symbol]() {
@@ -104,13 +147,20 @@ export class InternalError extends /*#__PURE__*/Data.TaggedError("InternalError"
   }
 }
 /**
- * @since 4.0.0
+ * Returns `true` when the supplied value is an `HttpServerError`.
+ *
  * @category predicates
+ * @since 4.0.0
  */
 export const isHttpServerError = u => hasProperty(u, TypeId);
 /**
- * @since 4.0.0
+ * Error describing a failure related to an HTTP response.
+ *
+ * It carries the request and response involved in the failure. When converted to
+ * a response it produces an empty `500` response.
+ *
  * @category error
+ * @since 4.0.0
  */
 export class ResponseError extends /*#__PURE__*/Data.TaggedError("ResponseError") {
   [Respondable.symbol]() {
@@ -127,13 +177,21 @@ export class ResponseError extends /*#__PURE__*/Data.TaggedError("ResponseError"
   }
 }
 /**
- * @since 4.0.0
+ * Error wrapping a low-level failure from the HTTP server implementation.
+ *
  * @category error
+ * @since 4.0.0
  */
 export class ServeError extends /*#__PURE__*/Data.TaggedError("ServeError") {}
 /**
+ * Context annotation used to mark an interrupt as caused by the client aborting
+ * the request.
+ *
+ * `causeResponse` uses this annotation to map a pure client abort to a `499`
+ * response instead of a server abort response.
+ *
+ * @category annotations
  * @since 4.0.0
- * @category Annotations
  */
 export class ClientAbort extends /*#__PURE__*/Context.Service()("effect/http/HttpServerError/ClientAbort") {
   static annotation = /*#__PURE__*/this.context(true).pipe(/*#__PURE__*/Context.add(Cause.StackTrace, {
@@ -147,6 +205,14 @@ const formatRequestMessage = (reason, description, info) => {
   return description ? `${prefix}: ${description}` : prefix;
 };
 /**
+ * Converts a failed handler cause into the HTTP response that should be sent and
+ * the cause that should be reported.
+ *
+ * Respondable failures and defects can choose their own response, defects that
+ * are already `HttpServerResponse` values are used directly, and pure interrupts
+ * produce either `499` for client aborts or `503` for server aborts.
+ *
+ * @category error handling
  * @since 4.0.0
  */
 export const causeResponse = cause => {
@@ -195,6 +261,13 @@ export const causeResponse = cause => {
   });
 };
 /**
+ * Synchronously derives an HTTP response from a failed handler cause.
+ *
+ * If the cause contains a defect that is already an `HttpServerResponse`, that
+ * response is used and removed from the remaining cause. Otherwise the response
+ * defaults to `500`.
+ *
+ * @category error handling
  * @since 4.0.0
  */
 export const causeResponseStripped = cause => {
@@ -219,6 +292,10 @@ const serverAbortError = /*#__PURE__*/Effect.succeed(/*#__PURE__*/Response.empty
   status: 503
 }));
 /**
+ * Extracts the response from a successful handler exit, or derives a response
+ * from the failure cause.
+ *
+ * @category error handling
  * @since 4.0.0
  */
 export const exitResponse = exit => {

package/dist/unstable/http/HttpServerError.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpServerError.js","names":["Cause","Context","Data","Effect","ErrorReporter","constUndefined","Option","hasProperty","Respondable","Response","TypeId","HttpServerError","TaggedError","constructor","props","reason","cause","stack","name","message","request","response","undefined","symbol","ignore","RequestParseError","succeed","empty","status","methodAndUrl","method","url","formatRequestMessage","_tag","description","RouteNotFound","InternalError","isHttpServerError","u","ResponseError","info","ServeError","ClientAbort","Service","annotation","context","pipe","add","StackTrace","parent","prefix","causeResponse","effect","succeedInternalServerError","failures","interrupts","isClientInterrupt","i","reasons","length","toResponseOrElse","error","internalServerError","push","isHttpServerResponse","defect","toResponseOrElseDefect","annotations","has","key","fromReasons","clientAbortError","serverAbortError","mapEager","makeDieReason","causeResponseStripped","filter","f","some","none","exitResponse","exit","value"],"sources":["../../../src/unstable/http/HttpServerError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"HttpServerError.js","names":["Cause","Context","Data","Effect","ErrorReporter","constUndefined","Option","hasProperty","Respondable","Response","TypeId","HttpServerError","TaggedError","constructor","props","reason","cause","stack","name","message","request","response","undefined","symbol","ignore","RequestParseError","succeed","empty","status","methodAndUrl","method","url","formatRequestMessage","_tag","description","RouteNotFound","InternalError","isHttpServerError","u","ResponseError","info","ServeError","ClientAbort","Service","annotation","context","pipe","add","StackTrace","parent","prefix","causeResponse","effect","succeedInternalServerError","failures","interrupts","isClientInterrupt","i","reasons","length","toResponseOrElse","error","internalServerError","push","isHttpServerResponse","defect","toResponseOrElseDefect","annotations","has","key","fromReasons","clientAbortError","serverAbortError","mapEager","makeDieReason","causeResponseStripped","filter","f","some","none","exitResponse","exit","value"],"sources":["../../../src/unstable/http/HttpServerError.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}