effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/Pull.d.ts

@@ -35,6 +35,12 @@ import * as Result from "./Result.ts";
  * An effectful pull step that either produces a value, fails with `E`, or
  * signals completion with `Cause.Done<Done>`.
  *
+ * **When to use**
+ *
+ * Use to model one low-level pull step when a consumer repeatedly evaluates an
+ * effect that may emit a value, fail normally, or signal normal completion
+ * through `Cause.Done`.
+ *
  * **Details**
  *
  * `Pull` represents completion in the error channel so low-level stream
@@ -49,6 +55,15 @@ export interface Pull<out A, out E = never, out Done = void, out R = never> exte
 /**
  * Extracts the success type from a Pull type.
  *
+ * **When to use**
+ *
+ * Use to derive the value produced by an existing `Pull` when declaring
+ * reusable type aliases, low-level stream helpers, or function signatures.
+ *
+ * @see {@link Error} for extracting the ordinary failure type
+ * @see {@link Leftover} for extracting the completion leftover type
+ * @see {@link Services} for extracting the required services type instead
+ *
  * @category type extractors
  * @since 4.0.0
  */
@@ -56,6 +71,16 @@ export type Success<P> = P extends Effect<infer _A, infer _E, infer _R> ? _A : n
 /**
  * Extracts the error type from a Pull type, excluding Done errors.
  *
+ * **When to use**
+ *
+ * Use to derive only the ordinary failure type from a `Pull` when declaring
+ * wrappers or APIs that handle completion separately.
+ *
+ * @see {@link Success} for extracting the pulled value type instead
+ * @see {@link Leftover} for extracting the completion leftover type
+ * @see {@link Services} for extracting the required services type instead
+ * @see {@link ExcludeDone} for excluding `Cause.Done` from an error union
+ *
  * @category type extractors
  * @since 4.0.0
  */
@@ -63,6 +88,16 @@ export type Error<P> = P extends Effect<infer _A, infer _E, infer _R> ? _E exten
 /**
  * Extracts the leftover type from a Pull type.
  *
+ * **When to use**
+ *
+ * Use to derive the completion leftover type from an existing `Pull` when
+ * declaring reusable type aliases or helper signatures that preserve a pull's
+ * done value.
+ *
+ * @see {@link Success} for extracting the pulled value type instead
+ * @see {@link Error} for extracting the ordinary failure type, excluding `Cause.Done`
+ * @see {@link Services} for extracting the required services type instead
+ *
  * @category type extractors
  * @since 4.0.0
  */
@@ -70,12 +105,29 @@ export type Leftover<P> = P extends Effect<infer _A, infer _E, infer _R> ? _E ex
 /**
  * Extracts the service requirements (context) type from a Pull type.
  *
+ * **When to use**
+ *
+ * Use to derive the context requirements of a generic or inferred `Pull`
+ * without restating its `R` type parameter.
+ *
+ * @see {@link Success} for extracting the pulled value type instead
+ * @see {@link Error} for extracting the ordinary failure type
+ * @see {@link Leftover} for extracting the completion leftover type
+ *
  * @category type extractors
  * @since 4.0.0
  */
 export type Services<P> = P extends Effect<infer _A, infer _E, infer _R> ? _R : never;
 /**
- * Excludes done errors from an error type union.
+ * Excludes `Cause.Done` completion signals from an error type union.
+ *
+ * **When to use**
+ *
+ * Use to describe the ordinary error type that remains after `Cause.Done`
+ * completion signals have been handled or filtered out of an error union.
+ *
+ * @see {@link Error} for extracting ordinary failures from a `Pull`
+ * @see {@link Leftover} for extracting the completion leftover type
  *
  * @category type extractors
  * @since 4.0.0
@@ -85,11 +137,20 @@ export type ExcludeDone<E> = Exclude<E, Cause.Done<any>>;
  * Handles `Cause.Done` failures in an effect while leaving ordinary failures
  * in the error channel.
  *
+ * **When to use**
+ *
+ * Use to recover from a `Cause.Done` completion signal in an effect, such as
+ * turning a pull leftover value into a successful recovery effect while
+ * preserving ordinary failures.
+ *
  * **Details**
  *
  * The handler receives the done leftover value and may recover with a new
  * effect. Non-done errors are preserved.
  *
+ * @see {@link matchEffect} for handling success, ordinary failure, and done outcomes explicitly
+ * @see {@link filterDoneLeftover} for extracting a done leftover from an existing `Cause`
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -98,11 +159,20 @@ export declare const catchDone: {
      * Handles `Cause.Done` failures in an effect while leaving ordinary failures
      * in the error channel.
      *
+     * **When to use**
+     *
+     * Use to recover from a `Cause.Done` completion signal in an effect, such as
+     * turning a pull leftover value into a successful recovery effect while
+     * preserving ordinary failures.
+     *
      * **Details**
      *
      * The handler receives the done leftover value and may recover with a new
      * effect. Non-done errors are preserved.
      *
+     * @see {@link matchEffect} for handling success, ordinary failure, and done outcomes explicitly
+     * @see {@link filterDoneLeftover} for extracting a done leftover from an existing `Cause`
+     *
      * @category Done
      * @since 4.0.0
      */
@@ -111,25 +181,52 @@ export declare const catchDone: {
      * Handles `Cause.Done` failures in an effect while leaving ordinary failures
      * in the error channel.
      *
+     * **When to use**
+     *
+     * Use to recover from a `Cause.Done` completion signal in an effect, such as
+     * turning a pull leftover value into a successful recovery effect while
+     * preserving ordinary failures.
+     *
      * **Details**
      *
      * The handler receives the done leftover value and may recover with a new
      * effect. Non-done errors are preserved.
      *
+     * @see {@link matchEffect} for handling success, ordinary failure, and done outcomes explicitly
+     * @see {@link filterDoneLeftover} for extracting a done leftover from an existing `Cause`
+     *
      * @category Done
      * @since 4.0.0
      */
     <A, R, E, A2, E2, R2>(self: Effect<A, E, R>, f: (leftover: Cause.Done.Extract<E>) => Effect<A2, E2, R2>): Effect<A | A2, ExcludeDone<E> | E2, R | R2>;
 };
 /**
- * Checks if a Cause contains any done errors.
+ * Checks whether a Cause contains any done errors.
+ *
+ * **When to use**
+ *
+ * Use to test a whole pull failure cause for normal completion when you only
+ * need a boolean branch and do not need the done payload.
+ *
+ * @see {@link isDoneFailure} for checking a single `Cause.Reason`
+ * @see {@link filterDone} for extracting the `Cause.Done` value from a `Cause`
+ * @see {@link filterNoDone} for selecting causes with no done failures
  *
  * @category Done
  * @since 4.0.0
  */
 export declare const isDoneCause: <E>(cause: Cause.Cause<E>) => boolean;
 /**
- * Checks if a Cause failure is a done error.
+ * Checks whether a `Cause.Reason` is a `Fail` reason whose error is a
+ * `Cause.Done` signal.
+ *
+ * **When to use**
+ *
+ * Use as a predicate when traversing `cause.reasons` and you need to identify
+ * done completion reasons before handling ordinary failures.
+ *
+ * @see {@link isDoneCause} for checking an entire `Cause` for any done reason
+ * @see {@link filterDone} for extracting the `Cause.Done` value from a `Cause`
  *
  * @category Done
  * @since 4.0.0
@@ -138,6 +235,11 @@ export declare const isDoneFailure: <E>(failure: Cause.Reason<E>) => failure is
 /**
  * Finds a `Cause.Done` failure in a `Cause`.
  *
+ * **When to use**
+ *
+ * Use to separate `Cause.Done` completion from ordinary causes while preserving
+ * the typed done value.
+ *
  * **Details**
  *
  * Returns a successful `Result` with the `Cause.Done` value when one is
@@ -150,11 +252,20 @@ export declare const filterDone: <E>(input: Cause.Cause<E>) => Result.Result<Cau
 /**
  * Finds a `Cause.Done` failure in a cause whose done value is not used.
  *
+ * **When to use**
+ *
+ * Use to detect `Cause.Done` completion in a `Cause` when the completion value
+ * is not part of the downstream logic.
+ *
  * **Details**
  *
  * Returns a successful `Result` with the done marker when present, otherwise
  * returns a failed `Result` with the non-done cause.
  *
+ * @see {@link filterDone} for preserving the typed `Cause.Done` value when the done payload matters
+ * @see {@link filterDoneLeftover} for extracting only the done leftover value
+ * @see {@link filterNoDone} for the inverse filter that succeeds only when no done failure is present
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -162,11 +273,19 @@ export declare const filterDoneVoid: <E extends Cause.Done>(input: Cause.Cause<E
 /**
  * Keeps a `Cause` only when it contains no `Cause.Done` failures.
  *
+ * **When to use**
+ *
+ * Use to select ordinary failure causes for handling while leaving `Cause.Done`
+ * completion causes outside that handler.
+ *
  * **Details**
  *
  * Returns a successful `Result` with the cause when every failure is non-done;
  * otherwise returns a failed `Result` with the original cause.
  *
+ * @see {@link filterDone} for the inverse typed done filter
+ * @see {@link filterDoneVoid} for done detection when the payload is not needed
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -174,6 +293,11 @@ export declare const filterNoDone: <E>(input: Cause.Cause<E>) => Result.Result<C
 /**
  * Filters a Cause to extract the leftover value from done errors.
  *
+ * **When to use**
+ *
+ * Use to extract only the leftover value carried by a `Cause.Done` completion
+ * signal.
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -182,11 +306,20 @@ export declare const filterDoneLeftover: <E>(cause: Cause.Cause<E>) => Result.Re
  * Converts a `Cause` into an `Exit`, treating `Cause.Done` as successful
  * completion.
  *
+ * **When to use**
+ *
+ * Use to produce an `Exit` for finalizing a low-level pull workflow when a
+ * `Cause.Done` signal should be treated as success and any remaining cause
+ * should fail.
+ *
  * **Details**
  *
  * If the cause contains a done value, that leftover becomes the successful
  * value. Otherwise the non-done cause becomes the failure cause.
  *
+ * @see {@link filterDone} for extracting the done signal without converting the cause to an `Exit`
+ * @see {@link matchEffect} for handling `Pull` success, failure, and done outcomes directly
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -194,6 +327,10 @@ export declare const doneExitFromCause: <E>(cause: Cause.Cause<E>) => Exit.Exit<
 /**
  * Pattern matches on a Pull, handling success, failure, and done cases.
  *
+ * **When to use**
+ *
+ * Use to handle all three `Pull` outcomes with effectful handlers.
+ *
  * **Example** (Matching Pull outcomes)
  *
  * ```ts
@@ -215,6 +352,10 @@ export declare const matchEffect: {
     /**
      * Pattern matches on a Pull, handling success, failure, and done cases.
      *
+     * **When to use**
+     *
+     * Use to handle all three `Pull` outcomes with effectful handlers.
+     *
      * **Example** (Matching Pull outcomes)
      *
      * ```ts
@@ -240,6 +381,10 @@ export declare const matchEffect: {
     /**
      * Pattern matches on a Pull, handling success, failure, and done cases.
      *
+     * **When to use**
+     *
+     * Use to handle all three `Pull` outcomes with effectful handlers.
+     *
      * **Example** (Matching Pull outcomes)
      *
      * ```ts

package/dist/Pull.d.ts.map

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

package/dist/Pull.js

@@ -40,24 +40,51 @@ import * as Result from "./Result.js";
  * Handles `Cause.Done` failures in an effect while leaving ordinary failures
  * in the error channel.
  *
+ * **When to use**
+ *
+ * Use to recover from a `Cause.Done` completion signal in an effect, such as
+ * turning a pull leftover value into a successful recovery effect while
+ * preserving ordinary failures.
+ *
  * **Details**
  *
  * The handler receives the done leftover value and may recover with a new
  * effect. Non-done errors are preserved.
  *
+ * @see {@link matchEffect} for handling success, ordinary failure, and done outcomes explicitly
+ * @see {@link filterDoneLeftover} for extracting a done leftover from an existing `Cause`
+ *
  * @category Done
  * @since 4.0.0
  */
 export const catchDone = /*#__PURE__*/dual(2, (effect, f) => internalEffect.catchCauseFilter(effect, filterDoneLeftover, l => f(l)));
 /**
- * Checks if a Cause contains any done errors.
+ * Checks whether a Cause contains any done errors.
+ *
+ * **When to use**
+ *
+ * Use to test a whole pull failure cause for normal completion when you only
+ * need a boolean branch and do not need the done payload.
+ *
+ * @see {@link isDoneFailure} for checking a single `Cause.Reason`
+ * @see {@link filterDone} for extracting the `Cause.Done` value from a `Cause`
+ * @see {@link filterNoDone} for selecting causes with no done failures
  *
  * @category Done
  * @since 4.0.0
  */
 export const isDoneCause = cause => cause.reasons.some(isDoneFailure);
 /**
- * Checks if a Cause failure is a done error.
+ * Checks whether a `Cause.Reason` is a `Fail` reason whose error is a
+ * `Cause.Done` signal.
+ *
+ * **When to use**
+ *
+ * Use as a predicate when traversing `cause.reasons` and you need to identify
+ * done completion reasons before handling ordinary failures.
+ *
+ * @see {@link isDoneCause} for checking an entire `Cause` for any done reason
+ * @see {@link filterDone} for extracting the `Cause.Done` value from a `Cause`
  *
  * @category Done
  * @since 4.0.0
@@ -66,6 +93,11 @@ export const isDoneFailure = failure => failure._tag === "Fail" && Cause.isDone(
 /**
  * Finds a `Cause.Done` failure in a `Cause`.
  *
+ * **When to use**
+ *
+ * Use to separate `Cause.Done` completion from ordinary causes while preserving
+ * the typed done value.
+ *
  * **Details**
  *
  * Returns a successful `Result` with the `Cause.Done` value when one is
@@ -78,11 +110,20 @@ export const filterDone = /*#__PURE__*/Filter.composePassthrough(Cause.findError
 /**
  * Finds a `Cause.Done` failure in a cause whose done value is not used.
  *
+ * **When to use**
+ *
+ * Use to detect `Cause.Done` completion in a `Cause` when the completion value
+ * is not part of the downstream logic.
+ *
  * **Details**
  *
  * Returns a successful `Result` with the done marker when present, otherwise
  * returns a failed `Result` with the non-done cause.
  *
+ * @see {@link filterDone} for preserving the typed `Cause.Done` value when the done payload matters
+ * @see {@link filterDoneLeftover} for extracting only the done leftover value
+ * @see {@link filterNoDone} for the inverse filter that succeeds only when no done failure is present
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -90,11 +131,19 @@ export const filterDoneVoid = /*#__PURE__*/Filter.composePassthrough(Cause.findE
 /**
  * Keeps a `Cause` only when it contains no `Cause.Done` failures.
  *
+ * **When to use**
+ *
+ * Use to select ordinary failure causes for handling while leaving `Cause.Done`
+ * completion causes outside that handler.
+ *
  * **Details**
  *
  * Returns a successful `Result` with the cause when every failure is non-done;
  * otherwise returns a failed `Result` with the original cause.
  *
+ * @see {@link filterDone} for the inverse typed done filter
+ * @see {@link filterDoneVoid} for done detection when the payload is not needed
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -102,6 +151,11 @@ export const filterNoDone = /*#__PURE__*/Filter.fromPredicate(cause => cause.rea
 /**
  * Filters a Cause to extract the leftover value from done errors.
  *
+ * **When to use**
+ *
+ * Use to extract only the leftover value carried by a `Cause.Done` completion
+ * signal.
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -110,11 +164,20 @@ export const filterDoneLeftover = /*#__PURE__*/Filter.composePassthrough(Cause.f
  * Converts a `Cause` into an `Exit`, treating `Cause.Done` as successful
  * completion.
  *
+ * **When to use**
+ *
+ * Use to produce an `Exit` for finalizing a low-level pull workflow when a
+ * `Cause.Done` signal should be treated as success and any remaining cause
+ * should fail.
+ *
  * **Details**
  *
  * If the cause contains a done value, that leftover becomes the successful
  * value. Otherwise the non-done cause becomes the failure cause.
  *
+ * @see {@link filterDone} for extracting the done signal without converting the cause to an `Exit`
+ * @see {@link matchEffect} for handling `Pull` success, failure, and done outcomes directly
+ *
  * @category Done
  * @since 4.0.0
  */
@@ -125,6 +188,10 @@ export const doneExitFromCause = cause => {
 /**
  * Pattern matches on a Pull, handling success, failure, and done cases.
  *
+ * **When to use**
+ *
+ * Use to handle all three `Pull` outcomes with effectful handlers.
+ *
  * **Example** (Matching Pull outcomes)
  *
  * ```ts

package/dist/Pull.js.map

@@ -1 +1 @@
-{"version":3,"file":"Pull.js","names":["Cause","Exit","Filter","dual","internalEffect","Result","catchDone","effect","f","catchCauseFilter","filterDoneLeftover","l","isDoneCause","cause","reasons","some","isDoneFailure","failure","_tag","isDone","error","filterDone","composePassthrough","findError","e","succeed","fail","filterDoneVoid","filterNoDone","fromPredicate","every","value","doneExitFromCause","halt","isFailure","success","failCause","matchEffect","self","options","matchCauseEffect","onSuccess","onFailure","onDone"],"sources":["../src/Pull.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Pull.js","names":["Cause","Exit","Filter","dual","internalEffect","Result","catchDone","effect","f","catchCauseFilter","filterDoneLeftover","l","isDoneCause","cause","reasons","some","isDoneFailure","failure","_tag","isDone","error","filterDone","composePassthrough","findError","e","succeed","fail","filterDoneVoid","filterNoDone","fromPredicate","every","value","doneExitFromCause","halt","isFailure","success","failCause","matchEffect","self","options","matchCauseEffect","onSuccess","onFailure","onDone"],"sources":["../src/Pull.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,OAAO,KAAKA,KAAK,MAAM,YAAY;AAEnC,OAAO,KAAKC,IAAI,MAAM,WAAW;AACjC,OAAO,KAAKC,MAAM,MAAM,aAAa;AACrC,SAASC,IAAI,QAAQ,eAAe;AACpC,OAAO,KAAKC,cAAc,MAAM,sBAAsB;AACtD,OAAO,KAAKC,MAAM,MAAM,aAAa;AAiHrC;AACA;AACA;AAEA;;;;;;;;;;;;;;;;;;;;;AAqBA,OAAO,MAAMC,SAAS,gBA0DlBH,IAAI,CAAC,CAAC,EAAE,CACVI,MAAuB,EACvBC,CAA0D,KAE1DJ,cAAc,CAACK,gBAAgB,CAACF,MAAM,EAAEG,kBAAyB,EAAGC,CAAM,IAAKH,CAAC,CAACG,CAAC,CAAC,CAAQ,CAAC;AAE9F;;;;;;;;;;;;;;;AAeA,OAAO,MAAMC,WAAW,GAAOC,KAAqB,IAAcA,KAAK,CAACC,OAAO,CAACC,IAAI,CAACC,aAAa,CAAC;AAEnG;;;;;;;;;;;;;;;AAeA,OAAO,MAAMA,aAAa,GACxBC,OAAwB,IACuBA,OAAO,CAACC,IAAI,KAAK,MAAM,IAAIlB,KAAK,CAACmB,MAAM,CAACF,OAAO,CAACG,KAAK,CAAC;AAEvG;;;;;;;;;;;;;;;;AAgBA,OAAO,MAAMC,UAAU,gBAE+CnB,MAAM,CACzEoB,kBAAkB,CACjBtB,KAAK,CAACuB,SAAS,EACdC,CAAC,IAAKxB,KAAK,CAACmB,MAAM,CAACK,CAAC,CAAC,GAAGnB,MAAM,CAACoB,OAAO,CAACD,CAAC,CAAC,GAAGnB,MAAM,CAACqB,IAAI,CAACF,CAAC,CAAC,CACrD;AAEV;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,MAAMG,cAAc,gBAE2CzB,MAAM,CAACoB,kBAAkB,CAC7FtB,KAAK,CAACuB,SAAS,EACdC,CAAC,IAAKxB,KAAK,CAACmB,MAAM,CAACK,CAAC,CAAC,GAAGnB,MAAM,CAACoB,OAAO,CAACD,CAAC,CAAC,GAAGnB,MAAM,CAACqB,IAAI,CAACF,CAAC,CAAC,CACrD;AAER;;;;;;;;;;;;;;;;;;;AAmBA,OAAO,MAAMI,YAAY,gBAKrB1B,MAAM,CAAC2B,aAAa,CAAEhB,KAA2B,IACnDA,KAAK,CAACC,OAAO,CAACgB,KAAK,CAAEb,OAAO,IAAK,CAACD,aAAa,CAACC,OAAO,CAAC,CAAC,CACnD;AAER;;;;;;;;;;;AAWA,OAAO,MAAMP,kBAAkB,gBAE0CR,MAAM,CAACoB,kBAAkB,CAChGtB,KAAK,CAACuB,SAAS,EACdC,CAAC,IAAKxB,KAAK,CAACmB,MAAM,CAACK,CAAC,CAAC,GAAGnB,MAAM,CAACoB,OAAO,CAACD,CAAC,CAACO,KAAK,CAAC,GAAG1B,MAAM,CAACqB,IAAI,CAACF,CAAC,CAAC,CAC3D;AAER;;;;;;;;;;;;;;;;;;;;;AAqBA,OAAO,MAAMQ,iBAAiB,GAAOnB,KAAqB,IAAsD;EAC9G,MAAMoB,IAAI,GAAGZ,UAAU,CAACR,KAAK,CAAC;EAC9B,OAAO,CAACR,MAAM,CAAC6B,SAAS,CAACD,IAAI,CAAC,GAAGhC,IAAI,CAACwB,OAAO,CAACQ,IAAI,CAACE,OAAO,CAACJ,KAAY,CAAC,GAAG9B,IAAI,CAACmC,SAAS,CAACH,IAAI,CAAChB,OAAO,CAAC;AACzG,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,OAAO,MAAMoB,WAAW,gBAgEpBlC,IAAI,CAAC,CAAC,EAAE,CAAiDmC,IAAsB,EAAEC,OAIpF,KACCnC,cAAc,CAACoC,gBAAgB,CAACF,IAAI,EAAE;EACpCG,SAAS,EAAEF,OAAO,CAACE,SAAS;EAC5BC,SAAS,EAAG7B,KAAK,IAAsD;IACrE,MAAMoB,IAAI,GAAGZ,UAAU,CAACR,KAAK,CAAC;IAC9B,OAAO,CAACR,MAAM,CAAC6B,SAAS,CAACD,IAAI,CAAC,GAAGM,OAAO,CAACI,MAAM,CAACV,IAAI,CAACE,OAAO,CAACJ,KAAU,CAAC,GAAGQ,OAAO,CAACG,SAAS,CAACT,IAAI,CAAChB,OAAO,CAAC;EAC5G;CACD,CAAC,CAAC","ignoreList":[]}