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

package/dist/TxSemaphore.js

@@ -1,21 +1,39 @@
 /**
- * The `TxSemaphore` module provides a transactional semaphore for coordinating
- * access to limited resources from within Effect transactions. A semaphore
- * tracks a fixed number of permits, and transactional operations can acquire,
- * release, or inspect those permits atomically with other transactional state.
- *
- * Use `TxSemaphore` when permit accounting needs to compose with `TxRef` and
- * other transactional updates, such as guarding resource pools, rate-limited
- * sections, or workflows that must reserve capacity consistently before
- * committing related state changes.
+ * Coordinate access to limited resources with a semaphore whose permit count
+ * participates in Effect transactions. A `TxSemaphore` keeps a fixed capacity
+ * and records permit changes in transactional state, so acquiring or releasing
+ * permits can commit atomically with related `TxRef` updates.
+ *
+ * **Mental model**
+ *
+ * - {@link make} creates a semaphore with a fixed number of permits.
+ * - {@link acquire} and {@link acquireN} wait by retrying the transaction when
+ *   there are not enough permits available.
+ * - {@link tryAcquire} and {@link tryAcquireN} update the permit count only
+ *   when enough permits are already available.
+ * - {@link release} and {@link releaseN} return permits, and the total cannot
+ *   exceed the original capacity.
+ * - {@link withPermit} and {@link withPermits} bracket a supplied effect,
+ *   while {@link withPermitScoped} holds one permit until the current scope
+ *   closes.
+ *
+ * **Common tasks**
+ *
+ * - Reserve capacity before committing related transactional state changes.
+ * - Protect a pool, queue, or rate-limited section with permit accounting that
+ *   composes with `TxRef`.
+ * - Inspect the current number of permits with {@link available} and the fixed
+ *   total with {@link capacity}.
  *
  * **Gotchas**
  *
- * - Permit operations are intended for transactional workflows and are wrapped
- *   with `Effect.tx`.
- * - The semaphore capacity is fixed at construction time; releasing more
- *   permits than the original capacity fails.
- * - Creating a semaphore with a negative number of permits defects.
+ * - Permit operations enter `Effect.tx`; group related transactional
+ *   work inside the same boundary when it must commit together.
+ * - Requesting more permits than the semaphore capacity with
+ *   {@link acquireN} can wait forever because the capacity never grows.
+ * - Creating a semaphore with negative permits, acquiring a non-positive number
+ *   of permits, or releasing a non-positive number of permits defects.
+ * - Extra releases are capped at the fixed capacity.
  *
  * @since 4.0.0
  */
@@ -49,6 +67,10 @@ const makeTxSemaphore = (permitsRef, capacity) => {
 /**
  * Creates a new TxSemaphore with the specified number of permits.
  *
+ * **When to use**
+ *
+ * Use to create a transactional semaphore with a fixed permit capacity.
+ *
  * **Example** (Creating a semaphore)
  *
  * ```ts
@@ -70,6 +92,9 @@ const makeTxSemaphore = (permitsRef, capacity) => {
  * })
  * ```
  *
+ * @see {@link available} for reading the current available permit count
+ * @see {@link capacity} for reading the fixed total permit count
+ *
  * @category constructors
  * @since 2.0.0
  */
@@ -83,6 +108,10 @@ export const make = permits => Effect.gen(function* () {
 /**
  * Gets the current number of available permits in the semaphore.
  *
+ * **When to use**
+ *
+ * Use to inspect how many permits are currently available.
+ *
  * **Example** (Checking available permits)
  *
  * ```ts
@@ -105,6 +134,8 @@ export const make = permits => Effect.gen(function* () {
  * })
  * ```
  *
+ * @see {@link capacity} for reading the fixed total permit count
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -112,6 +143,10 @@ export const available = self => TxRef.get(self.permitsRef);
 /**
  * Gets the maximum capacity (total permits) of the semaphore.
  *
+ * **When to use**
+ *
+ * Use to inspect the fixed total number of permits managed by the semaphore.
+ *
  * **Example** (Checking semaphore capacity)
  *
  * ```ts
@@ -130,6 +165,8 @@ export const available = self => TxRef.get(self.permitsRef);
  * })
  * ```
  *
+ * @see {@link available} for reading the current available permit count
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -138,6 +175,11 @@ export const capacity = self => Effect.succeed(self.capacity);
  * Acquires a single permit from the semaphore. If no permits are available,
  * the effect will block until one becomes available.
  *
+ * **When to use**
+ *
+ * Use to manually acquire one permit transactionally, waiting until one is
+ * available.
+ *
  * **Example** (Acquiring a permit)
  *
  * ```ts
@@ -159,6 +201,10 @@ export const capacity = self => Effect.succeed(self.capacity);
  * })
  * ```
  *
+ * @see {@link tryAcquire} for a non-blocking single-permit attempt
+ * @see {@link release} for returning one permit
+ * @see {@link withPermit} for automatic acquire and release around an effect
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -172,6 +218,11 @@ export const acquire = self => Effect.gen(function* () {
 /**
  * Acquires the specified number of permits from the semaphore.
  *
+ * **When to use**
+ *
+ * Use to manually acquire multiple permits transactionally, waiting until all
+ * requested permits are available.
+ *
  * **Details**
  *
  * If fewer than `n` permits are available, the transaction retries until enough
@@ -199,6 +250,10 @@ export const acquire = self => Effect.gen(function* () {
  * })
  * ```
  *
+ * @see {@link tryAcquireN} for a non-blocking multi-permit attempt
+ * @see {@link releaseN} for returning multiple permits
+ * @see {@link withPermits} for automatic acquire and release around an effect
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -218,6 +273,11 @@ export const acquireN = (self, n) => {
  * Tries to acquire a single permit from the semaphore without blocking,
  * returning `true` if successful or `false` if no permits are available.
  *
+ * **When to use**
+ *
+ * Use to attempt a single-permit acquisition without retrying when no permit is
+ * available.
+ *
  * **Example** (Trying to acquire a permit)
  *
  * ```ts
@@ -236,6 +296,9 @@ export const acquireN = (self, n) => {
  * })
  * ```
  *
+ * @see {@link acquire} for waiting until one permit is available
+ * @see {@link tryAcquireN} for attempting to acquire multiple permits without blocking
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -250,6 +313,11 @@ export const tryAcquire = self => TxRef.modify(self.permitsRef, permits => {
  * blocking, returning `true` if successful or `false` if not enough permits are
  * available.
  *
+ * **When to use**
+ *
+ * Use to attempt a multi-permit acquisition without retrying when not enough
+ * permits are available.
+ *
  * **Example** (Trying to acquire multiple permits)
  *
  * ```ts
@@ -268,6 +336,9 @@ export const tryAcquire = self => TxRef.modify(self.permitsRef, permits => {
  * })
  * ```
  *
+ * @see {@link acquireN} for waiting until all requested permits are available
+ * @see {@link tryAcquire} for attempting to acquire one permit without blocking
+ *
  * @category combinators
  * @since 4.0.0
  */
@@ -286,6 +357,10 @@ export const tryAcquireN = (self, n) => {
  * Releases one permit back to the semaphore, making it available for
  * acquisition.
  *
+ * **When to use**
+ *
+ * Use to manually return one permit after a transactional acquire.
+ *
  * **Details**
  *
  * If the semaphore is already at capacity, this operation leaves the permit
@@ -311,6 +386,9 @@ export const tryAcquireN = (self, n) => {
  * })
  * ```
  *
+ * @see {@link acquire} for manually acquiring one permit
+ * @see {@link releaseN} for returning multiple permits
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -318,6 +396,10 @@ export const release = self => TxRef.update(self.permitsRef, permits => permits
 /**
  * Releases the specified number of permits back to the semaphore.
  *
+ * **When to use**
+ *
+ * Use to manually return multiple permits after a transactional acquire.
+ *
  * **Details**
  *
  * The available permit count is capped at the semaphore capacity.
@@ -346,6 +428,9 @@ export const release = self => TxRef.update(self.permitsRef, permits => permits
  * })
  * ```
  *
+ * @see {@link acquireN} for manually acquiring multiple permits
+ * @see {@link release} for returning one permit
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -363,6 +448,11 @@ export const releaseN = (self, n) => {
  * automatically acquired before execution and released afterwards, even if the
  * effect fails or is interrupted.
  *
+ * **When to use**
+ *
+ * Use to run an effect while automatically acquiring and releasing one
+ * transactional permit.
+ *
  * **Details**
  *
  * The permit acquisition and release operations use atomic semantics to ensure
@@ -392,6 +482,10 @@ export const releaseN = (self, n) => {
  * })
  * ```
  *
+ * @see {@link withPermits} for automatically acquiring and releasing multiple permits
+ * @see {@link withPermitScoped} for acquiring one permit for the current scope
+ * @see {@link acquire} for manual single-permit acquisition
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -407,6 +501,11 @@ export const withPermit = (...args) => {
  * Runs an effect while holding the specified number of permits from the
  * semaphore.
  *
+ * **When to use**
+ *
+ * Use to run an effect while automatically acquiring and releasing multiple
+ * transactional permits.
+ *
  * **Details**
  *
  * The permits are acquired before the effect starts and released after it
@@ -441,6 +540,9 @@ export const withPermit = (...args) => {
  * })
  * ```
  *
+ * @see {@link withPermit} for automatically acquiring and releasing one permit
+ * @see {@link acquireN} for manual multi-permit acquisition
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -457,6 +559,11 @@ export const withPermits = (...args) => {
  * will be automatically released when the scope is closed, even if effects
  * within the scope fail or are interrupted.
  *
+ * **When to use**
+ *
+ * Use to acquire one transactional permit for the lifetime of the current
+ * scope.
+ *
  * **Details**
  *
  * The permit acquisition and release operations use atomic semantics to ensure
@@ -488,6 +595,9 @@ export const withPermits = (...args) => {
  * })
  * ```
  *
+ * @see {@link withPermit} for acquiring one permit around a single effect
+ * @see {@link acquire} for manual single-permit acquisition
+ *
  * @category combinators
  * @since 2.0.0
  */
@@ -495,6 +605,10 @@ export const withPermitScoped = self => Effect.acquireRelease(acquire(self), ()
 /**
  * Determines if the provided value is a TxSemaphore.
  *
+ * **When to use**
+ *
+ * Use to narrow an unknown value before treating it as a `TxSemaphore`.
+ *
  * **Example** (Checking semaphore values)
  *
  * ```ts
@@ -515,6 +629,8 @@ export const withPermitScoped = self => Effect.acquireRelease(acquire(self), ()
  * })
  * ```
  *
+ * @see {@link make} for creating a `TxSemaphore`
+ *
  * @category guards
  * @since 4.0.0
  */

package/dist/TxSemaphore.js.map

@@ -1 +1 @@
-{"version":3,"file":"TxSemaphore.js","names":["Effect","NodeInspectSymbol","toJson","pipeArguments","hasProperty","TxRef","TypeId","TxSemaphoreProto","toJSON","_id","capacity","pipe","arguments","makeTxSemaphore","permitsRef","self","Object","create","make","permits","gen","die","Error","tx","available","get","succeed","acquire","txRetry","set","acquireN","n","tryAcquire","modify","tryAcquireN","release","update","releaseN","newPermits","withPermit","args","length","effect","acquireUseRelease","withPermits","withPermitScoped","acquireRelease","isTxSemaphore","u"],"sources":["../src/TxSemaphore.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"TxSemaphore.js","names":["Effect","NodeInspectSymbol","toJson","pipeArguments","hasProperty","TxRef","TypeId","TxSemaphoreProto","toJSON","_id","capacity","pipe","arguments","makeTxSemaphore","permitsRef","self","Object","create","make","permits","gen","die","Error","tx","available","get","succeed","acquire","txRetry","set","acquireN","n","tryAcquire","modify","tryAcquireN","release","update","releaseN","newPermits","withPermit","args","length","effect","acquireUseRelease","withPermits","withPermitScoped","acquireRelease","isTxSemaphore","u"],"sources":["../src/TxSemaphore.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}