effect 4.0.0-beta.31 → 4.0.0-beta.33

package/src/unstable/http/HttpMiddleware.ts

@@ -6,6 +6,7 @@ import * as Effect from "../../Effect.ts"
 import { constant, constFalse } from "../../Function.ts"
 import * as internalEffect from "../../internal/effect.ts"
 import * as Layer from "../../Layer.ts"
+import * as Option from "../../Option.ts"
 import type { Predicate } from "../../Predicate.ts"
 import type { ReadonlyRecord } from "../../Record.ts"
 import { TracerEnabled } from "../../References.ts"
@@ -102,7 +103,7 @@ export const logger: <E, R>(
         } else if (exit._tag === "Failure") {
           const [response, cause] = causeResponseStripped(exit.cause)
           return Effect.andThen(
-            Effect.annotateLogs(Effect.log(cause ?? "Sent HTTP Response"), {
+            Effect.annotateLogs(Effect.log(Option.getOrElse(cause, () => "Sent HTTP Response")), {
               "http.method": request.method,
               "http.url": request.url,
               "http.status": response.status
@@ -139,7 +140,7 @@ export const tracer: <E, R>(
     }
     const nameGenerator = fiber.getRef(SpanNameGenerator)
     const span = internalEffect.makeSpanUnsafe(fiber, nameGenerator(request), {
-      parent: TraceContext.fromHeaders(request.headers),
+      parent: Option.getOrUndefined(TraceContext.fromHeaders(request.headers)),
       kind: "server"
     })
     const prevServices = fiber.services
@@ -147,23 +148,23 @@ export const tracer: <E, R>(
     return Effect.onExitPrimitive(httpApp, (exit) => {
       fiber.setServices(prevServices)
       const endTime = fiber.getRef(Clock).currentTimeNanosUnsafe()
-      fiber.currentScheduler.scheduleTask(() => {
+      fiber.currentDispatcher.scheduleTask(() => {
         const url = Request.toURL(request)
-        if (url !== undefined && (url.username !== "" || url.password !== "")) {
-          url.username = "REDACTED"
-          url.password = "REDACTED"
+        if (Option.isSome(url) && (url.value.username !== "" || url.value.password !== "")) {
+          url.value.username = "REDACTED"
+          url.value.password = "REDACTED"
         }
         const redactedHeaderNames = fiber.getRef(Headers.CurrentRedactedNames)
         const requestHeaders = Headers.redact(request.headers, redactedHeaderNames)
         span.attribute("http.request.method", request.method)
-        if (url !== undefined) {
-          span.attribute("url.full", url.toString())
-          span.attribute("url.path", url.pathname)
-          const query = url.search.slice(1)
+        if (Option.isSome(url)) {
+          span.attribute("url.full", url.value.toString())
+          span.attribute("url.path", url.value.pathname)
+          const query = url.value.search.slice(1)
           if (query !== "") {
-            span.attribute("url.query", url.search.slice(1))
+            span.attribute("url.query", url.value.search.slice(1))
           }
-          span.attribute("url.scheme", url.protocol.slice(0, -1))
+          span.attribute("url.scheme", url.value.protocol.slice(0, -1))
         }
         if (request.headers["user-agent"] !== undefined) {
           span.attribute("user_agent.original", request.headers["user-agent"])
@@ -171,8 +172,8 @@ export const tracer: <E, R>(
         for (const name in requestHeaders) {
           span.attribute(`http.request.header.${name}`, String(requestHeaders[name]))
         }
-        if (request.remoteAddress !== undefined) {
-          span.attribute("client.address", request.remoteAddress)
+        if (Option.isSome(request.remoteAddress)) {
+          span.attribute("client.address", request.remoteAddress.value)
         }
         const response = exitResponse(exit)
         span.attribute("http.response.status_code", response.status)
@@ -200,7 +201,7 @@ export const xForwardedHeaders = make((httpApp) =>
           "host",
           request.headers["x-forwarded-host"]
         ),
-        remoteAddress: request.headers["x-forwarded-for"]?.split(",")[0].trim()
+        remoteAddress: Option.fromNullishOr(request.headers["x-forwarded-for"]?.split(",")[0].trim())
       })
       : request)
 )

package/src/unstable/http/HttpPlatform.ts

@@ -5,6 +5,7 @@ import * as Effect from "../../Effect.ts"
 import * as FileSystem from "../../FileSystem.ts"
 import { identity } from "../../Function.ts"
 import * as Layer from "../../Layer.ts"
+import * as Option from "../../Option.ts"
 import type { PlatformError } from "../../PlatformError.ts"
 import * as ServiceMap from "../../ServiceMap.ts"
 import * as Stream from "../../Stream.ts"
@@ -80,8 +81,8 @@ export const make: (impl: {
         "etag",
         Etag.toString(etag)
       )
-      if (info.mtime) {
-        ;(headers as any)["last-modified"] = info.mtime.toUTCString()
+      if (Option.isSome(info.mtime)) {
+        ;(headers as any)["last-modified"] = info.mtime.value.toUTCString()
       }
       const contentLength = end !== undefined ? end - start : Number(info.size) - start
       return impl.fileResponse(

package/src/unstable/http/HttpRouter.ts

@@ -5,6 +5,7 @@ import * as Arr from "../../Array.ts"
 import * as Effect from "../../Effect.ts"
 import { compose, dual, identity } from "../../Function.ts"
 import * as Layer from "../../Layer.ts"
+import * as Option from "../../Option.ts"
 import type { ReadonlyRecord } from "../../Record.ts"
 import * as Schema from "../../Schema.ts"
 import type { ParseOptions } from "../../SchemaAST.ts"
@@ -12,7 +13,6 @@ import * as Scope from "../../Scope.ts"
 import * as ServiceMap from "../../ServiceMap.ts"
 import * as Tracer from "../../Tracer.ts"
 import type * as Types from "../../Types.ts"
-import * as UndefinedOr from "../../UndefinedOr.ts"
 import * as FindMyWay from "./FindMyWay.ts"
 import * as HttpEffect from "./HttpEffect.ts"
 import type * as HttpMethod from "./HttpMethod.ts"
@@ -177,8 +177,8 @@ export const make = Effect.gen(function*() {
           )
         }
         const route = result.handler
-        if (route.prefix !== undefined) {
-          contextMap.set(HttpServerRequest.HttpServerRequest.key, sliceRequestUrl(request, route.prefix))
+        if (Option.isSome(route.prefix)) {
+          contextMap.set(HttpServerRequest.HttpServerRequest.key, sliceRequestUrl(request, route.prefix.value))
         }
         contextMap.set(HttpServerRequest.ParsedSearchParams.key, result.searchParams)
         contextMap.set(RouteContext.key, {
@@ -501,7 +501,7 @@ export interface Route<E = never, R = never> {
   readonly path: PathInput
   readonly handler: Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>
   readonly uninterruptible: boolean
-  readonly prefix: string | undefined
+  readonly prefix: Option.Option<string>
 }
 
 /**
@@ -527,12 +527,12 @@ const makeRoute = <E, R>(options: {
   readonly path: PathInput
   readonly handler: Effect.Effect<HttpServerResponse.HttpServerResponse, E, R>
   readonly uninterruptible?: boolean | undefined
-  readonly prefix?: string | undefined
+  readonly prefix?: Option.Option<string> | string | undefined
 }): Route<E, Exclude<R, Provided>> =>
   (({
     ...options,
     uninterruptible: options.uninterruptible ?? false,
-    prefix: options.prefix,
+    prefix: typeof options.prefix === "string" ? Option.some(options.prefix) : options.prefix ?? Option.none(),
     [RouteTypeId]: RouteTypeId
   }) as Route<E, Exclude<R, Provided>>)
 
@@ -614,9 +614,9 @@ export const prefixRoute: {
   makeRoute({
     ...self,
     path: prefixPath(self.path, prefix) as PathInput,
-    prefix: UndefinedOr.match(self.prefix, {
-      onUndefined: () => prefix as string,
-      onDefined: (existingPrefix) => prefixPath(existingPrefix, prefix) as string
+    prefix: Option.match(self.prefix, {
+      onNone: () => prefix as string,
+      onSome: (existingPrefix) => prefixPath(existingPrefix, prefix) as string
     })
   }))
 

package/src/unstable/http/HttpServer.ts

@@ -36,6 +36,7 @@ export class HttpServer extends ServiceMap.Service<HttpServer, {
       Exclude<R, HttpServerRequest> | Scope.Scope
     >
   }
+
   readonly address: Address
 }>()("effect/http/HttpServer") {}
 
@@ -127,10 +128,7 @@ export const serve: {
   HttpServer | Exclude<Effect.Services<App>, HttpServerRequest | Scope.Scope>
 > =>
   Layer.effectDiscard(
-    Effect.flatMap(
-      HttpServer.asEffect(),
-      (server) => server.serve(effect, middleware!)
-    )
+    HttpServer.use((server) => server.serve(effect, middleware!))
   ) as any)
 
 /**
@@ -180,11 +178,7 @@ export const serveEffect: {
   void,
   never,
   Scope.Scope | HttpServer | Exclude<Effect.Services<App>, HttpServerRequest>
-> =>
-  Effect.flatMap(
-    HttpServer.asEffect(),
-    (server) => server.serve(effect, middleware!)
-  ) as any)
+> => HttpServer.use((server) => server.serve(effect, middleware!)) as any)
 
 /**
  * @since 4.0.0

package/src/unstable/http/HttpServerError.ts

@@ -7,6 +7,7 @@ import * as Effect from "../../Effect.ts"
 import * as ErrorReporter from "../../ErrorReporter.ts"
 import type * as Exit from "../../Exit.ts"
 import { constUndefined } from "../../Function.ts"
+import * as Option from "../../Option.ts"
 import { hasProperty } from "../../Predicate.ts"
 import * as ServiceMap from "../../ServiceMap.ts"
 import type * as Request from "./HttpServerRequest.ts"
@@ -256,7 +257,7 @@ export const causeResponse = <E>(
  */
 export const causeResponseStripped = <E>(
   cause: Cause.Cause<E>
-): readonly [response: Response.HttpServerResponse, cause: Cause.Cause<E> | undefined] => {
+): readonly [response: Response.HttpServerResponse, cause: Option.Option<Cause.Cause<E>>] => {
   let response: Response.HttpServerResponse | undefined
   const failures = cause.reasons.filter((f) => {
     if (f._tag === "Die" && Response.isHttpServerResponse(f.defect)) {
@@ -267,7 +268,7 @@ export const causeResponseStripped = <E>(
   })
   return [
     response ?? internalServerError,
-    failures.length > 0 ? Cause.fromReasons(failures) : undefined
+    failures.length > 0 ? Option.some(Cause.fromReasons(failures)) : Option.none()
   ]
 }
 

package/src/unstable/http/HttpServerRequest.ts

@@ -6,6 +6,7 @@ import * as Channel from "../../Channel.ts"
 import * as Effect from "../../Effect.ts"
 import type * as FileSystem from "../../FileSystem.ts"
 import * as Inspectable from "../../Inspectable.ts"
+import * as Option from "../../Option.ts"
 import type * as Path from "../../Path.ts"
 import type { ReadonlyRecord } from "../../Record.ts"
 import * as Result from "../../Result.ts"
@@ -64,7 +65,7 @@ export interface HttpServerRequest extends HttpIncomingMessage.HttpIncomingMessa
     options: {
       readonly url?: string
       readonly headers?: Headers.Headers
-      readonly remoteAddress?: string
+      readonly remoteAddress?: Option.Option<string>
     }
   ) => HttpServerRequest
 }
@@ -284,7 +285,10 @@ export const schemaBodyFormJson = <A, I, RD, RE>(
  * @category conversions
  */
 export const fromClientRequest = (request: HttpClientRequest.HttpClientRequest): HttpServerRequest => {
-  const url = HttpClientRequest.toUrl(request)?.toString() ?? request.url
+  const url = Option.match(HttpClientRequest.toUrl(request), {
+    onNone: () => request.url,
+    onSome: (url) => url.toString()
+  })
   return new ClientRequestImpl(request, url)
 }
 
@@ -305,11 +309,11 @@ export const toClientRequest = (request: HttpServerRequest): HttpClientRequest.H
       request.method,
       "",
       UrlParams.empty,
-      undefined,
+      Option.none(),
       request.headers,
       toClientBody(request)
     ),
-    toURL(request) ?? request.url
+    Option.getOrElse(toURL(request), () => request.url)
   )
 
 const toClientBody = (request: HttpServerRequest): HttpBody.HttpBody =>
@@ -343,13 +347,13 @@ class ServerRequestImpl extends Inspectable.Class implements HttpServerRequest {
   readonly source: Request
   readonly url: string
   public headersOverride?: Headers.Headers | undefined
-  private remoteAddressOverride?: string | undefined
+  private remoteAddressOverride?: Option.Option<string> | undefined
 
   constructor(
     source: Request,
     url: string,
     headersOverride?: Headers.Headers,
-    remoteAddressOverride?: string
+    remoteAddressOverride?: Option.Option<string>
   ) {
     super()
     this[TypeId] = TypeId
@@ -370,14 +374,14 @@ class ServerRequestImpl extends Inspectable.Class implements HttpServerRequest {
     options: {
       readonly url?: string | undefined
       readonly headers?: Headers.Headers | undefined
-      readonly remoteAddress?: string | undefined
+      readonly remoteAddress?: Option.Option<string> | undefined
     }
   ) {
     return new ServerRequestImpl(
       this.source,
       options.url ?? this.url,
       options.headers ?? this.headersOverride,
-      options.remoteAddress ?? this.remoteAddressOverride
+      "remoteAddress" in options ? options.remoteAddress : this.remoteAddressOverride
     )
   }
   get method(): HttpMethod {
@@ -386,8 +390,8 @@ class ServerRequestImpl extends Inspectable.Class implements HttpServerRequest {
   get originalUrl() {
     return this.source.url
   }
-  get remoteAddress(): string | undefined {
-    return this.remoteAddressOverride ? this.remoteAddressOverride : undefined
+  get remoteAddress(): Option.Option<string> {
+    return this.remoteAddressOverride ?? Option.none()
   }
   get headers(): Headers.Headers {
     this.headersOverride ??= Headers.fromInput(this.source.headers as any)
@@ -538,7 +542,7 @@ class ClientRequestImpl extends Inspectable.Class implements HttpServerRequest {
   readonly source: HttpClientRequest.HttpClientRequest
   public originalUrl: string
   public headersOverride?: Headers.Headers | undefined
-  private remoteAddressOverride?: string | undefined
+  private remoteAddressOverride?: Option.Option<string> | undefined
   private urlOverride?: string | undefined
 
   constructor(
@@ -546,7 +550,7 @@ class ClientRequestImpl extends Inspectable.Class implements HttpServerRequest {
     originalUrl: string,
     urlOverride?: string,
     headersOverride?: Headers.Headers,
-    remoteAddressOverride?: string
+    remoteAddressOverride?: Option.Option<string>
   ) {
     super()
     this[TypeId] = TypeId
@@ -570,7 +574,7 @@ class ClientRequestImpl extends Inspectable.Class implements HttpServerRequest {
     options: {
       readonly url?: string | undefined
       readonly headers?: Headers.Headers | undefined
-      readonly remoteAddress?: string | undefined
+      readonly remoteAddress?: Option.Option<string> | undefined
     }
   ) {
     return new ClientRequestImpl(
@@ -578,7 +582,7 @@ class ClientRequestImpl extends Inspectable.Class implements HttpServerRequest {
       this.originalUrl,
       options.url ?? this.url,
       options.headers ?? this.headersOverride,
-      options.remoteAddress ?? this.remoteAddressOverride
+      "remoteAddress" in options ? options.remoteAddress : this.remoteAddressOverride
     )
   }
 
@@ -590,8 +594,8 @@ class ClientRequestImpl extends Inspectable.Class implements HttpServerRequest {
     return this.urlOverride ?? removeHost(this.originalUrl)
   }
 
-  get remoteAddress(): string | undefined {
-    return this.remoteAddressOverride ? this.remoteAddressOverride : undefined
+  get remoteAddress(): Option.Option<string> {
+    return this.remoteAddressOverride ?? Option.none()
   }
 
   get headers(): Headers.Headers {
@@ -877,13 +881,13 @@ const textDecoder = new TextDecoder()
  * @since 4.0.0
  * @category conversions
  */
-export const toURL = (self: HttpServerRequest): URL | undefined => {
+export const toURL = (self: HttpServerRequest): Option.Option<URL> => {
   const host = self.headers.host ?? "localhost"
   const protocol = self.headers["x-forwarded-proto"] === "https" ? "https" : "http"
   try {
-    return new URL(self.url, `${protocol}://${host}`)
+    return Option.some(new URL(self.url, `${protocol}://${host}`))
   } catch {
-    return undefined
+    return Option.none()
   }
 }
 
@@ -899,7 +903,7 @@ export const toWebResult = (self: HttpServerRequest, options?: {
     return Result.succeed(self.source)
   }
   const url = toURL(self)
-  if (url === undefined) {
+  if (Option.isNone(url)) {
     return Result.fail(
       new RequestParseError({
         request: self,
@@ -918,7 +922,7 @@ export const toWebResult = (self: HttpServerRequest, options?: {
     requestInit.body = Stream.toReadableStreamWith(self.stream, options?.services ?? ServiceMap.empty())
     ;(requestInit as any).duplex = "half"
   }
-  return Result.succeed(new Request(url, requestInit))
+  return Result.succeed(new Request(url.value, requestInit))
 }
 
 /**

package/src/unstable/http/HttpServerResponse.ts

@@ -7,6 +7,7 @@ import type * as FileSystem from "../../FileSystem.ts"
 import { dual } from "../../Function.ts"
 import * as Inspectable from "../../Inspectable.ts"
 import { PipeInspectableProto } from "../../internal/core.ts"
+import * as Option from "../../Option.ts"
 import { type Pipeable, pipeArguments } from "../../Pipeable.ts"
 import type { PlatformError } from "../../PlatformError.ts"
 import { hasProperty } from "../../Predicate.ts"
@@ -965,8 +966,8 @@ class ServerHttpClientResponse extends Inspectable.Class implements HttpClientRe
     return this.response.cookies
   }
 
-  get remoteAddress(): string | undefined {
-    return undefined
+  get remoteAddress(): Option.Option<string> {
+    return Option.none()
   }
 
   get stream(): Stream.Stream<Uint8Array, HttpClientError.HttpClientError> {
@@ -1137,7 +1138,7 @@ export const fromClientResponse = (
     cookies: response.cookies,
     body: Body.stream(
       Stream.catchIf(response.stream, isEmptyBodyError, () => Stream.empty),
-      Headers.get(headers, "content-type"),
+      Option.getOrUndefined(Headers.get(headers, "content-type")),
       getContentLength(headers)
     )
   })
@@ -1152,7 +1153,7 @@ const isEmptyBodyError = (
   HttpClientError.isHttpClientError(error) && error.reason._tag === "EmptyBodyError"
 
 const getContentLength = (headers: Headers.Headers): number | undefined => {
-  const contentLength = Headers.get(headers, "content-length")
+  const contentLength = Option.getOrUndefined(Headers.get(headers, "content-length"))
   if (contentLength === undefined) {
     return undefined
   }

package/src/unstable/http/HttpTraceContext.ts

@@ -1,6 +1,7 @@
 /**
  * @since 4.0.0
  */
+import * as Option from "../../Option.ts"
 import * as Tracer from "../../Tracer.ts"
 import * as Headers from "./Headers.ts"
 
@@ -9,7 +10,7 @@ import * as Headers from "./Headers.ts"
  * @category models
  */
 export interface FromHeaders {
-  (headers: Headers.Headers): Tracer.ExternalSpan | undefined
+  (headers: Headers.Headers): Option.Option<Tracer.ExternalSpan>
 }
 
 /**
@@ -18,7 +19,12 @@ export interface FromHeaders {
  */
 export const toHeaders = (span: Tracer.Span): Headers.Headers =>
   Headers.fromRecordUnsafe({
-    b3: `${span.traceId}-${span.spanId}-${span.sampled ? "1" : "0"}${span.parent ? `-${span.parent.spanId}` : ""}`,
+    b3: `${span.traceId}-${span.spanId}-${span.sampled ? "1" : "0"}${
+      Option.match(span.parent, {
+        onNone: () => "",
+        onSome: (parent) => `-${parent.spanId}`
+      })
+    }`,
     traceparent: `00-${span.traceId}-${span.spanId}-${span.sampled ? "01" : "00"}`
   })
 
@@ -26,8 +32,16 @@ export const toHeaders = (span: Tracer.Span): Headers.Headers =>
  * @since 4.0.0
  * @category decoding
  */
-export const fromHeaders = (headers: Headers.Headers): Tracer.ExternalSpan | undefined => {
-  return w3c(headers) ?? b3(headers) ?? xb3(headers)
+export const fromHeaders = (headers: Headers.Headers): Option.Option<Tracer.ExternalSpan> => {
+  let span = w3c(headers)
+  if (Option.isSome(span)) {
+    return span
+  }
+  span = b3(headers)
+  if (Option.isSome(span)) {
+    return span
+  }
+  return xb3(headers)
 }
 
 /**
@@ -36,17 +50,17 @@ export const fromHeaders = (headers: Headers.Headers): Tracer.ExternalSpan | und
  */
 export const b3: FromHeaders = (headers) => {
   if (!("b3" in headers)) {
-    return undefined
+    return Option.none()
   }
   const parts = headers["b3"].split("-")
   if (parts.length < 2) {
-    return undefined
+    return Option.none()
   }
-  return Tracer.externalSpan({
+  return Option.some(Tracer.externalSpan({
     traceId: parts[0],
     spanId: parts[1],
     sampled: parts[2] ? parts[2] === "1" : true
-  })
+  }))
 }
 
 /**
@@ -55,13 +69,13 @@ export const b3: FromHeaders = (headers) => {
  */
 export const xb3: FromHeaders = (headers) => {
   if (!(headers["x-b3-traceid"]) || !(headers["x-b3-spanid"])) {
-    return undefined
+    return Option.none()
   }
-  return Tracer.externalSpan({
+  return Option.some(Tracer.externalSpan({
     traceId: headers["x-b3-traceid"],
     spanId: headers["x-b3-spanid"],
     sampled: headers["x-b3-sampled"] ? headers["x-b3-sampled"] === "1" : true
-  })
+  }))
 }
 
 const w3cTraceId = /^[0-9a-f]{32}$/i
@@ -73,26 +87,26 @@ const w3cSpanId = /^[0-9a-f]{16}$/i
  */
 export const w3c: FromHeaders = (headers) => {
   if (!(headers["traceparent"])) {
-    return undefined
+    return Option.none()
   }
   const parts = headers["traceparent"].split("-")
   if (parts.length !== 4) {
-    return undefined
+    return Option.none()
   }
   const [version, traceId, spanId, flags] = parts
   switch (version) {
     case "00": {
       if (w3cTraceId.test(traceId) === false || w3cSpanId.test(spanId) === false) {
-        return undefined
+        return Option.none()
       }
-      return Tracer.externalSpan({
+      return Option.some(Tracer.externalSpan({
         traceId,
         spanId,
         sampled: (parseInt(flags, 16) & 1) === 1
-      })
+      }))
     }
     default: {
-      return undefined
+      return Option.none()
     }
   }
 }

package/src/unstable/http/UrlParams.ts

@@ -19,7 +19,6 @@ import * as Schema from "../../Schema.ts"
 import * as Issue from "../../SchemaIssue.ts"
 import * as Transformation from "../../SchemaTransformation.ts"
 import * as Tuple from "../../Tuple.ts"
-import * as UndefinedOr from "../../UndefinedOr.ts"
 
 const TypeId = "~effect/http/UrlParams"
 
@@ -234,18 +233,17 @@ export const getFirst: {
    * @since 4.0.0
    * @category combinators
    */
-  (key: string): (self: UrlParams) => string | undefined
+  (key: string): (self: UrlParams) => Option.Option<string>
   /**
    * @since 4.0.0
    * @category combinators
    */
-  (self: UrlParams, key: string): string | undefined
+  (self: UrlParams, key: string): Option.Option<string>
 } = dual(
   2,
-  (self: UrlParams, key: string): string | undefined =>
+  (self: UrlParams, key: string): Option.Option<string> =>
     Arr.findFirst(self.params, ([k]) => k === key).pipe(
-      Option.map(([, value]) => value),
-      Option.getOrUndefined
+      Option.map(([, value]) => value)
     )
 )
 
@@ -258,16 +256,15 @@ export const getLast: {
    * @since 4.0.0
    * @category combinators
    */
-  (key: string): (self: UrlParams) => string | undefined
+  (key: string): (self: UrlParams) => Option.Option<string>
   /**
    * @since 4.0.0
    * @category combinators
    */
-  (self: UrlParams, key: string): string | undefined
-} = dual(2, (self: UrlParams, key: string): string | undefined =>
+  (self: UrlParams, key: string): Option.Option<string>
+} = dual(2, (self: UrlParams, key: string): Option.Option<string> =>
   Arr.findLast(self.params, ([k]) => k === key).pipe(
-    Option.map(([, value]) => value),
-    Option.getOrUndefined
+    Option.map(([, value]) => value)
   ))
 
 /**
@@ -537,9 +534,9 @@ export const schemaJsonField = (field: string): schemaJsonField =>
       Schema.UnknownFromJsonString,
       Transformation.transformOrFail({
         decode: (params) =>
-          UndefinedOr.match(getFirst(params, field), {
-            onUndefined: () => Effect.fail(new Issue.Pointer([field], new Issue.MissingKey(undefined))),
-            onDefined: Effect.succeed
+          Option.match(getFirst(params, field), {
+            onNone: () => Effect.fail(new Issue.Pointer([field], new Issue.MissingKey(undefined))),
+            onSome: Effect.succeed
           }),
         encode: (value) => Effect.succeed(make([[field, value]]))
       })

package/src/unstable/httpapi/HttpApiBuilder.ts

@@ -72,10 +72,16 @@ export const layer = <Id extends string, Groups extends HttpApiGroup.Any>(
       | Path
     >()
     const routes: Array<HttpRouter.Route<any, any>> = []
+    const availableGroups = Array.from(services.mapUnsafe.keys()).filter((key) =>
+      key.startsWith("effect/httpapi/HttpApiGroup/")
+    )
     for (const group of Object.values(api.groups)) {
       const groupRoutes = services.mapUnsafe.get(group.key) as Array<HttpRouter.Route<any, any>>
       if (groupRoutes === undefined) {
-        return yield* Effect.die(`HttpApiGroup "${group.key}" not found`)
+        const available = availableGroups.length === 0 ? "none" : availableGroups.join(", ")
+        return yield* Effect.die(
+          `HttpApiGroup "${group.identifier}" not found (key: "${group.key}"). Did you forget to provide HttpApiBuilder.group(api, "${group.identifier}", ...)? Available groups: ${available}`
+        )
       }
       routes.push(...groupRoutes)
     }
@@ -630,13 +636,13 @@ const getRequestMediaType = (request: HttpServerRequest): string => {
 const applyMiddleware = <A extends Effect.Effect<any, any, any>>(
   group: HttpApiGroup.AnyWithProps,
   endpoint: HttpApiEndpoint.AnyWithProps,
-  services: ServiceMap.ServiceMap<never>,
+  services: ServiceMap.ServiceMap<any>,
   handler: A
 ) => {
   const options = { group, endpoint }
   for (const key_ of endpoint.middlewares) {
     const key = key_ as any as HttpApiMiddleware.AnyService
-    const service = services.mapUnsafe.get(key_.key) as HttpApiMiddleware.HttpApiMiddleware<any, any, any>
+    const service = ServiceMap.getUnsafe(services, key as any) as HttpApiMiddleware.HttpApiMiddleware<any, any, any>
     const apply = HttpApiMiddleware.isSecurity(key)
       ? makeSecurityMiddleware(key, service as any)
       : service