effect 4.0.0-beta.74 → 4.0.0-beta.75

package/src/unstable/encoding/Msgpack.ts

@@ -44,8 +44,8 @@ import * as Option from "../../Option.ts"
 import * as Predicate from "../../Predicate.ts"
 import type * as Pull from "../../Pull.ts"
 import * as Schema from "../../Schema.ts"
-import * as Issue from "../../SchemaIssue.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaIssue from "../../SchemaIssue.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 
 const MsgPackErrorTypeId = "~effect/encoding/MsgPack/MsgPackError"
 
@@ -387,16 +387,16 @@ export interface schema<S extends Schema.Top> extends Schema.decodeTo<S, Schema.
  * @category schemas
  * @since 4.0.0
  */
-export const transformation: Transformation.Transformation<
+export const transformation: SchemaTransformation.Transformation<
   unknown,
   Uint8Array<ArrayBuffer>
-> = Transformation.transformOrFail({
+> = SchemaTransformation.transformOrFail({
   decode(e, _options) {
     try {
       return Effect.succeed(Msgpackr.decode(e))
     } catch (cause) {
       return Effect.fail(
-        new Issue.InvalidValue(Option.some(e), {
+        new SchemaIssue.InvalidValue(Option.some(e), {
           message: Predicate.hasProperty(cause, "message") ? String(cause.message) : String(cause)
         })
       )
@@ -407,7 +407,7 @@ export const transformation: Transformation.Transformation<
       return Effect.succeed(Msgpackr.encode(t) as Uint8Array<ArrayBuffer>)
     } catch (cause) {
       return Effect.fail(
-        new Issue.InvalidValue(Option.some(t), {
+        new SchemaIssue.InvalidValue(Option.some(t), {
           message: Predicate.hasProperty(cause, "message") ? String(cause.message) : String(cause)
         })
       )

package/src/unstable/encoding/Ndjson.ts

@@ -170,6 +170,11 @@ export const encodeSchemaString = <S extends Schema.Top>(
 /**
  * Creates a channel that parses NDJSON string chunks into values.
  *
+ * **When to use**
+ *
+ * Use when NDJSON input arrives as string chunks and each complete line should
+ * be parsed into a JSON value.
+ *
  * **Details**
  *
  * Lines may span input chunks.

package/src/unstable/encoding/Sse.ts

@@ -51,7 +51,7 @@ import { hasProperty } from "../../Predicate.ts"
 import * as Pull from "../../Pull.ts"
 import * as Result from "../../Result.ts"
 import * as Schema from "../../Schema.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 
 /**
  * Creates a channel that parses Server-Sent Events text chunks into `Event` values.
@@ -494,7 +494,7 @@ export const Event: Schema.Struct<{
  * @category models
  * @since 4.0.0
  */
-export const transformEvent = Transformation.transform<{
+export const transformEvent = SchemaTransformation.transform<{
   readonly id?: string | undefined
   readonly event: string
   readonly data: string

package/src/unstable/eventlog/EventGroup.ts

@@ -199,7 +199,8 @@ const makeProto = <
  *
  * **When to use**
  *
- * Use when call `.add(...)` to add event definitions and build a typed `EventGroup`.
+ * Use when you need the starting `EventGroup` value before adding event
+ * definitions with `.add(...)`.
  *
  * @category constructors
  * @since 4.0.0

package/src/unstable/eventlog/EventJournal.ts

@@ -188,6 +188,11 @@ export const RemoteId = Schema.Uint8Array.pipe(Schema.brand(RemoteIdTypeId))
 /**
  * Generates a new random `RemoteId`.
  *
+ * **When to use**
+ *
+ * Use when generating a fresh event-log remote id internally and the UUID bytes
+ * are trusted to satisfy the brand.
+ *
  * **Gotchas**
  *
  * This is unsafe because the generated UUID bytes are cast to the brand without
@@ -251,6 +256,11 @@ export const EntryIdOrder = Order.make<EntryId>((a, b) => {
  * Generates a UUID v7 `EntryId`, optionally using the supplied millisecond
  * timestamp.
  *
+ * **When to use**
+ *
+ * Use when generating an event-log entry id internally and the UUID v7 bytes
+ * are trusted to satisfy the brand.
+ *
  * **Gotchas**
  *
  * This is unsafe because the generated UUID bytes are cast to the brand without

package/src/unstable/eventlog/EventLog.ts

@@ -978,9 +978,9 @@ export const layerEventLog: Layer.Layer<EventLog | Registry, never, EventJournal
  *
  * **When to use**
  *
- * Use when an application has an `EventLogSchema` and event-group handler layer
- * and wants one layer that installs the shared `EventLog` runtime and registers
- * the handlers for typed writes.
+ * Use when you need one layer that installs the shared `EventLog` runtime for
+ * an `EventLogSchema` and registers an event-group handler layer for typed
+ * writes.
  *
  * **Details**
  *

package/src/unstable/eventlog/EventLogServerEncrypted.ts

@@ -103,9 +103,8 @@ export const layerRpcHandlers = Layer.unwrap(Effect.gen(function*() {
  *
  * **When to use**
  *
- * Use to expose the encrypted event-log RPC server when you already have an
- * `RpcServer.Protocol` and want clients using encrypted `EventLogRemote`
- * replication to synchronize through server-side `Storage`.
+ * Use when you need an encrypted event-log RPC server for encrypted
+ * `EventLogRemote` replication over an existing `RpcServer.Protocol`.
  *
  * **Details**
  *

package/src/unstable/eventlog/EventLogServerUnencrypted.ts

@@ -702,9 +702,8 @@ export const layerStorageMemory: Layer.Layer<Storage> = Layer.effect(Storage)(ma
  *
  * **When to use**
  *
- * Use to construct the unencrypted event-log server service directly when you
- * already provide `Storage` and an event-log `Registry` and want to supply the
- * service yourself.
+ * Use when you need the unencrypted event-log server service from provided
+ * `Storage` and an event-log `Registry`.
  *
  * **Details**
  *
@@ -806,10 +805,9 @@ export const layerServer: Layer.Layer<
  *
  * **When to use**
  *
- * Use when you need a complete unencrypted event-log RPC endpoint for a trusted
- * deployment, local development, tests, or a server-side event source, and you
- * can provide storage, store mapping, authorization, an RPC protocol, and the
- * event-group handler layer.
+ * Use when you need the full unencrypted event-log RPC server layer with
+ * storage, authorization, RPC protocol, and event-group handler dependencies
+ * supplied externally.
  *
  * **Details**
  *

package/src/unstable/eventlog/EventLogSessionAuth.ts

@@ -65,8 +65,8 @@ export const AuthPayloadContext = "eventlog-auth-v1"
  *
  * **When to use**
  *
- * Use when you need to validate the byte length of raw Ed25519 public keys for
- * session authentication.
+ * Use when implementing session-auth serialization or validation that must
+ * reject public keys with a non-canonical raw byte length.
  *
  * @category constants
  * @since 4.0.0
@@ -78,8 +78,8 @@ export const Ed25519PublicKeyLength = 32
  *
  * **When to use**
  *
- * Use when you need to validate the byte length of Ed25519 signatures for
- * session authentication.
+ * Use when implementing session-auth verification that must reject signatures
+ * with a non-canonical byte length before cryptographic checking.
  *
  * @category constants
  * @since 4.0.0

package/src/unstable/http/Cookies.ts

@@ -71,7 +71,7 @@ import * as Predicate from "../../Predicate.ts"
 import * as Record from "../../Record.ts"
 import * as Result from "../../Result.ts"
 import * as Schema from "../../Schema.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import type * as Types from "../../Types.ts"
 
 const TypeId = "~effect/http/Cookies"
@@ -130,7 +130,7 @@ export const CookiesSchema: CookiesSchema = Schema.declare(
     toCodecJson: () =>
       Schema.link<Cookies>()(
         Schema.Array(Schema.String),
-        Transformation.transform({
+        SchemaTransformation.transform({
           decode: (input) => fromSetCookie(input),
           encode: (cookies) => toSetCookieHeaders(cookies)
         })
@@ -138,7 +138,7 @@ export const CookiesSchema: CookiesSchema = Schema.declare(
     toCodecIso: () =>
       Schema.link<Cookies>()(
         Schema.Record(Schema.String, CookieSchema),
-        Transformation.transform({
+        SchemaTransformation.transform({
           decode: (input) => fromReadonlyRecord(input),
           encode: (cookies) => cookies.cookies
         })
@@ -1095,7 +1095,7 @@ export const toRecord = (self: Cookies): Record<string, string> => {
 export const schemaRecord = CookiesSchema.pipe(
   Schema.decodeTo(
     Schema.Record(Schema.String, Schema.String),
-    Transformation.transform({
+    SchemaTransformation.transform({
       decode: toRecord,
       encode: (self) => fromIterable(Object.entries(self).map(([name, value]) => makeCookieUnsafe(name, value)))
     })

package/src/unstable/http/Etag.ts

@@ -119,9 +119,8 @@ const fromFileWeb = (file: Body.HttpBody.FileLike) => {
  *
  * **When to use**
  *
- * Use when file size and modification time reliably change for every byte-level
- * change and the consuming HTTP code needs strong ETags from the `Generator`
- * service.
+ * Use when you need the `Generator` service to produce strong ETags and file
+ * size plus modification time reliably change for every byte-level change.
  *
  * **Gotchas**
  *

package/src/unstable/http/Headers.ts

@@ -66,7 +66,7 @@ import * as Record from "../../Record.ts"
 import * as Redactable from "../../Redactable.ts"
 import * as Redacted from "../../Redacted.ts"
 import * as Schema from "../../Schema.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import type { Mutable } from "../../Types.ts"
 
 /**
@@ -189,7 +189,7 @@ export const HeadersSchema: HeadersSchema = Schema.declare(
     toCodec: () =>
       Schema.link<Headers>()(
         Schema.Record(Schema.String, Schema.String),
-        Transformation.transform({
+        SchemaTransformation.transform({
           decode: (input) => fromInput(input),
           encode: (headers) => ({ ...headers })
         })

package/src/unstable/http/HttpBody.ts

@@ -65,7 +65,7 @@ import * as Predicate from "../../Predicate.ts"
 import * as Schema from "../../Schema.ts"
 import type { ParseOptions } from "../../SchemaAST.ts"
 import type { Issue } from "../../SchemaIssue.ts"
-import * as Parser from "../../SchemaParser.ts"
+import * as SchemaParser from "../../SchemaParser.ts"
 import type * as Stream_ from "../../Stream.ts"
 import * as UrlParams from "./UrlParams.ts"
 
@@ -365,7 +365,7 @@ export const jsonSchema = <S extends Schema.Top>(
   schema: S,
   options?: ParseOptions | undefined
 ) => {
-  const encode = Parser.encodeUnknownEffect(Schema.toCodecJson(schema))
+  const encode = SchemaParser.encodeUnknownEffect(Schema.toCodecJson(schema))
   return (body: S["Type"], contentType?: string): Effect.Effect<Uint8Array, HttpBodyError, S["EncodingServices"]> =>
     encode(body, options).pipe(
       Effect.mapError((issue) => new HttpBodyError({ reason: { _tag: "SchemaError", issue }, cause: issue })),

package/src/unstable/http/HttpClient.ts

@@ -165,8 +165,8 @@ export declare namespace HttpClient {
  *
  * **When to use**
  *
- * Use to provide the HTTP client implementation consumed by the module's
- * request accessor functions.
+ * Use to provide the default outgoing HTTP client service used by request
+ * accessors such as `execute`, `get`, and `post`.
  *
  * @category services
  * @since 4.0.0

package/src/unstable/http/HttpClientRequest.ts

@@ -950,21 +950,48 @@ export const bodyJson: {
 )
 
 /**
- * Sets a JSON request body using unsafe JSON encoding, which may throw instead of failing in the Effect error channel.
+ * Sets a JSON request body using unsafe JSON encoding.
+ *
+ * **When to use**
+ *
+ * Use when the request body is known to be JSON-serializable and a synchronous
+ * `HttpClientRequest` result is needed.
+ *
+ * **Gotchas**
+ *
+ * JSON encoding may throw instead of failing in the Effect error channel.
  *
  * @category combinators
  * @since 4.0.0
  */
 export const bodyJsonUnsafe: {
   /**
-   * Sets a JSON request body using unsafe JSON encoding, which may throw instead of failing in the Effect error channel.
+   * Sets a JSON request body using unsafe JSON encoding.
+   *
+   * **When to use**
+   *
+   * Use when the request body is known to be JSON-serializable and a synchronous
+   * `HttpClientRequest` result is needed.
+   *
+   * **Gotchas**
+   *
+   * JSON encoding may throw instead of failing in the Effect error channel.
    *
    * @category combinators
    * @since 4.0.0
    */
   (body: unknown): (self: HttpClientRequest) => HttpClientRequest
   /**
-   * Sets a JSON request body using unsafe JSON encoding, which may throw instead of failing in the Effect error channel.
+   * Sets a JSON request body using unsafe JSON encoding.
+   *
+   * **When to use**
+   *
+   * Use when the request body is known to be JSON-serializable and a synchronous
+   * `HttpClientRequest` result is needed.
+   *
+   * **Gotchas**
+   *
+   * JSON encoding may throw instead of failing in the Effect error channel.
    *
    * @category combinators
    * @since 4.0.0

package/src/unstable/http/HttpRouter.ts

@@ -475,7 +475,7 @@ export const schemaPathParams = <A, I extends Readonly<Record<string, string | u
  *
  * **When to use**
  *
- * Use when you use it to register routes or middleware with the router during layer
+ * Use when you need to register routes or middleware with the router during layer
  * construction.
  *
  * **Example** (Registering routes during layer construction)

package/src/unstable/http/HttpServerResponse.ts

@@ -391,6 +391,11 @@ export const schemaJson = <A, I, RD, RE>(
 /**
  * Creates a JSON HTTP response synchronously.
  *
+ * **When to use**
+ *
+ * Use when the response body is known to be JSON-serializable and you need a
+ * synchronous `HttpServerResponse`.
+ *
  * **Gotchas**
  *
  * Unlike `json`, serialization errors from `JSON.stringify` are not captured in
@@ -442,8 +447,8 @@ export const urlParams = (
  *
  * **When to use**
  *
- * Use when the underlying runtime already understands the body value, such
- * as a Web `Response`, `Blob`, or `ReadableStream`; the body is passed through
+ * Use when you want to pass through a body value already understood by the
+ * underlying runtime, such as a Web `Response`, `Blob`, or `ReadableStream`,
  * for later platform conversion.
  *
  * @category constructors
@@ -809,8 +814,8 @@ export const expireCookie: {
  *
  * **When to use**
  *
- * Use when setting one trusted cookie and encoding failures should throw
- * instead of being represented as `CookiesError` failures.
+ * Use when you need to set one trusted cookie and want encoding failures to
+ * throw instead of being represented as `CookiesError` failures.
  *
  * @category combinators
  * @since 4.0.0
@@ -822,8 +827,8 @@ export const setCookieUnsafe: {
    *
    * **When to use**
    *
-   * Use when setting one trusted cookie and encoding failures should throw
-   * instead of being represented as `CookiesError` failures.
+   * Use when you need to set one trusted cookie and want encoding failures to
+   * throw instead of being represented as `CookiesError` failures.
    *
    * @category combinators
    * @since 4.0.0
@@ -835,8 +840,8 @@ export const setCookieUnsafe: {
    *
    * **When to use**
    *
-   * Use when setting one trusted cookie and encoding failures should throw
-   * instead of being represented as `CookiesError` failures.
+   * Use when you need to set one trusted cookie and want encoding failures to
+   * throw instead of being represented as `CookiesError` failures.
    *
    * @category combinators
    * @since 4.0.0
@@ -867,8 +872,8 @@ export const setCookieUnsafe: {
  *
  * **When to use**
  *
- * Use when expiring one trusted cookie and encoding failures should throw
- * instead of being represented as `CookiesError` failures.
+ * Use when you need to expire one trusted cookie and want encoding failures to
+ * throw instead of being represented as `CookiesError` failures.
  *
  * @category combinators
  * @since 4.0.0
@@ -880,8 +885,8 @@ export const expireCookieUnsafe: {
    *
    * **When to use**
    *
-   * Use when expiring one trusted cookie and encoding failures should throw
-   * instead of being represented as `CookiesError` failures.
+   * Use when you need to expire one trusted cookie and want encoding failures to
+   * throw instead of being represented as `CookiesError` failures.
    *
    * @category combinators
    * @since 4.0.0
@@ -896,8 +901,8 @@ export const expireCookieUnsafe: {
    *
    * **When to use**
    *
-   * Use when expiring one trusted cookie and encoding failures should throw
-   * instead of being represented as `CookiesError` failures.
+   * Use when you need to expire one trusted cookie and want encoding failures to
+   * throw instead of being represented as `CookiesError` failures.
    *
    * @category combinators
    * @since 4.0.0
@@ -1096,8 +1101,8 @@ export const setCookies: {
  *
  * **When to use**
  *
- * Use when setting multiple trusted cookies and encoding failures should throw
- * instead of being represented as `CookiesError` failures.
+ * Use when you need to set multiple trusted cookies and want encoding failures
+ * to throw instead of being represented as `CookiesError` failures.
  *
  * @category combinators
  * @since 4.0.0
@@ -1109,8 +1114,8 @@ export const setCookiesUnsafe: {
    *
    * **When to use**
    *
-   * Use when setting multiple trusted cookies and encoding failures should throw
-   * instead of being represented as `CookiesError` failures.
+   * Use when you need to set multiple trusted cookies and want encoding failures
+   * to throw instead of being represented as `CookiesError` failures.
    *
    * @category combinators
    * @since 4.0.0
@@ -1130,8 +1135,8 @@ export const setCookiesUnsafe: {
    *
    * **When to use**
    *
-   * Use when setting multiple trusted cookies and encoding failures should throw
-   * instead of being represented as `CookiesError` failures.
+   * Use when you need to set multiple trusted cookies and want encoding failures
+   * to throw instead of being represented as `CookiesError` failures.
    *
    * @category combinators
    * @since 4.0.0

package/src/unstable/http/Multipart.ts

@@ -55,7 +55,7 @@ import * as Predicate from "../../Predicate.ts"
 import * as Pull from "../../Pull.ts"
 import * as Schema from "../../Schema.ts"
 import type { ParseOptions } from "../../SchemaAST.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import type * as Scope from "../../Scope.ts"
 import * as Stream from "../../Stream.ts"
 import * as UndefinedOr from "../../UndefinedOr.ts"
@@ -306,7 +306,7 @@ export const PersistedFileSchema: PersistedFileSchema = Schema.declare(
           contentType: Schema.String.annotate({ contentEncoding: "binary" }),
           path: Schema.String
         }),
-        Transformation.transform({
+        SchemaTransformation.transform({
           decode: ({ contentType, key, name, path }) => new PersistedFileImpl(key, name, contentType, path),
           encode: (file) => ({
             key: file.key,
@@ -344,7 +344,7 @@ export const SingleFileSchema: Schema.decodeTo<PersistedFileSchema, Schema.$Arra
   ).pipe(
     Schema.decodeTo(
       PersistedFileSchema,
-      Transformation.transform({
+      SchemaTransformation.transform({
         decode: ([file]) => file,
         encode: (file) => [file]
       })

package/src/unstable/http/UrlParams.ts

@@ -51,8 +51,8 @@ import { hasProperty } from "../../Predicate.ts"
 import type { ReadonlyRecord } from "../../Record.ts"
 import * as Result from "../../Result.ts"
 import * as Schema from "../../Schema.ts"
-import * as Issue from "../../SchemaIssue.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaIssue from "../../SchemaIssue.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import * as Tuple from "../../Tuple.ts"
 
 const TypeId = "~effect/http/UrlParams"
@@ -276,7 +276,7 @@ export const UrlParamsSchema: UrlParamsSchema = Schema.declare(
     toCodec: () =>
       Schema.link<UrlParams>()(
         Schema.Array(Schema.Tuple([Schema.String, Schema.String])),
-        Transformation.transform({
+        SchemaTransformation.transform({
           decode: make,
           encode: (self) => self.params
         })
@@ -339,6 +339,11 @@ export const getAll: {
 /**
  * Returns the first value for a query parameter key safely.
  *
+ * **When to use**
+ *
+ * Use when duplicate query parameters are ordered and the first occurrence has
+ * precedence.
+ *
  * **Details**
  *
  * Returns `Option.none` when the key is absent.
@@ -350,6 +355,11 @@ export const getFirst: {
   /**
    * Returns the first value for a query parameter key safely.
    *
+   * **When to use**
+   *
+   * Use when duplicate query parameters are ordered and the first occurrence has
+   * precedence.
+   *
    * **Details**
    *
    * Returns `Option.none` when the key is absent.
@@ -361,6 +371,11 @@ export const getFirst: {
   /**
    * Returns the first value for a query parameter key safely.
    *
+   * **When to use**
+   *
+   * Use when duplicate query parameters are ordered and the first occurrence has
+   * precedence.
+   *
    * **Details**
    *
    * Returns `Option.none` when the key is absent.
@@ -380,6 +395,11 @@ export const getFirst: {
 /**
  * Returns the last value for a query parameter key safely.
  *
+ * **When to use**
+ *
+ * Use when duplicate query parameters are ordered and the last occurrence has
+ * precedence.
+ *
  * **Details**
  *
  * Returns `Option.none` when the key is absent.
@@ -391,6 +411,11 @@ export const getLast: {
   /**
    * Returns the last value for a query parameter key safely.
    *
+   * **When to use**
+   *
+   * Use when duplicate query parameters are ordered and the last occurrence has
+   * precedence.
+   *
    * **Details**
    *
    * Returns `Option.none` when the key is absent.
@@ -402,6 +427,11 @@ export const getLast: {
   /**
    * Returns the last value for a query parameter key safely.
    *
+   * **When to use**
+   *
+   * Use when duplicate query parameters are ordered and the last occurrence has
+   * precedence.
+   *
    * **Details**
    *
    * Returns `Option.none` when the key is absent.
@@ -792,10 +822,10 @@ export const schemaJsonField = (field: string): schemaJsonField =>
   UrlParamsSchema.pipe(
     Schema.decodeTo(
       Schema.UnknownFromJsonString,
-      Transformation.transformOrFail({
+      SchemaTransformation.transformOrFail({
         decode: (params) =>
           Option.match(getFirst(params, field), {
-            onNone: () => Effect.fail(new Issue.Pointer([field], new Issue.MissingKey(undefined))),
+            onNone: () => Effect.fail(new SchemaIssue.Pointer([field], new SchemaIssue.MissingKey(undefined))),
             onSome: Effect.succeed
           }),
         encode: (value) => Effect.succeed(make([[field, value]]))
@@ -856,7 +886,7 @@ export const schemaRecord: schemaRecord = UrlParamsSchema.pipe(
       Schema.String,
       Schema.Union([Schema.String, Schema.NonEmptyArray(Schema.String)])
     ),
-    Transformation.transform({
+    SchemaTransformation.transform({
       decode: toReadonlyRecord,
       encode: fromInput
     })

package/src/unstable/httpapi/HttpApi.ts

@@ -54,7 +54,7 @@ import { type Pipeable, pipeArguments } from "../../Pipeable.ts"
 import * as Predicate from "../../Predicate.ts"
 import * as Record from "../../Record.ts"
 import type * as Schema from "../../Schema.ts"
-import type * as AST from "../../SchemaAST.ts"
+import type * as SchemaAST from "../../SchemaAST.ts"
 import type { Mutable } from "../../Types.ts"
 import type { PathInput } from "../http/HttpRouter.ts"
 import * as HttpApiEndpoint from "./HttpApiEndpoint.ts"
@@ -236,8 +236,9 @@ const makeProto = <Id extends string, Groups extends HttpApiGroup.Any>(
  *
  * **When to use**
  *
- * Use when add groups with `add` or `addHttpApi`, provide endpoint implementations with
- * `HttpApiBuilder.group`, and register the API with `HttpApiBuilder.layer`.
+ * Use when you need to start defining an HTTP API, add groups with `add` or
+ * `addHttpApi`, provide endpoint implementations with `HttpApiBuilder.group`,
+ * and register the API with `HttpApiBuilder.layer`.
  *
  * @category constructors
  * @since 4.0.0
@@ -321,7 +322,7 @@ export const reflect = <Id extends string, Groups extends HttpApiGroup.Any>(
 
 const extractResponseContent = (
   schemas: Array<Schema.Top>,
-  getStatus: (ast: AST.AST) => number
+  getStatus: (ast: SchemaAST.AST) => number
 ): ReadonlyMap<number, [Schema.Top, ...Array<Schema.Top>]> => {
   const map = new Map<number, [Schema.Top, ...Array<Schema.Top>]>()