@effect/platform 0.63.3 → 0.64.1

package/README.md

@@ -2,23 +2,8 @@
 
 Welcome to the documentation for `@effect/platform`, a library designed for creating platform-independent abstractions (Node.js, Bun, browsers).
 
-With `@effect/platform`, you can incorporate abstract services like `Terminal` or `FileSystem` into your program. Later, during the assembly of the final application, you can provide specific layers for the target platform using the corresponding packages: `platform-node`, `platform-bun`, and `platform-browser`.
-
-This package empowers you to perform various operations, such as:
-
-| **Operation**  | **Description**                                                                                  |
-| -------------- | ------------------------------------------------------------------------------------------------ |
-| HTTP API       | Declarative HTTP API servers & clients                                                           |
-| HTTP Client    | Sending HTTP requests and receiving responses                                                    |
-| HTTP Server    | Creating HTTP servers to handle incoming requests                                                |
-| HTTP Router    | Routing HTTP requests to specific handlers                                                       |
-| Terminal       | Reading and writing from/to standard input/output                                                |
-| Command        | Creating and running a command with the specified process name and an optional list of arguments |
-| FileSystem     | Reading and writing from/to the file system                                                      |
-| KeyValueStore  | Storing and retrieving key-value pairs                                                           |
-| PlatformLogger | Creating a logger that writes to a specified file from another string logger                     |
-
-By utilizing `@effect/platform`, you can write code that remains platform-agnostic, ensuring compatibility across different environments.
+> [!WARNING]
+> This documentation focuses on **unstable modules**. For stable modules, refer to the [official website documentation](https://effect.website/docs/guides/platform/introduction).
 
 # HTTP API
 
@@ -2345,402 +2330,3 @@ const handler = HttpApp.toWebHandler(router)
 const response = await handler(new Request("http://localhost:3000/foo"))
 console.log(await response.text()) // Output: content 2
 ```
-
-# Terminal
-
-The `@effect/platform/Terminal` module exports a single `Terminal` tag, which serves as the entry point to reading from and writing to standard input and standard output.
-
-## Writing to standard output
-
-```ts
-import { Terminal } from "@effect/platform"
-import { NodeRuntime, NodeTerminal } from "@effect/platform-node"
-import { Effect } from "effect"
-
-// const displayMessage: Effect.Effect<void, PlatformError, Terminal.Terminal>
-const displayMessage = Effect.gen(function* (_) {
-  const terminal = yield* _(Terminal.Terminal)
-  yield* _(terminal.display("a message\n"))
-})
-
-NodeRuntime.runMain(displayMessage.pipe(Effect.provide(NodeTerminal.layer)))
-// Output: "a message"
-```
-
-## Reading from standard input
-
-```ts
-import { Terminal } from "@effect/platform"
-import { NodeRuntime, NodeTerminal } from "@effect/platform-node"
-import { Console, Effect } from "effect"
-
-// const readLine: Effect.Effect<void, Terminal.QuitException, Terminal.Terminal>
-const readLine = Effect.gen(function* (_) {
-  const terminal = yield* _(Terminal.Terminal)
-  const input = yield* _(terminal.readLine)
-  yield* _(Console.log(`input: ${input}`))
-})
-
-NodeRuntime.runMain(readLine.pipe(Effect.provide(NodeTerminal.layer)))
-// Input: "hello"
-// Output: "input: hello"
-```
-
-These simple examples illustrate how to utilize the `Terminal` module for handling standard input and output in your programs. Let's use this knowledge to build a number guessing game:
-
-```ts
-import { Terminal } from "@effect/platform"
-import type { PlatformError } from "@effect/platform/Error"
-import { Effect, Option, Random } from "effect"
-
-export const secret = Random.nextIntBetween(1, 100)
-
-const parseGuess = (input: string) => {
-  const n = parseInt(input, 10)
-  return isNaN(n) || n < 1 || n > 100 ? Option.none() : Option.some(n)
-}
-
-const display = (message: string) =>
-  Effect.gen(function* (_) {
-    const terminal = yield* _(Terminal.Terminal)
-    yield* _(terminal.display(`${message}\n`))
-  })
-
-const prompt = Effect.gen(function* (_) {
-  const terminal = yield* _(Terminal.Terminal)
-  yield* _(terminal.display("Enter a guess: "))
-  return yield* _(terminal.readLine)
-})
-
-const answer: Effect.Effect<
-  number,
-  Terminal.QuitException | PlatformError,
-  Terminal.Terminal
-> = Effect.gen(function* (_) {
-  const input = yield* _(prompt)
-  const guess = parseGuess(input)
-  if (Option.isNone(guess)) {
-    yield* _(display("You must enter an integer from 1 to 100"))
-    return yield* _(answer)
-  }
-  return guess.value
-})
-
-const check = <A, E, R>(
-  secret: number,
-  guess: number,
-  ok: Effect.Effect<A, E, R>,
-  ko: Effect.Effect<A, E, R>
-): Effect.Effect<A, E | PlatformError, R | Terminal.Terminal> =>
-  Effect.gen(function* (_) {
-    if (guess > secret) {
-      yield* _(display("Too high"))
-      return yield* _(ko)
-    } else if (guess < secret) {
-      yield* _(display("Too low"))
-      return yield* _(ko)
-    } else {
-      return yield* _(ok)
-    }
-  })
-
-const end = display("You guessed it!")
-
-const loop = (
-  secret: number
-): Effect.Effect<
-  void,
-  Terminal.QuitException | PlatformError,
-  Terminal.Terminal
-> =>
-  Effect.gen(function* (_) {
-    const guess = yield* _(answer)
-    return yield* _(
-      check(
-        secret,
-        guess,
-        end,
-        Effect.suspend(() => loop(secret))
-      )
-    )
-  })
-
-export const game = Effect.gen(function* (_) {
-  yield* _(
-    display(
-      "We have selected a random number between 1 and 100. See if you can guess it in 10 turns or fewer. We'll tell you if your guess was too high or too low."
-    )
-  )
-  yield* _(loop(yield* _(secret)))
-})
-```
-
-Let's run the game in Node.js:
-
-```ts
-import { NodeRuntime, NodeTerminal } from "@effect/platform-node"
-import * as Effect from "effect/Effect"
-import { game } from "./game.js"
-
-NodeRuntime.runMain(game.pipe(Effect.provide(NodeTerminal.layer)))
-```
-
-Let's run the game in Bun:
-
-```ts
-import { BunRuntime, BunTerminal } from "@effect/platform-bun"
-import * as Effect from "effect/Effect"
-import { game } from "./game.js"
-
-BunRuntime.runMain(game.pipe(Effect.provide(BunTerminal.layer)))
-```
-
-# Command
-
-As an example of using the `@effect/platform/Command` module, let's see how to run the TypeScript compiler `tsc`:
-
-```ts
-import { Command, CommandExecutor } from "@effect/platform"
-import {
-  NodeCommandExecutor,
-  NodeFileSystem,
-  NodeRuntime
-} from "@effect/platform-node"
-import { Effect } from "effect"
-
-// const program: Effect.Effect<string, PlatformError, CommandExecutor.CommandExecutor>
-const program = Effect.gen(function* (_) {
-  const executor = yield* _(CommandExecutor.CommandExecutor)
-
-  // Creating a command to run the TypeScript compiler
-  const command = Command.make("tsc", "--noEmit")
-  console.log("Running tsc...")
-
-  // Executing the command and capturing the output
-  const output = yield* _(executor.string(command))
-  console.log(output)
-  return output
-})
-
-// Running the program with the necessary runtime and executor layers
-NodeRuntime.runMain(
-  program.pipe(
-    Effect.provide(NodeCommandExecutor.layer),
-    Effect.provide(NodeFileSystem.layer)
-  )
-)
-```
-
-## Obtaining Information About the Running Process
-
-Here, we'll explore how to retrieve information about a running process.
-
-```ts
-import { Command, CommandExecutor } from "@effect/platform"
-import {
-  NodeCommandExecutor,
-  NodeFileSystem,
-  NodeRuntime
-} from "@effect/platform-node"
-import { Effect, Stream, String } from "effect"
-
-const runString = <E, R>(
-  stream: Stream.Stream<Uint8Array, E, R>
-): Effect.Effect<string, E, R> =>
-  stream.pipe(Stream.decodeText(), Stream.runFold(String.empty, String.concat))
-
-const program = Effect.gen(function* (_) {
-  const executor = yield* _(CommandExecutor.CommandExecutor)
-
-  const command = Command.make("ls")
-
-  const [exitCode, stdout, stderr] = yield* _(
-    // Start running the command and return a handle to the running process.
-    executor.start(command),
-    Effect.flatMap((process) =>
-      Effect.all(
-        [
-          // Waits for the process to exit and returns the ExitCode of the command that was run.
-          process.exitCode,
-          // The standard output stream of the process.
-          runString(process.stdout),
-          // The standard error stream of the process.
-          runString(process.stderr)
-        ],
-        { concurrency: 3 }
-      )
-    )
-  )
-  console.log({ exitCode, stdout, stderr })
-})
-
-NodeRuntime.runMain(
-  Effect.scoped(program).pipe(
-    Effect.provide(NodeCommandExecutor.layer),
-    Effect.provide(NodeFileSystem.layer)
-  )
-)
-```
-
-## Running a Platform Command with stdout Streamed to process.stdout
-
-To run a command (for example `cat`) and stream its `stdout` to `process.stdout` follow these steps:
-
-```ts
-import { Command } from "@effect/platform"
-import { NodeContext, NodeRuntime } from "@effect/platform-node"
-import { Effect } from "effect"
-
-// Create a command to run `cat` on a file and inherit stdout
-const program = Command.make("cat", "./some-file.txt").pipe(
-  Command.stdout("inherit"),
-  Command.exitCode
-)
-
-// Run the command using NodeRuntime with the NodeContext layer
-NodeRuntime.runMain(program.pipe(Effect.provide(NodeContext.layer)))
-```
-
-# FileSystem
-
-The `@effect/platform/FileSystem` module provides a single `FileSystem` tag, which acts as the gateway for interacting with the filesystem.
-
-Here's a list of operations that can be performed using the `FileSystem` tag:
-
-| **Name**                    | **Arguments**                                                    | **Return**                                     | **Description**                                                                                                                                                        |
-| --------------------------- | ---------------------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **access**                  | `path: string`, `options?: AccessFileOptions`                    | `Effect<void, PlatformError>`                  | Check if a file can be accessed. You can optionally specify the level of access to check for.                                                                          |
-| **copy**                    | `fromPath: string`, `toPath: string`, `options?: CopyOptions`    | `Effect<void, PlatformError>`                  | Copy a file or directory from `fromPath` to `toPath`. Equivalent to `cp -r`.                                                                                           |
-| **copyFile**                | `fromPath: string`, `toPath: string`                             | `Effect<void, PlatformError>`                  | Copy a file from `fromPath` to `toPath`.                                                                                                                               |
-| **chmod**                   | `path: string`, `mode: number`                                   | `Effect<void, PlatformError>`                  | Change the permissions of a file.                                                                                                                                      |
-| **chown**                   | `path: string`, `uid: number`, `gid: number`                     | `Effect<void, PlatformError>`                  | Change the owner and group of a file.                                                                                                                                  |
-| **exists**                  | `path: string`                                                   | `Effect<boolean, PlatformError>`               | Check if a path exists.                                                                                                                                                |
-| **link**                    | `fromPath: string`, `toPath: string`                             | `Effect<void, PlatformError>`                  | Create a hard link from `fromPath` to `toPath`.                                                                                                                        |
-| **makeDirectory**           | `path: string`, `options?: MakeDirectoryOptions`                 | `Effect<void, PlatformError>`                  | Create a directory at `path`. You can optionally specify the mode and whether to recursively create nested directories.                                                |
-| **makeTempDirectory**       | `options?: MakeTempDirectoryOptions`                             | `Effect<string, PlatformError>`                | Create a temporary directory. By default, the directory will be created inside the system's default temporary directory.                                               |
-| **makeTempDirectoryScoped** | `options?: MakeTempDirectoryOptions`                             | `Effect<string, PlatformError, Scope>`         | Create a temporary directory inside a scope. Functionally equivalent to `makeTempDirectory`, but the directory will be automatically deleted when the scope is closed. |
-| **makeTempFile**            | `options?: MakeTempFileOptions`                                  | `Effect<string, PlatformError>`                | Create a temporary file. The directory creation is functionally equivalent to `makeTempDirectory`. The file name will be a randomly generated string.                  |
-| **makeTempFileScoped**      | `options?: MakeTempFileOptions`                                  | `Effect<string, PlatformError, Scope>`         | Create a temporary file inside a scope. Functionally equivalent to `makeTempFile`, but the file will be automatically deleted when the scope is closed.                |
-| **open**                    | `path: string`, `options?: OpenFileOptions`                      | `Effect<File, PlatformError, Scope>`           | Open a file at `path` with the specified `options`. The file handle will be automatically closed when the scope is closed.                                             |
-| **readDirectory**           | `path: string`, `options?: ReadDirectoryOptions`                 | `Effect<Array<string>, PlatformError>`         | List the contents of a directory. You can recursively list the contents of nested directories by setting the `recursive` option.                                       |
-| **readFile**                | `path: string`                                                   | `Effect<Uint8Array, PlatformError>`            | Read the contents of a file.                                                                                                                                           |
-| **readFileString**          | `path: string`, `encoding?: string`                              | `Effect<string, PlatformError>`                | Read the contents of a file as a string.                                                                                                                               |
-| **readLink**                | `path: string`                                                   | `Effect<string, PlatformError>`                | Read the destination of a symbolic link.                                                                                                                               |
-| **realPath**                | `path: string`                                                   | `Effect<string, PlatformError>`                | Resolve a path to its canonicalized absolute pathname.                                                                                                                 |
-| **remove**                  | `path: string`, `options?: RemoveOptions`                        | `Effect<void, PlatformError>`                  | Remove a file or directory. By setting the `recursive` option to `true`, you can recursively remove nested directories.                                                |
-| **rename**                  | `oldPath: string`, `newPath: string`                             | `Effect<void, PlatformError>`                  | Rename a file or directory.                                                                                                                                            |
-| **sink**                    | `path: string`, `options?: SinkOptions`                          | `Sink<void, Uint8Array, never, PlatformError>` | Create a writable `Sink` for the specified `path`.                                                                                                                     |
-| **stat**                    | `path: string`                                                   | `Effect<File.Info, PlatformError>`             | Get information about a file at `path`.                                                                                                                                |
-| **stream**                  | `path: string`, `options?: StreamOptions`                        | `Stream<Uint8Array, PlatformError>`            | Create a readable `Stream` for the specified `path`.                                                                                                                   |
-| **symlink**                 | `fromPath: string`, `toPath: string`                             | `Effect<void, PlatformError>`                  | Create a symbolic link from `fromPath` to `toPath`.                                                                                                                    |
-| **truncate**                | `path: string`, `length?: SizeInput`                             | `Effect<void, PlatformError>`                  | Truncate a file to a specified length. If the `length` is not specified, the file will be truncated to length `0`.                                                     |
-| **utimes**                  | `path: string`, `atime: Date \| number`, `mtime: Date \| number` | `Effect<void, PlatformError>`                  | Change the file system timestamps of the file at `path`.                                                                                                               |
-| **watch**                   | `path: string`                                                   | `Stream<WatchEvent, PlatformError>`            | Watch a directory or file for changes.                                                                                                                                 |
-
-Let's explore a simple example using `readFileString`:
-
-```ts
-import { FileSystem } from "@effect/platform"
-import { NodeFileSystem, NodeRuntime } from "@effect/platform-node"
-import { Effect } from "effect"
-
-// const readFileString: Effect.Effect<void, PlatformError, FileSystem.FileSystem>
-const readFileString = Effect.gen(function* (_) {
-  const fs = yield* _(FileSystem.FileSystem)
-
-  // Reading the content of the same file where this code is written
-  const content = yield* _(fs.readFileString("./index.ts", "utf8"))
-  console.log(content)
-})
-
-NodeRuntime.runMain(readFileString.pipe(Effect.provide(NodeFileSystem.layer)))
-```
-
-# KeyValueStore
-
-## Overview
-
-The `KeyValueStore` module provides a robust and effectful interface for managing key-value pairs. It supports asynchronous operations, ensuring data integrity and consistency, and includes built-in implementations for in-memory, file system-based, and schema-validated stores.
-
-## Basic Usage
-
-The `KeyValueStore` interface includes the following operations:
-
-- **get**: Retrieve a value by key.
-- **set**: Store a key-value pair.
-- **remove**: Delete a key-value pair.
-- **clear**: Remove all key-value pairs.
-- **size**: Get the number of stored pairs.
-- **modify**: Atomically modify a value.
-- **has**: Check if a key exists.
-- **isEmpty**: Check if the store is empty.
-
-**Example**
-
-```ts
-import { KeyValueStore, layerMemory } from "@effect/platform/KeyValueStore"
-import { Effect } from "effect"
-
-const program = Effect.gen(function* () {
-  const store = yield* KeyValueStore
-  console.log(yield* store.size) // Outputs: 0
-
-  yield* store.set("key", "value")
-  console.log(yield* store.size) // Outputs: 1
-
-  const value = yield* store.get("key")
-  console.log(value) // Outputs: { _id: 'Option', _tag: 'Some', value: 'value' }
-
-  yield* store.remove("key")
-  console.log(yield* store.size) // Outputs: 0
-})
-
-Effect.runPromise(program.pipe(Effect.provide(layerMemory)))
-```
-
-## Built-in Implementations
-
-The module provides several built-in implementations to suit different needs:
-
-- **In-Memory Store**: `layerMemory` provides a simple, in-memory key-value store, ideal for lightweight or testing scenarios.
-- **File System Store**: `layerFileSystem` offers a file-based store for persistent storage needs.
-- **Schema Store**: `layerSchema` enables schema-based validation for stored values, ensuring data integrity and type safety.
-
-## Schema Store
-
-The `SchemaStore` implementation allows you to validate and parse values according to a defined schema. This ensures that all data stored in the key-value store adheres to the specified structure, enhancing data integrity and type safety.
-
-**Example**
-
-```ts
-import { KeyValueStore, layerMemory } from "@effect/platform/KeyValueStore"
-import { Schema } from "@effect/schema"
-import { Effect } from "effect"
-
-// Define a schema for the values
-const Person = Schema.Struct({
-  name: Schema.String,
-  age: Schema.Number
-})
-
-const program = Effect.gen(function* () {
-  const store = (yield* KeyValueStore).forSchema(Person)
-
-  // Create a value that adheres to the schema
-  const value = { name: "Alice", age: 30 }
-  yield* store.set("user1", value)
-  console.log(yield* store.size) // Outputs: 1
-
-  // Retrieve and validate the value
-  const retrievedValue = yield* store.get("user1")
-  console.log(retrievedValue) // Outputs: { _id: 'Option', _tag: 'Some', value: { name: 'Alice', age: 30 } }
-})
-
-Effect.runPromise(program.pipe(Effect.provide(layerMemory)))
-```
-
-In this example:
-
-- **Person**: Defines the structure for the values stored in the key-value store.
-- **store.set**: Stores a value adhering to `Person`.
-- **store.get**: Retrieves and validates the stored value against `Person`.

package/dist/cjs/Command.js

@@ -44,9 +44,9 @@ const feed = exports.feed = internal.feed;
 /**
  * Flatten this command to a non-empty array of standard commands.
  *
- * * For a `StandardCommand`, this simply returns a `1` element array
- * * For a `PipedCommand`, all commands in the pipe will be extracted out into
- *   a array from left to right
+ * For a `StandardCommand`, this simply returns a `1` element array
+ * For a `PipedCommand`, all commands in the pipe will be extracted out into
+ * a array from left to right
  *
  * @since 1.0.0
  * @category combinators

package/dist/cjs/Command.js.map

@@ -1 +1 @@
-{"version":3,"file":"Command.js","names":["internal","_interopRequireWildcard","require","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","CommandTypeId","exports","isCommand","env","exitCode","feed","flatten","lines","make","pipeTo","runInShell","start","stream","streamLines","string","stderr","stdin","stdout","workingDirectory"],"sources":["../../src/Command.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Command.js","names":["internal","_interopRequireWildcard","require","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","CommandTypeId","exports","isCommand","env","exitCode","feed","flatten","lines","make","pipeTo","runInShell","start","stream","streamLines","string","stderr","stdin","stdout","workingDirectory"],"sources":["../../src/Command.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/Etag.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.toString = exports.GeneratorTypeId = exports.Generator = void 0;
+exports.toString = exports.layerWeak = exports.layer = exports.GeneratorTypeId = exports.Generator = void 0;
 var internal = _interopRequireWildcard(require("./internal/etag.js"));
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
@@ -22,4 +22,14 @@ const GeneratorTypeId = exports.GeneratorTypeId = internal.GeneratorTypeId;
  * @category tags
  */
 const Generator = exports.Generator = internal.tag;
+/**
+ * @since 1.0.0
+ * @category layers
+ */
+const layer = exports.layer = internal.layer;
+/**
+ * @since 1.0.0
+ * @category layers
+ */
+const layerWeak = exports.layerWeak = internal.layerWeak;
 //# sourceMappingURL=Etag.js.map

package/dist/cjs/Etag.js.map

@@ -1 +1 @@
-{"version":3,"file":"Etag.js","names":["internal","_interopRequireWildcard","require","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","toString","exports","GeneratorTypeId","Generator","tag"],"sources":["../../src/Etag.ts"],"sourcesContent":[null],"mappings":";;;;;;AAOA,IAAAA,QAAA,GAAAC,uBAAA,CAAAC,OAAA;AAA8C,SAAAC,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,CAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAH,wBAAAG,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAI,UAAA,SAAAJ,CAAA,eAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,WAAAK,OAAA,EAAAL,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAG,GAAA,CAAAN,CAAA,UAAAG,CAAA,CAAAI,GAAA,CAAAP,CAAA,OAAAQ,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,CAAA,IAAAd,CAAA,oBAAAc,CAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAhB,CAAA,EAAAc,CAAA,SAAAG,CAAA,GAAAP,CAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAb,CAAA,EAAAc,CAAA,UAAAG,CAAA,KAAAA,CAAA,CAAAV,GAAA,IAAAU,CAAA,CAAAC,GAAA,IAAAP,MAAA,CAAAC,cAAA,CAAAJ,CAAA,EAAAM,CAAA,EAAAG,CAAA,IAAAT,CAAA,CAAAM,CAAA,IAAAd,CAAA,CAAAc,CAAA,YAAAN,CAAA,CAAAH,OAAA,GAAAL,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAe,GAAA,CAAAlB,CAAA,EAAAQ,CAAA,GAAAA,CAAA;AA0B9C;;;;AAIO,MAAMW,QAAQ,GAAAC,OAAA,CAAAD,QAAA,GAA2BvB,QAAQ,CAACuB,QAAQ;AAEjE;;;;AAIO,MAAME,eAAe,GAAAD,OAAA,CAAAC,eAAA,GAAkBzB,QAAQ,CAACyB,eAAe;AAkBtE;;;;AAIO,MAAMC,SAAS,GAAAF,OAAA,CAAAE,SAAA,GAAsC1B,QAAQ,CAAC2B,GAAG","ignoreList":[]}
+{"version":3,"file":"Etag.js","names":["internal","_interopRequireWildcard","require","_getRequireWildcardCache","e","WeakMap","r","t","__esModule","default","has","get","n","__proto__","a","Object","defineProperty","getOwnPropertyDescriptor","u","hasOwnProperty","call","i","set","toString","exports","GeneratorTypeId","Generator","tag","layer","layerWeak"],"sources":["../../src/Etag.ts"],"sourcesContent":[null],"mappings":";;;;;;AAQA,IAAAA,QAAA,GAAAC,uBAAA,CAAAC,OAAA;AAA8C,SAAAC,yBAAAC,CAAA,6BAAAC,OAAA,mBAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAF,wBAAA,YAAAA,CAAAC,CAAA,WAAAA,CAAA,GAAAG,CAAA,GAAAD,CAAA,KAAAF,CAAA;AAAA,SAAAH,wBAAAG,CAAA,EAAAE,CAAA,SAAAA,CAAA,IAAAF,CAAA,IAAAA,CAAA,CAAAI,UAAA,SAAAJ,CAAA,eAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,WAAAK,OAAA,EAAAL,CAAA,QAAAG,CAAA,GAAAJ,wBAAA,CAAAG,CAAA,OAAAC,CAAA,IAAAA,CAAA,CAAAG,GAAA,CAAAN,CAAA,UAAAG,CAAA,CAAAI,GAAA,CAAAP,CAAA,OAAAQ,CAAA,KAAAC,SAAA,UAAAC,CAAA,GAAAC,MAAA,CAAAC,cAAA,IAAAD,MAAA,CAAAE,wBAAA,WAAAC,CAAA,IAAAd,CAAA,oBAAAc,CAAA,OAAAC,cAAA,CAAAC,IAAA,CAAAhB,CAAA,EAAAc,CAAA,SAAAG,CAAA,GAAAP,CAAA,GAAAC,MAAA,CAAAE,wBAAA,CAAAb,CAAA,EAAAc,CAAA,UAAAG,CAAA,KAAAA,CAAA,CAAAV,GAAA,IAAAU,CAAA,CAAAC,GAAA,IAAAP,MAAA,CAAAC,cAAA,CAAAJ,CAAA,EAAAM,CAAA,EAAAG,CAAA,IAAAT,CAAA,CAAAM,CAAA,IAAAd,CAAA,CAAAc,CAAA,YAAAN,CAAA,CAAAH,OAAA,GAAAL,CAAA,EAAAG,CAAA,IAAAA,CAAA,CAAAe,GAAA,CAAAlB,CAAA,EAAAQ,CAAA,GAAAA,CAAA;AA0B9C;;;;AAIO,MAAMW,QAAQ,GAAAC,OAAA,CAAAD,QAAA,GAA2BvB,QAAQ,CAACuB,QAAQ;AAEjE;;;;AAIO,MAAME,eAAe,GAAAD,OAAA,CAAAC,eAAA,GAAkBzB,QAAQ,CAACyB,eAAe;AAkBtE;;;;AAIO,MAAMC,SAAS,GAAAF,OAAA,CAAAE,SAAA,GAAsC1B,QAAQ,CAAC2B,GAAG;AAExE;;;;AAIO,MAAMC,KAAK,GAAAJ,OAAA,CAAAI,KAAA,GAAqB5B,QAAQ,CAAC4B,KAAK;AAErD;;;;AAIO,MAAMC,SAAS,GAAAL,OAAA,CAAAK,SAAA,GAAqB7B,QAAQ,CAAC6B,SAAS","ignoreList":[]}

package/dist/cjs/HttpApiBuilder.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.serve = exports.securitySetCookie = exports.securityDecode = exports.middlewareSecurityVoid = exports.middlewareSecurity = exports.middlewareOpenApi = exports.middlewareLayerScoped = exports.middlewareLayer = exports.middlewareCors = exports.middleware = exports.httpApp = exports.handle = exports.group = exports.api = exports.Router = exports.Middleware = exports.HandlersTypeId = void 0;
+exports.toWebHandler = exports.serve = exports.securitySetCookie = exports.securityDecode = exports.middlewareSecurityVoid = exports.middlewareSecurity = exports.middlewareOpenApi = exports.middlewareLayerScoped = exports.middlewareLayer = exports.middlewareCors = exports.middleware = exports.httpApp = exports.handle = exports.group = exports.api = exports.Router = exports.Middleware = exports.HandlersTypeId = void 0;
 var AST = _interopRequireWildcard(require("@effect/schema/AST"));
 var ParseResult = _interopRequireWildcard(require("@effect/schema/ParseResult"));
 var Schema = _interopRequireWildcard(require("@effect/schema/Schema"));
@@ -74,6 +74,39 @@ const httpApp = exports.httpApp = /*#__PURE__*/Effect.gen(function* () {
     onSuccess: Effect.succeed
   })));
 });
+/**
+ * Construct an http web handler from an `HttpApi` instance.
+ *
+ * @since 1.0.0
+ * @category constructors
+ * @example
+ * import { HttpApi } from "@effect/platform"
+ * import { Etag, HttpApiBuilder, HttpMiddleware, HttpPlatform } from "@effect/platform"
+ * import { NodeContext } from "@effect/platform-node"
+ * import { Layer, ManagedRuntime } from "effect"
+ *
+ * const ApiLive = HttpApiBuilder.api(HttpApi.empty)
+ *
+ * const runtime = ManagedRuntime.make(
+ *   Layer.mergeAll(
+ *     ApiLive,
+ *     HttpApiBuilder.Router.Live,
+ *     HttpPlatform.layer,
+ *     Etag.layerWeak
+ *   ).pipe(
+ *     Layer.provideMerge(NodeContext.layer)
+ *   )
+ * )
+ *
+ * const handler = HttpApiBuilder.toWebHandler(runtime, HttpMiddleware.logger)
+ */
+const toWebHandler = (runtime, middleware) => {
+  const handlerPromise = httpApp.pipe(Effect.bindTo("httpApp"), Effect.bind("runtime", () => runtime.runtimeEffect), Effect.map(({
+    httpApp,
+    runtime
+  }) => HttpApp.toWebHandlerRuntime(runtime)(middleware ? middleware(httpApp) : httpApp)), runtime.runPromise);
+  return request => handlerPromise.then(handler => handler(request));
+};
 /**
  * Build a root level `Layer` from an `HttpApi` instance.
  *
@@ -85,6 +118,7 @@ const httpApp = exports.httpApp = /*#__PURE__*/Effect.gen(function* () {
  * @since 1.0.0
  * @category constructors
  */
+exports.toWebHandler = toWebHandler;
 const api = self => Layer.succeed(HttpApi.HttpApi, self);
 /**
  * @since 1.0.0