effect 4.0.0-beta.26 → 4.0.0-beta.27

package/dist/Cause.d.ts

@@ -1129,7 +1129,7 @@ export declare const pretty: <E>(cause: Cause<E>) => string;
  * const error = new Cause.NoSuchElementError("not found")
  *
  * const program = Effect.gen(function*() {
- *   yield* error // fails the effect with NoSuchElementError
+ *   return yield* error // fails the effect with NoSuchElementError
  * })
  * ```
  *

package/dist/Data.d.ts

@@ -875,7 +875,7 @@ export declare const taggedEnum: {
  * }> {}
  *
  * const program = Effect.gen(function*() {
- *   yield* new NetworkError({ code: 500, message: "timeout" })
+ *   return yield* new NetworkError({ code: 500, message: "timeout" })
  * })
  *
  * // The effect fails with a NetworkError
@@ -916,7 +916,7 @@ export declare const Error: new <A extends Record<string, any> = {}>(args: Types
  * }> {}
  *
  * const program = Effect.gen(function*() {
- *   yield* new NotFound({ resource: "/users/42" })
+ *   return yield* new NotFound({ resource: "/users/42" })
  * })
  *
  * const recovered = program.pipe(

package/dist/Data.js

@@ -185,7 +185,7 @@ function taggedMatch() {
  * }> {}
  *
  * const program = Effect.gen(function*() {
- *   yield* new NetworkError({ code: 500, message: "timeout" })
+ *   return yield* new NetworkError({ code: 500, message: "timeout" })
  * })
  *
  * // The effect fails with a NetworkError
@@ -224,7 +224,7 @@ export const Error = core.Error;
  * }> {}
  *
  * const program = Effect.gen(function*() {
- *   yield* new NotFound({ resource: "/users/42" })
+ *   return yield* new NotFound({ resource: "/users/42" })
  * })
  *
  * const recovered = program.pipe(

package/dist/Effect.d.ts

@@ -2200,17 +2200,17 @@ export declare const fromOption: <A>(option: Option<A>) => Effect<A, Cause.NoSuc
  * ```ts
  * import { Console, Effect } from "effect"
  *
- * const input: string | null = null
- *
- * const program = Effect.gen(function*() {
+ * const program = Effect.fn(function*(input: string | null) {
  *   const value = yield* Effect.fromNullishOr(input)
  *   yield* Console.log(value)
- * }).pipe(
+ * },
  *   Effect.catch(() => Console.log("missing"))
  * )
  *
- * Effect.runPromise(program)
+ * Effect.runPromise(program(null))
  * // Output: missing
+ * Effect.runPromise(program("hello"))
+ * // Output: hello
  * ```
  *
  * @since 4.0.0
@@ -6096,7 +6096,7 @@ export declare const tapDefect: {
  *   attempts++
  *   yield* Console.log(`Attempt ${attempts}`)
  *   if (attempts < 3) {
- *     yield* Effect.fail("Not ready")
+ *     return yield* Effect.fail("Not ready")
  *   }
  *   return "Ready"
  * })
@@ -6820,7 +6820,10 @@ export declare const ignoreCause: <Arg extends Effect<any, any, any> | {
  *
  * const fetchUrl = Effect.gen(function*() {
  *   const endpoint = yield* Effect.service(Endpoint)
- *   return endpoint.url === "bad" ? yield* Effect.fail("Unavailable") : endpoint.url
+ *   if (endpoint.url === "bad") {
+ *     return yield* Effect.fail("Unavailable")
+ *   }
+ *   return endpoint.url
  * })
  *
  * const plan = ExecutionPlan.make(
@@ -6851,7 +6854,10 @@ export declare const withExecutionPlan: {
      *
      * const fetchUrl = Effect.gen(function*() {
      *   const endpoint = yield* Effect.service(Endpoint)
-     *   return endpoint.url === "bad" ? yield* Effect.fail("Unavailable") : endpoint.url
+     *   if (endpoint.url === "bad") {
+     *     return yield* Effect.fail("Unavailable")
+     *   }
+     *   return endpoint.url
      * })
      *
      * const plan = ExecutionPlan.make(
@@ -6887,7 +6893,10 @@ export declare const withExecutionPlan: {
      *
      * const fetchUrl = Effect.gen(function*() {
      *   const endpoint = yield* Effect.service(Endpoint)
-     *   return endpoint.url === "bad" ? yield* Effect.fail("Unavailable") : endpoint.url
+     *   if (endpoint.url === "bad") {
+     *     return yield* Effect.fail("Unavailable")
+     *   }
+     *   return endpoint.url
      * })
      *
      * const plan = ExecutionPlan.make(
@@ -9612,7 +9621,7 @@ export declare const isSuccess: <A, E, R>(self: Effect<A, E, R>) => Effect<boole
  * @since 2.0.0
  * @category Environment
  */
-export declare const services: <R>() => Effect<ServiceMap.ServiceMap<R>, never, R>;
+export declare const services: <R = never>() => Effect<ServiceMap.ServiceMap<R>, never, R>;
 /**
  * Transforms the current service map using the provided function.
  *
@@ -9674,7 +9683,7 @@ export declare const servicesWith: <R, A, E, R2>(f: (services: ServiceMap.Servic
  * const Database = ServiceMap.Service<Database>("Database")
  *
  * const DatabaseLive = Layer.succeed(Database)({
- *   query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+ *   query: Effect.fn("Database.query")((sql: string) => Effect.succeed(`Result for: ${sql}`))
  * })
  *
  * const program = Effect.gen(function*() {
@@ -9708,7 +9717,7 @@ export declare const provide: {
      * const Database = ServiceMap.Service<Database>("Database")
      *
      * const DatabaseLive = Layer.succeed(Database)({
-     *   query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+     *   query: Effect.fn("Database.query")((sql: string) => Effect.succeed(`Result for: ${sql}`))
      * })
      *
      * const program = Effect.gen(function*() {
@@ -9744,7 +9753,7 @@ export declare const provide: {
      * const Database = ServiceMap.Service<Database>("Database")
      *
      * const DatabaseLive = Layer.succeed(Database)({
-     *   query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+     *   query: Effect.fn("Database.query")((sql: string) => Effect.succeed(`Result for: ${sql}`))
      * })
      *
      * const program = Effect.gen(function*() {
@@ -9780,7 +9789,7 @@ export declare const provide: {
      * const Database = ServiceMap.Service<Database>("Database")
      *
      * const DatabaseLive = Layer.succeed(Database)({
-     *   query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+     *   query: Effect.fn("Database.query")((sql: string) => Effect.succeed(`Result for: ${sql}`))
      * })
      *
      * const program = Effect.gen(function*() {
@@ -9814,7 +9823,7 @@ export declare const provide: {
      * const Database = ServiceMap.Service<Database>("Database")
      *
      * const DatabaseLive = Layer.succeed(Database)({
-     *   query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+     *   query: Effect.fn("Database.query")((sql: string) => Effect.succeed(`Result for: ${sql}`))
      * })
      *
      * const program = Effect.gen(function*() {
@@ -9850,7 +9859,7 @@ export declare const provide: {
      * const Database = ServiceMap.Service<Database>("Database")
      *
      * const DatabaseLive = Layer.succeed(Database)({
-     *   query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+     *   query: Effect.fn("Database.query")((sql: string) => Effect.succeed(`Result for: ${sql}`))
      * })
      *
      * const program = Effect.gen(function*() {
@@ -9886,7 +9895,7 @@ export declare const provide: {
      * const Database = ServiceMap.Service<Database>("Database")
      *
      * const DatabaseLive = Layer.succeed(Database)({
-     *   query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+     *   query: Effect.fn("Database.query")((sql: string) => Effect.succeed(`Result for: ${sql}`))
      * })
      *
      * const program = Effect.gen(function*() {
@@ -12059,8 +12068,8 @@ export declare const cachedInvalidateWithTTL: {
  * import { Effect } from "effect"
  *
  * const program = Effect.gen(function*() {
- *   yield* Effect.interrupt
- *   yield* Effect.succeed("This won't execute")
+ *   return yield* Effect.interrupt
+ *   yield* Effect.succeed("This won't execute and is unreachable")
  * })
  *
  * Effect.runPromise(program).catch(console.error)
@@ -12829,7 +12838,7 @@ export declare const repeat: {
  *   attempt++
  *   if (attempt <= 2) {
  *     yield* Console.log(`Attempt ${attempt} failed`)
- *     yield* Effect.fail(`Error ${attempt}`)
+ *     return yield* Effect.fail(`Error ${attempt}`)
  *   }
  *   yield* Console.log(`Attempt ${attempt} succeeded`)
  *   return "success"
@@ -12879,7 +12888,7 @@ export declare const repeatOrElse: {
      *   attempt++
      *   if (attempt <= 2) {
      *     yield* Console.log(`Attempt ${attempt} failed`)
-     *     yield* Effect.fail(`Error ${attempt}`)
+     *     return yield* Effect.fail(`Error ${attempt}`)
      *   }
      *   yield* Console.log(`Attempt ${attempt} succeeded`)
      *   return "success"
@@ -12929,7 +12938,7 @@ export declare const repeatOrElse: {
      *   attempt++
      *   if (attempt <= 2) {
      *     yield* Console.log(`Attempt ${attempt} failed`)
-     *     yield* Effect.fail(`Error ${attempt}`)
+     *     return yield* Effect.fail(`Error ${attempt}`)
      *   }
      *   yield* Console.log(`Attempt ${attempt} succeeded`)
      *   return "success"