effect 4.0.0-beta.66 → 4.0.0-beta.67

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

@@ -1,29 +1,40 @@
 /**
- * HttpApiSchema provides helpers to annotate Effect Schema values with HTTP API metadata
- * (status codes and payload/response encodings) used by the HttpApi builder, client,
- * and OpenAPI generation.
- *
- * Mental model:
- * - A "Schema" is the base validation/encoding description from `Schema`.
- * - An "Encoding" tells HttpApi how to serialize/parse a payload or response body.
- * - A "Status" is metadata that chooses the HTTP response status code.
- * - "Empty" schemas represent responses with no body (204/201/202 or custom).
- * - "NoContent" schemas can still decode into a value via {@link asNoContent}.
- * - Multipart is a payload-only encoding for file-like form data.
- *
- * Common tasks:
- * - Set a response status on a schema -> {@link status}
- * - Declare an empty response -> {@link Empty}, {@link NoContent}, {@link Created}, {@link Accepted}
- * - Decode an empty response into a value -> {@link asNoContent}
- * - Force a specific encoding -> {@link asJson}, {@link asFormUrlEncoded}, {@link asText}, {@link asUint8Array}
- * - Mark multipart payloads -> {@link asMultipart}, {@link asMultipartStream}
- *
- * Gotchas:
- * - If you don't set an encoding, HttpApi assumes JSON by default.
- * - {@link asFormUrlEncoded} expects the schema's encoded type to be a record of strings.
- * - {@link asText} expects the encoded type to be `string`, and {@link asUint8Array} expects `Uint8Array`.
- * - Multipart encodings are intended for request payloads; response multipart is not supported.
- * - These helpers annotate schemas; they don't perform validation or IO by themselves.
+ * Helpers for attaching HTTP API metadata to Effect Schema values.
+ *
+ * This module is the schema-side bridge used by the unstable HttpApi endpoint
+ * builder, generated clients, and OpenAPI support. It does not define routes or
+ * perform IO. Instead, helpers such as {@link status}, {@link asJson},
+ * {@link asMultipart}, and {@link asNoContent} annotate schemas so downstream
+ * HTTP tooling can choose response status codes, content types, body codecs, and
+ * no-body handling while the original schema remains usable for validation and
+ * transformation.
+ *
+ * Common use cases:
+ * - Mark success or error schemas with explicit HTTP statuses using
+ *   {@link status}, {@link NoContent}, {@link Created}, {@link Accepted}, or
+ *   {@link Empty}.
+ * - Override the default JSON encoding for request payloads or responses with
+ *   {@link asFormUrlEncoded}, {@link asText}, {@link asUint8Array}, or
+ *   {@link asJson}.
+ * - Describe buffered or streaming multipart request payloads with
+ *   {@link asMultipart} and {@link asMultipartStream}.
+ * - Represent an HTTP response with no body while still decoding a client-side
+ *   value through {@link asNoContent}.
+ *
+ * Status and encoding details:
+ * - {@link status} only stores an annotation. The same annotation is interpreted
+ *   by the surrounding HttpApi context; unannotated success responses default to
+ *   `200`, and unannotated error responses default to `500`.
+ * - Missing encodings default to JSON for bodies and responses. Payload schemas
+ *   used with methods that have no request body fall back to form-url-encoded
+ *   metadata for parameter encoding.
+ * - {@link asFormUrlEncoded} expects the schema's encoded side to be a record
+ *   of strings. {@link asText} expects `string`, and {@link asUint8Array}
+ *   expects `Uint8Array`.
+ * - Multipart encodings are payload-only; response multipart is rejected when
+ *   response encoding is resolved.
+ * - These helpers attach annotations consumed by HttpApi internals. They do not
+ *   validate, encode, decode, or send data by themselves.
  *
  * @since 4.0.0
  */
@@ -133,6 +144,8 @@ export declare function status(code: StatusLiteral): <S extends Schema.Top>(self
  */
 export declare const Empty: (code: number) => Schema.Void;
 /**
+ * Type of the `NoContent` schema, a void schema annotated with HTTP status code 204.
+ *
  * @since 4.0.0
  */
 export interface NoContent extends Schema.Void {
@@ -141,11 +154,13 @@ export interface NoContent extends Schema.Void {
  * A void schema with the HTTP status code 204.
  * This is used to represent empty responses with the status code 204.
  *
- * @since 4.0.0
  * @category Empty
+ * @since 4.0.0
  */
 export declare const NoContent: NoContent;
 /**
+ * Type of the `Created` schema, a void schema annotated with HTTP status code 201.
+ *
  * @since 4.0.0
  */
 export interface Created extends Schema.Void {
@@ -159,6 +174,8 @@ export interface Created extends Schema.Void {
  */
 export declare const Created: Created;
 /**
+ * Type of the `Accepted` schema, a void schema annotated with HTTP status code 202.
+ *
  * @since 4.0.0
  */
 export interface Accepted extends Schema.Void {
@@ -172,14 +189,17 @@ export interface Accepted extends Schema.Void {
  */
 export declare const Accepted: Accepted;
 /**
+ * Schema type returned by `asNoContent`, encoding as `void` while decoding to the original schema type.
+ *
  * @since 4.0.0
  */
 export interface asNoContent<S extends Schema.Top> extends Schema.decodeTo<Schema.toType<S>, Schema.Void> {
 }
 /**
- * Marks a schema as a no content response.
+ * Marks a schema as a no-content response while preserving a decoded client value.
  *
- * The `decode` function is used to decode the response body on the client side into a meaningful value.
+ * The server encodes the response as `void`; generated clients call `decode` to
+ * produce the schema's decoded value when the response has no body.
  *
  * @see {@link NoContent} for a void schema with the status code 204.
  * @see {@link Empty} for creating a void schema with a specific status code.
@@ -191,14 +211,20 @@ export declare function asNoContent<S extends Schema.Top>(options: {
     readonly decode: LazyArg<S["Type"]>;
 }): (self: S) => asNoContent<S>;
 /**
+ * Runtime brand key used to mark schemas as buffered multipart payloads.
+ *
  * @since 4.0.0
  */
 export declare const MultipartTypeId = "~effect/httpapi/HttpApiSchema/Multipart";
 /**
+ * Type-level brand identifier used by `asMultipart`.
+ *
  * @since 4.0.0
  */
 export type MultipartTypeId = typeof MultipartTypeId;
 /**
+ * Schema type returned by `asMultipart` for buffered multipart payloads.
+ *
  * @since 4.0.0
  */
 export interface asMultipart<S extends Schema.Top> extends Schema.brand<S["Rebuild"], MultipartTypeId> {
@@ -213,14 +239,20 @@ export interface asMultipart<S extends Schema.Top> extends Schema.brand<S["Rebui
  */
 export declare function asMultipart(options?: Multipart_.withLimits.Options): <S extends Schema.Top>(self: S) => asMultipart<S>;
 /**
+ * Runtime brand key used to mark schemas as streaming multipart payloads.
+ *
  * @since 4.0.0
  */
 export declare const MultipartStreamTypeId = "~effect/httpapi/HttpApiSchema/MultipartStream";
 /**
+ * Type-level brand identifier used by `asMultipartStream`.
+ *
  * @since 4.0.0
  */
 export type MultipartStreamTypeId = typeof MultipartStreamTypeId;
 /**
+ * Schema type returned by `asMultipartStream` for streaming multipart payloads.
+ *
  * @since 4.0.0
  */
 export interface asMultipartStream<S extends Schema.Top> extends Schema.brand<S["Rebuild"], MultipartStreamTypeId> {
@@ -244,9 +276,9 @@ export declare function asJson(options?: {
     readonly contentType?: string;
 }): <S extends Schema.Top>(self: S) => S["Rebuild"];
 /**
- * Marks a schema as a URL params payload / response.
+ * Marks a schema as an `application/x-www-form-urlencoded` payload or response.
  *
- * The schema encoded side must be a record of strings.
+ * The schema's encoded side must be a record of strings.
  *
  * @category Encoding
  * @since 4.0.0
@@ -281,6 +313,11 @@ export declare function asUint8Array(options?: {
     readonly Encoded: Uint8Array;
 }>(self: S) => S["Rebuild"];
 /**
+ * Returns `true` when a schema AST represents a no-content response.
+ *
+ * The check succeeds for direct `void` schemas and schemas whose encoded or
+ * transformation target is `void`.
+ *
  * @since 4.0.0
  */
 export declare const isNoContent: (ast: AST.AST) => boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"HttpApiSchema.d.ts","sourceRoot":"","sources":["../../../src/unstable/httpapi/HttpApiSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HttpApiSchema.d.ts","sourceRoot":"","sources":["../../../src/unstable/httpapi/HttpApiSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,GAAG,MAAM,oBAAoB,CAAA;AAGzC,OAAO,KAAK,KAAK,UAAU,MAAM,sBAAsB,CAAA;AAEvD,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,WAAW,CAAC;QACpB,UAAU,OAAO;YACf,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SAO5C;KACF;CACF;AAgCD,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+Df,CAAA;AAEV;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,mBAAmB,CAAA;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAA;AACrF,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAA;AAQ5F;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,IAAsC,CAAA;AAElF;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,MAAM,CAAC,IAAI;CAAG;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,EAAE,SAAsB,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,OAAQ,SAAQ,MAAM,CAAC,IAAI;CAAG;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,OAAoB,CAAA;AAE1C;;;;GAIG;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,IAAI;CAAG;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAqB,CAAA;AAE5C;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAE,SAAQ,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC;CAAG;AAE5G;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;CACpC,IACS,MAAM,CAAC,KAAG,WAAW,CAAC,CAAC,CAAC,CAWjC;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,4CAA4C,CAAA;AAExE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAA;AAEpD;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAE,SAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;CAAG;AAEzG;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,IACzD,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAG,WAAW,CAAC,CAAC,CAAC,CASvD;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,kDAAkD,CAAA;AAEpF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA;AAEhE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAE,SAAQ,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAAG;AAErH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,OAAO,IAC/D,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAG,iBAAiB,CAAC,CAAC,CAAC,CAS7D;AA6BD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B,IACS,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,kBACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B,IACS,CAAC,SAAS,MAAM,CAAC,GAAG,EAC1B,MAAM,CAAC,kBAEV;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B,IACS,CAAC,SAAS,MAAM,CAAC,GAAG,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAAC,kBAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B,IACS,CAAC,SAAS,MAAM,CAAC,GAAG,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,EAAE,MAAM,CAAC,kBAEzE;AACD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,CAAC,GAAG,KAAG,OAO1C,CAAA"}

package/dist/unstable/httpapi/HttpApiSchema.js

@@ -1,29 +1,40 @@
 /**
- * HttpApiSchema provides helpers to annotate Effect Schema values with HTTP API metadata
- * (status codes and payload/response encodings) used by the HttpApi builder, client,
- * and OpenAPI generation.
+ * Helpers for attaching HTTP API metadata to Effect Schema values.
  *
- * Mental model:
- * - A "Schema" is the base validation/encoding description from `Schema`.
- * - An "Encoding" tells HttpApi how to serialize/parse a payload or response body.
- * - A "Status" is metadata that chooses the HTTP response status code.
- * - "Empty" schemas represent responses with no body (204/201/202 or custom).
- * - "NoContent" schemas can still decode into a value via {@link asNoContent}.
- * - Multipart is a payload-only encoding for file-like form data.
+ * This module is the schema-side bridge used by the unstable HttpApi endpoint
+ * builder, generated clients, and OpenAPI support. It does not define routes or
+ * perform IO. Instead, helpers such as {@link status}, {@link asJson},
+ * {@link asMultipart}, and {@link asNoContent} annotate schemas so downstream
+ * HTTP tooling can choose response status codes, content types, body codecs, and
+ * no-body handling while the original schema remains usable for validation and
+ * transformation.
  *
- * Common tasks:
- * - Set a response status on a schema -> {@link status}
- * - Declare an empty response -> {@link Empty}, {@link NoContent}, {@link Created}, {@link Accepted}
- * - Decode an empty response into a value -> {@link asNoContent}
- * - Force a specific encoding -> {@link asJson}, {@link asFormUrlEncoded}, {@link asText}, {@link asUint8Array}
- * - Mark multipart payloads -> {@link asMultipart}, {@link asMultipartStream}
+ * Common use cases:
+ * - Mark success or error schemas with explicit HTTP statuses using
+ *   {@link status}, {@link NoContent}, {@link Created}, {@link Accepted}, or
+ *   {@link Empty}.
+ * - Override the default JSON encoding for request payloads or responses with
+ *   {@link asFormUrlEncoded}, {@link asText}, {@link asUint8Array}, or
+ *   {@link asJson}.
+ * - Describe buffered or streaming multipart request payloads with
+ *   {@link asMultipart} and {@link asMultipartStream}.
+ * - Represent an HTTP response with no body while still decoding a client-side
+ *   value through {@link asNoContent}.
  *
- * Gotchas:
- * - If you don't set an encoding, HttpApi assumes JSON by default.
- * - {@link asFormUrlEncoded} expects the schema's encoded type to be a record of strings.
- * - {@link asText} expects the encoded type to be `string`, and {@link asUint8Array} expects `Uint8Array`.
- * - Multipart encodings are intended for request payloads; response multipart is not supported.
- * - These helpers annotate schemas; they don't perform validation or IO by themselves.
+ * Status and encoding details:
+ * - {@link status} only stores an annotation. The same annotation is interpreted
+ *   by the surrounding HttpApi context; unannotated success responses default to
+ *   `200`, and unannotated error responses default to `500`.
+ * - Missing encodings default to JSON for bodies and responses. Payload schemas
+ *   used with methods that have no request body fall back to form-url-encoded
+ *   metadata for parameter encoding.
+ * - {@link asFormUrlEncoded} expects the schema's encoded side to be a record
+ *   of strings. {@link asText} expects `string`, and {@link asUint8Array}
+ *   expects `Uint8Array`.
+ * - Multipart encodings are payload-only; response multipart is rejected when
+ *   response encoding is resolved.
+ * - These helpers attach annotations consumed by HttpApi internals. They do not
+ *   validate, encode, decode, or send data by themselves.
  *
  * @since 4.0.0
  */
@@ -118,8 +129,8 @@ export const Empty = code => Schema.Void.pipe(status(code));
  * A void schema with the HTTP status code 204.
  * This is used to represent empty responses with the status code 204.
  *
- * @since 4.0.0
  * @category Empty
+ * @since 4.0.0
  */
 export const NoContent = /*#__PURE__*/Empty(204);
 /**
@@ -139,9 +150,10 @@ export const Created = /*#__PURE__*/Empty(201);
  */
 export const Accepted = /*#__PURE__*/Empty(202);
 /**
- * Marks a schema as a no content response.
+ * Marks a schema as a no-content response while preserving a decoded client value.
  *
- * The `decode` function is used to decode the response body on the client side into a meaningful value.
+ * The server encodes the response as `void`; generated clients call `decode` to
+ * produce the schema's decoded value when the response has no body.
  *
  * @see {@link NoContent} for a void schema with the status code 204.
  * @see {@link Empty} for creating a void schema with a specific status code.
@@ -158,6 +170,8 @@ export function asNoContent(options) {
   };
 }
 /**
+ * Runtime brand key used to mark schemas as buffered multipart payloads.
+ *
  * @since 4.0.0
  */
 export const MultipartTypeId = "~effect/httpapi/HttpApiSchema/Multipart";
@@ -180,6 +194,8 @@ export function asMultipart(options) {
   });
 }
 /**
+ * Runtime brand key used to mark schemas as streaming multipart payloads.
+ *
  * @since 4.0.0
  */
 export const MultipartStreamTypeId = "~effect/httpapi/HttpApiSchema/MultipartStream";
@@ -236,9 +252,9 @@ export function asJson(options) {
   });
 }
 /**
- * Marks a schema as a URL params payload / response.
+ * Marks a schema as an `application/x-www-form-urlencoded` payload or response.
  *
- * The schema encoded side must be a record of strings.
+ * The schema's encoded side must be a record of strings.
  *
  * @category Encoding
  * @since 4.0.0
@@ -278,6 +294,11 @@ export function asUint8Array(options) {
   });
 }
 /**
+ * Returns `true` when a schema AST represents a no-content response.
+ *
+ * The check succeeds for direct `void` schemas and schemas whose encoded or
+ * transformation target is `void`.
+ *
  * @since 4.0.0
  */
 export const isNoContent = ast => {

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

@@ -1 +1 @@
-{"version":3,"file":"HttpApiSchema.js","names":["constVoid","Schema","AST","Transformation","hasBody","statusCodeByLiteral","Continue","SwitchingProtocols","Processing","EarlyHints","OK","Ok","Created","Accepted","NonAuthoritativeInformation","NoContent","ResetContent","PartialContent","MultiStatus","AlreadyReported","ImUsed","MultipleChoices","MovedPermanently","Found","SeeOther","NotModified","TemporaryRedirect","PermanentRedirect","BadRequest","Unauthorized","PaymentRequired","Forbidden","NotFound","MethodNotAllowed","NotAcceptable","ProxyAuthenticationRequired","RequestTimeout","Conflict","Gone","LengthRequired","PreconditionFailed","PayloadTooLarge","UriTooLong","UnsupportedMediaType","RangeNotSatisfiable","ExpectationFailed","ImATeapot","MisdirectedRequest","UnprocessableEntity","Locked","FailedDependency","TooEarly","UpgradeRequired","PreconditionRequired","TooManyRequests","RequestHeaderFieldsTooLarge","UnavailableForLegalReasons","InternalServerError","NotImplemented","BadGateway","ServiceUnavailable","GatewayTimeout","HttpVersionNotSupported","VariantAlsoNegotiates","InsufficientStorage","LoopDetected","NotExtended","NetworkAuthenticationRequired","status","code","statusCode","self","annotate","httpApiStatus","Empty","Void","pipe","asNoContent","options","decodeTo","toType","transform","decode","encode","MultipartTypeId","asMultipart","brand","_tag","mode","contentType","defaultContentType","limits","MultipartStreamTypeId","asMultipartStream","asNonMultipartEncoding","asJson","asFormUrlEncoded","asText","asUint8Array","isNoContent","ast","isVoid","encoded","toEncoded","target","encoding","to","undefined","resolveHttpApiEncoding","resolveAt","resolveHttpApiStatus","defaultJsonEncoding","defaultUrlEncodedEncoding","getEncoding","getPayloadEncoding","method","getResponseEncoding","out","Error","getStatusSuccess","getStatusError"],"sources":["../../../src/unstable/httpapi/HttpApiSchema.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"HttpApiSchema.js","names":["constVoid","Schema","AST","Transformation","hasBody","statusCodeByLiteral","Continue","SwitchingProtocols","Processing","EarlyHints","OK","Ok","Created","Accepted","NonAuthoritativeInformation","NoContent","ResetContent","PartialContent","MultiStatus","AlreadyReported","ImUsed","MultipleChoices","MovedPermanently","Found","SeeOther","NotModified","TemporaryRedirect","PermanentRedirect","BadRequest","Unauthorized","PaymentRequired","Forbidden","NotFound","MethodNotAllowed","NotAcceptable","ProxyAuthenticationRequired","RequestTimeout","Conflict","Gone","LengthRequired","PreconditionFailed","PayloadTooLarge","UriTooLong","UnsupportedMediaType","RangeNotSatisfiable","ExpectationFailed","ImATeapot","MisdirectedRequest","UnprocessableEntity","Locked","FailedDependency","TooEarly","UpgradeRequired","PreconditionRequired","TooManyRequests","RequestHeaderFieldsTooLarge","UnavailableForLegalReasons","InternalServerError","NotImplemented","BadGateway","ServiceUnavailable","GatewayTimeout","HttpVersionNotSupported","VariantAlsoNegotiates","InsufficientStorage","LoopDetected","NotExtended","NetworkAuthenticationRequired","status","code","statusCode","self","annotate","httpApiStatus","Empty","Void","pipe","asNoContent","options","decodeTo","toType","transform","decode","encode","MultipartTypeId","asMultipart","brand","_tag","mode","contentType","defaultContentType","limits","MultipartStreamTypeId","asMultipartStream","asNonMultipartEncoding","asJson","asFormUrlEncoded","asText","asUint8Array","isNoContent","ast","isVoid","encoded","toEncoded","target","encoding","to","undefined","resolveHttpApiEncoding","resolveAt","resolveHttpApiStatus","defaultJsonEncoding","defaultUrlEncodedEncoding","getEncoding","getPayloadEncoding","method","getResponseEncoding","out","Error","getStatusSuccess","getStatusError"],"sources":["../../../src/unstable/httpapi/HttpApiSchema.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -1,4 +1,28 @@
 /**
+ * The `HttpApiSecurity` module defines the security scheme values used by
+ * declarative HTTP APIs.
+ *
+ * Use these constructors when an API group or endpoint needs authentication
+ * middleware for bearer tokens, API keys, or HTTP Basic credentials. The values
+ * are intentionally small declarations: `HttpApiMiddleware.Service` attaches
+ * them to middleware, `HttpApiBuilder` decodes the matching credential shape from
+ * each request, and OpenAPI generation emits the corresponding
+ * `components.securitySchemes` and operation security requirements.
+ *
+ * Common uses include modeling `Authorization: Bearer ...` tokens, Basic
+ * username/password credentials, and API keys passed through headers, query
+ * parameters, or cookies. Bearer tokens and API-key values are exposed to
+ * middleware as `Redacted` values; Basic credentials expose the username with a
+ * redacted password. Cookie API keys can also be written to responses with
+ * `HttpApiBuilder.securitySetCookie`.
+ *
+ * A security scheme does not authenticate by itself: middleware must reject empty
+ * or invalid credentials. Bearer and Basic schemes read the `Authorization`
+ * header, while API-key headers use HTTP header name normalization and API-key
+ * query or cookie names are matched exactly. OpenAPI annotations such as
+ * descriptions and bearer formats affect generated documentation only; they do
+ * not change runtime decoding.
+ *
  * @since 4.0.0
  */
 import * as Context from "../../Context.ts";
@@ -7,18 +31,24 @@ import type { Redacted } from "../../Redacted.ts";
 import type { Covariant } from "../../Types.ts";
 declare const TypeId = "~effect/httpapi/HttpApiSecurity";
 /**
- * @since 4.0.0
+ * Union of security schemes supported by the HTTP API OpenAPI model.
+ *
  * @category models
+ * @since 4.0.0
  */
 export type HttpApiSecurity = Bearer | ApiKey | Basic;
 /**
- * @since 4.0.0
+ * Helper types for HTTP API security schemes.
+ *
  * @category models
+ * @since 4.0.0
  */
 export declare namespace HttpApiSecurity {
     /**
-     * @since 4.0.0
+     * Common prototype for security schemes, carrying the credential type and OpenAPI annotations.
+     *
      * @category models
+     * @since 4.0.0
      */
     interface Proto<out A> extends Pipeable {
         readonly [TypeId]: {
@@ -27,21 +57,27 @@ export declare namespace HttpApiSecurity {
         readonly annotations: Context.Context<never>;
     }
     /**
-     * @since 4.0.0
+     * Extracts the credential type produced by a security scheme.
+     *
      * @category models
+     * @since 4.0.0
      */
     type Type<A extends HttpApiSecurity> = A extends Proto<infer Out> ? Out : never;
 }
 /**
- * @since 4.0.0
+ * Bearer token security scheme whose decoded credential is a redacted token.
+ *
  * @category models
+ * @since 4.0.0
  */
 export interface Bearer extends HttpApiSecurity.Proto<Redacted> {
     readonly _tag: "Bearer";
 }
 /**
- * @since 4.0.0
+ * API key security scheme identifying the key name and whether it is read from a header, query parameter, or cookie.
+ *
  * @category models
+ * @since 4.0.0
  */
 export interface ApiKey extends HttpApiSecurity.Proto<Redacted> {
     readonly _tag: "ApiKey";
@@ -49,15 +85,19 @@ export interface ApiKey extends HttpApiSecurity.Proto<Redacted> {
     readonly key: string;
 }
 /**
- * @since 4.0.0
+ * HTTP Basic authentication security scheme whose decoded credential is `Credentials`.
+ *
  * @category models
+ * @since 4.0.0
  */
 export interface Basic extends HttpApiSecurity.Proto<Credentials> {
     readonly _tag: "Basic";
 }
 /**
- * @since 4.0.0
+ * Decoded credentials for HTTP Basic authentication.
+ *
  * @category models
+ * @since 4.0.0
  */
 export interface Credentials {
     readonly username: string;
@@ -69,8 +109,8 @@ export interface Credentials {
  * You can implement some api middleware for this security scheme using
  * `HttpApiBuilder.middlewareSecurity`.
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export declare const bearer: Bearer;
 /**
@@ -84,47 +124,64 @@ export declare const bearer: Bearer;
  *
  * The default value for `in` is "header".
  *
- * @since 4.0.0
  * @category constructors
+ * @since 4.0.0
  */
 export declare const apiKey: (options: {
     readonly key: string;
     readonly in?: "header" | "query" | "cookie" | undefined;
 }) => ApiKey;
 /**
- * @since 4.0.0
+ * Creates an HTTP Basic authentication security scheme.
+ *
+ * You can implement API middleware for this security scheme with
+ * `HttpApiBuilder.middlewareSecurity`.
+ *
  * @category constructors
+ * @since 4.0.0
  */
 export declare const basic: Basic;
 /**
- * @since 4.0.0
+ * Merges OpenAPI annotations into a security scheme.
+ *
  * @category annotations
+ * @since 4.0.0
  */
 export declare const annotateMerge: {
     /**
-     * @since 4.0.0
+     * Merges OpenAPI annotations into a security scheme.
+     *
      * @category annotations
+     * @since 4.0.0
      */
     <I>(annotations: Context.Context<I>): <A extends HttpApiSecurity>(self: A) => A;
     /**
-     * @since 4.0.0
+     * Merges OpenAPI annotations into a security scheme.
+     *
      * @category annotations
+     * @since 4.0.0
      */
     <A extends HttpApiSecurity, I>(self: A, annotations: Context.Context<I>): A;
 };
 /**
- * @since 4.0.0
+ * Adds an OpenAPI annotation value to a security scheme.
+ *
  * @category annotations
+ * @since 4.0.0
  */
 export declare const annotate: {
     /**
-     * @since 4.0.0
+     * Adds an OpenAPI annotation value to a security scheme.
+     *
      * @category annotations
+     * @since 4.0.0
      */
     <I, S>(service: Context.Key<I, S>, value: S): <A extends HttpApiSecurity>(self: A) => A;
     /**
-     * @since 4.0.0
+     * Adds an OpenAPI annotation value to a security scheme.
+     *
      * @category annotations
+     * @since 4.0.0
      */
     <A extends HttpApiSecurity, I, S>(self: A, service: Context.Key<I, S>, value: S): A;
 };

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

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