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

package/dist/Pipeable.js

@@ -25,6 +25,11 @@
  * Applies a `pipe` method's variadic arguments to an initial value from left
  * to right.
  *
+ * **When to use**
+ *
+ * Use to implement a custom `.pipe(...)` method from JavaScript's `arguments`
+ * object.
+ *
  * **Details**
  *
  * This helper is intended for implementing `Pipeable.pipe` methods that
@@ -91,10 +96,10 @@ export const pipeArguments = (self, args) => {
  *
  * **When to use**
  *
- * Classes or object prototypes can reuse this value when they need the
+ * Use when classes or object prototypes can reuse this value when they need the
  * standard pipe implementation backed by `pipeArguments`.
  *
- * @category models
+ * @category prototypes
  * @since 3.15.0
  */
 export const Prototype = {
@@ -103,12 +108,12 @@ export const Prototype = {
   }
 };
 /**
- * Base constructor whose instances implement the standard `Pipeable.pipe`
+ * Provides a base constructor whose instances implement the standard `Pipeable.pipe`
  * method.
  *
  * **When to use**
  *
- * Extend or compose this constructor when defining a class that should support
+ * Use when extend or compose this constructor when defining a class that should support
  * Effect-style method chaining through `.pipe(...)`.
  *
  * @category constructors
@@ -123,11 +128,18 @@ export const Class = /*#__PURE__*/function () {
  * Returns a subclass of the provided class that adds the standard `pipe`
  * method.
  *
+ * **When to use**
+ *
+ * Use to add pipe support to an existing class without extending a base class
+ * or modifying its prototype.
+ *
  * **Details**
  *
  * The original constructor and instance members are preserved, and the added
  * method delegates to `pipeArguments`.
  *
+ * @see {@link Prototype} for a reusable prototype object
+ * @see {@link Class} for a base constructor to extend
  * @category constructors
  * @since 4.0.0
  */

package/dist/Pipeable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Pipeable.js","names":["pipeArguments","self","args","length","ret","i","len","Prototype","pipe","arguments","Class","PipeableBase","prototype","Mixin","klass"],"sources":["../src/Pipeable.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Pipeable.js","names":["pipeArguments","self","args","length","ret","i","len","Prototype","pipe","arguments","Class","PipeableBase","prototype","Mixin","klass"],"sources":["../src/Pipeable.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/PlatformError.d.ts

@@ -39,11 +39,20 @@ declare const BadArgument_base: new <A extends Record<string, any> = {}>(args: i
 /**
  * Error data for an invalid argument passed to a platform API.
  *
+ * **When to use**
+ *
+ * Use when a platform API rejects caller input before performing the underlying
+ * operation and callers need invalid-argument reason data directly.
+ *
  * **Details**
  *
  * The error records the module and method that rejected the argument, with an
  * optional description and cause. It is usually wrapped in `PlatformError`.
  *
+ * @see {@link badArgument} for creating a wrapped `PlatformError` whose reason is `BadArgument`
+ * @see {@link SystemError} for failures reported by the host platform or operating system
+ * @see {@link PlatformError} for the wrapper used by most platform APIs
+ *
  * @category models
  * @since 4.0.0
  */
@@ -56,6 +65,10 @@ export declare class BadArgument extends BadArgument_base<{
     /**
      * Formats the module, method, and optional description that rejected the argument.
      *
+     * **When to use**
+     *
+     * Use to read the formatted error message for a rejected platform argument.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -63,11 +76,19 @@ export declare class BadArgument extends BadArgument_base<{
 /**
  * Normalized category for failures reported by platform or system operations.
  *
+ * **When to use**
+ *
+ * Use to type or match the normalized `_tag` on `SystemError` values reported
+ * by platform operations.
+ *
  * **Details**
  *
  * The tags group lower-level platform errors into a stable set such as
  * `NotFound`, `PermissionDenied`, `TimedOut`, and `Unknown`.
  *
+ * @see {@link SystemError} for the error data that carries this tag on its `_tag` field
+ * @see {@link systemError} for creating a `PlatformError` from a system failure with one of these tags
+ *
  * @category models
  * @since 4.0.0
  */
@@ -75,12 +96,21 @@ export type SystemErrorTag = "AlreadyExists" | "BadResource" | "Busy" | "Invalid
 /**
  * Error data for a platform or system operation failure.
  *
+ * **When to use**
+ *
+ * Use as the reason data for failures reported by a host platform or operating
+ * system when you need a normalized system error tag plus operation details.
+ *
  * **Details**
  *
  * The error records a normalized `_tag`, the module and method that failed,
  * and optional details such as the syscall, path or descriptor, description,
  * and original cause. It is usually wrapped in `PlatformError`.
  *
+ * @see {@link systemError} for creating the usual `PlatformError` wrapper from this reason data
+ * @see {@link BadArgument} for platform API failures caused by rejected caller input before an operation runs
+ * @see {@link SystemErrorTag} for the normalized tag values stored in `_tag`
+ *
  * @category models
  * @since 4.0.0
  */
@@ -96,6 +126,10 @@ export declare class SystemError extends Data.Error<{
     /**
      * Formats the normalized system error tag with operation and path details.
      *
+     * **When to use**
+     *
+     * Use to read the formatted error message for a normalized system failure.
+     *
      * @since 4.0.0
      */
     get message(): string;
@@ -107,11 +141,22 @@ declare const PlatformError_base: new <A extends Record<string, any> = {}>(args:
  * Tagged error used by platform APIs to report either invalid arguments or
  * system-level failures.
  *
+ * **When to use**
+ *
+ * Use as the shared error type for platform APIs that expose invalid arguments
+ * and host or operating-system failures through a single `Effect` error
+ * channel.
+ *
  * **Details**
  *
  * The `reason` field contains the underlying `BadArgument` or `SystemError`.
  * When that reason has a cause, the cause is preserved on the wrapper.
  *
+ * @see {@link BadArgument} for invalid inputs rejected before an operation runs
+ * @see {@link SystemError} for failures reported by the host platform or operating system
+ * @see {@link badArgument} for creating this wrapper from rejected caller input
+ * @see {@link systemError} for creating this wrapper from a host or operating-system failure
+ *
  * @category models
  * @since 4.0.0
  */
@@ -122,6 +167,10 @@ export declare class PlatformError extends PlatformError_base<{
     /**
      * Marks this value as a platform error wrapper for runtime guards.
      *
+     * **When to use**
+     *
+     * Use to identify `PlatformError` values through their runtime type marker.
+     *
      * @since 4.0.0
      */
     readonly [TypeId]: typeof TypeId;
@@ -132,8 +181,8 @@ export declare class PlatformError extends PlatformError_base<{
  *
  * **When to use**
  *
- * Use this helper when adapting an operating-system or platform failure into
- * the normalized platform error model.
+ * Use to adapt an operating-system or platform failure into the normalized
+ * platform error model.
  *
  * @category constructors
  * @since 4.0.0
@@ -152,8 +201,8 @@ export declare const systemError: (options: {
  *
  * **When to use**
  *
- * Use this helper when a platform API rejects caller input before performing
- * the underlying operation.
+ * Use to report a platform API rejecting caller input before performing the
+ * underlying operation.
  *
  * @category constructors
  * @since 4.0.0

package/dist/PlatformError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlatformError.d.ts","sourceRoot":"","sources":["../src/PlatformError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,QAAA,MAAM,MAAM,mCAAmC,CAAA;;;;AAE/C;;;;;;;;;;GAUG;AACH,qBAAa,WAAY,SAAQ,iBAAgC;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAC;IACA;;;;OAIG;IACH,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,aAAa,GACb,MAAM,GACN,aAAa,GACb,UAAU,GACV,kBAAkB,GAClB,UAAU,GACV,eAAe,GACf,SAAS,GACT,YAAY,GACZ,WAAW,CAAA;AAEf;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC;IAC1C,IAAI,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAC;IACA;;;;OAIG;IACH,IAAa,OAAO,IAAI,MAAM,CAI7B;CACF;;;;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,mBAAkC;IACnE,MAAM,EAAE,WAAW,GAAG,WAAW,CAAA;CAClC,CAAC;gBACY,MAAM,EAAE,WAAW,GAAG,WAAW;IAQ7C;;;;OAIG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAS;IAEzC,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,aAA4D,CAAA;AAEhE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,aAA4D,CAAA"}
+{"version":3,"file":"PlatformError.d.ts","sourceRoot":"","sources":["../src/PlatformError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,QAAA,MAAM,MAAM,mCAAmC,CAAA;;;;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,SAAQ,iBAAgC;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAC;IACA;;;;;;;;OAQG;IACH,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,aAAa,GACb,MAAM,GACN,aAAa,GACb,UAAU,GACV,kBAAkB,GAClB,UAAU,GACV,eAAe,GACf,SAAS,GACT,YAAY,GACZ,WAAW,CAAA;AAEf;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC;IAC1C,IAAI,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAC;IACA;;;;;;;;OAQG;IACH,IAAa,OAAO,IAAI,MAAM,CAI7B;CACF;;;;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,aAAc,SAAQ,mBAAkC;IACnE,MAAM,EAAE,WAAW,GAAG,WAAW,CAAA;CAClC,CAAC;gBACY,MAAM,EAAE,WAAW,GAAG,WAAW;IAQ7C;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAS;IAEzC,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,aAA4D,CAAA;AAEhE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,KAAG,aAA4D,CAAA"}

package/dist/PlatformError.js

@@ -36,11 +36,20 @@ const TypeId = "~effect/platform/PlatformError";
 /**
  * Error data for an invalid argument passed to a platform API.
  *
+ * **When to use**
+ *
+ * Use when a platform API rejects caller input before performing the underlying
+ * operation and callers need invalid-argument reason data directly.
+ *
  * **Details**
  *
  * The error records the module and method that rejected the argument, with an
  * optional description and cause. It is usually wrapped in `PlatformError`.
  *
+ * @see {@link badArgument} for creating a wrapped `PlatformError` whose reason is `BadArgument`
+ * @see {@link SystemError} for failures reported by the host platform or operating system
+ * @see {@link PlatformError} for the wrapper used by most platform APIs
+ *
  * @category models
  * @since 4.0.0
  */
@@ -48,6 +57,10 @@ export class BadArgument extends /*#__PURE__*/Data.TaggedError("BadArgument") {
   /**
    * Formats the module, method, and optional description that rejected the argument.
    *
+   * **When to use**
+   *
+   * Use to read the formatted error message for a rejected platform argument.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -57,12 +70,21 @@ export class BadArgument extends /*#__PURE__*/Data.TaggedError("BadArgument") {
 /**
  * Error data for a platform or system operation failure.
  *
+ * **When to use**
+ *
+ * Use as the reason data for failures reported by a host platform or operating
+ * system when you need a normalized system error tag plus operation details.
+ *
  * **Details**
  *
  * The error records a normalized `_tag`, the module and method that failed,
  * and optional details such as the syscall, path or descriptor, description,
  * and original cause. It is usually wrapped in `PlatformError`.
  *
+ * @see {@link systemError} for creating the usual `PlatformError` wrapper from this reason data
+ * @see {@link BadArgument} for platform API failures caused by rejected caller input before an operation runs
+ * @see {@link SystemErrorTag} for the normalized tag values stored in `_tag`
+ *
  * @category models
  * @since 4.0.0
  */
@@ -70,6 +92,10 @@ export class SystemError extends Data.Error {
   /**
    * Formats the normalized system error tag with operation and path details.
    *
+   * **When to use**
+   *
+   * Use to read the formatted error message for a normalized system failure.
+   *
    * @since 4.0.0
    */
   get message() {
@@ -80,11 +106,22 @@ export class SystemError extends Data.Error {
  * Tagged error used by platform APIs to report either invalid arguments or
  * system-level failures.
  *
+ * **When to use**
+ *
+ * Use as the shared error type for platform APIs that expose invalid arguments
+ * and host or operating-system failures through a single `Effect` error
+ * channel.
+ *
  * **Details**
  *
  * The `reason` field contains the underlying `BadArgument` or `SystemError`.
  * When that reason has a cause, the cause is preserved on the wrapper.
  *
+ * @see {@link BadArgument} for invalid inputs rejected before an operation runs
+ * @see {@link SystemError} for failures reported by the host platform or operating system
+ * @see {@link badArgument} for creating this wrapper from rejected caller input
+ * @see {@link systemError} for creating this wrapper from a host or operating-system failure
+ *
  * @category models
  * @since 4.0.0
  */
@@ -104,6 +141,10 @@ export class PlatformError extends /*#__PURE__*/Data.TaggedError("PlatformError"
   /**
    * Marks this value as a platform error wrapper for runtime guards.
    *
+   * **When to use**
+   *
+   * Use to identify `PlatformError` values through their runtime type marker.
+   *
    * @since 4.0.0
    */
   [TypeId] = TypeId;
@@ -116,8 +157,8 @@ export class PlatformError extends /*#__PURE__*/Data.TaggedError("PlatformError"
  *
  * **When to use**
  *
- * Use this helper when adapting an operating-system or platform failure into
- * the normalized platform error model.
+ * Use to adapt an operating-system or platform failure into the normalized
+ * platform error model.
  *
  * @category constructors
  * @since 4.0.0
@@ -128,8 +169,8 @@ export const systemError = options => new PlatformError(new SystemError(options)
  *
  * **When to use**
  *
- * Use this helper when a platform API rejects caller input before performing
- * the underlying operation.
+ * Use to report a platform API rejecting caller input before performing the
+ * underlying operation.
  *
  * @category constructors
  * @since 4.0.0

package/dist/PlatformError.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlatformError.js","names":["Data","TypeId","BadArgument","TaggedError","message","module","method","description","SystemError","Error","_tag","pathOrDescriptor","undefined","PlatformError","constructor","reason","cause","systemError","options","badArgument"],"sources":["../src/PlatformError.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,OAAO,KAAKA,IAAI,MAAM,WAAW;AAEjC,MAAMC,MAAM,GAAG,gCAAgC;AAE/C;;;;;;;;;;;AAWA,OAAM,MAAOC,WAAY,sBAAQF,IAAI,CAACG,WAAW,CAAC,aAAa,CAK7D;EACA;;;;;EAKA,IAAaC,OAAOA,CAAA;IAClB,OAAO,GAAG,IAAI,CAACC,MAAM,IAAI,IAAI,CAACC,MAAM,GAAG,IAAI,CAACC,WAAW,GAAG,KAAK,IAAI,CAACA,WAAW,EAAE,GAAG,EAAE,EAAE;EAC1F;;AA2BF;;;;;;;;;;;;AAYA,OAAM,MAAOC,WAAY,SAAQR,IAAI,CAACS,KAQpC;EACA;;;;;EAKA,IAAaL,OAAOA,CAAA;IAClB,OAAO,GAAG,IAAI,CAACM,IAAI,KAAK,IAAI,CAACL,MAAM,IAAI,IAAI,CAACC,MAAM,GAChD,IAAI,CAACK,gBAAgB,KAAKC,SAAS,GAAG,KAAK,IAAI,CAACD,gBAAgB,GAAG,GAAG,EACxE,GAAG,IAAI,CAACJ,WAAW,GAAG,KAAK,IAAI,CAACA,WAAW,EAAE,GAAG,EAAE,EAAE;EACtD;;AAGF;;;;;;;;;;;;AAYA,OAAM,MAAOM,aAAc,sBAAQb,IAAI,CAACG,WAAW,CAAC,eAAe,CAEjE;EACAW,YAAYC,MAAiC;IAC3C,IAAI,OAAO,IAAIA,MAAM,EAAE;MACrB,KAAK,CAAC;QAAEA,MAAM;QAAEC,KAAK,EAAED,MAAM,CAACC;MAAK,CAAS,CAAC;IAC/C,CAAC,MAAM;MACL,KAAK,CAAC;QAAED;MAAM,CAAE,CAAC;IACnB;EACF;EAEA;;;;;EAKS,CAACd,MAAM,IAAmBA,MAAM;EAEzC,IAAaG,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACW,MAAM,CAACX,OAAO;EAC5B;;AAGF;;;;;;;;;;;AAWA,OAAO,MAAMa,WAAW,GAAIC,OAQ3B,IAAoB,IAAIL,aAAa,CAAC,IAAIL,WAAW,CAACU,OAAO,CAAC,CAAC;AAEhE;;;;;;;;;;;AAWA,OAAO,MAAMC,WAAW,GAAID,OAK3B,IAAoB,IAAIL,aAAa,CAAC,IAAIX,WAAW,CAACgB,OAAO,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"PlatformError.js","names":["Data","TypeId","BadArgument","TaggedError","message","module","method","description","SystemError","Error","_tag","pathOrDescriptor","undefined","PlatformError","constructor","reason","cause","systemError","options","badArgument"],"sources":["../src/PlatformError.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,OAAO,KAAKA,IAAI,MAAM,WAAW;AAEjC,MAAMC,MAAM,GAAG,gCAAgC;AAE/C;;;;;;;;;;;;;;;;;;;;AAoBA,OAAM,MAAOC,WAAY,sBAAQF,IAAI,CAACG,WAAW,CAAC,aAAa,CAK7D;EACA;;;;;;;;;EASA,IAAaC,OAAOA,CAAA;IAClB,OAAO,GAAG,IAAI,CAACC,MAAM,IAAI,IAAI,CAACC,MAAM,GAAG,IAAI,CAACC,WAAW,GAAG,KAAK,IAAI,CAACA,WAAW,EAAE,GAAG,EAAE,EAAE;EAC1F;;AAmCF;;;;;;;;;;;;;;;;;;;;;AAqBA,OAAM,MAAOC,WAAY,SAAQR,IAAI,CAACS,KAQpC;EACA;;;;;;;;;EASA,IAAaL,OAAOA,CAAA;IAClB,OAAO,GAAG,IAAI,CAACM,IAAI,KAAK,IAAI,CAACL,MAAM,IAAI,IAAI,CAACC,MAAM,GAChD,IAAI,CAACK,gBAAgB,KAAKC,SAAS,GAAG,KAAK,IAAI,CAACD,gBAAgB,GAAG,GAAG,EACxE,GAAG,IAAI,CAACJ,WAAW,GAAG,KAAK,IAAI,CAACA,WAAW,EAAE,GAAG,EAAE,EAAE;EACtD;;AAGF;;;;;;;;;;;;;;;;;;;;;;;AAuBA,OAAM,MAAOM,aAAc,sBAAQb,IAAI,CAACG,WAAW,CAAC,eAAe,CAEjE;EACAW,YAAYC,MAAiC;IAC3C,IAAI,OAAO,IAAIA,MAAM,EAAE;MACrB,KAAK,CAAC;QAAEA,MAAM;QAAEC,KAAK,EAAED,MAAM,CAACC;MAAK,CAAS,CAAC;IAC/C,CAAC,MAAM;MACL,KAAK,CAAC;QAAED;MAAM,CAAE,CAAC;IACnB;EACF;EAEA;;;;;;;;;EASS,CAACd,MAAM,IAAmBA,MAAM;EAEzC,IAAaG,OAAOA,CAAA;IAClB,OAAO,IAAI,CAACW,MAAM,CAACX,OAAO;EAC5B;;AAGF;;;;;;;;;;;AAWA,OAAO,MAAMa,WAAW,GAAIC,OAQ3B,IAAoB,IAAIL,aAAa,CAAC,IAAIL,WAAW,CAACU,OAAO,CAAC,CAAC;AAEhE;;;;;;;;;;;AAWA,OAAO,MAAMC,WAAW,GAAID,OAK3B,IAAoB,IAAIL,aAAa,CAAC,IAAIX,WAAW,CAACgB,OAAO,CAAC,CAAC","ignoreList":[]}

package/dist/Pool.d.ts

@@ -11,6 +11,17 @@ declare const TypeId = "~effect/Pool";
  * associated with the acquisition and release of resources. An attempt to get
  * an item `A` from a pool may fail with an error of type `E`.
  *
+ * **When to use**
+ *
+ * Use when you need to share a bounded set of scoped resources across fibers
+ * while the pool manages acquisition, reuse, and release.
+ *
+ * @see {@link make} for creating a pool with size bounds
+ * @see {@link makeWithTTL} for creating a pool with idle item expiration
+ * @see {@link makeWithStrategy} for creating a pool with a custom strategy
+ * @see {@link get} for acquiring an item from a pool
+ * @see {@link invalidate} for removing a broken item from the pool
+ *
  * @category models
  * @since 2.0.0
  */
@@ -22,11 +33,20 @@ export interface Pool<in out A, in out E = never> extends Pipeable {
 /**
  * Normalized configuration used by a `Pool`.
  *
+ * **When to use**
+ *
+ * Use as the normalized, read-only description of how a pool acquires, sizes,
+ * shares, and resizes its items after construction.
+ *
  * **Details**
  *
  * The config stores the acquire effect, size bounds, per-item concurrency,
  * target utilization, and resizing strategy used by the pool implementation.
  *
+ * @see {@link Pool} for the value exposing this configuration
+ * @see {@link State} for mutable runtime state instead of static configuration
+ * @see {@link Strategy} for the resizing and reclamation contract stored on the config
+ *
  * @category models
  * @since 4.0.0
  */
@@ -41,6 +61,12 @@ export interface Config<A, E> {
 /**
  * Mutable runtime state maintained by a `Pool`.
  *
+ * **When to use**
+ *
+ * Use when you need to inspect or support the runtime state backing a `Pool`,
+ * including its scope, item sets, semaphores, waiters, invalidation tracking,
+ * and shutdown flag.
+ *
  * **Details**
  *
  * This state tracks the pool scope, active and available items, invalidated
@@ -48,6 +74,11 @@ export interface Config<A, E> {
  * inspection and implementation support; user code should prefer the
  * high-level pool operations.
  *
+ * @see {@link Pool} for the pool value exposing this state
+ * @see {@link PoolItem} for the entries stored in the runtime item sets
+ * @see {@link get} for acquiring items through the high-level API
+ * @see {@link invalidate} for invalidating items through the high-level API
+ *
  * @category models
  * @since 4.0.0
  */
@@ -65,12 +96,21 @@ export interface State<A, E> {
 /**
  * Internal record for a value managed by a `Pool`.
  *
+ * **When to use**
+ *
+ * Use when implementing a custom pool `Strategy` that needs to inspect
+ * acquired items, track reference counts, or return reclaimable items to the
+ * pool.
+ *
  * **Details**
  *
  * Each item stores the acquisition `Exit`, its finalizer, the current
  * reference count, and whether automatic reclaiming has been disabled because
  * the item was invalidated.
  *
+ * @see {@link Strategy} for the custom strategy callbacks that receive and return pool items
+ * @see {@link State} for the runtime sets that store active, available, and invalidated pool items
+ *
  * @category models
  * @since 4.0.0
  */
@@ -84,12 +124,19 @@ export interface PoolItem<A, E> {
  * Strategy used by a `Pool` to manage background resizing and item
  * reclamation.
  *
+ * **When to use**
+ *
+ * Use when defining a custom pool lifecycle policy that needs to run background
+ * work, observe acquired items, or choose items for reclamation.
+ *
  * **Details**
  *
  * `run` starts any strategy-specific background work, `onAcquire` is invoked
  * when an item is acquired, and `reclaim` selects an item that can be removed
  * or replaced.
  *
+ * @see {@link makeWithStrategy} for constructing a pool from a custom `Strategy`
+ *
  * @category models
  * @since 4.0.0
  */
@@ -101,6 +148,15 @@ export interface Strategy<A, E> {
 /**
  * Returns `true` if the specified value is a `Pool`, `false` otherwise.
  *
+ * **When to use**
+ *
+ * Use to validate unknown values at runtime boundaries before treating them as
+ * `Pool` values.
+ *
+ * **Details**
+ *
+ * This predicate narrows the input to `Pool<unknown, unknown>`.
+ *
  * @category refinements
  * @since 2.0.0
  */
@@ -108,6 +164,11 @@ export declare const isPool: (u: unknown) => u is Pool<unknown, unknown>;
 /**
  * Makes a new pool of the specified fixed size.
  *
+ * **When to use**
+ *
+ * Use to create a fixed-size pool when you know the exact number of resources
+ * needed upfront, without growth or shrinkage.
+ *
  * **Details**
  *
  * The pool is returned in a `Scope`, which governs the lifetime of the pool.
@@ -124,6 +185,8 @@ export declare const isPool: (u: unknown) => u is Pool<unknown, unknown>;
  * A `targetUtilization` of 0.5 will create new pool items when the existing items are
  * 50% utilized.
  *
+ * @see {@link makeWithTTL} for pools with min/max sizes and a TTL-based shrinking policy
+ * @see {@link makeWithStrategy} for pools with a custom resizing and reclamation strategy
  * @category constructors
  * @since 2.0.0
  */
@@ -137,6 +200,11 @@ export declare const make: <A, E, R>(options: {
  * Creates a scoped pool with minimum and maximum sizes and a time-to-live
  * policy for shrinking unused excess items.
  *
+ * **When to use**
+ *
+ * Use to create an elastic scoped pool that can grow up to a maximum size and
+ * later reclaim unused excess items.
+ *
  * **Details**
  *
  * The returned pool requires `Scope`; when that scope is closed, allocated
@@ -197,11 +265,19 @@ export declare const makeWithTTL: <A, E, R>(options: {
 /**
  * Creates a scoped pool using a custom resizing and reclamation strategy.
  *
+ * **When to use**
+ *
+ * Use to build a pool whose item lifecycle is controlled by an explicit
+ * `Strategy`, such as custom background resizing, replacement, or reclamation.
+ *
  * **Details**
  *
  * The returned pool requires `Scope`; closing the scope shuts down the pool and
- * releases allocated items. Use this constructor when `make` and `makeWithTTL`
- * do not provide the desired item lifecycle behavior.
+ * releases allocated items.
+ *
+ * @see {@link make} for fixed-size pools without custom resizing or reclamation
+ * @see {@link makeWithTTL} for min/max pools that shrink excess items with a TTL policy
+ * @see {@link Strategy} for the custom strategy contract consumed by this constructor
  *
  * @category constructors
  * @since 4.0.0
@@ -215,36 +291,86 @@ export declare const makeWithStrategy: <A, E, R>(options: {
     readonly strategy: Strategy<A, E>;
 }) => Effect.Effect<Pool<A, E>, never, Scope.Scope | R>;
 /**
- * Retrieves an item from the pool in a scoped effect. Note that if
- * acquisition fails, then the returned effect will fail for that same reason.
- * Retrying a failed acquisition attempt will repeat the acquisition attempt.
+ * Retrieves an item from the pool in a scoped effect.
+ *
+ * **When to use**
+ *
+ * Use to borrow a pooled resource for the lifetime of the current scope so it
+ * is automatically returned when that scope closes.
+ *
+ * **Details**
+ *
+ * The returned effect waits for an available item when the pool is at capacity.
+ * If acquiring a new item fails, the effect fails with the acquisition error.
+ *
+ * **Gotchas**
+ *
+ * Retrying a failed `get` can repeat the acquisition attempt.
+ *
+ * @see {@link invalidate} for removing an unhealthy item from future reuse
  *
  * @category getters
  * @since 2.0.0
  */
 export declare const get: <A, E>(self: Pool<A, E>) => Effect.Effect<A, E, Scope.Scope>;
 /**
- * Invalidates the specified item. This will cause the pool to eventually
- * reallocate the item, although this reallocation may occur lazily rather
- * than eagerly.
+ * Invalidates the specified item so the pool can remove it and reallocate the
+ * item, lazily if needed.
+ *
+ * **When to use**
+ *
+ * Use to prevent a pooled item from being reused after you determine it is no
+ * longer suitable, such as a stale connection or a resource that failed a
+ * health check.
+ *
+ * **Gotchas**
+ *
+ * The item is matched with strict equality. Passing an equivalent but different
+ * object instance does nothing.
+ *
+ * @see {@link get} for retrieving scoped items from the pool
  *
  * @category combinators
  * @since 2.0.0
  */
 export declare const invalidate: {
     /**
-     * Invalidates the specified item. This will cause the pool to eventually
-     * reallocate the item, although this reallocation may occur lazily rather
-     * than eagerly.
+     * Invalidates the specified item so the pool can remove it and reallocate the
+     * item, lazily if needed.
+     *
+     * **When to use**
+     *
+     * Use to prevent a pooled item from being reused after you determine it is no
+     * longer suitable, such as a stale connection or a resource that failed a
+     * health check.
+     *
+     * **Gotchas**
+     *
+     * The item is matched with strict equality. Passing an equivalent but different
+     * object instance does nothing.
+     *
+     * @see {@link get} for retrieving scoped items from the pool
      *
      * @category combinators
      * @since 2.0.0
      */
     <A>(item: A): <E>(self: Pool<A, E>) => Effect.Effect<void, never, Scope.Scope>;
     /**
-     * Invalidates the specified item. This will cause the pool to eventually
-     * reallocate the item, although this reallocation may occur lazily rather
-     * than eagerly.
+     * Invalidates the specified item so the pool can remove it and reallocate the
+     * item, lazily if needed.
+     *
+     * **When to use**
+     *
+     * Use to prevent a pooled item from being reused after you determine it is no
+     * longer suitable, such as a stale connection or a resource that failed a
+     * health check.
+     *
+     * **Gotchas**
+     *
+     * The item is matched with strict equality. Passing an equivalent but different
+     * object instance does nothing.
+     *
+     * @see {@link get} for retrieving scoped items from the pool
      *
      * @category combinators
      * @since 2.0.0

package/dist/Pool.d.ts.map

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