effect 4.0.5 → 4.0.7

package/dist/http-api/HttpApiSchema.d.ts

@@ -10,12 +10,15 @@
  * @stability unstable
  * @since 4.0.0
  */
+import * as Arr from "../Array.ts";
+import * as ByteSize from "../ByteSize.ts";
 import * as Sse from "../encoding/Sse.ts";
 import { type LazyArg } from "../Function.ts";
 import * as HttpStatus from "../http/HttpStatus.ts";
 import type * as Multipart_ from "../http/Multipart.ts";
 import * as Schema from "../Schema.ts";
 import * as SchemaAST from "../SchemaAST.ts";
+import * as Socket from "../socket/Socket.ts";
 import * as Stream from "../Stream.ts";
 declare module "../Schema.ts" {
     namespace Annotations {
@@ -73,9 +76,15 @@ export type StatusLiteral = HttpStatus.Literal;
  *
  * **Details**
  *
- * This is equivalent to calling `.annotate({ httpApiStatus: code })` on the
- * schema. You can pass either a numeric status code (for example, `201`) or a
- * common literal name (for example, `"Created"`).
+ * Stores the status with `.annotateKey({ httpApiStatus: code })` unless the
+ * schema or any of its checks already has an ordinary `httpApiStatus`
+ * annotation, including an explicit `undefined`. In that case, uses
+ * `.annotate({ httpApiStatus: code })` instead.
+ *
+ * Ordinary status annotations take precedence over key annotations. Checks
+ * without a status annotation preserve the existing status. You can pass
+ * either a numeric code (for example, `201`) or a common literal name
+ * (for example, `"Created"`).
  *
  * @stability unstable
  * @category schemas
@@ -207,6 +216,9 @@ export type StreamSseMode = "events" | "data";
  * application event. Endpoint construction rejects event schemas that declare
  * the reserved name statically.
  *
+ * `StreamSse` is response-only. The `payload` slot's type excludes it, and
+ * endpoint construction rejects it.
+ *
  * @stability unstable
  * @category models
  * @since 4.0.0
@@ -225,6 +237,7 @@ export interface StreamSse<Events extends Sse.EventCodec, Error extends Schema.C
     readonly mode: "sse";
     readonly sseMode: StreamSseMode;
     readonly contentType: string;
+    readonly contentTypes: Arr.NonEmptyReadonlyArray<string>;
     readonly events: Events;
     readonly error: Error;
     readonly "~Value"?: Value | undefined;
@@ -247,13 +260,14 @@ export interface SseEventFromData<Data extends Schema.Constraint> extends Schema
 }, Data["DecodingServices"], Data["EncodingServices"]> {
 }
 /**
- * Schema for a streaming `Uint8Array` success response.
+ * Schema for a streaming `Uint8Array` body.
  *
  * **Details**
  *
- * This declaration stores the response content type for later endpoint,
- * server, client, and OpenAPI integrations. It is intentionally separate from
- * the buffered `asUint8Array` response encoding.
+ * It works as a success response or as a request payload. It is intentionally
+ * separate from the buffered `asUint8Array` encoding. As a payload, the handler
+ * receives the body as it is read, and `maxBytes` caps the bytes read. It has
+ * no default and does not fall back to `MaxBodySize`.
  *
  * @stability unstable
  * @category models
@@ -265,18 +279,78 @@ export interface StreamUint8Array extends Schema.Bottom<Stream.Stream<Uint8Array
     readonly _tag: "StreamUint8Array";
     readonly mode: "uint8array";
     readonly contentType: string;
+    readonly contentTypes: Arr.NonEmptyReadonlyArray<string>;
+    readonly maxBytes: ByteSize.ByteSize | undefined;
 }
 /**
- * Schema for a streaming HTTP API success response.
+ * Schema for a stream of newline-delimited JSON elements.
+ *
+ * **Details**
+ *
+ * Each element is encoded as one line of JSON followed by `\n`, including the
+ * last. When decoding, `\n`, `\r\n` and a bare `\r` end a line, empty lines are
+ * skipped, a leading BOM is stripped and invalid UTF-8 fails. The first
+ * malformed line or element that fails to decode ends the stream, after every
+ * element before it has been delivered. A missing final newline is accepted if
+ * the last line parses.
+ *
+ * `maxElementBytes` caps the UTF-8 bytes of one line, without its terminator.
+ * `maxBytes` caps the whole body and has no default.
+ *
+ * As a request payload, the handler receives the elements as the body is
+ * read. Malformed lines and elements that fail to decode are an
+ * `HttpApiSchemaError`, and limit breaches are an `HttpApiPayloadTooLarge`.
+ *
+ * **Gotchas**
+ *
+ * There is no `error` schema. A failure mid-stream aborts the connection, so
+ * the reader sees a body read error, never a clean end. Typed failures
+ * mid-stream are a {@link StreamSse} feature. A body cut cleanly at a line
+ * boundary can't be told apart from a complete one.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.0.6
+ */
+export interface StreamNdjson<S extends Schema.Constraint> extends Schema.BottomLazy<SchemaAST.Declaration, StreamNdjson<S>> {
+    readonly "Type": Stream.Stream<S["Type"], unknown, never>;
+    readonly "Encoded": Stream.Stream<S["Type"], unknown, never>;
+    readonly "DecodingServices": S["DecodingServices"];
+    readonly "EncodingServices": S["EncodingServices"];
+    readonly "Rebuild": StreamNdjson<S>;
+    readonly "~type.make.in": Stream.Stream<S["Type"], unknown, never>;
+    readonly "~type.make": Stream.Stream<S["Type"], unknown, never>;
+    readonly "Iso": Stream.Stream<S["Type"], unknown, never>;
+    readonly [StreamSchemaTypeId]: typeof StreamSchemaTypeId;
+    readonly _tag: "StreamNdjson";
+    readonly mode: "ndjson";
+    readonly contentType: string;
+    readonly contentTypes: Arr.NonEmptyReadonlyArray<string>;
+    readonly schema: S;
+    readonly maxBytes: ByteSize.ByteSize | undefined;
+    readonly maxElementBytes: ByteSize.ByteSize;
+}
+/**
+ * Schema for a streaming HTTP API body.
+ *
+ * **Details**
+ *
+ * {@link StreamUint8Array} and {@link StreamNdjson} describe the body in either
+ * direction, with the endpoint slot deciding which. {@link StreamSse} is for
+ * success responses only.
  *
  * @stability unstable
  * @category models
  * @since 4.0.0
  */
-export type StreamSchema = StreamSse<Sse.EventCodec, Schema.Top, unknown> | StreamUint8Array;
+export type StreamSchema = StreamSse<Sse.EventCodec, Schema.Top, unknown> | StreamUint8Array | StreamNdjson<Schema.Top>;
 /**
  * Creates a Server-Sent Events streaming success response schema.
  *
+ * **Details**
+ *
+ * `StreamSse` is response-only. Endpoint construction rejects it in `payload`.
+ *
  * @stability unstable
  * @category constructors
  * @since 4.0.0
@@ -285,6 +359,10 @@ export declare const StreamSse: {
     /**
      * Creates a Server-Sent Events streaming success response schema.
      *
+     * **Details**
+     *
+     * `StreamSse` is response-only. Endpoint construction rejects it in `payload`.
+     *
      * @stability unstable
      * @category constructors
      * @since 4.0.0
@@ -297,6 +375,10 @@ export declare const StreamSse: {
     /**
      * Creates a Server-Sent Events streaming success response schema.
      *
+     * **Details**
+     *
+     * `StreamSse` is response-only. Endpoint construction rejects it in `payload`.
+     *
      * @stability unstable
      * @category constructors
      * @since 4.0.0
@@ -308,15 +390,156 @@ export declare const StreamSse: {
     }): StreamSse<SseEventFromData<Data>, Error, Data["Type"]>;
 };
 /**
- * Creates a streaming `Uint8Array` success response schema.
+ * Creates a streaming `Uint8Array` body schema.
+ *
+ * **Details**
+ *
+ * `contentType` defaults to `application/octet-stream`. Pass a list when the
+ * same stream is sent under several media types. The first entry is the
+ * default response type, and payloads are accepted under every entry.
+ * `maxBytes` only applies to request payloads and has no default.
  *
  * @stability unstable
  * @category constructors
  * @since 4.0.0
  */
 export declare const StreamUint8Array: (options?: {
-    readonly contentType?: string | undefined;
+    readonly contentType?: string | ReadonlyArray<string> | undefined;
+    readonly maxBytes?: ByteSize.Input | undefined;
 }) => StreamUint8Array;
+/**
+ * Creates a schema for a stream of newline-delimited JSON elements.
+ *
+ * **Details**
+ *
+ * `contentType` defaults to `application/x-ndjson` and `maxElementBytes` to 1
+ * MiB. `maxBytes` has no default. Pass a list of content types to accept
+ * aliases such as `application/jsonl`. The first entry is the default.
+ *
+ * **Example** (Declaring an NDJSON request payload)
+ *
+ * ```ts import.meta.vitest
+ * import { Schema } from "effect"
+ * import { HttpApiEndpoint, HttpApiSchema } from "effect/http-api"
+ *
+ * const Event = Schema.Struct({ id: Schema.Number })
+ * const payload = HttpApiSchema.StreamNdjson({ schema: Event, maxBytes: "100 MiB" })
+ *
+ * // The handler receives a Stream of Events
+ * const importEvents = HttpApiEndpoint.post("importEvents", "/events", {
+ *   payload,
+ *   success: Schema.Number
+ * })
+ *
+ * importEvents.path // => "/events"
+ * payload.contentType // => "application/x-ndjson"
+ * payload.maxElementBytes // => 1048576n
+ * ```
+ *
+ * @stability unstable
+ * @category constructors
+ * @since 4.0.6
+ */
+export declare const StreamNdjson: <S extends Schema.Constraint>(options: {
+    readonly schema: S;
+    readonly contentType?: string | ReadonlyArray<string> | undefined;
+    readonly maxBytes?: ByteSize.Input | undefined;
+    readonly maxElementBytes?: ByteSize.Input | undefined;
+}) => StreamNdjson<S>;
+declare const UpgradeTypeId = "~effect/http-api/HttpApiSchema/Upgrade";
+/**
+ * Schema for a success response that switches the connection to another
+ * protocol with an HTTP/1.1 upgrade.
+ *
+ * **Details**
+ *
+ * Created with {@link Upgrade}. The response is `101 Switching Protocols`, and
+ * the connection then carries raw bytes in both directions as a `Socket`.
+ * `Headers` is the schema of the custom `101` headers, or `never` when the
+ * upgrade declares none.
+ *
+ * @stability unstable
+ * @category models
+ * @since 4.0.6
+ */
+export interface Upgrade<Headers extends Schema.Top = Schema.Top> extends Schema.Bottom<Socket.Socket, Socket.Socket, never, never, SchemaAST.Declaration, Upgrade<Headers>> {
+    readonly "Rebuild": Upgrade<Headers>;
+    readonly [UpgradeTypeId]: typeof UpgradeTypeId;
+    readonly protocol: string;
+    readonly headers: Headers | undefined;
+}
+/**
+ * Declares an endpoint success that upgrades the connection to `protocol`,
+ * such as Docker's `tcp` for container attach.
+ *
+ * **When to use**
+ *
+ * Use as the only success schema of an endpoint that hands over its
+ * connection as a raw byte stream after `101 Switching Protocols`. For
+ * WebSocket, upgrade the request with `HttpServerRequest.upgrade` and
+ * connect with `Socket.makeWebSocket` instead.
+ *
+ * **Details**
+ *
+ * The handler receives an `upgrade` function that returns the connection.
+ * The `101` response is sent when the handler acquires the socket's reader,
+ * so a handler can still fail with a declared error before then. Requests
+ * that do not ask for `protocol` get `426 Upgrade Required`.
+ *
+ * `headers` declares custom `101` response headers, encoded like
+ * `WithHeaders` headers. The handler passes them to `upgrade`, so they can
+ * depend on the decoded request. `Connection`, `Upgrade`, `Content-Length`
+ * and `Transfer-Encoding` cannot be set.
+ *
+ * The endpoint may declare a buffered payload, which is decoded before the
+ * handler runs. Streaming payloads are rejected.
+ *
+ * The client sends `Connection: Upgrade` and `Upgrade: protocol`, and returns
+ * the response headers with the connection, decoded with `headers` when
+ * declared. Other responses are decoded as the endpoint's errors.
+ *
+ * **Example** (Declaring an exec start endpoint)
+ *
+ * ```ts
+ * import { Schema } from "effect"
+ * import { HttpApiEndpoint, HttpApiSchema } from "effect/http-api"
+ *
+ * const start = HttpApiEndpoint.post("start", "/exec/:id/start", {
+ *   params: { id: Schema.String },
+ *   payload: Schema.Struct({ Detach: Schema.Boolean, Tty: Schema.Boolean }),
+ *   success: HttpApiSchema.Upgrade({
+ *     protocol: "tcp",
+ *     headers: {
+ *       "content-type": Schema.Literals([
+ *         "application/vnd.docker.raw-stream",
+ *         "application/vnd.docker.multiplexed-stream"
+ *       ])
+ *     }
+ *   })
+ * })
+ * ```
+ *
+ * @stability unstable
+ * @category constructors
+ * @since 4.0.6
+ */
+export declare function Upgrade(options: {
+    readonly protocol: string;
+}): Upgrade<never>;
+/**
+ * @stability unstable
+ */
+export declare function Upgrade<H extends Schema.Struct.Fields>(options: {
+    readonly protocol: string;
+    readonly headers: H;
+}): Upgrade<Schema.Struct<H>>;
+/**
+ * @stability unstable
+ */
+export declare function Upgrade<H extends Schema.Top>(options: {
+    readonly protocol: string;
+    readonly headers: H;
+}): Upgrade<H>;
 /**
  * Runtime brand key used to mark `WithHeaders` response schemas.
  *
@@ -365,8 +588,8 @@ export type WithHeadersValueTypeId = typeof WithHeadersValueTypeId;
  *   `StreamSse` and `StreamUint8Array`; error responses remain non-streaming.
  *   Nesting `WithHeaders` is rejected at construction.
  * - `headers` is any schema; endpoint construction applies
- *   `Schema.toCodecStringTree` unless codecs are disabled, so leaves become
- *   `string | undefined` on the wire and `undefined` leaves are omitted from the response.
+ *   a StringTree codec unless codecs are disabled. Optional headers that encode
+ *   to `undefined` are omitted from the response.
  * - Status and response-encoding annotations are resolved from the wrapper
  *   first, falling through to the inner schema.
  * - A header-carrying response cannot share its status and content type with
@@ -649,6 +872,12 @@ export declare function asJson(options?: {
  *
  * The schema's encoded side must be a record of strings.
  *
+ * **Gotchas**
+ *
+ * Fields are flat on the server. A field that encodes to a nested object is
+ * sent as bracket keys that the server does not read back; use an explicit
+ * codec such as `Schema.fromJsonString(...)` for structured values.
+ *
  * @stability unstable
  * @category encoding
  * @since 4.0.0

package/dist/http-api/HttpApiSchema.d.ts.map

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

package/dist/http-api/HttpApiSchema.js

@@ -10,6 +10,8 @@
  * @stability unstable
  * @since 4.0.0
  */
+import * as Arr from "../Array.js";
+import * as ByteSize from "../ByteSize.js";
 import * as Sse from "../encoding/Sse.js";
 import { constVoid } from "../Function.js";
 import { hasBody } from "../http/HttpMethod.js";
@@ -18,14 +20,18 @@ import * as Predicate from "../Predicate.js";
 import * as Schema from "../Schema.js";
 import * as SchemaAST from "../SchemaAST.js";
 import * as SchemaTransformation from "../SchemaTransformation.js";
+import * as Socket from "../socket/Socket.js";
 import * as Stream from "../Stream.js";
+import * as MediaType from "./internal/mediaType.js";
 const StreamSchemaTypeId = "~effect/http-api/HttpApiSchema/Stream";
 /**
  * @stability unstable
  */
 export function status(code) {
   const statusCode = typeof code === "string" ? HttpStatus.fromLiteral(code) : code;
-  return self => self.annotate({
+  return self => findHttpApiStatusAnnotation(self.ast) === undefined ? self.annotateKey({
+    httpApiStatus: statusCode
+  }) : self.annotate({
     httpApiStatus: statusCode
   });
 }
@@ -88,9 +94,14 @@ export function asNoContent(options) {
   };
 }
 const streamSchema = /*#__PURE__*/Schema.declare(Stream.isStream);
+const defaultMaxElementBytes = /*#__PURE__*/ByteSize.mebibytes(1);
 /**
  * Creates a Server-Sent Events streaming success response schema.
  *
+ * **Details**
+ *
+ * `StreamSse` is response-only. Endpoint construction rejects it in `payload`.
+ *
  * @stability unstable
  * @category constructors
  * @since 4.0.0
@@ -108,13 +119,20 @@ export const StreamSse = options => {
     _tag: "StreamSse",
     mode: "sse",
     sseMode: options.events === undefined ? "data" : "events",
-    contentType: options.contentType ?? defaultStreamContentType("sse"),
+    ...streamContentTypes(options.contentType, "sse"),
     events,
     error: options.error ?? Schema.Never
   });
 };
 /**
- * Creates a streaming `Uint8Array` success response schema.
+ * Creates a streaming `Uint8Array` body schema.
+ *
+ * **Details**
+ *
+ * `contentType` defaults to `application/octet-stream`. Pass a list when the
+ * same stream is sent under several media types. The first entry is the
+ * default response type, and payloads are accepted under every entry.
+ * `maxBytes` only applies to request payloads and has no default.
  *
  * @stability unstable
  * @category constructors
@@ -124,7 +142,50 @@ export const StreamUint8Array = options => Schema.make(streamSchema.ast, {
   [StreamSchemaTypeId]: StreamSchemaTypeId,
   _tag: "StreamUint8Array",
   mode: "uint8array",
-  contentType: options?.contentType ?? defaultStreamContentType("uint8array")
+  ...streamContentTypes(options?.contentType, "uint8array"),
+  maxBytes: options?.maxBytes === undefined ? undefined : ByteSize.fromInputUnsafe(options.maxBytes)
+});
+/**
+ * Creates a schema for a stream of newline-delimited JSON elements.
+ *
+ * **Details**
+ *
+ * `contentType` defaults to `application/x-ndjson` and `maxElementBytes` to 1
+ * MiB. `maxBytes` has no default. Pass a list of content types to accept
+ * aliases such as `application/jsonl`. The first entry is the default.
+ *
+ * **Example** (Declaring an NDJSON request payload)
+ *
+ * ```ts import.meta.vitest
+ * import { Schema } from "effect"
+ * import { HttpApiEndpoint, HttpApiSchema } from "effect/http-api"
+ *
+ * const Event = Schema.Struct({ id: Schema.Number })
+ * const payload = HttpApiSchema.StreamNdjson({ schema: Event, maxBytes: "100 MiB" })
+ *
+ * // The handler receives a Stream of Events
+ * const importEvents = HttpApiEndpoint.post("importEvents", "/events", {
+ *   payload,
+ *   success: Schema.Number
+ * })
+ *
+ * importEvents.path // => "/events"
+ * payload.contentType // => "application/x-ndjson"
+ * payload.maxElementBytes // => 1048576n
+ * ```
+ *
+ * @stability unstable
+ * @category constructors
+ * @since 4.0.6
+ */
+export const StreamNdjson = options => Schema.make(streamSchema.ast, {
+  [StreamSchemaTypeId]: StreamSchemaTypeId,
+  _tag: "StreamNdjson",
+  mode: "ndjson",
+  ...streamContentTypes(options.contentType, "ndjson"),
+  schema: options.schema,
+  maxBytes: options.maxBytes === undefined ? undefined : ByteSize.fromInputUnsafe(options.maxBytes),
+  maxElementBytes: options.maxElementBytes === undefined ? defaultMaxElementBytes : ByteSize.fromInputUnsafe(options.maxElementBytes)
 });
 /**
  * @internal
@@ -138,12 +199,64 @@ export const isStreamSse = u => isStreamSchema(u) && u._tag === "StreamSse";
  * @internal
  */
 export const isStreamUint8Array = u => isStreamSchema(u) && u._tag === "StreamUint8Array";
+/**
+ * @internal
+ */
+export const isStreamNdjson = u => isStreamSchema(u) && u._tag === "StreamNdjson";
+const UpgradeTypeId = "~effect/http-api/HttpApiSchema/Upgrade";
+const upgradeSchema = /*#__PURE__*/Schema.declare(Socket.isSocket).pipe(/*#__PURE__*/status(101));
+/**
+ * @stability unstable
+ */
+export function Upgrade(options) {
+  if (options.protocol.toLowerCase() === "websocket") {
+    throw new Error("Upgrade does not support WebSocket");
+  }
+  const headers = options.headers === undefined || Schema.isSchema(options.headers) ? options.headers : Schema.Struct(options.headers);
+  return rebuildUpgrade(options.protocol, headers);
+}
+/**
+ * @internal
+ */
+export const rebuildUpgrade = (protocol, headers) => Schema.make(upgradeSchema.ast, {
+  [UpgradeTypeId]: UpgradeTypeId,
+  protocol,
+  headers
+});
+/**
+ * @internal
+ */
+export const isUpgrade = u => Schema.isSchema(u) && Predicate.hasProperty(u, UpgradeTypeId);
+function streamContentTypes(contentType, mode) {
+  if (contentType === undefined) contentType = defaultStreamContentType(mode);
+  if (typeof contentType === "string") return {
+    contentType,
+    contentTypes: [contentType]
+  };
+  if (!Arr.isReadonlyArrayNonEmpty(contentType)) {
+    throw new Error("Stream schemas require at least one content type");
+  }
+  const seen = new Set();
+  for (const entry of contentType) {
+    const normalized = MediaType.normalize(entry);
+    if (seen.has(normalized)) {
+      throw new Error(`Duplicate stream content type: ${entry}`);
+    }
+    seen.add(normalized);
+  }
+  return {
+    contentType: contentType[0],
+    contentTypes: contentType
+  };
+}
 function defaultStreamContentType(mode) {
   switch (mode) {
     case "sse":
       return "text/event-stream";
     case "uint8array":
       return "application/octet-stream";
+    case "ndjson":
+      return "application/x-ndjson";
   }
 }
 /**
@@ -174,6 +287,9 @@ export function WithHeaders(schema, headers) {
   if (isWithHeaders(schema)) {
     throw new Error("WithHeaders schemas cannot be nested");
   }
+  if (isUpgrade(schema)) {
+    throw new Error("WithHeaders cannot wrap an upgrade");
+  }
   return Schema.make(withHeadersValueSchema.ast, {
     [WithHeadersTypeId]: WithHeadersTypeId,
     schema,
@@ -290,6 +406,9 @@ export function rebuildWithHeaders(self, schema, headers) {
 export function encodeToWithHeaders(options, transformation) {
   return self => {
     const body = options.body;
+    if (isUpgrade(body)) {
+      throw new Error("encodeToWithHeaders cannot wrap an upgrade");
+    }
     const headers = Schema.Struct(options.headers);
     const status = resolveHttpApiStatus(body.ast);
     const encoding = resolveHttpApiEncoding(body.ast);
@@ -405,6 +524,12 @@ export function asJson(options) {
  *
  * The schema's encoded side must be a record of strings.
  *
+ * **Gotchas**
+ *
+ * Fields are flat on the server. A field that encodes to a nested object is
+ * sent as bracket keys that the server does not read back; use an explicit
+ * codec such as `Schema.fromJsonString(...)` for structured values.
+ *
  * @stability unstable
  * @category encoding
  * @since 4.0.0
@@ -474,7 +599,26 @@ const resolveHttpApiEncoding = /*#__PURE__*/SchemaAST.resolveAt("~httpApiEncodin
  * @internal
  */
 export const getWithHeadersAnnotation = /*#__PURE__*/SchemaAST.resolveAt("~httpApiWithHeaders");
-const resolveHttpApiStatus = /*#__PURE__*/SchemaAST.resolveAt("httpApiStatus");
+function findHttpApiStatusAnnotation(ast) {
+  if (ast.checks) {
+    for (let i = ast.checks.length - 1; i >= 0; i--) {
+      const check = ast.checks[i];
+      if (check.annotations && "httpApiStatus" in check.annotations) return check.annotations;
+      if (check._tag === "FilterGroup") {
+        const annotations = findHttpApiStatusAnnotation(check);
+        if (annotations !== undefined) return annotations;
+      }
+    }
+  }
+  const annotations = ast.annotations;
+  return annotations && "httpApiStatus" in annotations ? annotations : undefined;
+}
+function resolveHttpApiStatus(ast) {
+  const annotations = findHttpApiStatusAnnotation(ast);
+  // An explicit undefined clears the status instead of falling back to key context.
+  if (annotations !== undefined) return annotations.httpApiStatus;
+  return ast.context?.annotations?.httpApiStatus;
+}
 const defaultJsonEncoding = {
   _tag: "Json",
   contentType: "application/json"