effect 4.0.0-beta.99 → 4.0.0-rc.108

package/dist/unstable/httpapi/HttpApiTest.js.map

@@ -1 +1 @@
-{"version":3,"file":"HttpApiTest.js","names":["Context","Effect","Layer","HttpClient","HttpRouter","HttpServerRequest","HttpServerResponse","HttpApiBuilder","HttpApiClient","groups","fnUntraced","api","groupIdentifiers","options","context","identifier","group","includes","handlers","Map","routes","endpointIdentifier","endpoints","endpoint","handler","die","Error","isRaw","uninterruptible","set","push","handlerToRoute","add","layer","pipe","provide","succeedContext","toHttpEffect","httpClient","make","request","serverRequest","fromClientRequest","response","provideService","orDie","toClientResponse","scoped","makeWith","baseUrl"],"sources":["../../../src/unstable/httpapi/HttpApiTest.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;AAUA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,MAAM,MAAM,iBAAiB;AAEzC,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AAIvC,OAAO,KAAKC,UAAU,MAAM,uBAAuB;AAEnD,OAAO,KAAKC,UAAU,MAAM,uBAAuB;AACnD,OAAO,KAAKC,iBAAiB,MAAM,8BAA8B;AACjE,OAAO,KAAKC,kBAAkB,MAAM,+BAA+B;AAGnE,OAAO,KAAKC,cAAc,MAAM,qBAAqB;AACrD,OAAO,KAAKC,aAAa,MAAM,oBAAoB;AAInD;;;;;;;;;;;AAWA,OAAO,MAAMC,MAAM,gBAAGR,MAAM,CAACS,UAAU,CAAC,WAMtCC,GAAmC,EACnCC,gBAA6B,EAC7BC,OAEC;EAaD,IAAIC,OAAO,GAAG,OAAOb,MAAM,CAACa,OAAO,EAAiD;EAEpF,MAAML,MAAM,GAAGE,GAAG,CAACF,MAAqD;EACxE,KAAK,MAAMM,UAAU,IAAIN,MAAM,EAAE;IAC/B,MAAMO,KAAK,GAAGP,MAAM,CAACM,UAAU,CAAC;IAChC,IAAIH,gBAAgB,CAACK,QAAQ,CAACF,UAAiB,CAAC,EAAE;MAChD;IACF;IACA,MAAMG,QAAQ,GAAG,IAAIC,GAAG,EAA0B;IAClD,MAAMC,MAAM,GAAsC,EAAE;IACpD,KAAK,MAAMC,kBAAkB,IAAIL,KAAK,CAACM,SAAS,EAAE;MAChD,MAAMC,QAAQ,GAAGP,KAAK,CAACM,SAAS,CAACD,kBAAkB,CAAC;MACpD,MAAMG,OAAO,GAAmB;QAC9BD,QAAQ,EAAEA,QAAe;QACzBC,OAAO,EAAEA,CAAA,KAAMvB,MAAM,CAACwB,GAAG,CAAC,IAAIC,KAAK,CAAC,uBAAuBL,kBAAkB,EAAE,CAAC,CAAC;QACjFM,KAAK,EAAE,KAAK;QACZC,eAAe,EAAE;OAClB;MACDV,QAAQ,CAACW,GAAG,CAACR,kBAAkB,EAAEG,OAAO,CAAC;MACzCJ,MAAM,CAACU,IAAI,CAACvB,cAAc,CAACwB,cAAc,CAACf,KAAY,EAAEQ,OAAO,EAAEV,OAAO,CAAC,CAAC;IAC5E;IACAA,OAAO,GAAGd,OAAO,CAACgC,GAAG,CAAClB,OAAO,EAAEE,KAAY,EAAE;MAAEE,QAAQ;MAAEE;IAAM,CAAE,CAAC;EACpE;EAEA,MAAMa,KAAK,GAQP1B,cAAc,CAAC0B,KAAK,CAACtB,GAAG,CAAC,CAACuB,IAAI,CAChChC,KAAK,CAACiC,OAAO,CAACjC,KAAK,CAACkC,cAAc,CAACtB,OAAO,CAAC,CAAC,CACtC;EACR,MAAMU,OAAO,GAAG,OAAOpB,UAAU,CAACiC,YAAY,CAACJ,KAAK,CAAC;EACrD,MAAMK,UAAU,GAAGnC,UAAU,CAACoC,IAAI,CAACtC,MAAM,CAACS,UAAU,CAAC,WAAU8B,OAAO;IACpE,MAAMC,aAAa,GAAGpC,iBAAiB,CAACqC,iBAAiB,CAACF,OAAO,CAAC;IAClE,MAAMG,QAAQ,GAAG,OAAOnB,OAAO,CAACU,IAAI,CAClCjC,MAAM,CAAC2C,cAAc,CAACvC,iBAAiB,CAACA,iBAAiB,EAAEoC,aAAa,CAAC,EACzExC,MAAM,CAAC4C,KAAK,CACb;IACD,OAAOvC,kBAAkB,CAACwC,gBAAgB,CAACH,QAAQ,CAAC;EACtD,CAAC,EAAE1C,MAAM,CAAC8C,MAAM,CAAC,CAAC;EAElB,OAAO,OAAOvC,aAAa,CAACwC,QAAQ,CAACrC,GAAG,EAAE;IACxC2B,UAAU;IACVW,OAAO,EAAEpC,OAAO,EAAEoC,OAAO,IAAI;GAC9B,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"HttpApiTest.js","names":[],"sources":["../../../src/unstable/httpapi/HttpApiTest.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;AAUA,OAAO,KAAK,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAK,MAAM,MAAM,iBAAiB;AAEzC,OAAO,KAAK,KAAK,MAAM,gBAAgB;AAIvC,OAAO,KAAK,UAAU,MAAM,uBAAuB;AAEnD,OAAO,KAAK,UAAU,MAAM,uBAAuB;AACnD,OAAO,KAAK,iBAAiB,MAAM,8BAA8B;AACjE,OAAO,KAAK,kBAAkB,MAAM,+BAA+B;AAGnE,OAAO,KAAK,cAAc,MAAM,qBAAqB;AACrD,OAAO,KAAK,aAAa,MAAM,oBAAoB;AAInD;;;;;;;;;;;AAWA,OAAO,MAAM,MAAM,gBAAG,MAAM,CAAC,UAAU,CAAC,WAMtC,GAAmC,EACnC,gBAA6B,EAC7B,OAEC;EAaD,IAAI,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,EAAiD;EAEpF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAqD;EACxE,KAAK,MAAM,UAAU,IAAI,MAAM,EAAE;IAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IAChC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,UAAiB,CAAC,EAAE;MAChD;IACF;IACA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B;IAClD,MAAM,MAAM,GAAsC,EAAE;IACpD,KAAK,MAAM,kBAAkB,IAAI,KAAK,CAAC,SAAS,EAAE;MAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,kBAAkB,CAAC;MACpD,MAAM,OAAO,GAAmB;QAC9B,QAAQ,EAAE,QAAe;QACzB,OAAO,EAAE,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,uBAAuB,kBAAkB,EAAE,CAAC,CAAC;QACjF,KAAK,EAAE,KAAK;QACZ,eAAe,EAAE;OAClB;MACD,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,OAAO,CAAC;MACzC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,KAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5E;IACA,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAY,EAAE;MAAE,QAAQ;MAAE;IAAM,CAAE,CAAC;EACpE;EAEA,MAAM,KAAK,GAQP,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAChC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CACtC;EACR,MAAM,OAAO,GAAG,OAAO,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC;EACrD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,WAAU,OAAO;IACpE,MAAM,aAAa,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,OAAO,CAAC;IAClE,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,IAAI,CAClC,MAAM,CAAC,cAAc,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,aAAa,CAAC,EACzE,MAAM,CAAC,KAAK,CACb;IACD,OAAO,kBAAkB,CAAC,gBAAgB,CAAC,QAAQ,CAAC;EACtD,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;EAElB,OAAO,OAAO,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE;IACxC,UAAU;IACV,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI;GAC9B,CAAC;AACJ,CAAC,CAAC","ignoreList":[]}

package/dist/unstable/httpapi/OpenApi.d.ts

@@ -7,7 +7,7 @@ declare const Identifier_base: Context.ServiceClass<Identifier, "effect/httpapi/
 /**
  * OpenAPI annotation for overriding generated identifiers, including operation ids.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Identifier extends Identifier_base {
@@ -16,7 +16,7 @@ declare const Title_base: Context.ServiceClass<Title, "effect/httpapi/OpenApi/Ti
 /**
  * OpenAPI annotation for setting the API title or group tag name.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Title extends Title_base {
@@ -25,7 +25,7 @@ declare const Version_base: Context.ServiceClass<Version, "effect/httpapi/OpenAp
 /**
  * OpenAPI annotation for setting the generated API version.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Version extends Version_base {
@@ -34,7 +34,7 @@ declare const Description_base: Context.ServiceClass<Description, "effect/httpap
 /**
  * OpenAPI annotation for setting generated descriptions on APIs, groups, endpoints, or security schemes.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Description extends Description_base {
@@ -43,7 +43,7 @@ declare const License_base: Context.ServiceClass<License, "effect/httpapi/OpenAp
 /**
  * OpenAPI annotation for setting the generated API license metadata.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class License extends License_base {
@@ -52,7 +52,7 @@ declare const ExternalDocs_base: Context.ServiceClass<ExternalDocs, "effect/http
 /**
  * OpenAPI annotation for adding external documentation metadata to groups or endpoints.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class ExternalDocs extends ExternalDocs_base {
@@ -61,7 +61,7 @@ declare const Servers_base: Context.ServiceClass<Servers, "effect/httpapi/OpenAp
 /**
  * OpenAPI annotation for setting the generated API server list.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Servers extends Servers_base {
@@ -70,7 +70,7 @@ declare const Format_base: Context.ServiceClass<Format, "effect/httpapi/OpenApi/
 /**
  * OpenAPI annotation for setting the format metadata, such as a bearer token format on security schemes.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Format extends Format_base {
@@ -79,7 +79,7 @@ declare const Summary_base: Context.ServiceClass<Summary, "effect/httpapi/OpenAp
 /**
  * OpenAPI annotation for setting generated summary text.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Summary extends Summary_base {
@@ -88,7 +88,7 @@ declare const Deprecated_base: Context.ServiceClass<Deprecated, "effect/httpapi/
 /**
  * OpenAPI annotation for marking a generated endpoint operation as deprecated.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Deprecated extends Deprecated_base {
@@ -97,7 +97,7 @@ declare const Override_base: Context.ServiceClass<Override, "effect/httpapi/Open
 /**
  * OpenAPI annotation for shallowly merging additional fields into a generated OpenAPI object.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Override extends Override_base {
@@ -111,7 +111,7 @@ export declare class Override extends Override_base {
  * Use to hide internal, experimental, or otherwise undocumented HTTP API groups
  * and endpoints from generated OpenAPI output.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare const Exclude: Context.Reference<boolean>;
@@ -124,7 +124,7 @@ declare const Transform_base: Context.ServiceClass<Transform, "effect/httpapi/Op
  * The function is applied during generation to the annotated API, group tag, or
  * endpoint operation.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class Transform extends Transform_base {
@@ -316,7 +316,15 @@ export type OpenApiSpecContent = {
 export interface OpenApiSpecResponse {
     description: string;
     content?: OpenApiSpecContent;
+    headers?: Record<string, OpenAPISpecHeader>;
 }
+/**
+ * Generated OpenAPI response header object.
+ *
+ * @category models
+ * @since 4.0.0
+ */
+export type OpenAPISpecHeader = Omit<OpenAPISpecParameter, "name" | "in">;
 /**
  * Generated OpenAPI media type object containing the JSON Schema for a request or response body.
  *

package/dist/unstable/httpapi/OpenApi.d.ts.map

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

package/dist/unstable/httpapi/OpenApi.js

@@ -12,14 +12,15 @@ import * as Arr from "../../Array.js";
 import * as Context from "../../Context.js";
 import * as Equal from "../../Equal.js";
 import { constFalse } from "../../Function.js";
-import * as internalRecord from "../../internal/record.js";
+import * as InternalRecord from "../../internal/record.js";
+import * as InternalToJsonSchemaDocument from "../../internal/schema/toJsonSchemaDocument.js";
+import * as InternalToRepresentation from "../../internal/schema/toRepresentation.js";
 import * as JsonPatch from "../../JsonPatch.js";
 import { escapeToken } from "../../JsonPointer.js";
 import * as JsonSchema from "../../JsonSchema.js";
 import * as Option from "../../Option.js";
 import * as Schema from "../../Schema.js";
 import * as SchemaAST from "../../SchemaAST.js";
-import * as SchemaRepresentation from "../../SchemaRepresentation.js";
 import * as HttpMethod from "../http/HttpMethod.js";
 import * as HttpApi from "./HttpApi.js";
 import * as HttpApiEndpoint from "./HttpApiEndpoint.js";
@@ -28,77 +29,77 @@ import * as HttpApiSchema from "./HttpApiSchema.js";
 /**
  * OpenAPI annotation for overriding generated identifiers, including operation ids.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Identifier extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Identifier") {}
 /**
  * OpenAPI annotation for setting the API title or group tag name.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Title extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Title") {}
 /**
  * OpenAPI annotation for setting the generated API version.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Version extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Version") {}
 /**
  * OpenAPI annotation for setting generated descriptions on APIs, groups, endpoints, or security schemes.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Description extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Description") {}
 /**
  * OpenAPI annotation for setting the generated API license metadata.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class License extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/License") {}
 /**
  * OpenAPI annotation for adding external documentation metadata to groups or endpoints.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class ExternalDocs extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/ExternalDocs") {}
 /**
  * OpenAPI annotation for setting the generated API server list.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Servers extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Servers") {}
 /**
  * OpenAPI annotation for setting the format metadata, such as a bearer token format on security schemes.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Format extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Format") {}
 /**
  * OpenAPI annotation for setting generated summary text.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Summary extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Summary") {}
 /**
  * OpenAPI annotation for marking a generated endpoint operation as deprecated.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Deprecated extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Deprecated") {}
 /**
  * OpenAPI annotation for shallowly merging additional fields into a generated OpenAPI object.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Override extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Override") {}
@@ -111,7 +112,7 @@ export class Override extends /*#__PURE__*/Context.Service()("effect/httpapi/Ope
  * Use to hide internal, experimental, or otherwise undocumented HTTP API groups
  * and endpoints from generated OpenAPI output.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export const Exclude = /*#__PURE__*/Context.Reference("effect/httpapi/OpenApi/Exclude", {
@@ -125,7 +126,7 @@ export const Exclude = /*#__PURE__*/Context.Reference("effect/httpapi/OpenApi/Ex
  * The function is applied during generation to the annotated API, group tag, or
  * endpoint operation.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class Transform extends /*#__PURE__*/Context.Service()("effect/httpapi/OpenApi/Transform") {}
@@ -163,6 +164,20 @@ export const annotations = /*#__PURE__*/servicesPartial({
   transform: Transform
 });
 const apiCache = /*#__PURE__*/new WeakMap();
+const compileSchemas = asts => JsonSchema.toMultiDocumentOpenApi3_1(InternalToJsonSchemaDocument.toJsonSchemaMultiDocument(InternalToRepresentation.toRepresentations(Arr.map(asts, Schema.toCodecJsonAST), InternalToJsonSchemaDocument.toRepresentationOptions)));
+const cloneOpenAPISpec = value => {
+  if (Array.isArray(value)) {
+    return value.map(cloneOpenAPISpec);
+  }
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const key of Object.keys(value)) {
+      InternalRecord.assignProperty(out, key, cloneOpenAPISpec(value[key]));
+    }
+    return out;
+  }
+  return value;
+};
 /**
  * This function checks if a given tag exists within the provided context. If
  * the tag is present, it retrieves the associated value and applies the given
@@ -195,9 +210,12 @@ function processAnnotation(ctx, annotation, f) {
  * @since 4.0.0
  */
 export function fromApi(api) {
-  const cached = apiCache.get(api);
+  return fromApiWith(api, apiCache, compileSchemas);
+}
+function fromApiWith(api, cache, compileSchemas) {
+  const cached = cache.get(api);
   if (cached !== undefined) {
-    return cached;
+    return cloneOpenAPISpec(cached);
   }
   let spec = {
     openapi: "3.1.0",
@@ -251,7 +269,10 @@ export function fromApi(api) {
         tag.externalDocs = externalDocs;
       });
       processAnnotation(group.annotations, Override, override => {
-        Object.assign(tag, override);
+        // OpenAPI documents are JSON, so symbol keys are intentionally ignored.
+        for (const [key, value] of Object.entries(override)) {
+          InternalRecord.assignProperty(tag, key, value);
+        }
       });
       processAnnotation(group.annotations, Transform, transformFn => {
         tag = transformFn(tag);
@@ -280,12 +301,32 @@ export function fromApi(api) {
         for (const [status, {
           content,
           descriptions,
+          headers,
           streamContent
         }] of bodies) {
           const description = descriptions.size > 0 ? Array.from(descriptions).join(" | ") : defaultDescription();
-          op.responses[status] = {
+          InternalRecord.assignProperty(op.responses, status, {
             description
-          };
+          });
+          for (const schema of headers) {
+            const ast = SchemaAST.getLastEncoding(schema.ast);
+            if (SchemaAST.isObjects(ast)) {
+              for (const ps of ast.propertySignatures) {
+                const name = String(ps.name).toLowerCase();
+                if (name === "content-type") continue;
+                op.responses[status].headers ??= {};
+                InternalRecord.assignProperty(op.responses[status].headers, name, {
+                  schema: {},
+                  required: !SchemaAST.isOptional(ps.type)
+                });
+                pathOps.push({
+                  _tag: "parameter",
+                  ast: ps.type,
+                  path: ["paths", path, method, "responses", String(status), "headers", name, "schema"]
+                });
+              }
+            }
+          }
           if (content !== undefined) {
             content.forEach((map, encoding) => {
               map.forEach((schemas, contentType) => {
@@ -297,9 +338,9 @@ export function fromApi(api) {
                   path: ["paths", path, method, "responses", String(status), "content", contentType, "schema"]
                 });
                 op.responses[status].content ??= {};
-                op.responses[status].content[contentType] = {
+                InternalRecord.assignProperty(op.responses[status].content, contentType, {
                   schema: {}
-                };
+                });
               });
             });
           }
@@ -322,7 +363,7 @@ export function fromApi(api) {
                   ast: SchemaAST.getAST(stream.error),
                   path: ["paths", path, method, "responses", String(status), "content", contentType, "x-effect-stream", "errorSchema"]
                 });
-                op.responses[status].content[contentType] = {
+                InternalRecord.assignProperty(op.responses[status].content, contentType, {
                   schema: {},
                   "x-effect-stream": {
                     encoding: "sse",
@@ -330,9 +371,9 @@ export function fromApi(api) {
                     errorSchema: {},
                     failureEvent: reservedStreamFailureEvent
                   }
-                };
+                });
               } else {
-                op.responses[status].content[contentType] = {
+                InternalRecord.assignProperty(op.responses[status].content, contentType, {
                   schema: {
                     type: "string",
                     format: "binary"
@@ -340,7 +381,7 @@ export function fromApi(api) {
                   "x-effect-stream": {
                     encoding: "uint8array"
                   }
-                };
+                });
               }
             });
           }
@@ -392,7 +433,7 @@ export function fromApi(api) {
       function processHttpApiSecurity(name, security) {
         const scheme = makeSecurityScheme(security);
         if (!Object.hasOwn(spec.components.securitySchemes, name)) {
-          internalRecord.set(spec.components.securitySchemes, name, scheme);
+          InternalRecord.assignProperty(spec.components.securitySchemes, name, scheme);
           return;
         }
         if (!Equal.equals(securitySchemeForComparison(spec.components.securitySchemes[name]), securitySchemeForComparison(scheme))) {
@@ -428,9 +469,9 @@ export function fromApi(api) {
               ast: toEncodingAST(ast, encoding._tag),
               path: ["paths", path, method, "requestBody", "content", contentType, "schema"]
             });
-            content[contentType] = {
+            InternalRecord.assignProperty(content, contentType, {
               schema: {}
-            };
+            });
           }
           op.requestBody = {
             content,
@@ -446,9 +487,12 @@ export function fromApi(api) {
       processParameters(endpoint.headers, "header");
       processParameters(endpoint.query, "query");
       processResponseBodies(extractSuccessResponseBodies(endpoint), () => "Success");
-      processResponseBodies(extractResponseBodies(HttpApiEndpoint.getErrorSchemas(endpoint), HttpApiSchema.getStatusError, resolveDescriptionOrIdentifier), () => "Error");
+      processResponseBodies(extractResponseBodies(HttpApiEndpoint.getErrorSchemas(endpoint), HttpApiSchema.getStatusErrorSchema, resolveDescriptionOrIdentifier), () => "Error");
       processAnnotation(endpoint.annotations, Override, override => {
-        Object.assign(op, override);
+        // OpenAPI documents are JSON, so symbol keys are intentionally ignored.
+        for (const [key, value] of Object.entries(override)) {
+          InternalRecord.assignProperty(op, key, value);
+        }
       });
       processAnnotation(endpoint.annotations, Transform, transformFn => {
         op = transformFn(op);
@@ -465,8 +509,8 @@ export function fromApi(api) {
         operationIds.add(operationId);
       }
       pathOperations.add(pathOperation);
-      if (!spec.paths[path]) {
-        spec.paths[path] = {};
+      if (!Object.hasOwn(spec.paths, path)) {
+        InternalRecord.assignProperty(spec.paths, path, {});
       }
       spec.paths[path][method] = op;
     }
@@ -475,10 +519,10 @@ export function fromApi(api) {
     componentSchemas.forEach(componentSchema => {
       const identifier = SchemaAST.resolveIdentifier(componentSchema.ast);
       if (identifier !== undefined) {
-        if (identifier in spec.components.schemas) {
+        if (Object.hasOwn(spec.components.schemas, identifier)) {
           throw new globalThis.Error(`Duplicate component schema identifier: ${identifier}`);
         }
-        spec.components.schemas[identifier] = {};
+        InternalRecord.assignProperty(spec.components.schemas, identifier, {});
         pathOps.push({
           _tag: "schema",
           ast: componentSchema.ast,
@@ -491,8 +535,7 @@ export function fromApi(api) {
     return "/" + path.map(escapeToken).join("/");
   }
   if (Arr.isArrayNonEmpty(pathOps)) {
-    const multiDocument = SchemaRepresentation.fromASTs(Arr.map(pathOps, op => op.ast));
-    const jsonSchemaMultiDocument = JsonSchema.toMultiDocumentOpenApi3_1(SchemaRepresentation.toJsonSchemaMultiDocument(multiDocument));
+    const jsonSchemaMultiDocument = compileSchemas(Arr.map(pathOps, op => op.ast));
     const patchOps = pathOps.map((op, i) => {
       const oppath = escapePath(op.path);
       const value = jsonSchemaMultiDocument.schemas[i];
@@ -517,33 +560,40 @@ export function fromApi(api) {
     }
   });
   processAnnotation(api.annotations, Override, override => {
-    Object.assign(spec, override);
+    // OpenAPI documents are JSON, so symbol keys are intentionally ignored.
+    for (const [key, value] of Object.entries(override)) {
+      InternalRecord.assignProperty(spec, key, value);
+    }
   });
   processAnnotation(api.annotations, Transform, transformFn => {
     spec = transformFn(spec);
   });
-  apiCache.set(api, spec);
+  cache.set(api, cloneOpenAPISpec(spec));
   return spec;
 }
 const reservedStreamFailureEvent = "effect/httpapi/stream/failure";
 function extractSuccessResponseBodies(endpoint) {
-  return extractResponseBodies(HttpApiEndpoint.getSuccessSchemas(endpoint), HttpApiSchema.getStatusSuccess, resolveDescriptionOrIdentifier);
+  return extractResponseBodies(HttpApiEndpoint.getSuccessSchemas(endpoint), HttpApiSchema.getStatusSuccessSchema, resolveDescriptionOrIdentifier);
 }
 function extractResponseBodies(schemas, getStatus, getDescription) {
   const map = new Map();
   schemas.forEach(process);
   return map;
   function process(schema) {
-    if (HttpApiSchema.isStreamSchema(schema)) {
-      addStreamContent(schema);
-      return;
-    }
-    const ast = schema.ast;
-    const status = getStatus(ast);
-    if (HttpApiSchema.isNoContent(ast)) {
-      addNoContent(status, getDescription(schema.ast) ?? "<No Content>");
+    const annotation = HttpApiSchema.getWithHeadersAnnotation(schema.ast);
+    const body = HttpApiSchema.isWithHeaders(schema) ? schema.schema : annotation?.body ?? schema;
+    const headers = HttpApiSchema.isWithHeaders(schema) ? schema.headers : annotation?.headersCodec;
+    const status = getStatus(schema);
+    const ast = body.ast;
+    if (HttpApiSchema.isStreamSchema(body)) {
+      addStreamContent(body, status);
+    } else if (HttpApiSchema.isNoContent(ast)) {
+      addNoContent(status, getDescription(schema.ast) ?? getDescription(ast) ?? "<No Content>");
     } else {
-      addContent(schema, status, HttpApiSchema.getResponseEncoding(ast));
+      addContent(body, status, HttpApiSchema.getResponseEncodingSchema(schema), getDescription(schema.ast) ?? getDescription(ast));
+    }
+    if (headers !== undefined) {
+      map.get(status).headers.push(headers);
     }
   }
   function addNoContent(status, description) {
@@ -552,6 +602,7 @@ function extractResponseBodies(schemas, getStatus, getDescription) {
       map.set(status, {
         descriptions: new Set([description]),
         content: undefined,
+        headers: [],
         streamContent: undefined
       });
     } else {
@@ -560,8 +611,7 @@ function extractResponseBodies(schemas, getStatus, getDescription) {
       }
     }
   }
-  function addContent(schema, status, encoding) {
-    const description = getDescription(schema.ast);
+  function addContent(schema, status, encoding, description) {
     const statusMap = map.get(status);
     const {
       _tag,
@@ -571,6 +621,7 @@ function extractResponseBodies(schemas, getStatus, getDescription) {
       map.set(status, {
         descriptions: new Set(description !== undefined ? [description] : []),
         content: new Map([[_tag, new Map([[contentType, new Set([schema])]])]]),
+        headers: [],
         streamContent: undefined
       });
     } else {
@@ -595,19 +646,21 @@ function extractResponseBodies(schemas, getStatus, getDescription) {
       }
     }
   }
-  function addStreamContent(stream) {
-    const status = HttpApiSchema.getStatusStream(stream);
+  function addStreamContent(stream, status) {
     const statusMap = map.get(status);
     if (statusMap === undefined) {
       map.set(status, {
         descriptions: new Set(),
         content: undefined,
+        headers: [],
         streamContent: new Map([[stream.contentType, stream]])
       });
-    } else if (statusMap.streamContent === undefined) {
-      statusMap.streamContent = new Map([[stream.contentType, stream]]);
     } else {
-      statusMap.streamContent.set(stream.contentType, stream);
+      if (statusMap.streamContent === undefined) {
+        statusMap.streamContent = new Map([[stream.contentType, stream]]);
+      } else {
+        statusMap.streamContent.set(stream.contentType, stream);
+      }
     }
   }
 }
@@ -631,7 +684,7 @@ function toEncodingAST(ast, _tag) {
   }
 }
 function persistedFileToBinaryEncoding(ast) {
-  if (SchemaAST.isDeclaration(ast) && ast.annotations?.typeConstructor?._tag === "effect/http/PersistedFile") {
+  if (SchemaAST.isDeclaration(ast) && ast.annotations?.representation?.id === "effect/http/PersistedFile") {
     return Uint8ArrayEncoding.ast;
   }
   if (typeof ast?.recur === "function") {