effect 4.0.0-beta.101 → 4.0.0-beta.103

package/src/unstable/http/HttpServerResponse.ts

@@ -566,6 +566,36 @@ export const setHeader: {
     })
 )
 
+/**
+ * Returns a response with the specified header removed.
+ *
+ * @category combinators
+ * @since 4.0.0
+ */
+export const removeHeader: {
+  /**
+   * Returns a response with the specified header removed.
+   *
+   * @category combinators
+   * @since 4.0.0
+   */
+  (key: string): (self: HttpServerResponse) => HttpServerResponse
+  /**
+   * Returns a response with the specified header removed.
+   *
+   * @category combinators
+   * @since 4.0.0
+   */
+  (self: HttpServerResponse, key: string): HttpServerResponse
+} = dual(
+  2,
+  (self: HttpServerResponse, key: string): HttpServerResponse =>
+    makeResponse({
+      ...self,
+      headers: Headers.remove(self.headers, key)
+    })
+)
+
 /**
  * Returns a response with all supplied headers set on the existing header map.
  *

package/src/unstable/http/HttpStaticServer.ts

@@ -26,14 +26,41 @@ import * as HttpServerResponse from "./HttpServerResponse.ts"
  *
  * **Example** (Serving files from a directory)
  *
- * ```ts
- * import { Effect } from "effect"
- * import { HttpStaticServer } from "effect/unstable/http"
+ * ```ts import.meta.vitest
+ * import { Effect, FileSystem, Layer, Path } from "effect"
+ * import {
+ *   HttpEffect,
+ *   HttpPlatform,
+ *   HttpServerResponse,
+ *   HttpStaticServer
+ * } from "effect/unstable/http"
  *
- * const program = Effect.gen(function*() {
- *   const app = yield* HttpStaticServer.make({ root: "./public" })
- *   return app
+ * const TestFileSystem = FileSystem.layerNoop({
+ *   stat: () =>
+ *     Effect.succeed({
+ *       type: "File",
+ *       size: FileSystem.Size(20)
+ *     } as FileSystem.File.Info)
  * })
+ * const TestHttpPlatform = Layer.succeed(
+ *   HttpPlatform.HttpPlatform,
+ *   HttpPlatform.HttpPlatform.of({
+ *     platform: "web",
+ *     fileResponse: (path) => Effect.succeed(HttpServerResponse.text(`Serving ${path}`)),
+ *     fileWebResponse: () => Effect.die("unused")
+ *   })
+ * )
+ * const TestServices = Layer.mergeAll(Path.layer, TestFileSystem, TestHttpPlatform)
+ *
+ * const program = Effect.gen(function*() {
+ *   const app = yield* HttpStaticServer.make({ root: "/public" })
+ *   const handler = HttpEffect.toWebHandler(app)
+ *   const response = yield* Effect.promise(() => handler(new Request("http://localhost/guide.txt")))
+ *   const body = yield* Effect.promise(() => response.text())
+ *   return body
+ * }).pipe(Effect.provide(TestServices))
+ *
+ * await Effect.runPromise(program) // => "Serving /public/guide.txt"
  * ```
  *
  * @category constructors
@@ -179,7 +206,7 @@ export const make: (options: {
  *
  * **Example** (Mounting static files on a router)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Layer } from "effect"
  * import { HttpRouter, HttpServerResponse, HttpStaticServer } from "effect/unstable/http"
  *
@@ -191,6 +218,7 @@ export const make: (options: {
  * })
  *
  * const AppLayer = Layer.mergeAll(ApiLayer, StaticFilesLayer)
+ * Layer.isLayer(AppLayer) // => true
  * ```
  *
  * @category layers

package/src/unstable/http/Multipart.ts

@@ -276,6 +276,13 @@ export class MultipartError extends Data.TaggedError("MultipartError")<{
  */
 export interface PersistedFileSchema extends Schema.declare<PersistedFile> {}
 
+const PersistedFileEncoded = Schema.Struct({
+  key: Schema.String,
+  name: Schema.String,
+  contentType: Schema.String.annotate({ contentEncoding: "binary" }),
+  path: Schema.String
+})
+
 /**
  * Schema for persisted multipart files.
  *
@@ -290,23 +297,19 @@ export interface PersistedFileSchema extends Schema.declare<PersistedFile> {}
 export const PersistedFileSchema: PersistedFileSchema = Schema.declare(
   isPersistedFile,
   {
-    typeConstructor: {
-      _tag: "effect/http/PersistedFile"
-    },
-    generation: {
-      runtime: `Multipart.PersistedFileSchema`,
-      Type: `Multipart.PersistedFile`,
-      importDeclaration: `import * as Multipart from "effect/unstable/http/Multipart"`
+    representation: {
+      id: "effect/http/PersistedFile",
+      payload: null
     },
+    toCode: () => ({
+      runtime: "Multipart.PersistedFileSchema",
+      Type: "Multipart.PersistedFile",
+      importDeclarations: [`import * as Multipart from "effect/unstable/http/Multipart"`]
+    }),
     expected: "PersistedFile",
     toCodecJson: () =>
       Schema.link<PersistedFile>()(
-        Schema.Struct({
-          key: Schema.String,
-          name: Schema.String,
-          contentType: Schema.String.annotate({ contentEncoding: "binary" }),
-          path: Schema.String
-        }),
+        PersistedFileEncoded,
         SchemaTransformation.transform({
           decode: ({ contentType, key, name, path }) => new PersistedFileImpl(key, name, contentType, path),
           encode: (file) => ({
@@ -435,7 +438,7 @@ export const makeConfig = (
  * non-empty batches of parsed `Part` values, failing with `MultipartError` for
  * parser and limit failures.
  *
- * @category Parsers
+ * @category parsing
  * @since 4.0.0
  */
 export const makeChannel = <IE>(headers: Record<string, string>): Channel.Channel<
@@ -791,7 +794,7 @@ export declare namespace withLimits {
    * These settings control maximum part count, field size, file size, total body
    * size, and MIME types that should be treated as fields instead of files.
    *
-   * @category fiber refs
+   * @category options
    * @since 4.0.0
    */
   export type Options = {
@@ -810,7 +813,7 @@ export declare namespace withLimits {
  *
  * The default is `undefined`, meaning no explicit part-count limit.
  *
- * @category references
+ * @category services
  * @since 4.0.0
  */
 export const MaxParts = Context.Reference<number | undefined>("effect/http/Multipart/MaxParts", {
@@ -824,7 +827,7 @@ export const MaxParts = Context.Reference<number | undefined>("effect/http/Multi
  *
  * The default limit is 10 MiB.
  *
- * @category references
+ * @category services
  * @since 4.0.0
  */
 export const MaxFieldSize = Context.Reference<FileSystem.SizeInput>("effect/http/Multipart/MaxFieldSize", {
@@ -838,7 +841,7 @@ export const MaxFieldSize = Context.Reference<FileSystem.SizeInput>("effect/http
  *
  * The default is `undefined`, meaning no explicit per-file limit.
  *
- * @category references
+ * @category services
  * @since 4.0.0
  */
 export const MaxFileSize = Context.Reference<FileSystem.SizeInput | undefined>(
@@ -854,7 +857,7 @@ export const MaxFileSize = Context.Reference<FileSystem.SizeInput | undefined>(
  *
  * The default treats `application/json` parts as fields.
  *
- * @category references
+ * @category services
  * @since 4.0.0
  */
 export const FieldMimeTypes = Context.Reference<ReadonlyArray<string>>("effect/http/Multipart/FieldMimeTypes", {

package/src/unstable/http/Template.ts

@@ -154,7 +154,7 @@ export function make<A extends ReadonlyArray<Interpolated>>(
             values[index] = primitiveToString(value)
           })),
       {
-        concurrency: "inherit",
+        concurrency: "unbounded",
         discard: true
       }
     ),

package/src/unstable/http/Url.ts

@@ -88,7 +88,7 @@ const baseUrl = (): string | undefined => {
  *
  * **Example** (Parsing absolute and relative URLs)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Result } from "effect"
  * import { Url } from "effect/unstable/http"
  *
@@ -98,22 +98,12 @@ const baseUrl = (): string | undefined => {
  * //      ▼
  * const parsed = Url.fromString("https://example.com/path")
  *
- * if (Result.isSuccess(parsed)) {
- *   console.log("Parsed URL:", parsed.success.toString())
- * } else {
- *   console.log("Error:", parsed.failure.message)
- * }
- * // Output: Parsed URL: https://example.com/path
+ * Result.map(parsed, (url) => url.toString()) // => Result.succeed("https://example.com/path")
  *
  * // Parse a relative URL with a base
  * const relativeParsed = Url.fromString("/relative-path", "https://example.com")
  *
- * if (Result.isSuccess(relativeParsed)) {
- *   console.log("Parsed relative URL:", relativeParsed.success.toString())
- * } else {
- *   console.log("Error:", relativeParsed.failure.message)
- * }
- * // Output: Parsed relative URL: https://example.com/relative-path
+ * Result.map(relativeParsed, (url) => url.toString()) // => Result.succeed("https://example.com/relative-path")
  * ```
  *
  * @category constructors
@@ -139,7 +129,7 @@ export const fromString: {
    *
    * **Example** (Parsing absolute and relative URLs)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Result } from "effect"
    * import { Url } from "effect/unstable/http"
    *
@@ -149,22 +139,12 @@ export const fromString: {
    * //      ▼
    * const parsed = Url.fromString("https://example.com/path")
    *
-   * if (Result.isSuccess(parsed)) {
-   *   console.log("Parsed URL:", parsed.success.toString())
-   * } else {
-   *   console.log("Error:", parsed.failure.message)
-   * }
-   * // Output: Parsed URL: https://example.com/path
+   * Result.map(parsed, (url) => url.toString()) // => Result.succeed("https://example.com/path")
    *
    * // Parse a relative URL with a base
    * const relativeParsed = Url.fromString("/relative-path", "https://example.com")
    *
-   * if (Result.isSuccess(relativeParsed)) {
-   *   console.log("Parsed relative URL:", relativeParsed.success.toString())
-   * } else {
-   *   console.log("Error:", relativeParsed.failure.message)
-   * }
-   * // Output: Parsed relative URL: https://example.com/relative-path
+   * Result.map(relativeParsed, (url) => url.toString()) // => Result.succeed("https://example.com/relative-path")
    * ```
    *
    * @category constructors
@@ -183,7 +163,7 @@ export const fromString: {
  *
  * **Example** (Mutating URL credentials)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Url } from "effect/unstable/http"
  *
  * const myUrl = new URL("https://example.com")
@@ -193,11 +173,10 @@ export const fromString: {
  *   url.password = "pass"
  * })
  *
- * console.log("Mutated:", mutatedUrl.toString())
- * // Output: Mutated: https://user:pass@example.com/
+ * mutatedUrl.toString() // => "https://user:pass@example.com/"
  * ```
  *
- * @category modifiers
+ * @category transforming
  * @since 4.0.0
  */
 export const mutate: {
@@ -206,7 +185,7 @@ export const mutate: {
    *
    * **Example** (Mutating URL credentials)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Url } from "effect/unstable/http"
    *
    * const myUrl = new URL("https://example.com")
@@ -216,11 +195,10 @@ export const mutate: {
    *   url.password = "pass"
    * })
    *
-   * console.log("Mutated:", mutatedUrl.toString())
-   * // Output: Mutated: https://user:pass@example.com/
+   * mutatedUrl.toString() // => "https://user:pass@example.com/"
    * ```
    *
-   * @category modifiers
+   * @category transforming
    * @since 4.0.0
    */
   (f: (url: URL) => void): (self: URL) => URL
@@ -229,7 +207,7 @@ export const mutate: {
    *
    * **Example** (Mutating URL credentials)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Url } from "effect/unstable/http"
    *
    * const myUrl = new URL("https://example.com")
@@ -239,11 +217,10 @@ export const mutate: {
    *   url.password = "pass"
    * })
    *
-   * console.log("Mutated:", mutatedUrl.toString())
-   * // Output: Mutated: https://user:pass@example.com/
+   * mutatedUrl.toString() // => "https://user:pass@example.com/"
    * ```
    *
-   * @category modifiers
+   * @category transforming
    * @since 4.0.0
    */
   (self: URL, f: (url: URL) => void): URL
@@ -509,7 +486,7 @@ export const setUsername: {
  *
  * **Example** (Replacing query parameters)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Url, UrlParams } from "effect/unstable/http"
  *
  * const myUrl = new URL("https://example.com?foo=bar")
@@ -520,8 +497,7 @@ export const setUsername: {
  *   UrlParams.fromInput([["key", "value"]])
  * )
  *
- * console.log(updatedUrl.toString())
- * // Output: https://example.com/?key=value
+ * updatedUrl.toString() // => "https://example.com/?key=value"
  * ```
  *
  * @category setters
@@ -539,7 +515,7 @@ export const setUrlParams: {
    *
    * **Example** (Replacing query parameters)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Url, UrlParams } from "effect/unstable/http"
    *
    * const myUrl = new URL("https://example.com?foo=bar")
@@ -550,8 +526,7 @@ export const setUrlParams: {
    *   UrlParams.fromInput([["key", "value"]])
    * )
    *
-   * console.log(updatedUrl.toString())
-   * // Output: https://example.com/?key=value
+   * updatedUrl.toString() // => "https://example.com/?key=value"
    * ```
    *
    * @category setters
@@ -569,7 +544,7 @@ export const setUrlParams: {
    *
    * **Example** (Replacing query parameters)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Url, UrlParams } from "effect/unstable/http"
    *
    * const myUrl = new URL("https://example.com?foo=bar")
@@ -580,8 +555,7 @@ export const setUrlParams: {
    *   UrlParams.fromInput([["key", "value"]])
    * )
    *
-   * console.log(updatedUrl.toString())
-   * // Output: https://example.com/?key=value
+   * updatedUrl.toString() // => "https://example.com/?key=value"
    * ```
    *
    * @category setters
@@ -604,16 +578,15 @@ export const setUrlParams: {
  *
  * **Example** (Reading query parameters)
  *
- * ```ts
- * import { Url } from "effect/unstable/http"
+ * ```ts import.meta.vitest
+ * import { Url, UrlParams } from "effect/unstable/http"
  *
  * const myUrl = new URL("https://example.com?foo=bar")
  *
  * // Read parameters
  * const params = Url.urlParams(myUrl)
  *
- * console.log(params)
- * // Output: [ [ 'foo', 'bar' ] ]
+ * UrlParams.toString(params) // => "foo=bar"
  * ```
  *
  * @category getters
@@ -633,18 +606,17 @@ export const urlParams = (url: URL): UrlParams.UrlParams => UrlParams.fromInput(
  *
  * **Example** (Modifying query parameters)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Url, UrlParams } from "effect/unstable/http"
  *
  * const myUrl = new URL("https://example.com?foo=bar")
  *
  * const changedUrl = Url.modifyUrlParams(myUrl, UrlParams.append("key", "value"))
  *
- * console.log(changedUrl.toString())
- * // Output: https://example.com/?foo=bar&key=value
+ * changedUrl.toString() // => "https://example.com/?foo=bar&key=value"
  * ```
  *
- * @category modifiers
+ * @category transforming
  * @since 4.0.0
  */
 export const modifyUrlParams: {
@@ -660,18 +632,17 @@ export const modifyUrlParams: {
    *
    * **Example** (Modifying query parameters)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Url, UrlParams } from "effect/unstable/http"
    *
    * const myUrl = new URL("https://example.com?foo=bar")
    *
    * const changedUrl = Url.modifyUrlParams(myUrl, UrlParams.append("key", "value"))
    *
-   * console.log(changedUrl.toString())
-   * // Output: https://example.com/?foo=bar&key=value
+   * changedUrl.toString() // => "https://example.com/?foo=bar&key=value"
    * ```
    *
-   * @category modifiers
+   * @category transforming
    * @since 4.0.0
    */
   (f: (urlParams: UrlParams.UrlParams) => UrlParams.Input): (url: URL) => URL
@@ -687,18 +658,17 @@ export const modifyUrlParams: {
    *
    * **Example** (Modifying query parameters)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Url, UrlParams } from "effect/unstable/http"
    *
    * const myUrl = new URL("https://example.com?foo=bar")
    *
    * const changedUrl = Url.modifyUrlParams(myUrl, UrlParams.append("key", "value"))
    *
-   * console.log(changedUrl.toString())
-   * // Output: https://example.com/?foo=bar&key=value
+   * changedUrl.toString() // => "https://example.com/?foo=bar&key=value"
    * ```
    *
-   * @category modifiers
+   * @category transforming
    * @since 4.0.0
    */
   (url: URL, f: (urlParams: UrlParams.UrlParams) => UrlParams.Input): URL

package/src/unstable/http/UrlParams.ts

@@ -16,6 +16,7 @@ import { dual } from "../../Function.ts"
 import * as Hash from "../../Hash.ts"
 import type { Inspectable } from "../../Inspectable.ts"
 import { PipeInspectableProto } from "../../internal/core.ts"
+import * as InternalRecord from "../../internal/record.ts"
 import * as Option from "../../Option.ts"
 import type { Pipeable } from "../../Pipeable.ts"
 import { hasProperty } from "../../Predicate.ts"
@@ -236,15 +237,15 @@ export interface UrlParamsSchema extends Schema.declare<UrlParams, ReadonlyArray
 export const UrlParamsSchema: UrlParamsSchema = Schema.declare(
   isUrlParams,
   {
-    typeConstructor: {
-      _tag: "effect/http/UrlParams"
-    },
-    generation: {
-      runtime: `UrlParams.UrlParamsSchema`,
-      Type: `UrlParams.UrlParams`,
-      Encoded: `typeof UrlParams.UrlParamsSchema["Encoded"]`,
-      importDeclaration: `import * as UrlParams from "effect/unstable/http/UrlParams"`
+    representation: {
+      id: "effect/http/UrlParams",
+      payload: null
     },
+    toCode: () => ({
+      runtime: "UrlParams.UrlParamsSchema",
+      Type: "UrlParams.UrlParams",
+      importDeclarations: [`import * as UrlParams from "effect/unstable/http/UrlParams"`]
+    }),
     expected: "UrlParams",
     toEquivalence: () => Equivalence,
     toCodec: () =>
@@ -651,9 +652,8 @@ export const toString = (input: Input): string => new URLSearchParams(fromInput(
  *
  * **Example** (Converting parameters to a record)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { UrlParams } from "effect/unstable/http"
- * import * as assert from "node:assert"
  *
  * const urlParams = UrlParams.fromInput({
  *   a: 1,
@@ -661,12 +661,7 @@ export const toString = (input: Input): string => new URLSearchParams(fromInput(
  *   c: "string",
  *   e: [1, 2, 3]
  * })
- * const result = UrlParams.toRecord(urlParams)
- *
- * assert.deepStrictEqual(
- *   result,
- *   { "a": "1", "b": "true", "c": "string", "e": ["1", "2", "3"] }
- * )
+ * UrlParams.toRecord(urlParams) // => { a: "1", b: "true", c: "string", e: ["1", "2", "3"] }
  * ```
  *
  * @category converting
@@ -675,13 +670,15 @@ export const toString = (input: Input): string => new URLSearchParams(fromInput(
 export const toRecord = (self: UrlParams): Record<string, string | Arr.NonEmptyArray<string>> => {
   const out: Record<string, string | Arr.NonEmptyArray<string>> = {}
   for (const [k, value] of self.params) {
-    const curr = out[k]
-    if (curr === undefined) {
-      out[k] = value
-    } else if (typeof curr === "string") {
-      out[k] = [curr, value]
+    if (!Object.hasOwn(out, k)) {
+      InternalRecord.assignProperty(out, k, value)
     } else {
-      curr.push(value)
+      const current = out[k]
+      if (typeof current === "string") {
+        InternalRecord.assignProperty(out, k, [current, value])
+      } else {
+        current.push(value)
+      }
     }
   }
   return out
@@ -707,7 +704,7 @@ export const toReadonlyRecord: (self: UrlParams) => ReadonlyRecord<string, strin
  * @category schemas
  * @since 4.0.0
  */
-export interface schemaJsonField extends Schema.decodeTo<Schema.UnknownFromJsonString, UrlParamsSchema> {}
+export interface schemaJsonField extends Schema.decodeTo<Schema.fromJsonString<Schema.Unknown>, UrlParamsSchema> {}
 
 /**
  * Extracts a JSON value from the first occurrence of the given `field` in the
@@ -715,7 +712,7 @@ export interface schemaJsonField extends Schema.decodeTo<Schema.UnknownFromJsonS
  *
  * **Example** (Decoding JSON parameter fields)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Schema } from "effect"
  * import { UrlParams } from "effect/unstable/http"
  *
@@ -726,12 +723,11 @@ export interface schemaJsonField extends Schema.decodeTo<Schema.UnknownFromJsonS
  *   }))
  * )
  *
- * console.log(
- *   Schema.decodeSync(extractFoo)(UrlParams.fromInput({
- *     foo: JSON.stringify({ some: "bar", number: 42 }),
+ * const decoded = Schema.decodeSync(extractFoo)(UrlParams.fromInput({
+ *     foo: `{"some":"bar","number":42}`,
  *     baz: "qux"
  *   }))
- * )
+ * const result = [decoded.some, decoded.number] // => ["bar", 42]
  * ```
  *
  * @category schemas
@@ -777,7 +773,7 @@ export interface schemaRecord extends
  *
  * **Example** (Decoding URL parameters to a record)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Schema } from "effect"
  * import { UrlParams } from "effect/unstable/http"
  *
@@ -788,12 +784,11 @@ export interface schemaRecord extends
  *   }))
  * )
  *
- * console.log(
- *   Schema.decodeSync(toStruct)(UrlParams.fromInput({
+ * const decoded = Schema.decodeSync(toStruct)(UrlParams.fromInput({
  *     some: "value",
  *     number: 42
  *   }))
- * )
+ * const result = [decoded.some, decoded.number] // => ["value", 42]
  * ```
  *
  * @category schemas