effect 4.0.0-beta.73 → 4.0.0-beta.75

package/src/unstable/cluster/Sharding.ts

@@ -112,7 +112,7 @@ import * as Snowflake from "./Snowflake.ts"
  * Use to access or provide cluster routing, shard ownership, entity
  * registration, singleton registration, and persisted-work polling.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class Sharding extends Context.Service<Sharding, {
@@ -1487,9 +1487,9 @@ const make = Effect.gen(function*() {
  *
  * **When to use**
  *
- * Use when assembling a cluster sharding runtime from explicit sharding
- * configuration, runner communication, message storage, runner storage, and
- * runner health layers.
+ * Use when you need to assemble a cluster sharding runtime from explicit
+ * sharding configuration, runner communication, message storage, runner
+ * storage, and runner health layers.
  *
  * **Details**
  *

package/src/unstable/cluster/ShardingConfig.ts

@@ -203,10 +203,10 @@ export const defaults: ShardingConfig["Service"] = {
  *
  * **When to use**
  *
- * Use when wiring a cluster runner with explicit `ShardingConfig` values,
- * especially in tests, local development, or code paths where configuration
- * should be provided programmatically instead of loaded from environment
- * variables.
+ * Use when you need to wire a cluster runner with explicit `ShardingConfig`
+ * values, especially in tests, local development, or code paths where
+ * configuration should be provided programmatically instead of loaded from
+ * environment variables.
  *
  * **Details**
  *

package/src/unstable/cluster/SingletonAddress.ts

@@ -39,7 +39,7 @@ const TypeId = "~effect/cluster/SingletonAddress"
 /**
  * Represents the unique address of an singleton within the cluster.
  *
- * @category Address
+ * @category address
  * @since 4.0.0
  */
 export class SingletonAddress extends Schema.Class<SingletonAddress>(TypeId)({

package/src/unstable/cluster/Snowflake.ts

@@ -27,7 +27,7 @@ import * as Effect from "../../Effect.ts"
 import { identity } from "../../Function.ts"
 import * as Layer from "../../Layer.ts"
 import * as Schema from "../../Schema.ts"
-import * as Transformation from "../../SchemaTransformation.ts"
+import * as SchemaTransformation from "../../SchemaTransformation.ts"
 import type { MachineId } from "./MachineId.ts"
 
 /**
@@ -129,7 +129,7 @@ export interface SnowflakeFromString extends Schema.decodeTo<SnowflakeFromBigInt
  * @since 4.0.0
  */
 export const SnowflakeFromString: SnowflakeFromString = Schema.String.pipe(
-  Schema.decodeTo(SnowflakeFromBigInt, Transformation.bigintFromString)
+  Schema.decodeTo(SnowflakeFromBigInt, SchemaTransformation.bigintFromString)
 )
 
 /**
@@ -154,7 +154,7 @@ const constBigInt4096 = BigInt(4096)
  * **When to use**
  *
  * Use to pack known timestamp, machine id, and sequence parts into a branded
- * snowflake id when you already control id allocation.
+ * snowflake id.
  *
  * **Gotchas**
  *
@@ -179,7 +179,7 @@ export const make = (options: {
 /**
  * Extracts the Unix timestamp in milliseconds from a snowflake id.
  *
- * @category Parts
+ * @category parts
  * @since 4.0.0
  */
 export const timestamp = (snowflake: Snowflake): number => Number(snowflake >> constBigInt22) + sinceUnixEpoch
@@ -187,7 +187,7 @@ export const timestamp = (snowflake: Snowflake): number => Number(snowflake >> c
 /**
  * Extracts the timestamp from a snowflake id as a `DateTime.Utc`.
  *
- * @category Parts
+ * @category parts
  * @since 4.0.0
  */
 export const dateTime = (snowflake: Snowflake): DateTime.Utc => DateTime.makeUnsafe(timestamp(snowflake))
@@ -195,7 +195,7 @@ export const dateTime = (snowflake: Snowflake): DateTime.Utc => DateTime.makeUns
 /**
  * Extracts the machine id component from a snowflake id.
  *
- * @category Parts
+ * @category parts
  * @since 4.0.0
  */
 export const machineId = (snowflake: Snowflake): MachineId =>
@@ -204,7 +204,7 @@ export const machineId = (snowflake: Snowflake): MachineId =>
 /**
  * Extracts the per-machine sequence component from a snowflake id.
  *
- * @category Parts
+ * @category parts
  * @since 4.0.0
  */
 export const sequence = (snowflake: Snowflake): number => Number(snowflake % constBigInt4096)
@@ -212,7 +212,7 @@ export const sequence = (snowflake: Snowflake): number => Number(snowflake % con
 /**
  * Decomposes a snowflake id into its timestamp, machine id, and sequence parts.
  *
- * @category Parts
+ * @category parts
  * @since 4.0.0
  */
 export const toParts = (snowflake: Snowflake): Snowflake.Parts => ({

package/src/unstable/cluster/internal/entityManager.ts

@@ -15,7 +15,7 @@ import * as Option from "../../../Option.ts"
 import { CurrentLogAnnotations } from "../../../References.ts"
 import * as Schedule from "../../../Schedule.ts"
 import * as Schema from "../../../Schema.ts"
-import * as Issue from "../../../SchemaIssue.ts"
+import * as SchemaIssue from "../../../SchemaIssue.ts"
 import * as Scope from "../../../Scope.ts"
 import type * as Rpc from "../../rpc/Rpc.ts"
 import { RequestId } from "../../rpc/RpcMessage.ts"
@@ -636,7 +636,7 @@ const makeMessageDecode = <Type extends string, Rpcs extends Rpc.Any>(
     if (!rpc) {
       return Effect.fail(
         new Schema.SchemaError(
-          new Issue.InvalidValue(Option.some(message), {
+          new SchemaIssue.InvalidValue(Option.some(message), {
             message: `Unknown tag ${message.envelope.tag} for entity type ${entity.type}`
           })
         )

package/src/unstable/devtools/DevToolsClient.ts

@@ -55,7 +55,7 @@ const ResponseSchema = Schema.toCodecJson(DevToolsSchema.Response)
  * Service for sending span and span-event telemetry to the Effect devtools
  * connection.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class DevToolsClient extends Context.Service<

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

@@ -66,7 +66,7 @@ import type { EventLogRemote } from "./EventLogRemote.ts"
  * only when the handler succeeds, and exposes access to the underlying journal
  * entries and destroy operation.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class EventLog extends Context.Service<EventLog, {
@@ -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/EventLogEncryption.ts

@@ -82,7 +82,7 @@ const toBufferSource = (data: Uint8Array): ArrayBufferView<ArrayBuffer> => new U
  * Use to provide cryptographic operations required by encrypted event-log
  * replication.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class EventLogEncryption extends Context.Service<EventLogEncryption, {

package/src/unstable/eventlog/EventLogRemote.ts

@@ -63,7 +63,7 @@ import { makeGetIdentityRootSecretMaterial } from "./internal/identityRootSecret
  * It can write local entries to the remote, stream remote changes from a sequence
  * number, and run effects only after the supplied identity has authenticated.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class EventLogRemote extends Context.Service<EventLogRemote, {

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

@@ -79,7 +79,7 @@ import * as EventLogServer from "./EventLogServer.ts"
  * Use to access or provide the server service that handles plaintext
  * event-log writes.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class EventLogServerUnencrypted extends Context.Service<EventLogServerUnencrypted, {
@@ -290,7 +290,7 @@ export class EventLogServerAuthError extends Data.TaggedError("EventLogServerAut
  * Use to provide authorization checks for plaintext event-log writes, reads,
  * and identity authentication.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class EventLogServerAuthorization extends Context.Service<EventLogServerAuthorization, {
@@ -317,7 +317,7 @@ export class EventLogServerAuthorization extends Context.Service<EventLogServerA
  * Use to map client-visible store identifiers to server storage identifiers
  * before authorizing or serving unencrypted event-log requests.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class StoreMapping extends Context.Service<StoreMapping, {
@@ -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
         })
@@ -152,7 +152,7 @@ const CookieTypeId = "~effect/http/Cookies/Cookie"
  * HTTP cookie value with its decoded value, encoded value, and optional cookie
  * attributes such as domain, path, expiration, security, and same-site settings.
  *
- * @category cookie
+ * @category cookies
  * @since 4.0.0
  */
 export interface Cookie extends Inspectable.Inspectable {
@@ -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

@@ -78,7 +78,7 @@ export interface Strong {
 /**
  * Formats an `Etag` as an HTTP header value, including quotes and the `W/` prefix for weak tags.
  *
- * @category convertions
+ * @category converting
  * @since 4.0.0
  */
 export const toString = (self: Etag): string => {
@@ -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/FetchHttpClient.ts

@@ -47,7 +47,7 @@ import * as HttpClientResponse from "./HttpClientResponse.ts"
  *
  * Defaults to `globalThis.fetch`.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export const Fetch = Context.Reference<typeof globalThis.fetch>("effect/http/FetchHttpClient/Fetch", {
@@ -66,7 +66,7 @@ export const Fetch = Context.Reference<typeof globalThis.fetch>("effect/http/Fet
  *
  * Request-specific method, headers, body, and abort signal are supplied by the client when a request is executed.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class RequestInit extends Context.Service<RequestInit, globalThis.RequestInit>()(

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,10 +165,10 @@ 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 tags
+ * @category services
  * @since 4.0.0
  */
 export const HttpClient: Context.Service<HttpClient, HttpClient> = Context.Service<HttpClient, HttpClient>(

package/src/unstable/http/HttpClientRequest.ts

@@ -90,7 +90,7 @@ export interface HttpClientRequest extends Inspectable.Inspectable, Pipeable {
 /**
  * Options for constructing or modifying an `HttpClientRequest`.
  *
- * @category models
+ * @category options
  * @since 4.0.0
  */
 export interface Options {
@@ -113,7 +113,7 @@ export declare namespace Options {
   /**
    * Request options that omit the method and URL for helpers that already receive those values separately.
    *
-   * @category models
+   * @category options
    * @since 4.0.0
    */
   export interface NoUrl extends Omit<Options, "method" | "url"> {}
@@ -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/HttpMiddleware.ts

@@ -267,7 +267,7 @@ export const xForwardedHeaders = make((httpApp) =>
 /**
  * Middleware that parses the current request URL's search parameters and provides them as `ParsedSearchParams`.
  *
- * @category Search params
+ * @category search params
  * @since 4.0.0
  */
 export const searchParamsParser = <E, R>(

package/src/unstable/http/HttpPlatform.ts

@@ -38,7 +38,7 @@ import * as Response from "./HttpServerResponse.ts"
 /**
  * Service for platform-specific HTTP response helpers, including file-backed server responses.
  *
- * @category tags
+ * @category services
  * @since 4.0.0
  */
 export class HttpPlatform extends Context.Service<HttpPlatform, {