@deslop/stash 0.1.1066 → 0.1.1067

package/dist/{contracts-CoHsVor4.mjs → contracts-D4AmBpkn.mjs}

@@ -561,7 +561,7 @@ const addBackEdge = () => {
 * @category guards
 * @since 2.0.0
 */
-function isString(input) {
+function isString$1(input) {
 	return typeof input === "string";
 }
 /**
@@ -631,6 +631,38 @@ function isBoolean(input) {
 	return typeof input === "boolean";
 }
 /**
+* Checks whether a value is a `bigint`.
+*
+* **When to use**
+*
+* Use when you need a `Predicate` guard to narrow an `unknown` value to a
+* bigint.
+*
+* **Details**
+*
+* Uses `typeof input === "bigint"`.
+*
+* **Example** (Guarding bigints)
+*
+* ```ts import.meta.vitest
+* import { Predicate } from "effect"
+*
+* const data: unknown = 1n
+*
+* if (Predicate.isBigInt(data)) {
+*   data + 2n // => 3n
+* }
+* ```
+*
+* @see {@link isNumber}
+* @stability stable
+* @category guards
+* @since 2.0.0
+*/
+function isBigInt(input) {
+	return typeof input === "bigint";
+}
+/**
 * Checks whether a value is a `symbol`.
 *
 * **When to use**
@@ -695,7 +727,7 @@ function isSymbol(input) {
 * @since 4.0.0
 */
 function isPropertyKey(u) {
-	return isString(u) || isNumber(u) || isSymbol(u);
+	return isString$1(u) || isNumber(u) || isSymbol(u);
 }
 /**
 * Checks whether a value is a `function`.
@@ -1136,7 +1168,7 @@ function isError(input) {
 * @since 2.0.0
 */
 function isIterable(input) {
-	return hasProperty(input, Symbol.iterator) || isString(input);
+	return hasProperty(input, Symbol.iterator) || isString$1(input);
 }
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Hash.js
@@ -3937,6 +3969,35 @@ const getOrElse$1 = /*#__PURE__*/ dual(2, (self, onNone) => isNone(self) ? onNon
 */
 const orElse = /*#__PURE__*/ dual(2, (self, that) => isNone(self) ? that() : self);
 /**
+* Returns `Some` of the fallback value if `self` is `None`; otherwise returns
+* `self`.
+*
+* **When to use**
+*
+* Use when providing a default plain value (not an `Option`) as fallback
+*
+* **Details**
+*
+* - `Some` → returns `self` unchanged
+* - `None` → calls `onNone()`, wraps result in `Some`, and returns it
+*
+* **Example** (Providing a fallback value)
+*
+* ```ts import.meta.vitest
+* import { Option } from "effect"
+*
+* Option.none().pipe(Option.orElseSome(() => "b")) // => Option.some("b")
+* Option.some("a").pipe(Option.orElseSome(() => "b")) // => Option.some("a")
+* ```
+*
+* @see {@link orElse} when the fallback is itself an `Option`
+*
+* @stability stable
+* @category error handling
+* @since 2.0.0
+*/
+const orElseSome = /*#__PURE__*/ dual(2, (self, onNone) => isNone(self) ? some$1(onNone()) : self);
+/**
 * Converts a nullable value (`null` or `undefined`) into an `Option`.
 *
 * **When to use**
@@ -4270,7 +4331,7 @@ const flatMapNullishOr = /*#__PURE__*/ dual(2, (self, f) => isNone(self) ? none(
 * @category sequencing
 * @since 2.0.0
 */
-const flatten$2 = /*#__PURE__*/ flatMap$7(identity);
+const flatten$5 = /*#__PURE__*/ flatMap$7(identity);
 /**
 * Combines a structure of `Option`s (tuple, struct, or iterable) into a single
 * `Option` containing the unwrapped structure.
@@ -4393,7 +4454,7 @@ const toArray = (self) => isNone(self) ? [] : [self.value];
 * @category filtering
 * @since 2.0.0
 */
-const filter$4 = /*#__PURE__*/ dual(2, (self, predicate) => isNone(self) ? none() : predicate(self.value) ? some$1(self.value) : none());
+const filter$3 = /*#__PURE__*/ dual(2, (self, predicate) => isNone(self) ? none() : predicate(self.value) ? some$1(self.value) : none());
 /**
 * Lifts a `Predicate` or `Refinement` into the `Option` context: returns
 * `Some(value)` when the predicate holds, `None` otherwise.
@@ -5162,31 +5223,10 @@ const constEmptyIterator = { next() {
 * @category constructors
 * @since 2.0.0
 */
-const empty$11 = () => constEmpty;
+const empty$10 = () => constEmpty;
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Record.js
 /**
-* Creates a new, empty record.
-*
-* **Example** (Creating an empty record)
-*
-* ```ts import.meta.vitest
-* import { Record } from "effect"
-*
-* // Create an empty record
-* const emptyRecord = Record.empty<string, number>()
-* emptyRecord // => {}
-*
-* // The type ensures type safety for future operations
-* Record.set(emptyRecord, "count", 42) // => { count: 42 }
-* ```
-*
-* @stability stable
-* @category constructors
-* @since 2.0.0
-*/
-const empty$10 = () => ({});
-/**
 * Determines if a mutable record is empty.
 *
 * **Example** (Checking for an empty record)
@@ -5287,27 +5327,6 @@ const map$7 = /*#__PURE__*/ dual(2, (self, f) => {
 	return out;
 });
 /**
-* Selects properties from a record whose values match the given predicate.
-*
-* **Example** (Filtering record values)
-*
-* ```ts import.meta.vitest
-* import { Record } from "effect"
-*
-* const x = { a: 1, b: 2, c: 3, d: 4 }
-* Record.filter(x, (n) => n > 2) // => { c: 3, d: 4 }
-* ```
-*
-* @stability stable
-* @category filtering
-* @since 2.0.0
-*/
-const filter$3 = /*#__PURE__*/ dual(2, (self, predicate) => {
-	const out = empty$10();
-	for (const key of keys$1(self)) if (predicate(self[key], key)) assignProperty$1(out, key, self[key]);
-	return out;
-});
-/**
 * Retrieves the keys of a given record as an array.
 *
 * **Example** (Getting record keys)
@@ -5620,6 +5639,34 @@ const prepend$1 = /*#__PURE__*/ dual(2, (self, head) => [head, ...self]);
 */
 const append$1 = /*#__PURE__*/ dual(2, (self, last) => [...self, last]);
 /**
+* Concatenates two iterables into a single array.
+*
+* **When to use**
+*
+* Use to combine two iterable inputs into a new array with the second input's
+* elements after the first.
+*
+* **Details**
+*
+* If either input is non-empty, the result is a `NonEmptyArray`.
+*
+* **Example** (Concatenating arrays)
+*
+* ```ts import.meta.vitest
+* import { Array } from "effect"
+*
+* Array.appendAll([1, 2], [3, 4]) // => [1, 2, 3, 4]
+* ```
+*
+* @see {@link append} — add a single element to the end
+* @see {@link prependAll} — add elements to the front
+*
+* @stability stable
+* @category combining
+* @since 2.0.0
+*/
+const appendAll$1 = /*#__PURE__*/ dual(2, (self, that) => fromIterable$6(self).concat(fromIterable$6(that)));
+/**
 * Checks whether a value is an `Array`.
 *
 * **When to use**
@@ -5895,7 +5942,7 @@ const headNonEmpty = /*#__PURE__*/ getUnsafe$1(0);
 * @category getters
 * @since 2.0.0
 */
-const last = (self) => isReadonlyArrayNonEmpty(self) ? some$1(lastNonEmpty(self)) : none();
+const last$1 = (self) => isReadonlyArrayNonEmpty(self) ? some$1(lastNonEmpty(self)) : none();
 /**
 * Returns the last element of a `NonEmptyReadonlyArray` directly (no `Option`
 * wrapper).
@@ -6828,7 +6875,7 @@ const applyOverlays = (map, overlay) => {
 	applyOverlays(map, overlay.parent);
 	map.set(overlay.key, overlay.value);
 };
-const flatten$1 = (self) => {
+const flatten$4 = (self) => {
 	if (self._flat) return self._flat;
 	if (!self.overlay) return self._flat = self.base;
 	const map = new Map(self.base);
@@ -6847,7 +6894,7 @@ const lookup = (self, key) => {
 	const value = impl.base.get(key);
 	if (value === void 0 && !impl.base.has(key)) return notFound;
 	if (impl.overlay && ++impl.baseHits >= impl.base.size && impl.baseHits >= FlattenAfterBaseHits) {
-		impl.base = flatten$1(impl);
+		impl.base = flatten$4(impl);
 		impl.overlay = void 0;
 		impl.depth = 0;
 	}
@@ -6888,7 +6935,7 @@ const lookup = (self, key) => {
 const makeUnsafe$6 = (mapUnsafe) => makeImpl$1(void 0, mapUnsafe, void 0, 0);
 const Proto$9 = {
 	get mapUnsafe() {
-		return flatten$1(this);
+		return flatten$4(this);
 	},
 	...PipeInspectableProto,
 	[TypeId$35]: { _Services: (_) => _ },
@@ -7299,7 +7346,7 @@ const merge$4 = /*#__PURE__*/ dual(2, (self, that) => {
 * @category combining
 * @since 3.12.0
 */
-const mergeAll$2 = (...ctxs) => {
+const mergeAll$3 = (...ctxs) => {
 	const map = /* @__PURE__ */ new Map();
 	for (let i = 0; i < ctxs.length; i++) ctxs[i].mapUnsafe.forEach((value, key) => {
 		map.set(key, value);
@@ -8400,6 +8447,42 @@ const Class$1 = class extends Class$3 {
 	}
 };
 /**
+* Provides a base class for immutable data types with a `_tag` discriminator.
+*
+* **When to use**
+*
+* Use when you need a single-variant tagged type or an ad-hoc discriminator.
+*
+* **Details**
+*
+* Like {@link Class}, but the resulting instances also carry a
+* `readonly _tag: Tag` property. The `_tag` is excluded from the constructor
+* argument.
+*
+* **Example** (Defining a tagged class)
+*
+* ```ts import.meta.vitest
+* import { Data } from "effect"
+*
+* class Person extends Data.TaggedClass("Person")<{
+*   readonly name: string
+* }> {}
+*
+* new Person({ name: "Mike" })._tag // => "Person"
+* ```
+*
+* @see {@link Class} — without a `_tag`
+* @see {@link TaggedError} — tagged error variant
+* @see {@link TaggedEnum} — multi-variant unions
+*
+* @stability stable
+* @category constructors
+* @since 2.0.0
+*/
+const TaggedClass = (tag) => class extends Class$1 {
+	_tag = tag;
+};
+/**
 * Creates constructors and matchers for a `TaggedEnum` type.
 *
 * **When to use**
@@ -9373,7 +9456,7 @@ var FiberImpl = class {
 		this._interruptedCause = this._interruptedCause ? causeCombine(this._interruptedCause, cause) : cause;
 		if (this.interruptible) {
 			if (this._running) this._deferredInterrupt = true;
-			else this.evaluate(failCause$5(this._interruptedCause));
+			else this.evaluate(failCause$6(this._interruptedCause));
 		}
 	}
 	pollUnsafe() {
@@ -9424,7 +9507,7 @@ var FiberImpl = class {
 			while (true) try {
 				if (this._deferredInterrupt) {
 					this._deferredInterrupt = false;
-					current = failCause$5(this._interruptedCause);
+					current = failCause$6(this._interruptedCause);
 				}
 				this.currentOpCount++;
 				const cache = this.cache;
@@ -9522,10 +9605,10 @@ const makeFiberContextCache = (context) => {
 };
 const deferredInterruptCont = {
 	[contA](_value, fiber) {
-		return failCause$5(fiber._interruptedCause);
+		return failCause$6(fiber._interruptedCause);
 	},
 	[contE](_cause, fiber) {
-		return failCause$5(fiber._interruptedCause);
+		return failCause$6(fiber._interruptedCause);
 	}
 };
 const maxInlineSteps = 32;
@@ -9602,9 +9685,19 @@ const fiberInterruptAll = (fibers) => withFiber$1((parent) => {
 	return asVoid$1(fiberAwaitAll(fiberArr));
 });
 /** @internal */
+const fiberInterruptAllAs = /*#__PURE__*/ dual(2, (fibers, fiberId) => withFiber$1((parent) => {
+	const annotations = fiberStackAnnotations(parent);
+	const fiberArr = empty$9();
+	for (const fiber of fibers) {
+		fiber.interruptUnsafe(fiberId, annotations);
+		fiberArr.push(fiber);
+	}
+	return asVoid$1(fiberAwaitAll(fiberArr));
+}));
+/** @internal */
 const succeed$7 = exitSucceed;
 /** @internal */
-const failCause$5 = exitFailCause;
+const failCause$6 = exitFailCause;
 /** @internal */
 const fail$6 = exitFail;
 /** @internal */
@@ -9651,9 +9744,9 @@ const succeedNone$1 = /*#__PURE__*/ succeed$7(/*#__PURE__*/ none());
 /** @internal */
 const transposeOption$1 = (self) => isNone(self) ? succeedNone$1 : map$5(self.value, some$1);
 /** @internal */
-const failCauseSync$1 = (evaluate) => suspend$3(() => failCause$5(evaluate()));
+const failCauseSync$1 = (evaluate) => suspend$3(() => failCause$6(evaluate()));
 /** @internal */
-const die$4 = (defect) => exitDie(defect);
+const die$5 = (defect) => exitDie(defect);
 /** @internal */
 const failSync = (error) => suspend$3(() => fail$6(error()));
 /** @internal */
@@ -9672,7 +9765,7 @@ const try_$1 = (options) => {
 };
 /** @internal */
 const promise$1 = (evaluate) => callbackOptions(function(resume, signal) {
-	evaluate(signal).then((a) => resume(succeed$7(a)), (e) => resume(die$4(e)));
+	evaluate(signal).then((a) => resume(succeed$7(a)), (e) => resume(die$5(e)));
 }, evaluate.length !== 0);
 /** @internal */
 const tryPromise$1 = (options) => {
@@ -9683,7 +9776,7 @@ const tryPromise$1 = (options) => {
 			try {
 				return fail$6(internalCall(() => catcher(cause)));
 			} catch (err) {
-				return die$4(err);
+				return die$5(err);
 			}
 		});
 		try {
@@ -9740,7 +9833,7 @@ const asyncFinalizer = /*#__PURE__*/ makePrimitive({
 		}
 	},
 	[contE](cause, _fiber) {
-		return hasInterrupts$1(cause) ? flatMap$4(combineFinalizerCause(exitFailCause(cause), this[args]()), () => failCause$5(cause)) : failCause$5(cause);
+		return hasInterrupts$1(cause) ? flatMap$4(combineFinalizerCause(exitFailCause(cause), this[args]()), () => failCause$6(cause)) : failCause$6(cause);
 	}
 });
 /** @internal */
@@ -9805,7 +9898,7 @@ const makeFn = (name, bodyOrOptions, defError, pipeables, addSpan, spanOptions)
 			callError = new globalThis.Error();
 			setStackTraceLimit(prevLimit);
 		}
-		return updateService(addSpan ? useSpan$1(name, spanOptions, (span) => provideParentSpan(result, span)) : result, CurrentStackFrame, (prev) => ({
+		return updateService$1(addSpan ? useSpan$1(name, spanOptions, (span) => provideParentSpan(result, span)) : result, CurrentStackFrame, (prev) => ({
 			name,
 			stack: callError ? fnStackCleaner(() => callError.stack) : constUndefined,
 			parent: {
@@ -9847,7 +9940,7 @@ const fromIteratorEagerUnsafe = (evaluate) => {
 			}
 		}
 	} catch (error) {
-		return die$4(error);
+		return die$5(error);
 	}
 };
 const fromIteratorUnsafe = /*#__PURE__*/ function() {
@@ -9926,7 +10019,7 @@ const asSome$1 = (self) => map$5(self, some$1);
 /** @internal */
 const andThen$1 = /*#__PURE__*/ dual(2, (self, f) => new ContImpl(self, isEffect$1(f) ? returnPayload : andThenCont, f));
 /** @internal */
-const tap$1 = /*#__PURE__*/ dual(2, (self, f) => new ContImpl(self, isEffect$1(f) ? tapEffectCont : tapCont, f));
+const tap$2 = /*#__PURE__*/ dual(2, (self, f) => new ContImpl(self, isEffect$1(f) ? tapEffectCont : tapCont, f));
 /** @internal */
 const asVoid$1 = (self) => new ContImpl(self, returnPayload, exitVoid);
 /** @internal */
@@ -9972,6 +10065,8 @@ const flatMapEager$1 = /*#__PURE__*/ dual(2, (self, f) => {
 	return flatMap$4(self, f);
 });
 /** @internal */
+const flatten$3 = (self) => flatMap$4(self, identity);
+/** @internal */
 const map$5 = /*#__PURE__*/ dual(2, (self, f) => new ContImpl(self, mapCont, f));
 /** @internal */
 const mapEager$1 = /*#__PURE__*/ dual(2, (self, f) => effectIsExit(self) ? exitMap(self, f) : map$5(self, f));
@@ -9987,7 +10082,7 @@ const catchEager$1 = /*#__PURE__*/ dual(2, (self, f) => {
 		if (isFailure$1(error)) return self;
 		return f(error.success);
 	}
-	return catch_$2(self, f);
+	return catch_$3(self, f);
 });
 /** @internal */
 const exitInterrupt$1 = (fiberId) => exitFailCause(causeInterrupt(fiberId));
@@ -10041,7 +10136,7 @@ const updateContext$1 = /*#__PURE__*/ dual(2, (self, f) => withFiber$1((fiber) =
 	return self;
 }));
 /** @internal */
-const updateService = /*#__PURE__*/ dual(3, (self, service, f) => updateContext$1(self, (s) => {
+const updateService$1 = /*#__PURE__*/ dual(3, (self, service, f) => updateContext$1(self, (s) => {
 	const prev = getUnsafe(s, service);
 	const next = f(prev);
 	if (prev === next) return s;
@@ -10058,12 +10153,14 @@ const provideContext$3 = /*#__PURE__*/ dual(2, (self, context) => {
 	return updateContext$1(self, merge$4(context));
 });
 /** @internal */
-const provideService$1 = function() {
+const provideService$3 = function() {
 	if (arguments.length === 1) return dual(2, (self, impl) => provideServiceImpl(self, arguments[0], impl));
 	return dual(3, (self, service, impl) => provideServiceImpl(self, service, impl)).apply(this, arguments);
 };
 const provideServiceImpl = (self, service, implementation) => updateContext$1(self, add(service, implementation));
 /** @internal */
+const provideServiceEffect$1 = /*#__PURE__*/ dual(3, (self, service, acquire) => flatMap$4(acquire, (implementation) => provideService$3(self, service, implementation)));
+/** @internal */
 const zipWith$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[1]), (self, that, f, options) => options?.concurrent ? map$5(all$2([self, that], { concurrency: 2 }), ([a, a2]) => f(a, a2)) : flatMap$4(self, (a) => map$5(that, (a2) => f(a, a2))));
 /** @internal */
 const filterOrFail$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, predicate, orFailWith) => filterOrElse(self, predicate, orFailWith ? (a) => fail$6(orFailWith(a)) : () => fail$6(new NoSuchElementError())));
@@ -10088,41 +10185,41 @@ const OnFailureImpl = function(self, f) {
 OnFailureImpl.prototype = OnFailureProto;
 /** @internal */
 const catchCauseIf$1 = /*#__PURE__*/ dual(3, (self, predicate, f) => catchCause$2(self, (cause) => {
-	if (!predicate(cause)) return failCause$5(cause);
+	if (!predicate(cause)) return failCause$6(cause);
 	return f(cause);
 }));
 /** @internal */
 const catchCauseFilter$1 = /*#__PURE__*/ dual(3, (self, filter, f) => catchCause$2(self, (cause) => {
 	const eb = filter(cause);
-	return isFailure$1(eb) ? failCause$5(eb.failure) : f(eb.success, cause);
+	return isFailure$1(eb) ? failCause$6(eb.failure) : f(eb.success, cause);
 }));
 /** @internal */
-const catch_$2 = /*#__PURE__*/ dual(2, (self, f) => catchCauseFilter$1(self, findError$1, (e) => f(e)));
+const catch_$3 = /*#__PURE__*/ dual(2, (self, f) => catchCauseFilter$1(self, findError$1, (e) => f(e)));
 /** @internal */
 const catchDefect$1 = /*#__PURE__*/ dual(2, (self, f) => catchCauseFilter$1(self, findDefect, f));
 /** @internal */
-const tapCause$1 = /*#__PURE__*/ dual(2, (self, f) => catchCause$2(self, (cause) => andThen$1(f(cause), failCause$5(cause))));
+const tapCause$1 = /*#__PURE__*/ dual(2, (self, f) => catchCause$2(self, (cause) => andThen$1(f(cause), failCause$6(cause))));
 /** @internal */
 const tapCauseFilter = /*#__PURE__*/ dual(3, (self, filter, f) => catchCause$2(self, (cause) => {
 	const result = filter(cause);
-	if (isFailure$1(result)) return failCause$5(cause);
-	return andThen$1(f(result.success, cause), failCause$5(cause));
+	if (isFailure$1(result)) return failCause$6(cause);
+	return andThen$1(f(result.success, cause), failCause$6(cause));
 }));
 /** @internal */
 const tapError$1 = /*#__PURE__*/ dual(2, (self, f) => tapCauseFilter(self, findError$1, (e) => f(e)));
 /** @internal */
 const catchIf$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, predicate, f, orElse) => catchCause$2(self, (cause) => {
 	const error = findError$1(cause);
-	if (isFailure$1(error)) return failCause$5(error.failure);
-	if (!predicate(error.success)) return orElse ? orElse(error.success) : failCause$5(cause);
+	if (isFailure$1(error)) return failCause$6(error.failure);
+	if (!predicate(error.success)) return orElse ? orElse(error.success) : failCause$6(cause);
 	return f(error.success);
 }));
 /** @internal */
-const catchFilter$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, filter, f, orElse) => catchCause$2(self, (cause) => {
+const catchFilter$3 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, filter, f, orElse) => catchCause$2(self, (cause) => {
 	const error = findError$1(cause);
-	if (isFailure$1(error)) return failCause$5(error.failure);
+	if (isFailure$1(error)) return failCause$6(error.failure);
 	const result = filter(error.success);
-	if (isFailure$1(result)) return orElse ? orElse(result.failure) : failCause$5(cause);
+	if (isFailure$1(result)) return orElse ? orElse(result.failure) : failCause$6(cause);
 	return f(result.success);
 }));
 /** @internal */
@@ -10131,30 +10228,30 @@ const catchTag$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, k, f
 	return catchIf$1(self, pred, f, orElse);
 });
 /** @internal */
-const catchTags$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, cases, orElse) => {
+const catchTags$2 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, cases, orElse) => {
 	let keys;
-	return catchFilter$1(self, (e) => {
+	return catchFilter$3(self, (e) => {
 		keys ??= Object.keys(cases);
-		return hasProperty(e, "_tag") && isString(e["_tag"]) && keys.includes(e["_tag"]) ? succeed$8(e) : fail$7(e);
+		return hasProperty(e, "_tag") && isString$1(e["_tag"]) && keys.includes(e["_tag"]) ? succeed$8(e) : fail$7(e);
 	}, (e) => cases[e["_tag"]](e), orElse);
 });
 /** @internal */
-const catchReason$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, errorTag, reasonTag, f, orElse) => catchIf$1(self, (e) => isTagged(e, errorTag) && hasProperty(e, "reason") && (orElse !== void 0 || isTagged(e.reason, reasonTag)), (e) => {
+const catchReason$3 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, errorTag, reasonTag, f, orElse) => catchIf$1(self, (e) => isTagged(e, errorTag) && hasProperty(e, "reason") && (orElse !== void 0 || isTagged(e.reason, reasonTag)), (e) => {
 	const reason = e.reason;
 	if (isTagged(reason, reasonTag)) return f(reason, e);
 	return orElse ? orElse(reason, e) : fail$6(e);
 }));
 /** @internal */
-const mapError$3 = /*#__PURE__*/ dual(2, (self, f) => catch_$2(self, (error) => failSync(() => f(error))));
+const mapError$3 = /*#__PURE__*/ dual(2, (self, f) => catch_$3(self, (error) => failSync(() => f(error))));
 /** @internal */
 const mapBoth = /*#__PURE__*/ dual(2, (self, options) => matchEffect$2(self, {
 	onFailure: (e) => failSync(() => options.onFailure(e)),
 	onSuccess: (a) => sync$2(() => options.onSuccess(a))
 }));
 /** @internal */
-const orDie$3 = (self) => catch_$2(self, die$4);
+const orDie$3 = (self) => catch_$3(self, die$5);
 /** @internal */
-const orElseSucceed$1 = /*#__PURE__*/ dual(2, (self, f) => catch_$2(self, (error) => sync$2(() => f(error))));
+const orElseSucceed$1 = /*#__PURE__*/ dual(2, (self, f) => catch_$3(self, (error) => sync$2(() => f(error))));
 /** @internal */
 const ignore$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, options) => {
 	if (!options?.log) return matchEffect$2(self, {
@@ -10165,7 +10262,7 @@ const ignore$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, option
 	return matchCauseEffect$1(self, {
 		onFailure(cause) {
 			const failure = findFail(cause);
-			return isFailure$1(failure) ? failCause$5(failure.failure) : options.message === void 0 ? logEffect(cause) : logEffect(options.message, cause);
+			return isFailure$1(failure) ? failCause$6(failure.failure) : options.message === void 0 ? logEffect(cause) : logEffect(options.message, cause);
 		},
 		onSuccess: (_) => void_$3
 	});
@@ -10224,7 +10321,7 @@ const makeMatch = (op, onFailure) => {
 };
 const MatchImpl = /*#__PURE__*/ makeMatch("Match", function(cause, fiber) {
 	const fail = cause.reasons.find(isFailReason$1);
-	if (fail === void 0) return failCause$5(cause);
+	if (fail === void 0) return failCause$6(cause);
 	const handlers = this.payload;
 	return fiber.succeedWith(continuationMarksStack ? handlers.onFailure(fail.error) : internalCall(() => handlers.onFailure(fail.error)));
 });
@@ -10232,7 +10329,7 @@ const MatchImpl = /*#__PURE__*/ makeMatch("Match", function(cause, fiber) {
 const matchEffect$2 = /*#__PURE__*/ dual(2, (self, options) => matchCauseEffect$1(self, {
 	onFailure: (cause) => {
 		const fail = cause.reasons.find(isFailReason$1);
-		return fail ? options.onFailure(fail.error) : failCause$5(cause);
+		return fail ? options.onFailure(fail.error) : failCause$6(cause);
 	},
 	onSuccess: options.onSuccess
 }));
@@ -10312,7 +10409,7 @@ const runFinalizer = (finalizer, exit_) => {
 		return exitDie(defect);
 	}
 };
-const combineFinalizerCause = (exit_, finalizer) => exitIsSuccess(exit_) ? finalizer : catchCause$2(finalizer, (cause) => failCause$5(causeCombine(exit_.cause, cause)));
+const combineFinalizerCause = (exit_, finalizer) => exitIsSuccess(exit_) ? finalizer : catchCause$2(finalizer, (cause) => failCause$6(causeCombine(exit_.cause, cause)));
 const scopeCloseFinalizers = /*#__PURE__*/ fnUntraced$1(function* (self, finalizers, exit_) {
 	let exits = [];
 	const fibers = [];
@@ -10389,7 +10486,7 @@ const scopeMake = (finalizerStrategy) => sync$2(() => scopeMakeUnsafe(finalizerS
 /** @internal */
 const scope$1 = scopeTag;
 /** @internal */
-const provideScope = /*#__PURE__*/ provideService$1(scopeTag);
+const provideScope = /*#__PURE__*/ provideService$3(scopeTag);
 /** @internal */
 const scoped$1 = (self) => withFiber$1((fiber) => {
 	const prev = fiber.context;
@@ -10407,7 +10504,7 @@ const scopedWith$1 = (f) => suspend$3(() => {
 	return onExit$2(f(scope), (exit) => suspend$3(() => scopeCloseUnsafe(scope, exit) ?? void_$3));
 });
 /** @internal */
-const acquireRelease$1 = (acquire, release, options) => contextWith$1((context) => uninterruptibleMask$1((restore) => flatMap$4(scope$1, (scope) => tap$1(options?.interruptible ? restore(acquire) : acquire, (a) => scopeAddFinalizerExit(scope, (exit) => provideContext$3(release(a, exit), context))))));
+const acquireRelease$1 = (acquire, release, options) => contextWith$1((context) => uninterruptibleMask$1((restore) => flatMap$4(scope$1, (scope) => tap$2(options?.interruptible ? restore(acquire) : acquire, (a) => scopeAddFinalizerExit(scope, (exit) => provideContext$3(release(a, exit), context))))));
 /** @internal */
 const addFinalizer$2 = (finalizer) => flatMap$4(scope$1, (scope) => contextWith$1((context) => scopeAddFinalizerExit(scope, (exit) => provideContext$3(finalizer(exit), context))));
 const OnExitImpl = /*#__PURE__*/ function() {
@@ -10520,7 +10617,7 @@ const makeCachedUnsafe = (self, ttlMillis) => {
 /** @internal */
 const cached$1 = (self) => sync$2(() => makeCachedUnsafe(self, infiniteTTL)[0]);
 /** @internal */
-const interrupt$3 = /*#__PURE__*/ withFiber$1((fiber) => failCause$5(causeInterrupt(fiber.id)));
+const interrupt$3 = /*#__PURE__*/ withFiber$1((fiber) => failCause$6(causeInterrupt(fiber.id)));
 /** @internal */
 const uninterruptible$1 = (self) => withFiber$1((fiber) => {
 	if (!fiber.interruptible) return self;
@@ -10532,7 +10629,7 @@ const setInterruptible = /*#__PURE__*/ makePrimitive({
 	op: "SetInterruptible",
 	[contAll](fiber) {
 		fiber.interruptible = this[args];
-		if (fiber._interruptedCause && fiber.interruptible) return () => failCause$5(fiber._interruptedCause);
+		if (fiber._interruptedCause && fiber.interruptible) return () => failCause$6(fiber._interruptedCause);
 	}
 });
 const setInterruptibleTrue = /*#__PURE__*/ setInterruptible(true);
@@ -10540,7 +10637,7 @@ const setInterruptibleFalse = /*#__PURE__*/ setInterruptible(false);
 const setFiberInterruptible = (fiber) => {
 	fiber.interruptible = true;
 	fiber._stack.push(setInterruptibleFalse);
-	if (fiber._interruptedCause) return failCause$5(fiber._interruptedCause);
+	if (fiber._interruptedCause) return failCause$6(fiber._interruptedCause);
 };
 /**
 * Makes the current fiber uninterruptible for the returned effect without an
@@ -11020,7 +11117,7 @@ const makeSpanScoped$1 = (name, options) => uninterruptible$1(withFiber$1((fiber
 }));
 const provideSpanStackFrame = (name, stack) => {
 	stack = typeof stack === "function" ? stack : constUndefined;
-	return updateService(CurrentStackFrame, (parent) => ({
+	return updateService$1(CurrentStackFrame, (parent) => ({
 		name,
 		stack,
 		parent
@@ -11043,7 +11140,7 @@ const useSpan$1 = (name, ...args) => {
 		return evaluate(span);
 	});
 };
-const provideParentSpan = /*#__PURE__*/ provideService$1(ParentSpan);
+const provideParentSpan = /*#__PURE__*/ provideService$3(ParentSpan);
 /** @internal */
 const withParentSpan$1 = function() {
 	const dataFirst = isEffect$1(arguments[0]);
@@ -11071,6 +11168,15 @@ const withSpan$1 = function() {
 	return (self, ...args) => useSpan$1(name, fnArg ? fnArg(...args) : options, (span) => withParentSpan$1(self, span, traceOptions));
 };
 /** @internal */
+const annotateCurrentSpan$1 = (...args) => withFiber$1((fiber) => {
+	const span = fiber.currentSpanLocal;
+	if (span) {
+		if (args.length === 1) for (const [key, value] of Object.entries(args[0])) span.attribute(key, value);
+		else span.attribute(args[0], args[1]);
+	}
+	return void_$3;
+});
+/** @internal */
 const ClockRef = /*#__PURE__*/ Reference("effect/Clock", { defaultValue: () => new ClockImpl() });
 const MAX_TIMER_MILLIS = 2 ** 31 - 1;
 var ClockImpl = class {
@@ -11445,7 +11551,7 @@ const done$1 = /* @__PURE__ */ dual(2, (self, effect) => sync$2(() => doneUnsafe
 * @category completion
 * @since 2.0.0
 */
-const failCause$4 = /*#__PURE__*/ dual(2, (self, cause) => done$1(self, exitFailCause(cause)));
+const failCause$5 = /*#__PURE__*/ dual(2, (self, cause) => done$1(self, exitFailCause(cause)));
 /**
 * Attempts to complete the `Deferred` with interruption by the specified
 * `FiberId`.
@@ -11479,7 +11585,7 @@ const failCause$4 = /*#__PURE__*/ dual(2, (self, cause) => done$1(self, exitFail
 * @category completion
 * @since 2.0.0
 */
-const interruptWith = /*#__PURE__*/ dual(2, (self, fiberId) => failCause$4(self, causeInterrupt(fiberId)));
+const interruptWith = /*#__PURE__*/ dual(2, (self, fiberId) => failCause$5(self, causeInterrupt(fiberId)));
 /**
 * Returns `true` if this `Deferred` has already been completed with a value or
 * an error, `false` otherwise.
@@ -11691,7 +11797,7 @@ const succeed$6 = exitSucceed;
 * @category constructors
 * @since 2.0.0
 */
-const failCause$3 = exitFailCause;
+const failCause$4 = exitFailCause;
 /**
 * Creates a failed Exit from a typed error value.
 *
@@ -11752,7 +11858,7 @@ const fail$5 = exitFail;
 * @category constructors
 * @since 2.0.0
 */
-const die$3 = exitDie;
+const die$4 = exitDie;
 /**
 * Creates a failed Exit representing fiber interruption.
 *
@@ -12663,7 +12769,7 @@ var CurrentMemoMap = class CurrentMemoMap extends (/*#__PURE__*/ Service()("effe
 * @category destructors
 * @since 2.0.0
 */
-const buildWithMemoMap = /*#__PURE__*/ dual(3, (self, memoMap, scope) => provideService$1(map$5(suspend$3(() => self.build(memoMap, scope)), add(CurrentMemoMap, memoMap)), CurrentMemoMap, memoMap));
+const buildWithMemoMap = /*#__PURE__*/ dual(3, (self, memoMap, scope) => provideService$3(map$5(suspend$3(() => self.build(memoMap, scope)), add(CurrentMemoMap, memoMap)), CurrentMemoMap, memoMap));
 /**
 * Builds a layer into a scoped value.
 *
@@ -13094,7 +13200,7 @@ const unwrapKey = /*#__PURE__*/ Service("effect/Layer/unwrap");
 const unwrap$4 = (self) => flatMap$3(effect(unwrapKey)(self), get$4(unwrapKey));
 const mergeAllEffect = (layers, memoMap, scope) => {
 	const parentScope = forkUnsafe(scope, "parallel");
-	return forEach$2(layers, (layer) => layer.build(memoMap, forkUnsafe(parentScope, "sequential")), { concurrency: layers.length }).pipe(map$5((context) => mergeAll$2(...context)));
+	return forEach$2(layers, (layer) => layer.build(memoMap, forkUnsafe(parentScope, "sequential")), { concurrency: layers.length }).pipe(map$5((context) => mergeAll$3(...context)));
 };
 /**
 * Combines all the provided layers concurrently, creating a new layer with
@@ -13145,7 +13251,7 @@ const mergeAllEffect = (layers, memoMap, scope) => {
 * @category zipping
 * @since 2.0.0
 */
-const mergeAll$1 = (...layers) => fromBuild((memoMap, scope) => mergeAllEffect(layers, memoMap, scope));
+const mergeAll$2 = (...layers) => fromBuild((memoMap, scope) => mergeAllEffect(layers, memoMap, scope));
 /**
 * Merges this layer with another layer concurrently, producing a new layer with
 * combined input, error, and output types.
@@ -13192,7 +13298,7 @@ const mergeAll$1 = (...layers) => fromBuild((memoMap, scope) => mergeAllEffect(l
 * @category zipping
 * @since 2.0.0
 */
-const merge$3 = /*#__PURE__*/ dual(2, (self, that) => mergeAll$1(self, ...Array.isArray(that) ? that : [that]));
+const merge$3 = /*#__PURE__*/ dual(2, (self, that) => mergeAll$2(self, ...Array.isArray(that) ? that : [that]));
 const provideWith = (self, that, f) => fromBuild((memoMap, scope) => flatMap$4(Array.isArray(that) ? mergeAllEffect(that, memoMap, scope) : that.build(memoMap, scope), (context) => self.build(memoMap, scope).pipe(provideContext$3(context), map$5((merged) => f(merged, context)))));
 /**
 * Feeds the output services of the dependency layer into the requirements of
@@ -13673,7 +13779,7 @@ const fail$4 = causeFail;
 * @category constructors
 * @since 2.0.0
 */
-const die$2 = causeDie;
+const die$3 = causeDie;
 /**
 * Creates a standalone `Fail` reason (not wrapped in a `Cause`).
 *
@@ -14163,6 +14269,42 @@ const IllegalArgumentError = IllegalArgumentError$1;
 */
 const UnknownError = UnknownError$1;
 /**
+* Attaches metadata to every reason in a `Cause`.
+*
+* **When to use**
+*
+* Use to attach diagnostic metadata to every reason in a cause.
+*
+* **Details**
+*
+* Annotations are stored as a `Context` on each reason and can be
+* retrieved later via {@link reasonAnnotations} or {@link annotations}.
+* The runtime uses this to attach stack traces and spans.
+*
+* - Returns a new `Cause`.
+* - By default, existing keys are preserved. Pass `{ overwrite: true }` to
+*   replace them.
+*
+* **Example** (Annotating a cause)
+*
+* ```ts import.meta.vitest
+* import { Cause, Context } from "effect"
+*
+* class RequestId extends Context.Service<RequestId, string>()("RequestId") {}
+*
+* const annotated = Cause.annotate(Cause.fail("error"), Context.make(RequestId, "req-1"))
+* Context.getOrUndefined(Cause.annotations(annotated), RequestId) // => "req-1"
+* ```
+*
+* @see {@link annotations} for reading merged annotations from a cause
+* @see {@link reasonAnnotations} for reading annotations from a single reason
+*
+* @stability stable
+* @category annotations
+* @since 4.0.0
+*/
+const annotate$1 = causeAnnotate;
+/**
 * Reads the annotations from a single `Reason` as a `Context`.
 *
 * **When to use**
@@ -14412,6 +14554,8 @@ const isDateTime$1 = (u) => hasProperty(u, TypeId$31);
 /** @internal */
 const isTimeZone = (u) => hasProperty(u, TimeZoneTypeId);
 /** @internal */
+const isUtc$1 = (self) => self._tag === "Utc";
+/** @internal */
 const isZoned = (self) => self._tag === "Zoned";
 const makeUtc = (epochMillis) => {
 	const self = Object.create(ProtoUtc);
@@ -14473,7 +14617,11 @@ const makeZonedUnsafe$1 = (input, options) => {
 	return makeZonedFromAdjusted(self.epochMilliseconds, zone, options?.disambiguation ?? "compatible");
 };
 /** @internal */
+const make$32 = /*#__PURE__*/ liftThrowable(makeUnsafe$3);
+/** @internal */
 const now$1 = /*#__PURE__*/ map$5(currentTimeMillis, makeUtc);
+/** @internal */
+const toUtc$1 = (self) => makeUtc(self.epochMilliseconds);
 const validZoneCache = /*#__PURE__*/ new Map();
 const formatOptions = {
 	day: "numeric",
@@ -14618,6 +14766,8 @@ const calculateNamedOffset = (utcMillis, adjustedMillis, zone) => {
 	return result;
 };
 /** @internal */
+const formatIso$1 = (self) => toDateUtc$1(self).toISOString();
+/** @internal */
 const formatIsoOffset = (self) => {
 	const date = toDate(self);
 	return self._tag === "Utc" ? date.toISOString() : `${date.toISOString().slice(0, -1)}${zonedOffsetIso(self)}`;
@@ -14738,6 +14888,23 @@ const round = /*#__PURE__*/ dual(2, (self, precision) => {
 });
 globalThis.String;
 /**
+* Checks whether a value is a `string`.
+*
+* **Example** (Checking for strings)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.isString("a") // => true
+* String.isString(1) // => false
+* ```
+*
+* @stability stable
+* @category guards
+* @since 2.0.0
+*/
+const isString = isString$1;
+/**
 * Converts a string to lowercase.
 *
 * **Example** (Converting strings to lowercase)
@@ -15027,6 +15194,23 @@ const repeat$2 = (count) => (self) => self.repeat(normalize$1(count));
 * @since 2.0.0
 */
 const replaceAll = (searchValue, replaceValue) => (self) => self.replaceAll(searchValue, replaceValue);
+/**
+* Converts a camelCase string to snake_case.
+*
+* **Example** (Converting camelCase to snake_case)
+*
+* ```ts import.meta.vitest
+* import { String } from "effect"
+*
+* String.camelToSnake("helloWorld") // => "hello_world"
+* String.camelToSnake("fooBarBaz") // => "foo_bar_baz"
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 2.0.0
+*/
+const camelToSnake = (self) => self.replace(/([A-Z])/g, "_$1").toLowerCase();
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/random.js
 /** @internal */
@@ -15191,7 +15375,7 @@ const filterDoneLeftover = (cause) => {
 */
 const doneExitFromCause = (cause) => {
 	const halt = filterDone(cause);
-	return !isFailure$1(halt) ? succeed$6(halt.success.value) : failCause$3(halt.failure);
+	return !isFailure$1(halt) ? succeed$6(halt.success.value) : failCause$4(halt.failure);
 };
 /**
 * Pattern matches on a Pull, handling success, failure, and done cases.
@@ -15405,7 +15589,7 @@ const fromStepWithMetadata = (step) => fromStep(map$5(step, (f) => {
 * @category destructors
 * @since 4.0.0
 */
-const toStep = (schedule) => catchCause$2(schedule.step, (cause) => succeed$7(() => failCause$5(cause)));
+const toStep = (schedule) => catchCause$2(schedule.step, (cause) => succeed$7(() => failCause$6(cause)));
 /**
 * Extracts a step function from a `Schedule` that sleeps for each computed
 * delay and returns metadata for the completed step.
@@ -15465,7 +15649,7 @@ const toStepWithMetadata = (schedule) => clockWith$1((clock) => map$5(toStep(sch
 const min = (schedules) => fromStep(map$5(all$2(schedules.map(toStep)), (steps) => (now, input) => flatMap$4(forEach$2(steps, (step) => matchEffect$1(step(now, input), {
 	onSuccess: (result) => succeed$7(result[1]),
 	onDone: () => undefined_$1,
-	onFailure: failCause$5
+	onFailure: failCause$6
 })), (results) => {
 	const duration = minDuration(results);
 	if (duration === void 0) return done(zero$2);
@@ -15534,7 +15718,7 @@ const exponential = (base, factor = 2) => {
 */
 const passthrough$2 = (self) => fromStep(map$5(toStep(self), (step) => (now, input) => matchEffect$1(step(now, input), {
 	onSuccess: (result) => succeed$7([input, result[1]]),
-	onFailure: failCause$5,
+	onFailure: failCause$6,
 	onDone: () => done(input)
 })));
 /**
@@ -15613,14 +15797,14 @@ const forever$1 = /*#__PURE__*/ spaced(zero$2);
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/layer.js
 const provideLayer = (self, layer, options) => scopedWith$1((scope) => flatMap$4(options?.local ? buildWithMemoMap(layer, makeMemoMapUnsafe(), scope) : buildWithScope(layer, scope), (context) => provideContext$3(self, context)));
 /** @internal */
-const provide$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, source, options) => isContext(source) ? provideContext$3(self, source) : provideLayer(self, Array.isArray(source) ? mergeAll$1(...source) : source, options));
+const provide$1 = /*#__PURE__*/ dual((args) => isEffect$1(args[0]), (self, source, options) => isContext(source) ? provideContext$3(self, source) : provideLayer(self, Array.isArray(source) ? mergeAll$2(...source) : source, options));
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/internal/schedule.js
 const findErrorOnly = (cause) => cause.reasons.every(isFailReason$1) ? findError$1(cause) : fail$7(cause);
 /** @internal */
 const repeatOrElse = /*#__PURE__*/ dual(3, (self, schedule, orElse) => flatMap$4(toStepWithMetadata(schedule), (step) => {
 	let meta = CurrentMetadata.defaultValue();
-	return catchCauseFilter$1(catchDone(forever$2(tap$1(flatMap$4(suspend$3(() => provideService$1(self, CurrentMetadata, meta)), step), (meta_) => sync$2(() => {
+	return catchCauseFilter$1(catchDone(forever$2(tap$2(flatMap$4(suspend$3(() => provideService$3(self, CurrentMetadata, meta)), step), (meta_) => sync$2(() => {
 		meta = meta_;
 	})), { disableYield: true }), (out) => succeed$7(out)), findErrorOnly, (error) => orElse(error, meta.attempt === 0 ? none() : some$1(meta)));
 }));
@@ -15628,7 +15812,7 @@ const repeatOrElse = /*#__PURE__*/ dual(3, (self, schedule, orElse) => flatMap$4
 const retryOrElse$1 = /*#__PURE__*/ dual(3, (self, policy, orElse) => flatMap$4(toStepWithMetadata(policy), (step) => {
 	let meta = CurrentMetadata.defaultValue();
 	let lastError;
-	const loop = catchCauseFilter$1(suspend$3(() => provideService$1(self, CurrentMetadata, meta)), findErrorOnly, (error) => {
+	const loop = catchCauseFilter$1(suspend$3(() => provideService$3(self, CurrentMetadata, meta)), findErrorOnly, (error) => {
 		lastError = error;
 		return flatMap$4(step(error), (meta_) => {
 			meta = meta_;
@@ -16370,7 +16554,7 @@ const fail$3 = fail$6;
 * @category constructors
 * @since 2.0.0
 */
-const failCause$2 = failCause$5;
+const failCause$3 = failCause$6;
 /**
 * Creates an `Effect` that represents a failure with a `Cause` computed lazily.
 *
@@ -16438,7 +16622,7 @@ const failCauseSync = failCauseSync$1;
 * @category constructors
 * @since 2.0.0
 */
-const die$1 = die$4;
+const die$2 = die$5;
 const try_ = try_$1;
 /**
 * Yields control back to the Effect runtime, allowing other fibers to execute.
@@ -16673,6 +16857,31 @@ const transposeOption = transposeOption$1;
 */
 const flatMap$2 = flatMap$4;
 /**
+* Flattens an `Effect` that produces another `Effect` into a single effect.
+*
+* **Example** (Flattening nested effects)
+*
+* ```ts import.meta.vitest
+* import { Effect } from "effect"
+* const output: Array<unknown> = []
+*
+* const nested = Effect.succeed(Effect.succeed("hello"))
+*
+* const program = Effect.gen(function*() {
+*   const value = yield* Effect.flatten(nested)
+*   yield* Effect.sync(() => { output.push(value) })
+* })
+*
+* Effect.runSync(program)
+* output // => ["hello"]
+* ```
+*
+* @stability stable
+* @category sequencing
+* @since 2.0.0
+*/
+const flatten$2 = flatten$3;
+/**
 * Runs this effect and then runs another effect, optionally using the first
 * effect's success value to choose the next effect.
 *
@@ -16807,7 +17016,7 @@ const andThen = andThen$1;
 * @category sequencing
 * @since 2.0.0
 */
-const tap = tap$1;
+const tap$1 = tap$2;
 /**
 * Converts both success and failure of an `Effect` into a `Result` type.
 *
@@ -17117,7 +17326,7 @@ const asVoid = asVoid$1;
 * @since 2.0.0
 */
 const zipWith = zipWith$1;
-const catch_$1 = catch_$2;
+const catch_$2 = catch_$3;
 /**
 * Catches and handles specific errors by their `_tag` field, which is used as a
 * discriminator.
@@ -17215,7 +17424,7 @@ const catchTag = catchTag$1;
 * @category error handling
 * @since 2.0.0
 */
-const catchTags = catchTags$1;
+const catchTags$1 = catchTags$2;
 /**
 * Catches a specific reason within a tagged error.
 *
@@ -17266,7 +17475,7 @@ const catchTags = catchTags$1;
 * @category error handling
 * @since 4.0.0
 */
-const catchReason = catchReason$1;
+const catchReason$2 = catchReason$3;
 /**
 * Handles both recoverable and unrecoverable errors by providing a recovery
 * effect.
@@ -17429,7 +17638,7 @@ const catchIf = catchIf$1;
 * @category error handling
 * @since 4.0.0
 */
-const catchFilter = catchFilter$1;
+const catchFilter$2 = catchFilter$3;
 /**
 * Recovers from specific failures based on a predicate.
 *
@@ -18592,6 +18801,43 @@ const serviceOption = serviceOption$1;
 */
 const updateContext = updateContext$1;
 /**
+* Runs an effect with a service implementation transformed by the provided
+* function.
+*
+* **Details**
+*
+* The service must be available in the effect's context; `updateService`
+* replaces it for the wrapped effect with the value returned by the updater.
+*
+* **Example** (Replacing a service for one effect)
+*
+* ```ts import.meta.vitest
+* import { Context, Effect } from "effect"
+* const output: Array<unknown> = []
+*
+* // Define a counter service
+* const Counter = Context.Service<{ count: number }>("Counter")
+*
+* const program = Effect.gen(function*() {
+*   const updatedCounter = yield* Effect.service(Counter)
+*   yield* Effect.sync(() => { output.push(`Updated count: ${updatedCounter.count}`) })
+*   return updatedCounter.count
+* }).pipe(
+*   Effect.updateService(Counter, (counter) => ({ count: counter.count + 1 }))
+* )
+*
+* // Provide initial service and run
+* const result = Effect.provideService(program, Counter, { count: 0 })
+* void output.push(Effect.runSync(result))
+* output // => ["Updated count: 1", 1]
+* ```
+*
+* @stability stable
+* @category providing services
+* @since 2.0.0
+*/
+const updateService = updateService$1;
+/**
 * Provides one concrete service implementation to an effect.
 *
 * **When to use**
@@ -18639,7 +18885,64 @@ const updateContext = updateContext$1;
 * @category providing services
 * @since 2.0.0
 */
-const provideService = provideService$1;
+const provideService$2 = provideService$3;
+/**
+* Provides one service to an effect using an effectful acquisition.
+*
+* **When to use**
+*
+* Use when the service implementation must be created by an effect and its
+* acquisition failure should remain in the returned effect.
+*
+* **Details**
+*
+* `provideServiceEffect` runs the acquisition effect to produce the service
+* implementation, removes that service from the wrapped effect's requirements,
+* and leaves any other requirements to be provided later. Acquisition failures
+* are included in the returned effect's error channel.
+*
+* **Example** (Providing a service with an effect)
+*
+* ```ts import.meta.vitest
+* import { Context, Effect } from "effect"
+* const output: Array<unknown> = []
+*
+* // Define a database connection service
+* interface DatabaseConnection {
+*   readonly query: (sql: string) => Effect.Effect<string>
+* }
+* const Database = Context.Service<DatabaseConnection>("Database")
+*
+* // Effect that creates a database connection
+* const createConnection = Effect.gen(function*() {
+*   yield* Effect.sync(() => { output.push("Establishing database connection...") })
+*   yield* Effect.sync(() => { output.push("Database connected!") })
+*   return {
+*     query: (sql: string) => Effect.succeed(`Result for: ${sql}`)
+*   }
+* })
+*
+* const program = Effect.gen(function*() {
+*   const db = yield* Effect.service(Database)
+*   return yield* db.query("SELECT * FROM users")
+* })
+*
+* // Provide the service through an effect
+* const withDatabase = Effect.provideServiceEffect(
+*   program,
+*   Database,
+*   createConnection
+* )
+*
+* void output.push(await Effect.runPromise(withDatabase))
+* output // => ["Establishing database connection...", "Database connected!", "Result for: SELECT * FROM users"]
+* ```
+*
+* @stability stable
+* @category providing services
+* @since 2.0.0
+*/
+const provideServiceEffect = provideServiceEffect$1;
 /**
 * Returns the current scope for resource management.
 *
@@ -19273,6 +19576,31 @@ const forever = forever$2;
 */
 const repeat = repeat$1;
 /**
+* Adds an annotation to the current span if available.
+*
+* **Example** (Annotating the current span)
+*
+* ```ts import.meta.vitest
+* import { Effect } from "effect"
+*
+* const program = Effect.gen(function*() {
+*   yield* Effect.annotateCurrentSpan("userId", "123")
+*   yield* Effect.annotateCurrentSpan({
+*     operation: "user-lookup"
+*   })
+*   return "success"
+* })
+*
+* const traced = Effect.withSpan(program, "user-operation")
+* Effect.runSync(traced) // => "success"
+* ```
+*
+* @stability stable
+* @category tracing
+* @since 2.0.0
+*/
+const annotateCurrentSpan = annotateCurrentSpan$1;
+/**
 * Create a new span for tracing, and automatically close it when the Scope
 * finalizes.
 *
@@ -20124,7 +20452,7 @@ const logDebug = /*#__PURE__*/ logWithLevel("Debug");
 * @category logging
 * @since 2.0.0
 */
-const annotateLogs = /*#__PURE__*/ dual((args) => isEffect(args[0]), (effect, ...args) => updateService(effect, CurrentLogAnnotations, (annotations) => {
+const annotateLogs = /*#__PURE__*/ dual((args) => isEffect(args[0]), (effect, ...args) => updateService$1(effect, CurrentLogAnnotations, (annotations) => {
 	const newAnnotations = args.length === 1 ? {
 		...annotations,
 		...args[0]
@@ -20169,7 +20497,7 @@ const annotateLogs = /*#__PURE__*/ dual((args) => isEffect(args[0]), (effect, ..
 * @category logging
 * @since 2.0.0
 */
-const withLogSpan = /*#__PURE__*/ dual(2, (effect, label) => flatMap$4(currentTimeMillis$1, (now) => updateService(effect, CurrentLogSpans, (spans) => {
+const withLogSpan = /*#__PURE__*/ dual(2, (effect, label) => flatMap$4(currentTimeMillis$1, (now) => updateService$1(effect, CurrentLogSpans, (spans) => {
 	return [[label, now], ...spans];
 })));
 /**
@@ -20232,7 +20560,7 @@ const effectify = (fn, onError, onSyncError) => (...args) => callback$1((resume)
 			else resume(succeed$4(result));
 		});
 	} catch (err) {
-		resume(onSyncError ? fail$3(onSyncError(err, args)) : die$1(err));
+		resume(onSyncError ? fail$3(onSyncError(err, args)) : die$2(err));
 	}
 });
 /**
@@ -20507,7 +20835,7 @@ const fnUntracedEager = fnUntracedEager$1;
 * @category constructors
 * @since 4.0.0
 */
-const BigInt$2 = globalThis.BigInt;
+const BigInt$4 = globalThis.BigInt;
 /**
 * Converts a `bigint` to a `number` safely.
 *
@@ -20538,7 +20866,7 @@ const BigInt$2 = globalThis.BigInt;
 * @since 2.0.0
 */
 const toNumber = (b) => {
-	if (b > BigInt$2(Number.MAX_SAFE_INTEGER) || b < BigInt$2(Number.MIN_SAFE_INTEGER)) return none();
+	if (b > BigInt$4(Number.MAX_SAFE_INTEGER) || b < BigInt$4(Number.MIN_SAFE_INTEGER)) return none();
 	return some$1(Number(b));
 };
 //#endregion
@@ -21173,6 +21501,7 @@ const toReadonlyArray_ = (self) => {
 const toReadonlyArray = toReadonlyArray_;
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Fiber.js
+const await_ = fiberAwait;
 /**
 * Joins a fiber, blocking until it completes. If the fiber succeeds,
 * returns its value. If it fails, the error is propagated.
@@ -21333,6 +21662,51 @@ const interruptAs = fiberInterruptAs;
 */
 const interruptAll = fiberInterruptAll;
 /**
+* Interrupts all fibers in the provided iterable using the specified fiber ID as the
+* interrupting fiber. This allows you to control which fiber is considered the source
+* of the interruption, which can be useful for debugging and tracing.
+*
+* **When to use**
+*
+* Use to interrupt several fibers while recording a specific fiber ID as the
+* interruptor.
+*
+* **Details**
+*
+* The returned Effect completes only after all interrupted fibers have
+* completed.
+*
+* **Gotchas**
+*
+* The supplied ID affects the recorded interruptor. It does not make
+* interruption synchronous or force uninterruptible regions to stop early.
+*
+* **Example** (Interrupting multiple fibers as another fiber)
+*
+* ```ts import.meta.vitest
+* import { Effect, Fiber } from "effect"
+*
+* const program = Effect.gen(function*() {
+*   // Create a controlling fiber
+*   const controllerFiber = yield* Effect.forkChild(Effect.succeed("controller"))
+*
+*   const worker1 = yield* Effect.forkChild(Effect.never)
+*   const worker2 = yield* Effect.forkChild(Effect.never)
+*
+*   yield* Fiber.interruptAllAs([worker1, worker2], controllerFiber.id)
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @see {@link interruptAll} for using the current fiber as the interruptor
+*
+* @stability stable
+* @category interruption
+* @since 2.0.0
+*/
+const interruptAllAs = fiberInterruptAllAs;
+/**
 * Returns the current fiber if called from within a fiber context,
 * otherwise returns `undefined`.
 *
@@ -22205,7 +22579,7 @@ const unsubscribe = (self) => uninterruptible(withFiber((state) => {
 	return forEach$1(takeAll$2(self.pollers), (d) => interruptWith(d, state.id), {
 		discard: true,
 		concurrency: "unbounded"
-	}).pipe(tap(() => sync(() => {
+	}).pipe(tap$1(() => sync(() => {
 		self.subscribers.delete(self.subscription);
 		self.subscription.unsubscribe();
 		self.replayWindow.close();
@@ -23014,7 +23388,7 @@ const offerAllUnsafe = (self, messages) => {
 * @category completion
 * @since 4.0.0
 */
-const failCause$1 = /*#__PURE__*/ dual(2, (self, cause) => sync$2(() => failCauseUnsafe(self, cause)));
+const failCause$2 = /*#__PURE__*/ dual(2, (self, cause) => sync$2(() => failCauseUnsafe(self, cause)));
 /**
 * Fails the queue with a cause synchronously. If the queue is already done, `false` is
 * returned.
@@ -23110,7 +23484,7 @@ const failCauseUnsafe = (self, cause) => {
 * @category completion
 * @since 4.0.0
 */
-const end = (self) => failCause$1(self, causeFail(Done$1()));
+const end = (self) => failCause$2(self, causeFail(Done$1()));
 /**
 * Signals queue completion synchronously.
 *
@@ -23898,7 +24272,7 @@ const ChannelProto = {
 */
 const fromTransform$1 = (transform) => {
 	const self = Object.create(ChannelProto);
-	self.transform = (upstream, scope) => catchCause$1(transform(upstream, scope), (cause) => succeed$4(failCause$2(cause)));
+	self.transform = (upstream, scope) => catchCause$1(transform(upstream, scope), (cause) => succeed$4(failCause$3(cause)));
 	return self;
 };
 /**
@@ -24011,7 +24385,7 @@ const DefaultChunkSize = 4096;
 const asyncQueue = (scope, f, options) => make$26({
 	capacity: options?.bufferSize,
 	strategy: options?.strategy
-}).pipe(tap((queue) => addFinalizer$1(scope, shutdown(queue))), tap((queue) => provide$3(f(queue), scope).pipe(catchCause$1((cause) => failCause$1(queue, cause)), forkIn(scope))));
+}).pipe(tap$1((queue) => addFinalizer$1(scope, shutdown(queue))), tap$1((queue) => provide$3(f(queue), scope).pipe(catchCause$1((cause) => failCause$2(queue, cause)), forkIn(scope))));
 /**
 * Creates a `Channel` that interacts with a callback function using a queue, emitting arrays.
 *
@@ -24186,7 +24560,7 @@ const fromIterableArray = (iterable, chunkSize = DefaultChunkSize) => fromIterat
 * @category constructors
 * @since 2.0.0
 */
-const succeed$3 = (value) => fromEffect(succeed$4(value));
+const succeed$3 = (value) => fromEffect$1(succeed$4(value));
 /**
 * Represents a `Channel` that emits no elements.
 *
@@ -24253,7 +24627,7 @@ const fail$2 = (error) => fromPull$1(succeed$4(fail$3(error)));
 * @category constructors
 * @since 2.0.0
 */
-const failCause = (cause) => fromPull$1(failCause$2(cause));
+const failCause$1 = (cause) => fromPull$1(failCause$3(cause));
 /**
 * Constructs a channel that fails immediately with the specified defect.
 *
@@ -24271,7 +24645,7 @@ const failCause = (cause) => fromPull$1(failCause$2(cause));
 * @category constructors
 * @since 4.0.0
 */
-const die = (defect) => failCause(die$2(defect));
+const die$1 = (defect) => failCause$1(die$3(defect));
 /**
 * Uses an effect to write a single value to the channel.
 *
@@ -24290,7 +24664,7 @@ const die = (defect) => failCause(die$2(defect));
 * @category constructors
 * @since 2.0.0
 */
-const fromEffect = (effect) => fromPull$1(sync(() => {
+const fromEffect$1 = (effect) => fromPull$1(sync(() => {
 	let done$19 = false;
 	return suspend$2(() => {
 		if (done$19) return done();
@@ -24613,7 +24987,7 @@ const readableStreamToPullUnsafe = (options) => {
 			try: () => reader.read(),
 			catch: options.onError
 		}), {
-			onFailure: (cause) => exit.current ?? failCause$2(cause),
+			onFailure: (cause) => exit.current ?? failCause$3(cause),
 			onSuccess: ({ done: done$13, value }) => {
 				if (exit.current) return exit.current;
 				return done$13 ? done() : succeed$4(of(value));
@@ -24690,6 +25064,85 @@ const mapDone = /*#__PURE__*/ dual(2, (self, f) => mapDoneEffect(self, (o) => su
 const mapDoneEffect = /*#__PURE__*/ dual(2, (self, f) => transformPull$1(self, (pull) => succeed$4(catchDone(pull, (done$15) => flatMap$2(f(done$15), done)))));
 const concurrencyIsSequential = (concurrency) => concurrency === void 0 || concurrency !== "unbounded" && concurrency <= 1;
 /**
+* Maps each output element with an effectful function, preserving the source
+* channel's done value.
+*
+* **When to use**
+*
+* Use when transforming each channel output needs an Effect, service
+* dependency, failure channel, or configured concurrency.
+*
+* **Details**
+*
+* The mapping function receives the output element and its zero-based index.
+* By default elements are mapped sequentially. Use `options.concurrency` to
+* map multiple elements concurrently, and `options.unordered` to allow
+* concurrently mapped outputs to be emitted as soon as they complete.
+*
+* **Example** (Mapping channel output with effects)
+*
+* ```ts import.meta.vitest
+* import { Channel, Effect } from "effect"
+*
+* const numbersChannel = Channel.fromIterable([1, 2, 3, 4, 5])
+* const processedChannel = Channel.mapEffect(
+*   numbersChannel,
+*   (n) => Effect.succeed(n * n)
+* )
+* await Effect.runPromise(Channel.runCollect(processedChannel)) // => [1, 4, 9, 16, 25]
+* ```
+*
+* @stability stable
+* @category sequencing
+* @since 2.0.0
+*/
+const mapEffect$1 = /*#__PURE__*/ dual((args) => isChannel(args[0]), (self, f, options) => concurrencyIsSequential(options?.concurrency) ? mapEffectSequential(self, f) : mapEffectConcurrent(self, f, options));
+const mapEffectSequential = (self, f) => fromTransform$1((upstream, scope) => {
+	let i = 0;
+	return map$3(toTransform(self)(upstream, scope), flatMap$2((o) => f(o, i++)));
+});
+const mapEffectConcurrent = (self, f, options) => fromTransformBracket(fnUntraced(function* (upstream, scope, forkedScope) {
+	let i = 0;
+	const pull = yield* toTransform(self)(upstream, scope);
+	const concurrencyN = options.concurrency === "unbounded" ? Number.MAX_SAFE_INTEGER : options.concurrency;
+	const queue = yield* bounded(0);
+	yield* addFinalizer$1(forkedScope, shutdown(queue));
+	const runFork = runForkWith(yield* context());
+	const trackFiber = runIn(forkedScope);
+	if (options.unordered) {
+		const semaphore = makeUnsafe$1(concurrencyN);
+		const release = constant(semaphore.release(1));
+		const handle = matchCauseEffect({
+			onFailure: (cause) => flatMap$2(failCause$2(queue, cause), release),
+			onSuccess: (value) => flatMap$2(offer(queue, value), release)
+		});
+		yield* semaphore.take(1).pipe(flatMap$2(() => pull), flatMap$2((value) => {
+			const index = i++;
+			trackFiber(runFork(handle(suspend$2(() => f(value, index)))));
+			return void_$1;
+		}), forever({ disableYield: true }), catchCause$1((cause) => semaphore.withPermits(concurrencyN - 1)(failCause$2(queue, cause))), forkIn(forkedScope));
+	} else {
+		const effects = yield* bounded(concurrencyN - 2);
+		yield* addFinalizer$1(forkedScope, shutdown(effects));
+		yield* take$1(effects).pipe(flatten$2, flatMap$2((value) => offer(queue, value)), forever({ disableYield: true }), catchCause$1((cause) => failCause$2(queue, cause)), forkIn(forkedScope));
+		let errorCause;
+		const onExit = (exit) => {
+			if (exit._tag === "Success") return;
+			errorCause = exit.cause;
+			failCauseUnsafe(queue, exit.cause);
+		};
+		yield* pull.pipe(flatMap$2((value) => {
+			if (errorCause) return failCause$3(errorCause);
+			const index = i++;
+			const fiber = runFork(suspend$2(() => f(value, index)));
+			trackFiber(fiber);
+			fiber.addObserver(onExit);
+			return offer(effects, join(fiber));
+		}), forever({ disableYield: true }), catchCause$1((cause) => offer(effects, failCause$4(cause)).pipe(andThen(failCause$2(effects, cause)))), forkIn(forkedScope));
+	}
+	return take$1(queue);
+}));
+/**
 * Maps each output element to a channel and flattens the child channel
 * outputs.
 *
@@ -24746,7 +25199,7 @@ const flatMapSequential = (self, f) => fromTransform$1((upstream, scope) => map$
 	});
 	return suspend$2(() => childPull ?? makePull);
 }));
-const flatMapConcurrent = (self, f, options) => self.pipe(map$2(f), mergeAll(options));
+const flatMapConcurrent = (self, f, options) => self.pipe(map$2(f), mergeAll$1(options));
 /**
 * Flattens a channel of channels.
 *
@@ -24776,7 +25229,7 @@ const flatMapConcurrent = (self, f, options) => self.pipe(map$2(f), mergeAll(opt
 * @category constructors
 * @since 2.0.0
 */
-const flatten = (channels) => flatMap$1(channels, identity);
+const flatten$1 = (channels) => flatMap$1(channels, identity);
 /**
 * Flattens a channel that outputs arrays into a channel that outputs individual elements.
 *
@@ -24918,7 +25371,7 @@ const mapAccum$1 = /*#__PURE__*/ dual((args) => isChannel(args[0]), (self, initi
 		onFailure(cause_) {
 			cause = cause_;
 			const b = options?.onHalt && options.onHalt(state);
-			return b && b.length > 0 ? succeed$4([state, b]) : failCause$2(cause_);
+			return b && b.length > 0 ? succeed$4([state, b]) : failCause$3(cause_);
 		},
 		onSuccess(a) {
 			const b = f(state, a);
@@ -24927,7 +25380,7 @@ const mapAccum$1 = /*#__PURE__*/ dual((args) => isChannel(args[0]), (self, initi
 	});
 	return suspend$2(function loop() {
 		if (current === void 0) {
-			if (cause) return failCause$2(cause);
+			if (cause) return failCause$3(cause);
 			return flatMap$2(pullNext, ([newState, values]) => {
 				state = newState;
 				if (values.length === 0) return loop();
@@ -24985,10 +25438,10 @@ const catchCause = /*#__PURE__*/ dual(2, (self, f) => fromTransform$1((upstream,
 	let forkedScope = forkUnsafe(scope);
 	return map$3(toTransform(self)(upstream, forkedScope), (pull) => {
 		let currentPull = pull.pipe(catchCause$1((cause) => {
-			if (isDoneCause(cause)) return failCause$2(cause);
+			if (isDoneCause(cause)) return failCause$3(cause);
 			const toClose = forkedScope;
 			forkedScope = forkUnsafe(scope);
-			return close(toClose, failCause$3(cause)).pipe(andThen(toTransform(f(cause))(upstream, forkedScope)), flatMap$2((childPull) => {
+			return close(toClose, failCause$4(cause)).pipe(andThen(toTransform(f(cause))(upstream, forkedScope)), flatMap$2((childPull) => {
 				currentPull = childPull;
 				return childPull;
 			}));
@@ -25021,9 +25474,78 @@ const catchCause = /*#__PURE__*/ dual(2, (self, f) => fromTransform$1((upstream,
 */
 const catchCauseFilter = /*#__PURE__*/ dual(3, (self, filter, f) => catchCause(self, (cause) => {
 	const result = filter(cause);
-	return isFailure$1(result) ? failCause(result.failure) : f(result.success, cause);
+	return isFailure$1(result) ? failCause$1(result.failure) : f(result.success, cause);
+}));
+const catch_$1 = /*#__PURE__*/ dual(2, (self, f) => catchCauseFilter(self, findError, (e) => f(e)));
+/**
+* Recovers from typed channel errors selected by a `Filter`.
+*
+* **When to use**
+*
+* Use to recover from channel errors with a reusable `Filter` when matching
+* can also narrow or transform the error before choosing the recovery channel.
+*
+* **Details**
+*
+* Successful filter results are handled by the recovery function. Failed
+* filter results are handled by `orElse` when provided. Without `orElse`,
+* failed filter results are re-failed.
+*
+* @see {@link catchIf} for selecting typed errors with a predicate
+* @see {@link catchTag} for selecting tagged typed errors
+* @see {@link catchCauseFilter} for selecting full causes with a `Filter`
+*
+* @stability stable
+* @category error handling
+* @since 4.0.0
+*/
+const catchFilter$1 = /*#__PURE__*/ dual((args) => isChannel(args[0]), (self, filter, f, orElse) => catch_$1(self, (err) => {
+	const result = filter(err);
+	return isFailure$1(result) ? orElse ? orElse(result.failure) : fail$2(result.failure) : f(result.success);
+}));
+/**
+* Catches a specific reason within a tagged error.
+*
+* **Example** (Recovering from nested reasons)
+*
+* ```ts import.meta.vitest
+* import { Channel, Data, Effect } from "effect"
+*
+* class RateLimitError extends Data.TaggedError("RateLimitError")<{
+*   retryAfter: number
+* }> {}
+*
+* class QuotaExceededError extends Data.TaggedError("QuotaExceededError")<{
+*   limit: number
+* }> {}
+*
+* class AiError extends Data.TaggedError("AiError")<{
+*   reason: RateLimitError | QuotaExceededError
+* }> {}
+*
+* const reason = new RateLimitError({ retryAfter: 60 })
+* const channel = Channel.fail(new AiError({ reason }))
+*
+* const recovered = channel.pipe(
+*   Channel.catchReason("AiError", "RateLimitError", (reason) =>
+*     Channel.succeed(`retry: ${reason.retryAfter}`)
+*   )
+* )
+* Effect.runSync(Channel.runCollect(recovered)) // => ["retry: 60"]
+* ```
+*
+* @stability stable
+* @category error handling
+* @since 4.0.0
+*/
+const catchReason$1 = /*#__PURE__*/ dual((args) => isChannel(args[0]), (self, errorTag, reasonTag, f, orElse) => catch_$1(self, (error) => {
+	if (isTagged(error, errorTag) && hasProperty(error, "reason")) {
+		const reason = error.reason;
+		if (isTagged(reason, reasonTag)) return f(reason, error);
+		return orElse ? orElse(reason, error) : fail$2(error);
+	}
+	return fail$2(error);
 }));
-const catch_ = /*#__PURE__*/ dual(2, (self, f) => catchCauseFilter(self, findError, (e) => f(e)));
 /**
 * Returns a new channel, which is the same as this one, except the failure
 * value of the returned channel is created by applying the specified function
@@ -25033,7 +25555,7 @@ const catch_ = /*#__PURE__*/ dual(2, (self, f) => catchCauseFilter(self, findErr
 * @category error handling
 * @since 2.0.0
 */
-const mapError$1 = /*#__PURE__*/ dual(2, (self, f) => catch_(self, (err) => fail$2(f(err))));
+const mapError$1 = /*#__PURE__*/ dual(2, (self, f) => catch_$1(self, (err) => fail$2(f(err))));
 /**
 * Converts all errors in the channel to defects (unrecoverable failures).
 * This is useful when you want to treat errors as programming errors.
@@ -25061,7 +25583,7 @@ const mapError$1 = /*#__PURE__*/ dual(2, (self, f) => catch_(self, (err) => fail
 * @category error handling
 * @since 2.0.0
 */
-const orDie$1 = (self) => catch_(self, die);
+const orDie$1 = (self) => catch_$1(self, die$1);
 /**
 * Merges multiple channels with specified concurrency and buffering options.
 *
@@ -25099,7 +25621,7 @@ const orDie$1 = (self) => catch_(self, die);
 * @category combining
 * @since 2.0.0
 */
-const mergeAll = /*#__PURE__*/ dual(2, (channels, { bufferSize = 16, concurrency, switch: switch_ = false }) => fromTransformBracket(fnUntraced(function* (upstream, scope, forkedScope) {
+const mergeAll$1 = /*#__PURE__*/ dual(2, (channels, { bufferSize = 16, concurrency, switch: switch_ = false }) => fromTransformBracket(fnUntraced(function* (upstream, scope, forkedScope) {
 	const concurrencyN = concurrency === "unbounded" ? Number.MAX_SAFE_INTEGER : Math.max(1, concurrency);
 	const semaphore = switch_ ? void 0 : makeUnsafe$1(concurrencyN);
 	const doneLatch = yield* make$30(true);
@@ -25126,12 +25648,12 @@ const mergeAll = /*#__PURE__*/ dual(2, (channels, { bufferSize = 16, concurrency
 				if (fibers.size === 0) yield* doneLatch.open;
 				yield* interrupt(fiber);
 			}
-			const fiber = yield* childPull.pipe(tap(() => yieldNow), flatMap$2((value) => offer(queue, value)), forever({ disableYield: true }), onError(fnUntraced(function* (cause) {
+			const fiber = yield* childPull.pipe(tap$1(() => yieldNow), flatMap$2((value) => offer(queue, value)), forever({ disableYield: true }), onError(fnUntraced(function* (cause) {
 				const exit$2 = doneExitFromCause(cause);
 				const closeExit = yield* exit(close(childScope, exit$2));
 				if (!fibers.has(fiber)) return;
 				const failure = asVoidAll([exit$2, closeExit]);
-				if (isFailure(failure)) yield* failCause$1(queue, failure.cause);
+				if (isFailure(failure)) yield* failCause$2(queue, failure.cause);
 				fibers.delete(fiber);
 				if (semaphore) yield* semaphore.release(1);
 				if (fibers.size === 0) yield* doneLatch.open;
@@ -25141,8 +25663,8 @@ const mergeAll = /*#__PURE__*/ dual(2, (channels, { bufferSize = 16, concurrency
 		}
 	}).pipe(catchCause$1((cause) => {
 		const halt = filterDone(cause);
-		if (isSuccess$1(halt)) return doneLatch.whenOpen(failCause$1(queue, cause));
-		return failCause$1(queue, cause);
+		if (isSuccess$1(halt)) return doneLatch.whenOpen(failCause$2(queue, cause));
+		return failCause$2(queue, cause);
 	}), forkIn(forkedScope));
 	return take$1(queue);
 })));
@@ -25177,12 +25699,12 @@ const merge$2 = /*#__PURE__*/ dual((args) => isChannel(args[0]) && isChannel(arg
 	let done = 0;
 	function onExit(side, cause) {
 		done++;
-		if (!isDoneCause(cause)) return failCause$1(queue, cause);
+		if (!isDoneCause(cause)) return failCause$2(queue, cause);
 		switch (strategy) {
-			case "both": return done === 2 ? failCause$1(queue, cause) : void_$1;
+			case "both": return done === 2 ? failCause$2(queue, cause) : void_$1;
 			case "left":
-			case "right": return side === strategy ? failCause$1(queue, cause) : void_$1;
-			case "either": return failCause$1(queue, cause);
+			case "right": return side === strategy ? failCause$2(queue, cause) : void_$1;
+			case "either": return failCause$2(queue, cause);
 		}
 	}
 	const runSide = (side, channel, scope) => toTransform(channel)(upstream, scope).pipe(flatMap$2((pull) => pull.pipe(flatMap$2((value) => offer(queue, value)), forever)), onError((cause) => onExitPrimitive(doneExitFromCause(cause), (exit) => close(scope, exit)).pipe(matchCauseEffect({
@@ -25271,7 +25793,7 @@ const splitLines$1 = () => fromTransform$1((upstream, _scope) => sync(() => {
 		if (done$14._tag === "Some") return done(done$14.value);
 		return matchEffect$1(upstream, {
 			onSuccess: loop,
-			onFailure: failCause$2,
+			onFailure: failCause$3,
 			onDone: (leftover) => {
 				done$14 = some$1(leftover);
 				if (stringBuilder.length > 0) {
@@ -25350,8 +25872,8 @@ const pipeTo = /*#__PURE__*/ dual(2, (self, that) => fromTransform$1((upstream,
 * @since 2.0.0
 */
 const pipeToOrFail = /*#__PURE__*/ dual(2, (self, that) => fromTransform$1((upstream, scope) => flatMap$2(toTransform(self)(upstream, scope), (upstream) => {
-	const upstreamPull = catchCause$1(upstream, (cause) => isDoneCause(cause) ? failCause$2(cause) : die$1(Done(cause)));
-	return map$3(toTransform(that)(upstreamPull, scope), (pull) => catchDefect(pull, (defect) => isDone(defect) ? failCause$2(defect.value) : die$1(defect)));
+	const upstreamPull = catchCause$1(upstream, (cause) => isDoneCause(cause) ? failCause$3(cause) : die$2(Done(cause)));
+	return map$3(toTransform(that)(upstreamPull, scope), (pull) => catchDefect(pull, (defect) => isDone(defect) ? failCause$3(defect.value) : die$2(defect)));
 })));
 /**
 * Constructs a `Channel` from a scoped effect that will result in a
@@ -25419,6 +25941,20 @@ const unwrap$3 = (channel) => fromTransform$1((upstream, scope) => {
 */
 const onExit = /*#__PURE__*/ dual(2, (self, finalizer) => fromTransformBracket((upstream, scope, forkedScope) => addFinalizerExit(forkedScope, finalizer).pipe(andThen(toTransform(self)(upstream, scope)))));
 /**
+* Runs an effect when the channel completes successfully.
+*
+* **Details**
+*
+* The effect runs before the original done value is propagated. The effect is
+* not run when the channel fails. If the effect fails, the returned channel
+* fails with that error.
+*
+* @stability stable
+* @category hooks
+* @since 4.0.0
+*/
+const onEnd$1 = /*#__PURE__*/ dual(2, (self, onEnd) => transformPull$1(self, (pull) => succeed$4(catchDone(pull, (leftover) => flatMap$2(onEnd, () => done(leftover))))));
+/**
 * Returns a channel with a finalizer effect that is guaranteed to run once the
 * channel begins execution, whether it succeeds or fails.
 *
@@ -25463,6 +25999,15 @@ const runWith = (self, f, onHalt) => suspend$2(() => {
 */
 const provideContext$1 = /*#__PURE__*/ dual(2, (self, context) => fromTransform$1((upstream, scope) => map$3(provideContext$2(toTransform(self)(upstream, scope), context), provideContext$2(context))));
 /**
+* Provides a concrete service for a context key, removing that service
+* requirement from the returned channel.
+*
+* @stability stable
+* @category providing services
+* @since 2.0.0
+*/
+const provideService$1 = /*#__PURE__*/ dual(3, (self, key, service) => fromTransform$1((upstream, scope) => map$3(provideService$2(toTransform(self)(upstream, scope), key, service), provideService$2(key, service))));
+/**
 * Runs a channel and applies an effect to each output element.
 *
 * **Example** (Running effects for each output)
@@ -25819,6 +26364,47 @@ const take = (n) => {
 	});
 };
 /**
+* A sink that reduces its inputs using the provided function `f` starting from
+* the specified `initial` state.
+*
+* @stability stable
+* @category folding
+* @since 4.0.0
+*/
+const reduceArray = (initial, f) => fromTransform((upstream) => {
+	let state = initial();
+	return upstream.pipe(flatMap$2((arr) => {
+		state = f(state, arr);
+		return void_$1;
+	}), forever({ disableYield: true }), catchDone(() => succeed$4([state])));
+});
+const last_ = /*#__PURE__*/ reduceArray(none, (_, arr) => last$1(arr));
+/**
+* Creates a sink containing the last value.
+*
+* **When to use**
+*
+* Use when you need to consume all upstream input and keep only the final
+* element.
+*
+* **Details**
+*
+* Returns `Option.some(last)` with the final input value, or `Option.none` when
+* the upstream ends without input.
+*
+* **Gotchas**
+*
+* This sink produces a result only when the upstream ends, so it does not
+* complete for a stream that does not end.
+*
+* @see {@link head} for taking the first input value instead
+*
+* @stability stable
+* @category constructors
+* @since 2.0.0
+*/
+const last = () => last_;
+/**
 * A sink that executes the provided effectful function for every item fed
 * to it.
 *
@@ -26168,6 +26754,23 @@ const isStream = (u) => hasProperty(u, TypeId$20);
 */
 const fromChannel = fromChannel$2;
 /**
+* Creates a stream from an effect.
+*
+* **Example** (Creating a stream from an effect)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* const stream = Stream.fromEffect(Effect.succeed(42))
+* await Effect.runPromise(Stream.runCollect(stream)) // => [42]
+* ```
+*
+* @stability stable
+* @category constructors
+* @since 2.0.0
+*/
+const fromEffect = (effect) => fromChannel(fromEffect$1(map$3(effect, of)));
+/**
 * Creates a stream from a pull effect, such as one produced by `Stream.toPull`.
 *
 * **Details**
@@ -26340,6 +26943,45 @@ const suspend = (stream) => fromChannel(suspend$1(() => stream().channel));
 */
 const fail$1 = (error) => fromChannel(fail$2(error));
 /**
+* Creates a stream that fails with the specified `Cause`.
+*
+* **Example** (Failing with a cause)
+*
+* ```ts import.meta.vitest
+* import { Cause, Effect, Stream } from "effect"
+*
+* const stream = Stream.failCause(Cause.fail("Database connection failed")).pipe(
+*   Stream.catchCause(() => Stream.succeed("recovered"))
+* )
+*
+* await Effect.runPromise(Stream.runCollect(stream)) // => ["recovered"]
+* ```
+*
+* @stability stable
+* @category constructors
+* @since 2.0.0
+*/
+const failCause = (cause) => fromChannel(failCause$1(cause));
+/**
+* The stream that dies with the specified defect.
+*
+* **Example** (Dying with a defect)
+*
+* ```ts import.meta.vitest
+* import { Cause, Effect, Exit, Stream } from "effect"
+*
+* const defect = new Error("Boom")
+* const stream = Stream.die(defect)
+*
+* await Effect.runPromise(Effect.exit(Stream.runCollect(stream))) // => Exit.failCause(Cause.die(defect))
+* ```
+*
+* @stability stable
+* @category constructors
+* @since 2.0.0
+*/
+const die = (defect) => fromChannel(die$1(defect));
+/**
 * Creates a new `Stream` from an iterable collection of values.
 *
 * **Details**
@@ -26544,6 +27186,131 @@ const map$1 = /*#__PURE__*/ dual(2, (self, f) => suspend(() => {
 	return fromChannel(map$2(self.channel, map$6((o) => f(o, i++))));
 }));
 /**
+* Transforms each emitted chunk using the provided function, which receives the chunk and its index.
+*
+* **Example** (Mapping stream chunks)
+*
+* ```ts import.meta.vitest
+* import { Array, Effect, Stream } from "effect"
+*
+* const program = Effect.gen(function*() {
+*   const result = yield* Stream.make(1, 2, 3, 4).pipe(
+*     Stream.rechunk(2),
+*     Stream.mapArray((chunk, index) => Array.map(chunk, (n) => n + index)),
+*     Stream.runCollect
+*   )
+*   result // => [ 1, 2, 4, 5 ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @stability stable
+* @category mapping
+* @since 4.0.0
+*/
+const mapArray = /*#__PURE__*/ dual(2, (self, f) => fromChannel(map$2(self.channel, f)));
+/**
+* Maps over elements of the stream with the specified effectful function.
+*
+* **When to use**
+*
+* Use when each stream element transformation needs an Effect, service
+* dependency, failure channel, or configured concurrency.
+*
+* **Example** (Effectfully mapping stream values)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* const events: Array<string> = []
+* const stream = Stream.make(1, 2, 3)
+*
+* const mappedStream = stream.pipe(
+*   Stream.mapEffect((n) =>
+*     Effect.sync(() => {
+*       events.push(`Processing: ${n}`)
+*       return n * 2
+*     })
+*   )
+* )
+*
+* const program = Effect.gen(function*() {
+*   const result = yield* Stream.runCollect(mappedStream)
+*   result // => [2, 4, 6]
+* })
+*
+* await Effect.runPromise(program)
+* events // => ["Processing: 1", "Processing: 2", "Processing: 3"]
+* ```
+*
+* @stability stable
+* @category mapping
+* @since 2.0.0
+*/
+const mapEffect = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, f, options) => self.channel.pipe(flattenArray, mapEffect$1(f, options), map$2(of), fromChannel));
+/**
+* Maps over non-empty array chunks emitted by the stream effectfully.
+*
+* **When to use**
+*
+* Use when transformation needs to see and replace each non-empty emitted chunk
+* effectfully instead of mapping individual stream elements.
+*
+* **Example** (Effectfully mapping stream chunks)
+*
+* ```ts import.meta.vitest
+* import { Array, Effect, Stream } from "effect"
+*
+* const program = Effect.gen(function*() {
+*   const result = yield* Stream.fromArray([1, 2, 3, 4]).pipe(
+*     Stream.rechunk(2),
+*     Stream.mapArrayEffect((chunk, index) =>
+*       Effect.succeed(Array.map(chunk, (n) => n + index * 10))
+*     ),
+*     Stream.runCollect
+*   )
+*   result // => [ 1, 2, 13, 14 ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @stability stable
+* @category mapping
+* @since 4.0.0
+*/
+const mapArrayEffect = /*#__PURE__*/ dual(2, (self, f) => fromChannel(mapEffect$1(self.channel, f)));
+/**
+* Runs the provided effect for each element while preserving the elements.
+*
+* **Example** (Tapping stream values)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* const events: Array<string> = []
+* const program = Effect.gen(function*() {
+*   const result = yield* Stream.fromArray([1, 2, 3]).pipe(
+*     Stream.tap((n) => Effect.sync(() => events.push(`before mapping: ${n}`))),
+*     Stream.map((n) => n * 2),
+*     Stream.tap((n) => Effect.sync(() => events.push(`after mapping: ${n}`))),
+*     Stream.runCollect
+*   )
+*
+*   result // => [2, 4, 6]
+* })
+*
+* await Effect.runPromise(program)
+* events // => ["before mapping: 1", "after mapping: 2", "before mapping: 2", "after mapping: 4", "before mapping: 3", "after mapping: 6"]
+* ```
+*
+* @stability stable
+* @category sequencing
+* @since 2.0.0
+*/
+const tap = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, f, options) => mapEffect(self, (a) => as(f(a), a), options));
+/**
 * Maps each element to a stream and flattens the resulting streams.
 *
 * **Details**
@@ -26575,6 +27342,62 @@ const map$1 = /*#__PURE__*/ dual(2, (self, f) => suspend(() => {
 */
 const flatMap = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, f, options) => self.channel.pipe(flattenArray, flatMap$1((a) => f(a).channel, options), fromChannel));
 /**
+* Flattens a stream of streams into a single stream.
+*
+* **Details**
+*
+* With the default sequential concurrency, inner streams are concatenated in
+* strict order. When `concurrency` is greater than `1` or `"unbounded"`,
+* multiple inner streams may run at the same time and their outputs are merged
+* as they arrive.
+*
+* **Example** (Flattening nested streams)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* const streamOfStreams = Stream.make(
+*   Stream.make(1, 2),
+*   Stream.make(3, 4),
+*   Stream.make(5, 6)
+* )
+*
+* const program = Effect.gen(function*() {
+*   const values = yield* Stream.runCollect(Stream.flatten(streamOfStreams))
+*   values // => [ 1, 2, 3, 4, 5, 6 ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @stability stable
+* @category sequencing
+* @since 2.0.0
+*/
+const flatten = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, options) => flatMap(self, identity, options));
+/**
+* Flattens the iterables emitted by this stream into the stream's structure.
+*
+* **Example** (Flattening iterable values)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* const program = Effect.gen(function*() {
+*   const stream = Stream.make([1, 2], [3, 4]).pipe(Stream.flattenIterable)
+*   const values = yield* Stream.runCollect(stream)
+*   values // => [ 1, 2, 3, 4 ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @stability stable
+* @category sequencing
+* @since 4.0.0
+*/
+const flattenIterable = (self) => flatMap(self, fromIterable$5);
+/**
 * Concatenates two streams, emitting all elements from the first stream
 * followed by all elements from the second stream.
 *
@@ -26596,7 +27419,7 @@ const flatMap = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, f, option
 * @since 2.0.0
 */
 const concat = /*#__PURE__*/ dual(2, (self, that) => {
-	const stream = fromChannel(flatten(fromIterator(() => concatChannels(self, that))));
+	const stream = fromChannel(flatten$1(fromIterator(() => concatChannels(self, that))));
 	concatParts.set(stream, [self, that]);
 	return stream;
 });
@@ -26640,6 +27463,48 @@ function* concatChannels(self, that) {
 */
 const merge$1 = /*#__PURE__*/ dual((args) => isStream(args[0]) && isStream(args[1]), (self, that, options) => fromChannel(merge$2(toChannel(self), toChannel(that), options)));
 /**
+* Merges a collection of streams, running up to the specified number concurrently.
+*
+* **When to use**
+*
+* Use to merge an iterable of already-created streams while bounding how many
+* inner streams may run at the same time.
+*
+* **Details**
+*
+* The `concurrency` option is required and may be a number or `"unbounded"`.
+* `bufferSize` controls buffering between inner streams, and outputs are
+* emitted as they arrive under concurrent merging.
+*
+* **Example** (Merging streams with bounded concurrency)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* const streams = [
+*   Stream.fromEffect(Effect.delay(Effect.succeed("A"), "20 millis")),
+*   Stream.fromEffect(Effect.delay(Effect.succeed("B"), "10 millis"))
+* ]
+*
+* const program = Effect.gen(function*() {
+*   const values = yield* Stream.mergeAll(streams, { concurrency: 2 }).pipe(
+*     Stream.runCollect
+*   )
+*   values // => [ 'B', 'A' ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @see {@link merge} for merging exactly two streams and choosing a halt strategy
+* @see {@link flatten} for flattening a stream that already emits streams
+*
+* @stability stable
+* @category merging
+* @since 2.0.0
+*/
+const mergeAll = /*#__PURE__*/ dual(2, (streams, options) => flatten(fromIterable$5(streams), options));
+/**
 * Filters a stream to the elements that satisfy a predicate.
 *
 * **Example** (Filtering stream values)
@@ -26663,6 +27528,127 @@ const merge$1 = /*#__PURE__*/ dual((args) => isStream(args[0]) && isStream(args[
 * @since 2.0.0
 */
 const filter = /*#__PURE__*/ dual(2, (self, predicate) => fromChannel(filterArray(toChannel(self), predicate)));
+const catch_ = /*#__PURE__*/ dual(2, (self, f) => fromChannel(catch_$1(self.channel, (error) => f(error).channel)));
+/**
+* Recovers from errors that match a `Filter` by switching to a recovery
+* stream.
+*
+* **When to use**
+*
+* Use to recover from stream errors with a reusable `Filter` when matching can
+* also narrow or transform the error before choosing the recovery stream.
+*
+* **Details**
+*
+* Successful filter results are passed to `f`. Failed filter results go to
+* `orElse` when provided; otherwise the filter failure is re-failed.
+*
+* @see {@link catchIf} for predicate or refinement based recovery
+* @see {@link catchTag} for `_tag` based recovery from one tagged error
+* @see {@link catchTags} for `_tag` based recovery from multiple tagged errors
+* @see {@link catchCauseFilter} for filtering full causes
+*
+* @stability stable
+* @category error handling
+* @since 4.0.0
+*/
+const catchFilter = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, filter, f, orElse) => fromChannel(catchFilter$1(toChannel(self), filter, (e) => f(e).channel, orElse && ((e) => orElse(e).channel))));
+/**
+* Switches to a recovery stream based on matching `_tag` handlers.
+*
+* **Example** (Catching tagged failures with handlers)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* class NotFound {
+*   readonly _tag = "NotFound"
+*   constructor(readonly resource: string) {}
+* }
+*
+* class Unauthorized {
+*   readonly _tag = "Unauthorized"
+*   constructor(readonly user: string) {}
+* }
+*
+* const stream = Stream.fail(new NotFound("profile"))
+*
+* const program = Effect.gen(function* () {
+*   const result = yield* stream.pipe(
+*     Stream.catchTags({
+*       NotFound: () => Stream.succeed("fallback"),
+*       Unauthorized: () => Stream.succeed("login")
+*     }),
+*     Stream.runCollect
+*   )
+*   result // => [ 'fallback' ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @stability stable
+* @category error handling
+* @since 2.0.0
+*/
+const catchTags = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, cases, orElse) => {
+	let keys;
+	return catchFilter(self, (e) => {
+		keys ??= Object.keys(cases);
+		return hasProperty(e, "_tag") && isString(e["_tag"]) && keys.includes(e["_tag"]) ? succeed$8(e) : fail$7(e);
+	}, (e) => cases[e["_tag"]](e), orElse);
+});
+/**
+* Catches a specific reason within a tagged error.
+*
+* **When to use**
+*
+* Use to handle nested error causes without removing the parent error
+* from the error channel.
+*
+* **Details**
+*
+* The handler receives the unwrapped reason.
+*
+* **Example** (Catching a tagged error reason)
+*
+* ```ts import.meta.vitest
+* import { Data, Effect, Stream } from "effect"
+*
+* class RateLimitError extends Data.TaggedError("RateLimitError")<{
+*   retryAfter: number
+* }> {}
+*
+* class QuotaExceededError extends Data.TaggedError("QuotaExceededError")<{
+*   limit: number
+* }> {}
+*
+* class AiError extends Data.TaggedError("AiError")<{
+*   reason: RateLimitError | QuotaExceededError
+* }> {}
+*
+* const stream = Stream.fail(
+*   new AiError({ reason: new RateLimitError({ retryAfter: 60 }) })
+* )
+*
+* const program = Effect.gen(function*() {
+*   const values = yield* stream.pipe(
+*     Stream.catchReason("AiError", "RateLimitError", (reason) =>
+*       Stream.succeed(`retry: ${reason.retryAfter}`)
+*     ),
+*     Stream.runCollect
+*   )
+*   values // => [ 'retry: 60' ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @stability stable
+* @category error handling
+* @since 4.0.0
+*/
+const catchReason = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, errorTag, reasonTag, f, orElse) => fromChannel(catchReason$1(toChannel(self), errorTag, reasonTag, (reason, error) => f(reason, error).channel, orElse && ((reason, error) => orElse(reason, error).channel))));
 /**
 * Transforms the errors emitted by this stream using `f`.
 *
@@ -26977,7 +27963,7 @@ const transduce = /*#__PURE__*/ dual(2, (self, sink) => transformPull(self, (ups
 			return succeed$4(chunk);
 		}
 		return upstream;
-	}).pipe(catch_$1((error) => {
+	}).pipe(catch_$2((error) => {
 		done$4 = fail$5(error);
 		return done();
 	}));
@@ -27036,7 +28022,7 @@ const aggregateWithin = /*#__PURE__*/ dual(3, (self, sink, schedule) => fromChan
 	yield* pull.pipe(pullLatch.whenOpen, flatMap$2((arr) => {
 		pullLatch.closeUnsafe();
 		return offer(buffer, arr);
-	}), forever, catchCause$1((cause) => failCause$1(buffer, cause)), forkIn(scope));
+	}), forever, catchCause$1((cause) => failCause$2(buffer, cause)), forkIn(scope));
 	const clock = yield* Clock;
 	const step = yield* toStep(schedule);
 	const hasInput = makeUnsafe$2(false);
@@ -27199,6 +28185,32 @@ const decodeText$1 = /*#__PURE__*/ dual((args) => isStream(args[0]), (self, opti
 */
 const splitLines = (self) => self.channel.pipe(pipeTo(splitLines$1()), fromChannel);
 /**
+* Runs the provided effect when the stream ends successfully.
+*
+* **Example** (Running an effect on end)
+*
+* ```ts import.meta.vitest
+* import { Effect, Stream } from "effect"
+*
+* const events: Array<string> = []
+* const program = Effect.gen(function*() {
+*   const values = yield* Stream.make(1, 2, 3).pipe(
+*     Stream.onEnd(Effect.sync(() => events.push("ended"))),
+*     Stream.runCollect
+*   )
+*   values // => [1, 2, 3]
+* })
+*
+* await Effect.runPromise(program)
+* events // => ["ended"]
+* ```
+*
+* @stability stable
+* @category sequencing
+* @since 3.6.0
+*/
+const onEnd = /*#__PURE__*/ dual(2, (self, onEnd) => fromChannel(onEnd$1(self.channel, onEnd)));
+/**
 * Executes the provided finalizer after this stream's finalizers run.
 *
 * **Example** (Ensuring finalization)
@@ -27262,6 +28274,44 @@ const ensuring = /*#__PURE__*/ dual(2, (self, finalizer) => fromChannel(ensuring
 */
 const provideContext = /*#__PURE__*/ dual(2, (self, context) => fromChannel(provideContext$1(self.channel, context)));
 /**
+* Provides the stream with a single required service, eliminating that
+* requirement from its environment.
+*
+* **Example** (Providing a stream service)
+*
+* ```ts import.meta.vitest
+* import { Context, Effect, Stream } from "effect"
+*
+* class Greeter extends Context.Service<Greeter, {
+*   greet: (name: string) => string
+* }>()("Greeter") {}
+*
+* const stream = Stream.fromEffect(
+*   Effect.service(Greeter).pipe(
+*     Effect.map((greeter) => greeter.greet("Ada"))
+*   )
+* )
+*
+* const program = Effect.gen(function*() {
+*   const collected = yield* Stream.runCollect(
+*     stream.pipe(
+*       Stream.provideService(Greeter, {
+*         greet: (name) => `Hello, ${name}`
+*       })
+*     )
+*   )
+*   collected // => [ 'Hello, Ada' ]
+* })
+*
+* await Effect.runPromise(program)
+* ```
+*
+* @stability stable
+* @category providing services
+* @since 2.0.0
+*/
+const provideService = /*#__PURE__*/ dual(3, (self, key, service) => fromChannel(provideService$1(self.channel, key, service)));
+/**
 * Runs a stream with a sink and returns the sink result.
 *
 * **Example** (Running a stream with a sink)
@@ -27861,10 +28911,12 @@ const jsonSchemaAnnotationKeys = [
 	"contentSchema"
 ];
 /** @internal */
-const resolveIdentifier = /*#__PURE__*/ resolveAt("identifier");
+const resolveIdentifier$1 = /*#__PURE__*/ resolveAt("identifier");
 /** @internal */
 const resolveIdentifierFallback = /*#__PURE__*/ resolveAt(IDENTIFIER_FALLBACK_KEY);
 /** @internal */
+const resolveDescription$1 = /*#__PURE__*/ resolveAt("description");
+/** @internal */
 const getExpected = /*#__PURE__*/ memoize((ast) => {
 	const identifier = resolve$1(ast)?.identifier;
 	if (typeof identifier === "string") return identifier;
@@ -28454,6 +29506,22 @@ function getSchemaIssueOrThrow(cause, message) {
 */
 const isDateTime = isDateTime$1;
 /**
+* Checks whether a `DateTime` is a UTC `DateTime` (no time zone information).
+*
+* **When to use**
+*
+* Use to narrow a `DateTime` before passing it to code that requires a UTC
+* value without an associated time zone.
+*
+* @see {@link isZoned} for narrowing to zoned date-times
+* @see {@link match} for handling both UTC and zoned cases
+*
+* @stability stable
+* @category guards
+* @since 3.6.0
+*/
+const isUtc = isUtc$1;
+/**
 * Create a `DateTime` from supported input values.
 *
 * **When to use**
@@ -28528,6 +29596,43 @@ const makeUnsafe = makeUnsafe$3;
 */
 const makeZonedUnsafe = makeZonedUnsafe$1;
 /**
+* Creates a `DateTime` safely from supported input values.
+*
+* **Details**
+*
+* - A `DateTime`
+* - A JavaScript `Date`
+* - The number of milliseconds since the Unix epoch
+* - An object with date and time parts
+* - A string that can be parsed as a date
+*
+* Returns `Some` with the constructed `DateTime` when the input is valid, or
+* `None` when construction would fail, including invalid `Date` instances or
+* unparseable strings.
+*
+* **Example** (Creating optional DateTime values)
+*
+* ```ts import.meta.vitest
+* import { DateTime, Option } from "effect"
+*
+* // from Date
+* DateTime.make(new Date("2024-01-01T12:00:00Z")) // => Option.some(DateTime.makeUnsafe("2024-01-01T12:00:00Z"))
+*
+* // from parts
+* DateTime.make({ year: 2024 }) // => Option.some(DateTime.makeUnsafe("2024-01-01T00:00:00Z"))
+*
+* // from string
+* DateTime.make("2024-01-01") // => Option.some(DateTime.makeUnsafe("2024-01-01T00:00:00Z"))
+*
+* DateTime.make("not a date") // => Option.none()
+* ```
+*
+* @stability stable
+* @category constructors
+* @since 3.6.0
+*/
+const make$21 = make$32;
+/**
 * Gets the current time using the `Clock` service and converts it to a `DateTime`.
 *
 * **Example** (Getting the current DateTime)
@@ -28545,6 +29650,37 @@ const makeZonedUnsafe = makeZonedUnsafe$1;
 */
 const now = now$1;
 /**
+* Converts a `DateTime` to a UTC `DateTime`.
+*
+* **When to use**
+*
+* Use to represent the same instant in UTC instead of its current time zone.
+*
+* **Details**
+*
+* The returned value keeps the same epoch milliseconds and changes only the
+* `DateTime` representation to UTC.
+*
+* **Example** (Converting DateTime values to UTC)
+*
+* ```ts import.meta.vitest
+* import { DateTime } from "effect"
+*
+* const now = DateTime.makeZonedUnsafe({ year: 2024 }, {
+*   timeZone: "Europe/London"
+* })
+*
+* // set as UTC
+* const utc: DateTime.Utc = DateTime.toUtc(now)
+* utc // => DateTime.makeUnsafe("2024-01-01T00:00:00Z")
+* ```
+*
+* @stability stable
+* @category converting
+* @since 3.13.0
+*/
+const toUtc = toUtc$1;
+/**
 * Gets the milliseconds since the Unix epoch of a `DateTime`.
 *
 * **Details**
@@ -28565,6 +29701,31 @@ const now = now$1;
 * @since 3.6.0
 */
 const toEpochMillis = toEpochMillis$1;
+/**
+* Formats a `DateTime` as a UTC ISO string.
+*
+* **Details**
+*
+* Always returns the UTC representation in ISO 8601 format, ignoring any time zone.
+*
+* **Example** (Formatting DateTime values as ISO strings)
+*
+* ```ts import.meta.vitest
+* import { DateTime } from "effect"
+*
+* DateTime.formatIso(DateTime.makeUnsafe("2024-01-01T12:30:45.123Z")) // => "2024-01-01T12:30:45.123Z"
+*
+* const zoned = DateTime.makeZonedUnsafe("2024-01-01T12:30:45.123Z", {
+*   timeZone: "Europe/London"
+* })
+* DateTime.formatIso(zoned) // => "2024-01-01T12:30:45.123Z"
+* ```
+*
+* @stability stable
+* @category formatting
+* @since 3.6.0
+*/
+const formatIso = formatIso$1;
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/encoding/Base64.js
 /**
@@ -28781,6 +29942,36 @@ function forbidden(message) {
 		return isSome(oe) ? new Forbidden(annotations, oe.value, options) : new Forbidden(annotations);
 	});
 }
+/**
+* Getter that always fails with a `Forbidden` issue indicating that encoding is unsupported.
+*
+* **When to use**
+*
+* Use as the encode side of a decode-only Schema transformation.
+*
+* **Details**
+*
+* Its `Getter<never, unknown>` type is assignable to every encoding getter because it accepts any input and never
+* produces an output value.
+*
+* **Example** (Rejecting encoding)
+*
+* ```ts import.meta.vitest
+* import { Effect, Option, SchemaGetter } from "effect"
+*
+* const issue = await Effect.runPromise(
+*   Effect.flip(SchemaGetter.run(SchemaGetter.forbiddenEncoding, Option.some("value"), {}))
+* )
+* issue._tag // => "Forbidden"
+* ```
+*
+* @see {@link forbidden} for a forbidden getter with a custom message
+*
+* @stability stable
+* @category constructors
+* @since 4.0.0
+*/
+const forbiddenEncoding = /*#__PURE__*/ forbidden(() => "Encoding is not supported");
 const passthrough_$1 = /*#__PURE__*/ makeGetter({ _tag: "Passthrough" });
 function passthrough$1() {
 	return passthrough_$1;
@@ -28873,6 +30064,43 @@ function transformEffect$1(f) {
 	});
 }
 /**
+* Creates a getter that transforms the full `Option` — both present and absent values.
+*
+* **When to use**
+*
+* Use when you need a schema getter to handle both `Some` and `None` cases.
+*
+* **Details**
+*
+* The getter is pure and never fails. It receives the full `Option<E>` and
+* must return `Option<T>`, so it can turn a present value into absent or an
+* absent value into present.
+*
+* **Example** (Filtering out empty strings)
+*
+* ```ts import.meta.vitest
+* import { Effect, Option, SchemaGetter } from "effect"
+*
+* const skipEmpty = SchemaGetter.transformOptional<string, string>((o) =>
+*   Option.filter(o, (s) => s.length > 0)
+* )
+* Effect.runSync(SchemaGetter.run(skipEmpty, Option.some(""), {})) // => Option.none()
+* ```
+*
+* @see {@link transform} when you only need to transform present values
+* @see {@link omit} when you always want `None`
+*
+* @stability stable
+* @category transforming
+* @since 4.0.0
+*/
+function transformOptional$1(f) {
+	return makeGetter({
+		_tag: "TransformOptional",
+		transform: f
+	});
+}
+/**
 * Creates a getter that effectfully transforms the full `Option`.
 *
 * @stability stable
@@ -28886,6 +30114,74 @@ function transformOptionalEffect(f) {
 	});
 }
 /**
+* Creates a getter that always returns `None`, effectively omitting the value from output.
+*
+* **When to use**
+*
+* Use when you need a schema getter to exclude a field during decoding or
+* encoding.
+*
+* **Details**
+*
+* - Always returns `Option.None` regardless of input.
+* - Never fails.
+*
+* **Example** (Omitting a field during encoding)
+*
+* ```ts import.meta.vitest
+* import { Effect, Option, SchemaGetter } from "effect"
+*
+* const omitField = SchemaGetter.omit<string>()
+* Effect.runSync(SchemaGetter.run(omitField, Option.some("hidden"), {})) // => Option.none()
+* ```
+*
+* @see {@link transformOptional} when you want conditional omission
+* @see {@link forbidden} when you want to fail instead of silently omit
+*
+* @stability stable
+* @category filtering
+* @since 4.0.0
+*/
+function omit$1() {
+	return transformOptional$1(() => none());
+}
+/**
+* Creates a getter that replaces `undefined` values with a default.
+*
+* **When to use**
+*
+* Use when you need a schema getter to provide a fallback for a field that may
+* be `undefined` in the encoded input.
+*
+* **Details**
+*
+* - If the input is `Some(undefined)` or `None`, produces `Some(T)`.
+* - If the input is `Some(value)` where value is not `undefined`, passes it through.
+* - `defaultValue` is an `Effect` that will be executed each time a default is needed.
+*
+* **Example** (Providing a default value for an optional field)
+*
+* ```ts import.meta.vitest
+* import { Effect, Option, SchemaGetter } from "effect"
+*
+* const withZero = SchemaGetter.withDefault(Effect.succeed(0))
+* await Effect.runPromise(SchemaGetter.run(withZero, Option.some(undefined), {})) // => Option.some(0)
+* ```
+*
+* @see {@link transformOptionalEffect} for custom effectful missing-key handling
+* @see {@link required} when absent input should fail instead of using a default
+*
+* @stability stable
+* @category transforming
+* @since 4.0.0
+*/
+function withDefault$2(defaultValue) {
+	return transformOptionalEffect((o) => {
+		const filtered = filter$3(o, isNotUndefined);
+		return isSome(filtered) ? succeed$4(filtered) : mapEager(defaultValue, some$1);
+	});
+}
+/**
 * Coerces any value to a `string` using the global `String()` constructor.
 *
 * **When to use**
@@ -28946,6 +30242,35 @@ function String$4() {
 function Number$3() {
 	return transform$1(globalThis.Number);
 }
+/**
+* Coerces a value to `bigint` using the global `BigInt()` constructor.
+*
+* **When to use**
+*
+* Use when you need a schema getter to convert a present string, number, or
+* boolean value to `bigint`.
+*
+* **Details**
+*
+* - Delegates to `globalThis.BigInt`.
+* - Throws at runtime if the input cannot be converted (e.g. non-numeric string).
+*
+* **Example** (Coercing to a bigint)
+*
+* ```ts import.meta.vitest
+* import { Effect, Option, SchemaGetter } from "effect"
+*
+* const toBigInt = SchemaGetter.BigInt<string>()
+* Effect.runSync(SchemaGetter.run(toBigInt, Option.some("42"), {})) // => Option.some(42n)
+* ```
+*
+* @stability stable
+* @category converting
+* @since 4.0.0
+*/
+function BigInt$3() {
+	return transform$1(globalThis.BigInt);
+}
 function parseJson(options) {
 	return transformEffect$1((input, parseOptions) => try_({
 		try: () => JSON.parse(input, options?.reviver),
@@ -29538,6 +30863,53 @@ function transformEffect(options) {
 function transform(options) {
 	return new Transformation(transform$1(options.decode), transform$1(options.encode));
 }
+/**
+* Creates a `Transformation` where decode and encode operate on `Option`
+* values, giving full control over missing-key handling.
+*
+* **When to use**
+*
+* Use when you need a schema transformation to produce or consume `Option.None`
+* for absent keys.
+* - You are working with optional struct fields.
+*
+* **Details**
+*
+* - Each function receives `Option<input>` and returns `Option<output>`.
+* - `Option.None` input means the key is absent; returning `Option.None`
+*   omits the key from the output.
+* - Pure and synchronous.
+*
+* **Example** (Converting an optional key to Option)
+*
+* ```ts import.meta.vitest
+* import { Option, Schema, SchemaTransformation } from "effect"
+*
+* const schema = Schema.Struct({
+*   a: Schema.optionalKey(Schema.Number).pipe(
+*     Schema.decodeTo(
+*       Schema.Option(Schema.Number),
+*       SchemaTransformation.transformOptional({
+*         decode: Option.some,
+*         encode: Option.flatten
+*       })
+*     )
+*   )
+* })
+* Schema.decodeSync(schema)({}).a // => Option.none()
+* ```
+*
+* @see {@link transform} — when you don't need Option-level control
+* @see {@link optionFromOptionalKey} — built-in for the common optional-key-to-Option pattern
+* @see {@link optionFromOptional} — built-in for optional (undefined) to Option
+*
+* @stability stable
+* @category transforming
+* @since 4.0.0
+*/
+function transformOptional(options) {
+	return new Transformation(transformOptional$1(options.decode), transformOptional$1(options.encode));
+}
 const passthrough_ = /*#__PURE__*/ new Transformation(/*#__PURE__*/ passthrough$1(), /*#__PURE__*/ passthrough$1());
 function passthrough() {
 	return passthrough_;
@@ -29577,6 +30949,40 @@ function passthrough() {
 * @since 4.0.0
 */
 const numberFromString = /*#__PURE__*/ new Transformation(/*#__PURE__*/ Number$3(), /*#__PURE__*/ String$4());
+/**
+* Decodes a `string` into a `bigint` and encodes a `bigint` back to a
+* `string`.
+*
+* **When to use**
+*
+* Use when you need a schema transformation to parse large integer strings
+* (e.g. database IDs, blockchain values).
+*
+* **Details**
+*
+* Decoding coerces the string to a bigint like `BigInt(s)`. Encoding coerces
+* the bigint to a string like `String(n)`. Decoding fails if the string is not
+* a valid bigint representation.
+*
+* **Example** (Converting a string to a BigInt)
+*
+* ```ts import.meta.vitest
+* import { Schema, SchemaTransformation } from "effect"
+*
+* const schema = Schema.String.pipe(
+*   Schema.decodeTo(Schema.BigInt, SchemaTransformation.bigintFromString)
+* )
+* Schema.decodeSync(schema)("42") // => 42n
+* ```
+*
+* @see {@link numberFromString}
+* @see {@link transform}
+*
+* @stability stable
+* @category converting
+* @since 4.0.0
+*/
+const bigintFromString = /*#__PURE__*/ new Transformation(/*#__PURE__*/ BigInt$3(), /*#__PURE__*/ String$4());
 const isJsonError = (input) => isObject(input) && typeof input["message"] === "string";
 const decodeJsonError = (input) => {
 	const err = Object.hasOwn(input, "cause") ? new Error(input.message, { cause: decodeDefect(input.cause) }) : new Error(input.message);
@@ -30154,7 +31560,7 @@ const String$3 = class extends ASTNodeImpl {
 	_tag = "String";
 	/** @internal */
 	getParser() {
-		return fromRefinement(this, isString);
+		return fromRefinement(this, isString$1);
 	}
 	/** @internal */
 	matchPart(s, options) {
@@ -30277,6 +31683,51 @@ const Boolean$2 = class extends ASTNodeImpl {
 */
 const boolean = /*#__PURE__*/ new Boolean$2();
 /**
+* Constructs a {@link BigInt}.
+*
+* @stability stable
+* @category constructors
+* @since 4.0.0
+*/
+const BigInt$2 = class extends ASTNodeImpl {
+	_tag = "BigInt";
+	/** @internal */
+	getParser() {
+		return fromRefinement(this, isBigInt);
+	}
+	/** @internal */
+	matchPart(s, options) {
+		if (!isStringBigIntRegExp.test(s)) return void 0;
+		const value = globalThis.BigInt(s);
+		if (options.disableChecks || !this.checks) return value;
+		return collectIssues(this.checks, value, void 0, this, options) ? void 0 : value;
+	}
+	/** @internal */
+	toCodecStringTree() {
+		return replaceEncoding(this, [bigIntToString]);
+	}
+	/** @internal */
+	getExpected() {
+		return "bigint";
+	}
+};
+/**
+* Provides the singleton {@link BigInt} AST instance.
+*
+* **When to use**
+*
+* Use to reuse the canonical `BigInt` AST node when constructing, inspecting,
+* or transforming schemas at the AST level.
+*
+* @see {@link BigInt} for the AST node class and string-codec behavior
+* @see {@link isBigInt} for narrowing an AST to a `BigInt` node
+*
+* @stability stable
+* @category constructors
+* @since 4.0.0
+*/
+const bigInt = /*#__PURE__*/ new BigInt$2();
+/**
 * Constructs a {@link Arrays}.
 *
 * @stability stable
@@ -30369,7 +31820,7 @@ const Arrays = class extends ASTNodeImpl {
 				}
 				return parse(input, options);
 			} catch (error) {
-				return die$1(error);
+				return die$2(error);
 			}
 		};
 	}
@@ -30419,7 +31870,7 @@ const parseArrayConcurrent = /*#__PURE__*/ iterateConcurrent()(parseArrayOptions
 const wrapPropertyKeyIssue = (s, ast, key, exit) => {
 	if (exit.cause.reasons.length === 0) return exit;
 	const issue = getSchemaIssue(exit.cause);
-	if (issue === void 0) return failCause$3(map$4(exit.cause, (issue) => new Composite(ast, [new Pointer([key], issue)], s.input, s.options)));
+	if (issue === void 0) return failCause$4(map$4(exit.cause, (issue) => new Composite(ast, [new Pointer([key], issue)], s.input, s.options)));
 	const pointer = new Pointer([key], issue);
 	if (s.options.errors === "all") {
 		if (s.issues) s.issues.push(pointer);
@@ -30448,7 +31899,7 @@ function getIndexSignatureKeys(input, parameter, options = defaultParseOptions)
 			default: return [];
 		}
 	}
-	return go(parameterFromPropertyKey(toEncoded(parameter)));
+	return go(parameterFromPropertyKey(toEncoded$1(parameter)));
 }
 /**
 * Constructs a {@link PropertySignature}.
@@ -30683,7 +32134,7 @@ const Objects = class extends ASTNodeImpl {
 					if (terminal) return terminal;
 				}
 			} catch (error) {
-				return die$1(error);
+				return die$2(error);
 			}
 			return succeed$1(out);
 		};
@@ -30768,6 +32219,11 @@ function tuple(elements, checks = void 0) {
 function union(members, options, checks) {
 	return new Union$1(members.map(getAST), options, void 0, checks);
 }
+/** @internal */
+function mutable$1(ast) {
+	if (ast.encoding) throw new Error("mutable does not support encodings");
+	return new Arrays(true, ast.elements, ast.rest, ast.annotations, ast.checks, void 0, ast.context, ast.encodingChecks);
+}
 const toCandidate = /*#__PURE__*/ memoizeIdempotent((ast) => {
 	while (true) {
 		if (isSuspend(ast)) return unknown;
@@ -31033,7 +32489,7 @@ const Union$1 = class extends ASTNodeImpl {
 		if (typeof expected === "string") return expected;
 		if (this.types.length === 0) return "never";
 		const types = this.types.map((type) => {
-			const encoded = toEncoded(type);
+			const encoded = toEncoded$1(type);
 			switch (encoded._tag) {
 				case "Arrays": {
 					const literals = encoded.elements.filter(isLiteral);
@@ -31053,7 +32509,7 @@ const Union$1 = class extends ASTNodeImpl {
 };
 function failSingleUnionCandidate(ast, cause, input, options) {
 	const issue = getSchemaIssue(cause);
-	if (!issue) return failCause$3(cause);
+	if (!issue) return failCause$4(cause);
 	return fail$5(new AnyOf(ast, [issue], input, options));
 }
 function catchSingleUnionCandidate(ast, result, input, options) {
@@ -31122,6 +32578,36 @@ function formatIsOptional(isOptional) {
 	return isOptional ? "?" : "";
 }
 /**
+* Constructs a {@link Suspend}.
+*
+* @stability stable
+* @category constructors
+* @since 4.0.0
+*/
+const Suspend = class extends ASTNodeImpl {
+	_tag = "Suspend";
+	thunk;
+	constructor(thunk, annotations, checks, encoding, context) {
+		if (checks) throw new Error("Cannot add checks to Suspend");
+		super(annotations, void 0, encoding, context);
+		let ast;
+		this.thunk = () => ast ??= thunk();
+	}
+	/** @internal */
+	getParser(compile) {
+		let parser;
+		return (input, options) => (parser ??= compile(this.thunk()))(input, options);
+	}
+	/** @internal */
+	recur(recur) {
+		return new Suspend(() => recur(this.thunk()), this.annotations, void 0, void 0, this.context);
+	}
+	/** @internal */
+	getExpected(getExpected) {
+		return getExpected(this.thunk());
+	}
+};
+/**
 * Constructs a {@link Filter}.
 *
 * @stability stable
@@ -31506,13 +32992,13 @@ function canPreserveEncodingChecks(ast) {
 * @category transforming
 * @since 4.0.0
 */
-const toType = /*#__PURE__*/ memoizeIdempotent((ast) => {
+const toType$1 = /*#__PURE__*/ memoizeIdempotent((ast) => {
 	const owner = getContextOwner(ast);
 	if (owner !== ast) {
-		const type = toType(owner);
+		const type = toType$1(owner);
 		return type === owner && ast.encoding === void 0 ? ast : replaceContext(type, ast.context);
 	}
-	const type = "recur" in ast ? ast.recur(toType) : ast;
+	const type = "recur" in ast ? ast.recur(toType$1) : ast;
 	if ("encodingChecks" in type && type.encodingChecks) {
 		const checks = canPreserveEncodingChecks(ast) ? type.encodingChecks : isArrays(type) || isObjects(type) || isDeclaration(type) && type.typeParameters.length > 0 ? extractStructuralChecks(type.encodingChecks) : void 0;
 		return copy$1(type, {
@@ -31549,8 +33035,8 @@ const toType = /*#__PURE__*/ memoizeIdempotent((ast) => {
 * @category transforming
 * @since 4.0.0
 */
-const toEncoded = /*#__PURE__*/ memoizeIdempotent((ast) => {
-	return toType(flip(ast));
+const toEncoded$1 = /*#__PURE__*/ memoizeIdempotent((ast) => {
+	return toType$1(flip(ast));
 });
 function flipEncoding(ast, encoding) {
 	const links = encoding;
@@ -31651,6 +33137,20 @@ function isStringFinite(annotations) {
 const finiteString = /*#__PURE__*/ appendChecks(string, [/*#__PURE__*/ isStringFinite()]);
 const finiteToString = /*#__PURE__*/ new Link(finiteString, numberFromString);
 const numberToString = /*#__PURE__*/ new Link(/*#__PURE__*/ new Union$1([finiteString, nonFiniteLiterals]), numberFromString);
+const isStringBigIntRegExp = /*#__PURE__*/ new globalThis.RegExp(`^-?\\d+$`);
+/** @internal */
+function isStringBigInt(annotations) {
+	return isPattern$1(isStringBigIntRegExp, {
+		expected: "a string representing a bigint",
+		representation: {
+			id: "effect/schema/isStringBigInt",
+			payload: null
+		},
+		toJsonSchema: () => ({ pattern: isStringBigIntRegExp.source }),
+		...annotations
+	});
+}
+const bigIntToString = /*#__PURE__*/ new Link(/* @__PURE__ */ appendChecks(string, [/*#__PURE__*/ isStringBigInt({ expected: "a string representing a bigint" })]), bigintFromString);
 /** @internal */
 function collectIssues(checks, value, issues, ast, options) {
 	for (let i = 0; i < checks.length; i++) {
@@ -31676,6 +33176,33 @@ function getConstructorDescriptor(ast) {
 	const getDescriptor = ast.annotations?.[CONSTRUCTOR_ANNOTATION_KEY];
 	return isFunction(getDescriptor) ? getDescriptor(ast.typeParameters) : void 0;
 }
+/**
+* Returns the `identifier` annotation from the AST node, if set.
+*
+* **Details**
+*
+* The identifier is typically set by `Schema.annotations({ identifier: "..." })`
+* and is used for error messages and schema identification.
+*
+* @see {@link resolve}
+* @see {@link resolveTitle}
+* @stability stable
+* @category annotations
+* @since 4.0.0
+*/
+const resolveIdentifier = resolveIdentifier$1;
+/**
+* Returns the `description` annotation from the AST node, if set.
+*
+* @see {@link resolve}
+* @see {@link resolveTitle}
+* @see {@link resolveIdentifier}
+*
+* @stability stable
+* @category annotations
+* @since 4.0.0
+*/
+const resolveDescription = resolveDescription$1;
 function isJsonLeaf(u) {
 	return u === null || typeof u === "string" || typeof u === "boolean" || typeof u === "number" && globalThis.Number.isFinite(u);
 }
@@ -31745,6 +33272,11 @@ const Json$1 = /*#__PURE__*/ new Declaration([], () => (input, ast, options) =>
 	toCodecStringTree: () => unknownToStringTree
 });
 /** @internal */
+const MutableJson$1 = /*#__PURE__*/ annotate(Json$1, { representation: {
+	id: "effect/schema/MutableJson",
+	payload: null
+} });
+/** @internal */
 const unknownToJson = /*#__PURE__*/ new Link(Json$1, /*#__PURE__*/ passthrough());
 /** @internal */
 const objectKeywordToJson = /*#__PURE__*/ new Link(/*#__PURE__*/ new Union$1([/*#__PURE__*/ new Arrays(false, [], [Json$1]), /*#__PURE__*/ new Objects([], [/*#__PURE__*/ new IndexSignature(string, Json$1)])]), /*#__PURE__*/ passthrough());
@@ -32272,7 +33804,7 @@ const fromDuplex = (options) => fromTransform$1((upstream, scope) => {
 		encoding: options.encoding
 	}).pipe(catchCause$1((cause) => {
 		if (isDoneCause(cause)) return void_$1;
-		exit.current = failCause$3(cause);
+		exit.current = failCause$4(cause);
 		latch.openUnsafe();
 		return void_$1;
 	}), forkIn(scope), flatMap$2(() => readableToPullUnsafe({
@@ -32638,7 +34170,7 @@ const layer$12 = /*#__PURE__*/ effect(ChildProcessSpawner, /* @__PURE__ */ gen(f
 		return sync(stop);
 	});
 	const terminateProcessGroup = fnUntraced(function* (command, childProcess, exitSignal, options) {
-		const signalGroup = (signal) => killProcessGroup(command, childProcess, signal).pipe(catch_$1(() => killProcess(command, childProcess, signal)));
+		const signalGroup = (signal) => killProcessGroup(command, childProcess, signal).pipe(catch_$2(() => killProcess(command, childProcess, signal)));
 		yield* signalGroup(options?.killSignal ?? "SIGTERM");
 		if (isUndefined(options?.forceKillAfter)) yield* awaitProcessExit(childProcess, exitSignal, processGroupGraceMillis);
 		else {
@@ -33264,7 +34796,7 @@ const Proto$5 = {
 		return this.toString();
 	},
 	toString() {
-		return `<redacted${isString(this.label) ? ":" + this.label : ""}>`;
+		return `<redacted${isString$1(this.label) ? ":" + this.label : ""}>`;
 	},
 	[symbol$2]() {
 		return hash(redactedRegistry.get(this));
@@ -34673,7 +36205,7 @@ function makeEffect(schema) {
 	const ast = schema.ast;
 	let parser;
 	return (input, options) => {
-		return (parser ??= runWithCompiler(constructorCompiler, toType(ast)))(input, options?.disableChecks ? options?.parseOptions ? {
+		return (parser ??= runWithCompiler(constructorCompiler, toType$1(ast)))(input, options?.disableChecks ? options?.parseOptions ? {
 			...options.parseOptions,
 			disableChecks: true
 		} : { disableChecks: true } : options?.parseOptions);
@@ -34734,7 +36266,7 @@ function makeOption(schema) {
 * @since 4.0.0
 */
 function make$13(schema) {
-	return makeConstructorSync(toType(schema.ast));
+	return makeConstructorSync(toType$1(schema.ast));
 }
 /**
 * Creates a type guard that checks whether an input satisfies the schema's decoded
@@ -34776,7 +36308,7 @@ function makeIs(ast) {
 }
 /** @internal */
 function _is(ast) {
-	const typeAST = toType(ast);
+	const typeAST = toType$1(ast);
 	let guard = (input) => {
 		guard = makeIs(typeAST);
 		return guard(input);
@@ -34811,6 +36343,10 @@ function decodeUnknownEffect$1(schema, options) {
 	const parser = run(schema.ast);
 	return options === void 0 ? parser : (input, overrideOptions) => parser(input, mergeParseOptions(options, overrideOptions));
 }
+/** @internal */
+function decodeUnknownOption$1(schema, options) {
+	return asOption(decodeUnknownEffect$1(schema, options));
+}
 /**
 * Creates an effectful encoder for `unknown` input.
 *
@@ -34866,6 +36402,16 @@ function runWithCompiler(compiler, ast) {
 function asExit(parser) {
 	return (input, options) => runSyncExit(parser(input, options));
 }
+/** @internal */
+function asOption(parser) {
+	const parserExit = asExit(parser);
+	return (input, options) => {
+		const exit = parserExit(input, options);
+		if (isSuccess(exit)) return some$1(exit.value);
+		getSchemaIssueOrThrow(exit.cause, "Option adapter can only return none for schema issues");
+		return none();
+	};
+}
 function runSync(effect, message) {
 	const exit = runSyncExit(effect);
 	if (isSuccess(exit)) return exit.value;
@@ -34887,7 +36433,7 @@ function makeConstructorSync(ast) {
 			try {
 				output = make(input, parseOptions);
 			} catch (error) {
-				getSchemaIssueOrThrow(die$2(error), "Constructor adapter can only throw schema issues");
+				getSchemaIssueOrThrow(die$3(error), "Constructor adapter can only throw schema issues");
 				throw error;
 			}
 			if (output !== invalid$1 && output !== missing) return output;
@@ -35054,6 +36600,45 @@ function decodeUriFragment(fragment) {
 		return;
 	}
 }
+/**
+* Parses a JSON Pointer URI fragment into decoded path tokens.
+*
+* **When to use**
+*
+* Use when you need to resolve a URI fragment against a JSON document.
+*
+* **Details**
+*
+* Percent-encoding is decoded before the pointer is split into tokens, then
+* each token is decoded with {@link unescapeToken}. The empty string and `#`
+* both represent the document root.
+*
+* **Gotchas**
+*
+* Returns `undefined` when the input is not a URI fragment, contains characters
+* that require percent-encoding, or contains an invalid JSON Pointer escape
+* sequence.
+*
+* **Example** (Parsing URI fragments)
+*
+* ```ts import.meta.vitest
+* import { JsonPointer } from "effect"
+*
+* JsonPointer.parseUriFragment("#/users/a~1b") // => ["users", "a/b"]
+* JsonPointer.parseUriFragment("#/caf%C3%A9") // => ["café"]
+* JsonPointer.parseUriFragment("#/%") // => undefined
+* JsonPointer.parseUriFragment("#/a#b") // => undefined
+* ```
+*
+* @see {@link formatUriFragment} for the inverse operation
+* @stability stable
+* @category decoding
+* @since 4.0.0
+*/
+function parseUriFragment(fragment) {
+	const pointer = decodeUriFragment(fragment);
+	return pointer === void 0 ? void 0 : pointer.length === 0 ? [] : pointer.slice(1).split("/").map(unescapeToken);
+}
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/JsonSchema.js
 /**
@@ -35067,6 +36652,11 @@ function decodeUriFragment(fragment) {
 * @stability stable
 * @since 4.0.0
 */
+/** @internal */
+function getReferenceKey($ref) {
+	const path = $ref.startsWith("#") ? parseUriFragment($ref) : void 0;
+	return path !== void 0 && path.length === 2 && path[0] === "$defs" ? path[1] : void 0;
+}
 function transformSchema(node, transform) {
 	return walk(node, false, true);
 	function walk(node, inheritedResource, isRoot = false) {
@@ -35164,7 +36754,7 @@ function validateCanonicalObjectPropertyNames(ast) {
 }
 function makeReorder(getPriority) {
 	return (types) => {
-		const sortedTypes = [...types].sort((a, b) => getPriority(toEncoded(a)) - getPriority(toEncoded(b)));
+		const sortedTypes = [...types].sort((a, b) => getPriority(toEncoded$1(a)) - getPriority(toEncoded$1(b)));
 		if (!sortedTypes.some((ast, index) => ast !== types[index])) return types;
 		return sortedTypes;
 	};
@@ -35182,7 +36772,7 @@ function toCodecJsonASTStep(ast, recur) {
 		case "Declaration": {
 			const getLink = ast.annotations?.toCodecJson ?? ast.annotations?.toCodec;
 			if (!isFunction(getLink)) return replaceEncoding(ast, [unknownToJson]);
-			const link = getLink(ast.typeParameters.map((tp) => make$12(toEncoded(tp))));
+			const link = getLink(ast.typeParameters.map((tp) => make$12(toEncoded$1(tp))));
 			return link === void 0 ? ast : replaceEncoding(ast, [mapLink(link, recur)]);
 		}
 		case "Unknown": return replaceEncoding(ast, [unknownToJson]);
@@ -35225,7 +36815,7 @@ const toStringTreeReorder = /*#__PURE__*/ makeReorder((ast) => {
 function toCodecStringTreeASTStep(ast, recur, onMissingAnnotation) {
 	switch (ast._tag) {
 		case "Declaration": {
-			const typeParameters = ast.typeParameters.map((tp) => make$12(recur(toEncoded(tp))));
+			const typeParameters = ast.typeParameters.map((tp) => make$12(recur(toEncoded$1(tp))));
 			const getStringTreeLink = ast.annotations?.toCodecStringTree;
 			if (isFunction(getStringTreeLink)) {
 				const link = getStringTreeLink(typeParameters);
@@ -35915,8 +37505,8 @@ function toRepresentations(asts, options) {
 	function getCandidate(input) {
 		const ast = getLastEncoding(input);
 		const owner = getContextOwner(ast);
-		let identifier = resolveIdentifier(ast);
-		const fallback = identifier === void 0 ? (ast !== input ? resolveIdentifier(input) : void 0) ?? resolveIdentifierFallback(ast) : void 0;
+		let identifier = resolveIdentifier$1(ast);
+		const fallback = identifier === void 0 ? (ast !== input ? resolveIdentifier$1(input) : void 0) ?? resolveIdentifierFallback(ast) : void 0;
 		if (fallback !== void 0) identifier = `${fallback}Encoded`;
 		let candidatesByIdentifier = candidates.get(owner);
 		if (candidatesByIdentifier === void 0) {
@@ -35967,7 +37557,7 @@ function toRepresentations(asts, options) {
 	}
 	function visitChecks(checks) {
 		checks?.forEach((check) => {
-			check.annotations?.representation?.schemas?.forEach((schema) => visit(toType(schema)));
+			check.annotations?.representation?.schemas?.forEach((schema) => visit(toType$1(schema)));
 			if (check._tag === "FilterGroup") visitChecks(check.checks);
 		});
 	}
@@ -36107,7 +37697,7 @@ function toRepresentations(asts, options) {
 		const { representation, ...ordinary } = annotations;
 		const projected = representation === void 0 ? void 0 : representation.schemas === void 0 ? representation : {
 			...representation,
-			schemas: representation.schemas.map((schema) => recur(toType(schema)))
+			schemas: representation.schemas.map((schema) => recur(toType$1(schema)))
 		};
 		return {
 			...projected === void 0 ? void 0 : { representation: projected },
@@ -36391,7 +37981,7 @@ function fromIssueEffect(self) {
 	return catchCause$1(self, (cause) => failCauseSync(() => map$4(cause, (issue) => new SchemaError(issue))));
 }
 function fromIssueExit(exit) {
-	return isSuccess(exit) ? exit : failCause$3(map$4(exit.cause, (issue) => new SchemaError(issue)));
+	return isSuccess(exit) ? exit : failCause$4(map$4(exit.cause, (issue) => new SchemaError(issue)));
 }
 function getSchemaErrorOrThrow(cause, message) {
 	let schemaError;
@@ -36498,6 +38088,34 @@ function decodeUnknownEffect(schema, options) {
 */
 const decodeEffect = decodeUnknownEffect;
 /**
+* Decodes an `unknown` input against a schema, returning an `Option` that is
+* `Some` with the decoded value on success or `None` for schema mismatches.
+*
+* **When to use**
+*
+* Use when you do not know the input type statically and only need to know
+* whether decoding succeeded.
+*
+* **Details**
+*
+* Prefer this over {@link decodeUnknownExit} or {@link decodeUnknownEffect}
+* when you don't need error details. For input already typed as the schema's
+* `Encoded` type use {@link decodeOption}.
+* Options may be provided either when creating the decoder or when applying it;
+* application options override creation options.
+*
+* **Gotchas**
+*
+* Only causes made entirely of schema issues are converted to `None`. Causes
+* that contain defects, interruptions, or other non-schema reasons throw
+* instead.
+*
+* @stability stable
+* @category decoding
+* @since 3.10.0
+*/
+const decodeUnknownOption = decodeUnknownOption$1;
+/**
 * Decodes an `unknown` input against a schema synchronously, returning the
 * decoded value or throwing a {@link SchemaError} for schema mismatches.
 *
@@ -36777,6 +38395,24 @@ const optional = /*#__PURE__*/ lambda((self) => {
 	return make$11(optional$1(self.ast), { schema });
 });
 /**
+* Extracts the type-side schema: sets `Encoded` to equal the decoded `Type`,
+* discarding the encoding transformation path.
+*
+* @stability stable
+* @category transforming
+* @since 4.0.0
+*/
+const toType = /*#__PURE__*/ lambda((schema) => make$11(toType$1(schema.ast), { schema }));
+/**
+* Extracts the encoded-side schema: sets `Type` to equal the `Encoded`,
+* discarding the decoding transformation path.
+*
+* @stability stable
+* @category transforming
+* @since 4.0.0
+*/
+const toEncoded = /*#__PURE__*/ lambda((schema) => make$11(toEncoded$1(schema.ast), { schema }));
+/**
 * Creates a schema for a single literal value (string, number, bigint, boolean, or null).
 *
 * **Example** (Defining a string literal)
@@ -36896,6 +38532,21 @@ const Number$1 = /*#__PURE__*/ make$11(number);
 */
 const Boolean$1 = /*#__PURE__*/ make$11(boolean);
 /**
+* Schema for `bigint` values. Validates that the input is `typeof` `"bigint"`.
+*
+* **When to use**
+*
+* Use when the input is already a bigint and the schema should validate and
+* preserve bigint values without parsing from another representation.
+*
+* @see {@link BigIntFromString} for parsing string input into a bigint
+*
+* @stability stable
+* @category schemas
+* @since 4.0.0
+*/
+const BigInt$1 = /*#__PURE__*/ make$11(bigInt);
+/**
 * Schema for a TypeScript `void` return value.
 *
 * **When to use**
@@ -37061,6 +38712,34 @@ const ArraySchema = /*#__PURE__*/ lambda((schema) => make$11(new Arrays(false, [
 * @since 3.10.0
 */
 const NonEmptyArray = /*#__PURE__*/ lambda((schema) => make$11(new Arrays(false, [schema.ast], [schema.ast]), { value: schema }));
+/**
+* Makes an array or tuple schema mutable, removing the `readonly` modifier.
+*
+* **Gotchas**
+*
+* This combinator does not support an encoding attached to the array or tuple
+* node and throws if one is present. Encodings on element schemas are
+* supported.
+*
+* **Example** (Defining mutable arrays)
+*
+* ```ts import.meta.vitest
+* import { Schema } from "effect"
+*
+* const schema = Schema.mutable(Schema.Array(Schema.Number))
+*
+* // number[]   (mutable)
+* type T = typeof schema.Type
+* const value: T = [1, 2]
+* value.push(3)
+* value // => [1, 2, 3]
+* ```
+*
+* @stability stable
+* @category transforming
+* @since 3.10.0
+*/
+const mutable = /*#__PURE__*/ lambda((schema) => make$11(mutable$1(schema.ast), { schema }));
 function makeUnion(ast, members) {
 	return make$11(ast, {
 		members,
@@ -37178,6 +38857,17 @@ function decodeTo(to, transformation) {
 		});
 	};
 }
+/**
+* Constructs a decode-only `SchemaAST.Link`.
+*
+* @internal
+*/
+function linkDecoding() {
+	return (to, decode) => link$1()(to, {
+		decode,
+		encode: forbiddenEncoding
+	});
+}
 /** @internal */
 const TrueLiterals = /*#__PURE__*/ Literals([
 	"true",
@@ -37199,6 +38889,11 @@ const BooleanLiterals = /*#__PURE__*/ Literals([...TrueLiterals.literals, ...Fal
 	decode: (value) => value === "true" || value === "yes" || value === "on" || value === "1" || value === "y",
 	encode: (value) => value ? "true" : "false"
 })));
+function encodeTo(to, transformation) {
+	return (from) => {
+		return transformation ? decodeTo(from, transformation)(to) : decodeTo(from)(to);
+	};
+}
 /**
 * Attaches a constructor default value to a schema field.
 *
@@ -37229,6 +38924,100 @@ const BooleanLiterals = /*#__PURE__*/ Literals([...TrueLiterals.literals, ...Fal
 function withConstructorDefault(defaultValue) {
 	return (schema) => make$11(withConstructorDefault$1(schema.ast, defaultValue), { schema });
 }
+function toIssueEffect(self) {
+	return catchCause$1(self, (cause) => failCauseSync(() => map$4(cause, (error) => error.issue)));
+}
+/**
+* Makes a struct key optional on the `Encoded` side and provides a default
+* `Encoded` value when the key is missing during decoding.
+*
+* **Details**
+*
+* The key uses `optionalKey` on the encoded side, so it may be absent from the
+* input object but **not** `undefined`. The default value is specified in terms
+* of the `Encoded` type (before any decoding transformations).
+*
+* Options:
+*
+* - `encodingStrategy`:
+*   - `"passthrough"` (default): include the value in the encoded output.
+*   - `"omit"`: omit the key from the encoded output.
+*
+* **Example** (Providing a default for a missing struct key)
+*
+* ```ts import.meta.vitest
+* import { Effect, Schema } from "effect"
+*
+* const MySchema = Schema.Struct({
+*   name: Schema.String.pipe(Schema.withDecodingDefaultKey(Effect.succeed("anonymous")))
+* })
+*
+* Schema.decodeUnknownSync(MySchema)({}).name // => "anonymous"
+* ```
+*
+* @see {@link withDecodingDefault} for the value-level variant (key absent **or** `undefined`)
+* @see {@link withDecodingDefaultTypeKey} for the variant where the default is a `Type` value
+* @stability stable
+* @category decoding
+* @since 4.0.0
+*/
+function withDecodingDefaultKey(defaultValue, options) {
+	const encode = options?.encodingStrategy === "omit" ? omit$1() : passthrough$1();
+	return (self) => {
+		return optionalKey(toEncoded(self)).pipe(decodeTo(self, {
+			decode: withDefault$2(toIssueEffect(defaultValue)),
+			encode
+		}));
+	};
+}
+/**
+* Wraps the `Encoded` side with `optional` (key absent **or** `undefined`)
+* and provides a default `Encoded` value when the field is missing or
+* `undefined` during decoding.
+*
+* **When to use**
+*
+* Use when the default is expressed in the encoded representation, before the
+* field's decoding transformation runs.
+*
+* **Details**
+*
+* The default value is specified in terms of the `Encoded` type (before any
+* decoding transformations).
+*
+* Options:
+*
+* - `encodingStrategy`:
+*   - `"passthrough"` (default): include the value in the encoded output.
+*   - `"omit"`: omit the key from the encoded output.
+*
+* **Example** (Providing a default for an optional field value)
+*
+* ```ts import.meta.vitest
+* import { Effect, Schema } from "effect"
+*
+* const MySchema = Schema.Struct({
+*   name: Schema.String.pipe(Schema.optional, Schema.withDecodingDefault(Effect.succeed("anonymous")))
+* })
+*
+* Schema.decodeUnknownSync(MySchema)({ name: undefined }).name // => "anonymous"
+* ```
+*
+* @see {@link withDecodingDefaultKey} for the key-level variant (key absent only, not `undefined`)
+* @see {@link withDecodingDefaultType} for the variant where the default is a `Type` value
+* @stability stable
+* @category decoding
+* @since 3.10.0
+*/
+function withDecodingDefault(defaultValue, options) {
+	const encode = options?.encodingStrategy === "omit" ? omit$1() : passthrough$1();
+	return (self) => {
+		return optional(toEncoded(self)).pipe(decodeTo(self, {
+			decode: withDefault$2(toIssueEffect(defaultValue)),
+			encode
+		}));
+	};
+}
 /**
 * Combines a {@link Literal} schema with {@link withConstructorDefault}, making it ideal
 * for discriminator fields in tagged unions. When constructing via `make`, the
@@ -37495,6 +39284,29 @@ function isUUID(version, annotations) {
 */
 const Finite = /*#__PURE__*/ make$11(finite);
 /**
+* Creates a greater-than-or-equal-to (`>=`) check for any ordered type from an
+* `Order.Order` instance.
+*
+* @stability stable
+* @category validation
+* @since 4.0.0
+*/
+function makeIsGreaterThanOrEqualTo(options) {
+	const gte = isGreaterThanOrEqualTo$1(options.order);
+	const formatter = options.formatter ?? format$2;
+	return (minimum, annotations) => {
+		return makeFilter((input) => gte(input, minimum), {
+			expected: `a value greater than or equal to ${formatter(minimum)}`,
+			arbitraryConstraint: {
+				order: options.order,
+				minimum
+			},
+			...options.annotate?.(minimum),
+			...annotations
+		});
+	};
+}
+/**
 * Creates an inclusive or exclusive range check for any ordered type from an
 * `Order.Order` instance.
 *
@@ -37530,6 +39342,36 @@ function encodeNumberPayload(number) {
 	return number;
 }
 /**
+* Validates that a number is greater than or equal to the specified value
+* (inclusive).
+*
+* **Details**
+*
+* JSON Schema:
+*
+* This check corresponds to the `minimum` constraint in JSON Schema.
+*
+* Arbitrary:
+*
+* During arbitrary generation, this applies a `minimum` constraint
+* to ensure generated numbers are greater than or equal to the specified value.
+*
+* @stability stable
+* @category validation
+* @since 4.0.0
+*/
+const isGreaterThanOrEqualTo = /*#__PURE__*/ makeIsGreaterThanOrEqualTo({
+	order: Number$5,
+	annotate: (minimum) => ({
+		representation: {
+			id: "effect/schema/isGreaterThanOrEqualTo",
+			payload: { minimum: encodeNumberPayload(minimum) }
+		},
+		toJsonSchema: () => ({ minimum }),
+		toCode: () => ({ runtime: `Schema.isGreaterThanOrEqualTo(${format$2(minimum)})` })
+	})
+});
+/**
 * Validates that a number is within a specified range. The range boundaries can
 * be inclusive or exclusive based on the provided options.
 *
@@ -37804,6 +39646,22 @@ const URL$2 = /*#__PURE__*/ instanceOf(globalThis.URL, {
 	expected: "URL",
 	toCodecJson: () => link$1()(URLString, urlFromString)
 });
+/**
+* Schema that decodes a `string` into a `URL`.
+*
+* **Details**
+*
+* Decoding:
+* - A **valid** URL `string` is decoded as a `URL`
+*
+* Encoding:
+* - A `URL` is encoded as a `string`
+*
+* @stability stable
+* @category schemas
+* @since 4.0.0
+*/
+const URLFromString = /*#__PURE__*/ URLString.pipe(/*#__PURE__*/ decodeTo(URL$2, urlFromString));
 const JsonString = /*#__PURE__*/ String$2.annotate({
 	expected: "a string that will be decoded as JSON",
 	contentMediaType: "application/json"
@@ -37875,6 +39733,23 @@ const Uint8Array$1 = /*#__PURE__*/ instanceOf(globalThis.Uint8Array, {
 	toCodecJson: () => link$1()(Base64String, uint8ArrayFromBase64String)
 });
 /**
+* Schema that decodes a base64 encoded string into a
+* `Uint8Array`.
+*
+* **Details**
+*
+* Decoding:
+* - A **valid** base64 encoded string is decoded as a `Uint8Array`.
+*
+* Encoding:
+* - A `Uint8Array` is encoded as a base64-encoded string.
+*
+* @stability stable
+* @category schemas
+* @since 3.10.0
+*/
+const Uint8ArrayFromBase64 = /*#__PURE__*/ Base64String.pipe(/*#__PURE__*/ decodeTo(Uint8Array$1, uint8ArrayFromBase64String));
+/**
 * Creates a schema for `Cause.Reason` values using separate schemas for typed
 * failures and unexpected defects.
 *
@@ -38017,6 +39892,159 @@ function Cause(error, defect) {
 		defect
 	});
 }
+const dateTimeUtcFromString = /*#__PURE__*/ transformEffect({
+	decode: (s, options) => {
+		return match$6(make$21(s), {
+			onNone: () => fail$3(new InvalidValue({ expected: "a valid UTC DateTime string" }, s, options)),
+			onSome: (result) => succeed$4(toUtc(result))
+		});
+	},
+	encode: (utc) => succeed$4(formatIso(utc))
+});
+const arbitraryMinimumDateTimestamp = -864e13;
+const arbitraryMaximumDateTimestamp = 864e13;
+function dateTimeArbitraryBounds(constraint, domainMinimum, domainMaximum) {
+	const minimum = Math.max(domainMinimum, constraint?.minimum === void 0 ? domainMinimum : constraint.minimum.epochMilliseconds + (constraint.exclusiveMinimum === true ? 1 : 0));
+	const maximum = Math.min(domainMaximum, constraint?.maximum === void 0 ? domainMaximum : constraint.maximum.epochMilliseconds - (constraint.exclusiveMaximum === true ? 1 : 0));
+	return minimum <= maximum ? [minimum, maximum] : [domainMinimum, domainMaximum];
+}
+function dateTimeArbitraryInteger(minimum, maximum) {
+	return Int.check(isBetween({
+		minimum,
+		maximum
+	}));
+}
+/**
+* Schema for `DateTime.Utc` values.
+*
+* **When to use**
+*
+* Use to validate existing `DateTime.Utc` schema values and use the default JSON
+* codec that represents them as UTC ISO strings.
+*
+* **Details**
+*
+* The default JSON codec decodes UTC ISO strings into `DateTime.Utc` values and
+* encodes `DateTime.Utc` values as UTC ISO strings.
+*
+* @see {@link DateTimeUtcFromString} for decoding date-time strings into UTC values
+* @see {@link DateTimeUtcFromDate} for decoding JavaScript Date values into UTC values
+* @see {@link DateTimeUtcFromMillis} for decoding epoch milliseconds into UTC values
+* @see {@link DateTimeZoned} for preserving zoned DateTime values
+*
+* @stability stable
+* @category schemas
+* @since 3.10.0
+*/
+const DateTimeUtc = /*#__PURE__*/ declare((u) => isDateTime(u) && isUtc(u), {
+	representation: {
+		id: "effect/schema/DateTimeUtc",
+		payload: null
+	},
+	toCode: () => ({
+		runtime: `Schema.DateTimeUtc`,
+		Type: `DateTime.Utc`,
+		importDeclarations: [`import * as DateTime from "effect/DateTime"`]
+	}),
+	expected: "DateTime.Utc",
+	toCodecArbitrary: ({ constraint }) => {
+		const [minimum, maximum] = dateTimeArbitraryBounds(constraint, arbitraryMinimumDateTimestamp, arbitraryMaximumDateTimestamp);
+		return linkDecoding()(dateTimeArbitraryInteger(minimum, maximum), transform$1(makeUnsafe));
+	},
+	toCodecJson: () => link$1()(String$2, dateTimeUtcFromString),
+	toFormatter: () => (utc) => utc.toString()
+});
+/**
+* Schema that decodes a date-time string into a `DateTime.Utc`.
+*
+* **Details**
+*
+* Decoding:
+*
+* - A string accepted by `DateTime.make` is parsed and normalized to UTC. Strings
+*   without an explicit zone are interpreted as UTC.
+*
+* Encoding:
+*
+* - A `DateTime.Utc` is encoded as a UTC ISO 8601 string.
+*
+* @see {@link DateTimeUtcFromDate} for decoding JavaScript Date values into UTC values
+* @see {@link DateTimeUtcFromMillis} for decoding epoch milliseconds into UTC values
+* @see {@link DateFromString} for decoding strings into JavaScript Date instances
+*
+* @stability stable
+* @category schemas
+* @since 4.0.0
+*/
+const DateTimeUtcFromString = /*#__PURE__*/ String$2.annotate({ expected: "a string that will be decoded as a DateTime.Utc" }).pipe(/*#__PURE__*/ decodeTo(DateTimeUtc, dateTimeUtcFromString));
+/**
+* Schema for `Duration` values.
+*
+* **Details**
+*
+* The default JSON serializer encodes `Duration` as a tagged object with the
+* duration type and value.
+*
+* **Example** (Defining a Duration schema)
+*
+* ```ts import.meta.vitest
+* import { Duration, Schema } from "effect"
+*
+* Schema.decodeUnknownSync(Schema.Duration)(Duration.seconds(5)) // => Duration.seconds(5)
+* ```
+*
+* @stability stable
+* @category schemas
+*
+* @since 3.10.0
+*/
+const Duration = /*#__PURE__*/ declare(isDuration, {
+	representation: {
+		id: "effect/schema/Duration",
+		payload: null
+	},
+	toCode: () => ({
+		runtime: `Schema.Duration`,
+		Type: `Duration.Duration`,
+		importDeclarations: [`import * as Duration from "effect/Duration"`]
+	}),
+	expected: "Duration",
+	toCodecJson: () => link$1()(Union([
+		Struct({ _tag: Literal("Infinity") }),
+		Struct({ _tag: Literal("NegativeInfinity") }),
+		Struct({
+			_tag: Literal("Nanos"),
+			value: BigInt$1
+		}),
+		Struct({
+			_tag: Literal("Millis"),
+			value: Int
+		})
+	]), transform({
+		decode: (e) => {
+			switch (e._tag) {
+				case "Infinity": return infinity;
+				case "NegativeInfinity": return negativeInfinity;
+				case "Nanos": return nanos(e.value);
+				case "Millis": return millis(e.value);
+			}
+		},
+		encode: (duration) => {
+			switch (duration.value._tag) {
+				case "Infinity": return { _tag: "Infinity" };
+				case "NegativeInfinity": return { _tag: "NegativeInfinity" };
+				case "Nanos": return {
+					_tag: "Nanos",
+					value: duration.value.nanos
+				};
+				case "Millis": return {
+					_tag: "Millis",
+					value: duration.value.millis
+				};
+			}
+		}
+	}))
+});
 /**
 * Creates a schema for `Exit` values using schemas for the success value, typed
 * failure, and unexpected defect channels.
@@ -38045,7 +40073,7 @@ function Exit(value, error, defect) {
 					onFailure: (issue) => makeCompositeAtKey(ast, "value", issue, input, options)
 				});
 				case "Failure": return mapBothEager(decodeUnknownEffect$1(cause)(input.cause, options), {
-					onSuccess: failCause$3,
+					onSuccess: failCause$4,
 					onFailure: (issue) => makeCompositeAtKey(ast, "cause", issue, input, options)
 				});
 			}
@@ -38068,7 +40096,7 @@ function Exit(value, error, defect) {
 			_tag: Literal("Failure"),
 			cause: Cause(error, defect)
 		})]), transform({
-			decode: (e) => e._tag === "Success" ? succeed$6(e.value) : failCause$3(e.cause),
+			decode: (e) => e._tag === "Success" ? succeed$6(e.value) : failCause$4(e.cause),
 			encode: (exit) => isSuccess(exit) ? {
 				_tag: "Success",
 				value: exit.value
@@ -38576,6 +40604,18 @@ const Json = /*#__PURE__*/ make$11(/*#__PURE__*/ annotate(Json$1, { toCode: () =
 	runtime: "Schema.Json",
 	Type: "Schema.Json"
 }) }));
+/**
+* Schema that accepts any mutable JSON-compatible value. See {@link Json} for
+* the immutable variant.
+*
+* @stability stable
+* @category schemas
+* @since 4.0.0
+*/
+const MutableJson = /*#__PURE__*/ make$11(/*#__PURE__*/ annotate(MutableJson$1, { toCode: () => ({
+	runtime: "Schema.MutableJson",
+	Type: "Schema.MutableJson"
+}) }));
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/http/HttpClientError.js
 /**
@@ -40569,7 +42609,7 @@ var Writer = class {
 	}
 };
 function matchesEveryKey(parameter) {
-	const ast = toEncoded(parameter);
+	const ast = toEncoded$1(parameter);
 	return ast._tag === "String" && ast.checks === void 0;
 }
 function matchIndexSignature(layout, key, options) {
@@ -40974,7 +43014,7 @@ function toBinaryASTStep(ast) {
 			const getJson = ast.annotations?.toCodecJson;
 			const getCodec = ast.annotations?.toCodec;
 			if (!isFunction(getJson) && !isFunction(getCodec)) return ast;
-			const typeParameters = ast.typeParameters.map((tp) => make$11(toEncoded(tp)));
+			const typeParameters = ast.typeParameters.map((tp) => make$11(toEncoded$1(tp)));
 			const link = (isFunction(getJson) ? getJson(typeParameters) : void 0) ?? (isFunction(getCodec) ? getCodec(typeParameters) : void 0);
 			return link === void 0 ? ast : replaceEncoding(ast, [mapLink(link, toBinaryAST)]);
 		}
@@ -41125,7 +43165,7 @@ function computeRequired(layout) {
 function compileLayout(root) {
 	const exact = isExact(root);
 	const exitSuccess = !exact && isExitWithExactSuccess(root);
-	root = toEncoded(root);
+	root = toEncoded$1(root);
 	const memo = /* @__PURE__ */ new Map();
 	let recursive = false;
 	let stringSlots = 0;
@@ -43373,7 +45413,7 @@ function decodeValueUnchecked(layout, r) {
 			if (tag === 0) return succeed$6(requirePresent(decodeChecked(layout.value, r)));
 			if (tag !== 1) invalid("bool", void 0, r.options);
 			const cause = decodeValue(layout.cause, r);
-			return failCause$3(cause);
+			return failCause$4(cause);
 		}
 		case "cause": {
 			const count = r.uvarint();
@@ -43441,14 +45481,14 @@ function makeTransformation(layout, mode, trusted, successOnly = false) {
 				if (trusted !== void 0 && isObjectOrArray(value) && (!successOnly || isSuccessExit(value))) trusted.value = value;
 				return succeed$4(value);
 			} catch (e) {
-				return e instanceof IssueError ? fail$3(e.issue) : die$1(e);
+				return e instanceof IssueError ? fail$3(e.issue) : die$2(e);
 			}
 		},
 		encode: (value, options) => {
 			try {
 				return succeed$4(encodeFrame(layout, value, options, mode));
 			} catch (e) {
-				return e instanceof IssueError ? fail$3(e.issue) : die$1(e);
+				return e instanceof IssueError ? fail$3(e.issue) : die$2(e);
 			}
 		}
 	});
@@ -43477,7 +45517,7 @@ function takeTrusted(trusted, input) {
 	return true;
 }
 function bypassPass(target, decodeAccept, encodeAccept) {
-	const type = make$11(toType(target.ast));
+	const type = make$11(toType$1(target.ast));
 	const parse = decodeUnknownEffect$1(type);
 	const run = (accept) => () => (input, _ast, options) => accept(input, options) ? sameExit : parse(input, options);
 	return make$11(new Declaration([type.ast], run(decodeAccept), { identifier: "binary value" }, void 0, void 0, void 0, void 0, run(encodeAccept)));
@@ -43501,7 +45541,7 @@ function passThrough(target) {
 	return bypassPass(target, reportsExcess, reportsExcess);
 }
 function withCycleGuard(target) {
-	const type = make$11(toType(target.ast));
+	const type = make$11(toType$1(target.ast));
 	const decoded = /* @__PURE__ */ new WeakSet();
 	return decodeTo(declareConstructor()([type], ([type]) => (input, ast, options) => {
 		if (isObjectOrArray(input) && decoded.delete(input)) return succeed$4(input);
@@ -44541,7 +46581,7 @@ const unwrap = (wrapped) => {
 };
 const isSourceError = (u) => isTagged(u, "SourceError");
 const cursorToString = () => "<configuration>";
-const mapReasons = (f) => (self) => catchCause$1(self, (cause) => failCause$2(fromReasons(cause.reasons.map(f))));
+const mapReasons = (f) => (self) => catchCause$1(self, (cause) => failCause$3(fromReasons(cause.reasons.map(f))));
 const loadCursor = (provider, path) => provider.load(path).pipe(mapReasons((reason) => isFailReason(reason) ? makeDieReason(reason.error).annotate(reasonAnnotations(reason)) : reason), mapEager((node) => ({
 	provider,
 	path,
@@ -44701,7 +46741,7 @@ const toConfigCursorAST = /*#__PURE__*/ memoize((root) => {
 */
 function schema(codec, path) {
 	const codecStringTree = toCodecStringTree(codec);
-	const encodedAst = toEncoded(codecStringTree.ast);
+	const encodedAst = toEncoded$1(codecStringTree.ast);
 	const decodeCursor = decodeUnknownEffect$1(make$11(toConfigCursorAST(codecStringTree.ast)));
 	const localPath = typeof path === "string" ? [path] : path ?? [];
 	return make$5((provider, pathPrefix) => {
@@ -45858,7 +47898,7 @@ function defaultShouldQuit(input) {
 * @category layers
 * @since 4.0.0
 */
-const layer$1 = /*#__PURE__*/ provideMerge(layer$12, /*#__PURE__*/ mergeAll$1(layer$8, layer$10, layer$6, layer$4, layer$3));
+const layer$1 = /*#__PURE__*/ provideMerge(layer$12, /*#__PURE__*/ mergeAll$2(layer$8, layer$10, layer$6, layer$4, layer$3));
 //#endregion
 //#region ../../node_modules/.pnpm/effect@4.0.2/node_modules/effect/dist/Runtime.js
 /**
@@ -46439,4 +48479,4 @@ var RpcContracts = class extends make$7(make$9("notes.watch", {
 	payload: Struct({ id: NoteId })
 })) {};
 //#endregion
-export { Socket as $, isNonEmpty as $a, match$5 as $c, onExitPrimitive as $i, isNotUndefined as $l, mkUint8Array as $n, make$33 as $o, cached as $r, contains as $s, fromInput as $t, withDefault as A, tryPromise as Aa, some as Ac, gen as Ai, contA as Al, toEpochMillis as An, map$4 as Ao, take$1 as Ar, Tracer as As, TaggedError as At, constPing as B, withLogSpan as Ba, toEntries as Bc, logInfo as Bi, toStringUnknown as Bl, flatMap as Bn, merge$3 as Bo, badArgument as Br, Reference as Bs, encodeUnknownEffect as Bt, Redacted as C, sync as Ca, last as Cc, forEach$1 as Ci, toArray as Cl, toArrayBuffer as Cn, fromReasons as Co, failCause$1 as Cr, forkUnsafe$1 as Cs, Literal as Ct, option as D, timeoutOption as Da, prepend$1 as Dc, forkScoped as Di, flip$1 as Dl, ChildProcessSpawner as Dn, interruptors as Do, offerUnsafe as Dr, sync$2 as Ds, Record as Dt, map as E, timeout as Ea, match$4 as Ec, forkIn as Ei, combine$1 as El, make$18 as En, hasInterruptsOnly as Eo, offerAll as Er, reportCauseUnsafe as Es, NullOr as Et, layerJson as F, useSpan as Fa, filter$3 as Fc, isEffect as Fi, setStackTraceLimit as Fl, decodeText$1 as Fn, effect as Fo, getCurrent as Fr, TaggedError$1 as Fs, decodeEffect as Ft, ClientAbort as G, min as Ga, flatMap$6 as Gc, mapError$2 as Gi, array as Gl, fromQueue as Gn, succeedContext as Go, zero$1 as Gr, getOrUndefined as Gs, tag as Gt, ServerClient as H, withSpan as Ha, make$37 as Hc, makeSpanScoped as Hi, redact$1 as Hl, fromChannel as Hn, provide$2 as Ho, fromInputUnsafe as Hr, add as Hs, is as Ht, layerSchemaBinary as I, void_$1 as Ia, get$6 as Ic, log as Ii, BaseProto as Il, empty$4 as In, effectContext as Io, interrupt as Ir, taggedEnum as Is, decodeSync as It, spanAttributes as J, isDoneCause as Ja, getOrThrow as Jc, matchCauseEffectEager as Ji, number$1 as Jl, limitBytes as Jn, addFinalizer$1 as Jo, andThen as Jr, make$36 as Js, toJsonSchemaDocument as Jt, getStreamSchemas as K, spaced as Ka, fromOption$2 as Kc, match as Ki, combine$2 as Kl, fromReadableStream as Kn, unwrap$4 as Ko, acquireRelease as Kr, getOrUndefinedUnsafe as Ks, toCodecJson as Kt, RequestId as L, whileLoop as La, has$3 as Lc, logDebug as Li, Class$2 as Ll, ensuring as Ln, effectDiscard as Lo, interruptAll as Lr, parts as Ls, decodeUnknownEffect as Lt, withRun as M, uninterruptible as Ma, take$3 as Mc, ignoreCause as Mi, withFiber$1 as Ml, Path$1 as Mn, squash as Mo, publishUnsafe as Mr, make$34 as Ms, Tuple as Mt, withRunClient as N, uninterruptibleMask as Na, takeRight as Nc, interrupt$1 as Ni, assignProperty$1 as Nl, FileSystem as Nn, CurrentMemoMap as No, unbounded as Nr, nativeTracer as Ns, Union as Nt, succeed as O, timeoutOrElse as Oa, reduce as Oc, fromOption as Oi, mapInput as Ol, encode as On, isNoSuchElementError as Oo, shutdown as Or, DisablePropagation as Os, String$2 as Ot, RpcSerialization as P, updateContext as Pa, assignProperty as Pc, interruptible as Pi, getStackTraceLimit as Pl, concat as Pn, buildWithMemoMap as Po, makeUnsafe$2 as Pr, Error$2 as Ps, Unknown as Pt, CloseEvent as Q, isEmpty$1 as Qa, map$8 as Qc, onExit$1 as Qi, hasProperty as Ql, mkString as Qn, forkUnsafe as Qo, asVoid as Qr, allocate as Qs, empty as Qt, ResponseDefectEncoded as R, withFiber as Ra, keys$1 as Rc, logError as Ri, NodeInspectSymbol as Rl, fail$1 as Rn, empty$7 as Ro, interruptAs as Rr, seconds as Rs, encodeEffect as Rt, Port as S, suspend$2 as Sa, join$1 as Sc, fnUntraced as Si, some$1 as Sl, pipeThroughDuplex as Sn, findError as So, end as Sr, fiberEnterUninterruptibleUnsafe as Ss, Finite as St, URL$1 as T, tapError as Ta, map$6 as Tc, forkChild as Ti, String$6 as Tl, fromWritable as Tn, hasInterrupts as To, offer as Tr, onExitUnsafe as Ts, NonEmptyArray as Tt, exitSchema as U, zipWith as Ua, fail$7 as Uc, map$3 as Ui, equals$1 as Ul, fromIterable$5 as Un, provideMerge as Uo, gibibytes as Ur, empty$8 as Us, optional as Ut, constPong as V, withParentSpan as Va, empty$11 as Vc, logWarning as Vi, format$2 as Vl, fromArray as Vn, mergeAll$1 as Vo, fromInput$2 as Vr, Service as Vs, fromJsonString as Vt, isWrapper as W, exponential as Wa, failVoid as Wc, mapEager as Wi, symbol$1 as Wl, fromPubSub as Wn, succeed$5 as Wo, mebibytes as Wr, get$4 as Ws, optionalKey as Wt, Collector as X, endsWith as Xa, isResult as Xc, never$1 as Xi, string$1 as Xl, mapAccum as Xn, close as Xo, as as Xr, merge$4 as Xs, omit as Xt, spanName as Y, Random as Ya, isFailure$1 as Yc, matchEffect as Yi, optimize as Yl, map$1 as Yn, addFinalizerExit as Yo, annotateLogs as Yr, makeUnsafe$6 as Ys, isSchemaError$1 as Yt, makeCollectorUnsafe as Z, includes as Za, isSuccess$1 as Zc, onError as Zi, symbol$2 as Zl, mapError as Zn, closeUnsafe as Zo, asSome as Zr, Prototype as Zs, encodeUnknownEffect$1 as Zt, QuitError as _, scoped as _a, head as _c, failCause$2 as _i, liftThrowable as _l, fromSetCookie as _n, StackTrace as _o, mkUint8Array$1 as _r, isDeferred as _s, BooleanLiterals as _t, ImageType as a, provide as aa, every$1 as ac, catchIf as ai, filter$4 as al, CurrentRedactedNames as an, replaceAll as ao, runHead as ar, TracerTimingEnabled as as, layerWebSocket as at, constTrue as au, layer$8 as b, succeed$4 as ba, isReadonlyArrayEmpty as bc, flatMapEager as bi, none as bl, toSetCookieHeaders as bn, done as bo, bounded as br, effectIsExit as bs, Exit as bt, NotesError as c, raceFirst as ca, findFirst as cc, catchTags as ci, flatten$2 as cl, fromRecordUnsafe as cn, startsWith as co, succeed$2 as cr, failCause$3 as cs, EmptyBodyError as ct, constant as cu, layer as d, retry as da, flatMap$5 as dc, contextWith as di, getOrElse$1 as dl, remove$1 as dn, trimEnd as do, toReadableStreamEffect as dr, isFailure as ds, HttpClientErrorSchema as dt, identity as du, onInterrupt as ea, dedupe as ec, callback$1 as ei, succeed$8 as el, setAll as en, length as eo, orDie as er, makeUnsafe$4 as es, SocketError as et, isObject as eu, make as f, retryOrElse as fa, fromIterable$6 as fc, delay as fi, getOrNull as fl, set$1 as fn, max as fo, toReadableStreamWith as fr, isSuccess as fs, InvalidUrlError as ft, pipe as fu, layer$1 as g, scope as ga, groupBy as gc, fail$3 as gi, liftPredicate as gl, empty$3 as gn, Done as go, mapError$1 as gr, into as gs, ArraySchema as gt, errorReported as h, runSync$1 as ha, getUnsafe$1 as hc, exit as hi, isSome as hl, value as hn, Clock as ho, fromTransform$1 as hr, doneUnsafe as hs, Any as ht, FileType as i, promise as ia, ensure as ic, catchFilter as ii, exists as il, get as in, replace as io, runForEachArray as ir, MinimumLogLevel as is, fromWebSocket as it, constFalse$1 as iu, Stdio as j, try_ as ja, sort as jc, ignore as ji, contE as jl, defaultFormatter as jn, prettyErrors as jo, takeAll as jr, externalSpan as js, TrueLiterals as jt, unwrap as k, transposeOption as ka, reverse as kc, fromResult as ki, PipeInspectableProto as kl, now as kn, makeDieReason as ko, shutdownUnsafe as kr, ParentSpan as ks, Struct as kt, Organization as l, repeat as la, findFirstIndex as lc, catch_$1 as li, fromNullishOr as ll, isRedactedName as ln, toLowerCase as lo, suspend as lr, interrupt$2 as ls, EncodeError as lt, dual as lu, errorExitCode as m, runForkWith as ma, getSomes as mc, ensuring$2 as mi, isNone as ml, make$16 as mn, round as mo, fromPull$1 as mr, _await as ms, TransportError as mt, Capture as n, orDie$2 as na, drop as nc, catchCauseIf as ni, all$4 as nl, has as nn, padStart as no, run$1 as nr, CurrentLogAnnotations as ns, SocketOpenError as nt, isUndefined as nu, Note as o, provideContext$2 as oa, filter$2 as oc, catchReason as oi, flatMap$7 as ol, empty$2 as on, slice as oo, runLast as or, die$3 as os, layerWebSocketConstructorGlobal as ot, constUndefined as ou, runMain as p, runFork as pa, get$5 as pc, die$1 as pi, getOrUndefined$1 as pl, setAll$1 as pn, parse as po, unwrap$1 as pr, succeed$6 as ps, StatusCodeError as pt, pipeArguments as pu, isStreamSchema as q, catchDone as qa, getOrElse as qc, matchCauseEffect as qi, hash as ql, groupedWithin as qn, Scope as qo, all$1 as qr, getUnsafe as qs, toCodecStringTree as qt, Extraction as r, orElseSucceed as ra, empty$9 as rc, catchDefect as ri, contains$1 as rl, fromIterable$2 as rn, repeat$2 as ro, runForEach as rr, CurrentLogSpans as rs, SocketReadError as rt, compose as ru, NoteId as s, provideService as sa, filterMap as sc, catchTag as si, flatMapNullishOr as sl, fromInput$1 as sn, split as so, scan as sr, fail$5 as ss, DecodeError as st, constVoid as su, RpcContracts as t, option$1 as ta, dedupeAdjacentWith as tc, catchCause$1 as ti, try_$2 as tl, fromIterable as tn, match$1 as to, pipeThroughChannel as tr, provide$3 as ts, SocketErrorReason as tt, isTagged as tu, LogToStderr as u, result as ua, findLast as uc, context as ui, fromUndefinedOr as ul, merge as un, trim as uo, takeUntil as ur, isExit as us, HttpClientError as ut, flow as uu, Terminal as v, service as va, headNonEmpty as vc, filterOrFail as vi, map$9 as vl, isEmpty as vn, combine as vo, make$25 as vr, makeUnsafe$5 as vs, Defect as vt, String$1 as w, tapCause as wa, lastNonEmpty as wc, forever as wi, Number$5 as wl, toUint8Array as wn, hasDies as wo, make$26 as wr, makeSpanUnsafe as ws, Never as wt, Crypto as x, succeedNone as xa, isReadonlyArrayNonEmpty as xc, fn as xi, orElse as xl, fromReadable as xn, filterInterruptors as xo, collect as xr, fiberEnterInterruptibleUnsafe as xs, FalseLiterals as xt, isQuitError as y, serviceOption as ya, isArray as yc, flatMap$2 as yi, match$6 as yl, parseHeader as yn, die$2 as yo, makeUnsafe$1 as yr, ConsoleRef as ys, Error$1 as yt, constEof as z, withFiberSucceed as za, map$7 as zc, logFatal as zi, toJson as zl, filter as zn, launch as zo, runIn as zr, toMillis as zs, encodeSync as zt };
+export { Socket as $, forkIn as $a, effectIsExit as $c, identity as $d, shutdownUnsafe as $i, groupBy as $l, empty$3 as $n, tapCause as $o, fromArray as $r, fail$4 as $s, decodeSync as $t, isSome as $u, withDefault as A, catchDefect as Aa, closeUnsafe as Ac, array as Ad, takeUntil as Ai, make$36 as Al, isSchemaError$1 as An, orElseSucceed as Ao, passthrough as Ar, isNonEmpty as As, Literal as At, fromOption$2 as Au, constPing as B, die$2 as Ba, fail$5 as Bc, isNotNullish as Bd, mkUint8Array$1 as Bi, empty$9 as Bl, get as Bn, retryOrElse as Bo, catchReason as Br, toLowerCase as Bs, String$2 as Bt, all$4 as Bu, Redacted as C, as as Ca, succeed$5 as Cc, NodeInspectSymbol as Cd, runForEach as Ci, Service as Cl, toCodecStringTree as Cn, never$1 as Co, null_ as Cr, catchDone as Cs, Duration as Ct, toEntries as Cu, option as D, callback$1 as Da, addFinalizer$1 as Dc, redact$1 as Dd, scan as Di, getOrUndefined as Dl, withConstructorDefault as Dn, onInterrupt as Do, resolveIdentifier as Dr, endsWith as Ds, Finite as Dt, fail$7 as Du, map as E, cached as Ea, Scope as Ec, format$2 as Ed, runLast as Ei, get$4 as El, toType as En, onExitPrimitive as Eo, resolveDescription as Er, camelToSnake as Es, FalseLiterals as Et, make$37 as Eu, layerJson as F, catchTags$1 as Fa, CurrentLogAnnotations as Fc, string$1 as Fd, last as Fi, appendAll$1 as Fl, fromInput as Fn, provideServiceEffect as Fo, now as Fr, replace as Fs, Null as Ft, isSuccess$1 as Fu, ClientAbort as G, filterOrFail as Ga, isSuccess as Gc, compose as Gd, collect as Gi, findFirst as Gl, isRedactedName as Gn, scoped as Go, die as Gr, round as Gs, URL$2 as Gt, flatMapNullishOr as Gu, ServerClient as H, exit as Ha, interrupt$2 as Hc, isObject as Hd, make$25 as Hi, every$1 as Hl, empty$2 as Hn, runForkWith as Ho, catch_ as Hr, trimEnd as Hs, TaggedError as Ht, exists as Hu, layerSchemaBinary as I, catch_$2 as Ia, CurrentLogSpans as Ic, symbol$2 as Id, fromPull$1 as Ii, contains as Il, setAll as In, raceFirst as Io, toEpochMillis as Ir, replaceAll as Is, NullOr as It, map$8 as Iu, spanAttributes as J, fn as Ja, doneUnsafe as Jc, constUndefined as Jd, make$26 as Ji, flatMap$5 as Jl, set$1 as Jn, succeed$4 as Jo, fail$1 as Jr, StackTrace as Js, Uint8ArrayFromBase64 as Jt, fromUndefinedOr as Ju, getStreamSchemas as K, flatMap$2 as Ka, succeed$6 as Kc, constFalse$1 as Kd, end as Ki, findFirstIndex as Kl, merge as Kn, service as Ko, empty$4 as Kr, Clock as Ks, URLFromString as Kt, flatten$5 as Ku, RequestId as L, context as La, MinimumLogLevel as Lc, hasProperty as Ld, fromTransform$1 as Li, dedupe as Ll, fromIterable as Ln, repeat as Lo, defaultFormatter as Lr, slice as Ls, Number$1 as Lt, match$5 as Lu, withRun as M, catchIf as Ma, make$33 as Mc, hash as Md, toReadableStreamEffect as Mi, merge$4 as Ml, getReferenceKey as Mn, provide as Mo, transformOptional as Mr, match$1 as Ms, MutableJson as Mt, getOrThrow as Mu, withRunClient as N, catchReason$2 as Na, makeUnsafe$4 as Nc, number$1 as Nd, toReadableStreamWith as Ni, Prototype as Nl, encodeUnknownEffect$1 as Nn, provideContext$2 as No, encode as Nr, padStart as Ns, Never as Nt, isFailure$1 as Nu, succeed as O, catchCause$1 as Oa, addFinalizerExit as Oc, equals$1 as Od, succeed$2 as Oi, getOrUndefinedUnsafe as Ol, withDecodingDefault as On, option$1 as Oo, string as Or, includes as Os, Int as Ot, failVoid as Ou, RpcSerialization as P, catchTag as Pa, provide$3 as Pc, optimize as Pd, unwrap$1 as Pi, allocate as Pl, empty as Pn, provideService$2 as Po, formatIso as Pr, repeat$2 as Ps, NonEmptyArray as Pt, isResult as Pu, CloseEvent as Q, forkChild as Qa, ConsoleRef as Qc, flow as Qd, shutdown as Qi, getUnsafe$1 as Ql, value as Qn, tap$1 as Qo, flattenIterable as Qr, done as Qs, decodeEffect as Qt, isNone as Qu, ResponseDefectEncoded as R, contextWith as Ra, TracerTimingEnabled as Rc, isIterable as Rd, map$2 as Ri, dedupeAdjacentWith as Rl, has as Rn, result as Ro, Path$1 as Rr, split as Rs, Record as Rt, succeed$8 as Ru, Port as S, annotateLogs as Sa, provideMerge as Sc, Class$2 as Sd, runCollect as Si, Reference as Sl, toCodecJson as Sn, matchEffect as So, mapOrSame as Sr, spaced as Ss, Defect as St, map$7 as Su, URL$1 as T, asVoid as Ta, unwrap$4 as Tc, toStringUnknown as Td, runHead as Ti, empty$8 as Tl, toJsonSchemaDocument as Tn, onExit$1 as To, replaceChecks as Tr, Random as Ts, Exit as Tt, headUnsafe as Tu, exitSchema as U, fail$3 as Ua, isExit as Uc, isTagged as Ud, makeUnsafe$1 as Ui, filter$2 as Ul, fromInput$1 as Un, runSync$1 as Uo, concat as Ur, max as Us, TrueLiterals as Ut, filter$3 as Uu, constPong as V, ensuring$2 as Va, failCause$4 as Vc, isNotUndefined as Vd, pipeTo as Vi, ensure as Vl, CurrentRedactedNames as Vn, runFork as Vo, catchTags as Vr, trim as Vs, Struct as Vt, contains$1 as Vu, isWrapper as W, failCause$3 as Wa, isFailure as Wc, isUndefined as Wd, bounded as Wi, filterMap as Wl, fromRecordUnsafe as Wn, scope as Wo, decodeText$1 as Wr, parse as Ws, Tuple as Wt, flatMap$7 as Wu, Collector as X, forEach$1 as Xa, isDeferred as Xc, constant as Xd, offerAll as Xi, get$5 as Xl, isRedacted as Xn, suspend$2 as Xo, filter as Xr, combine as Xs, Union as Xt, getOrNull as Xu, spanName as Y, fnUntraced as Ya, into as Yc, constVoid as Yd, offer as Yi, fromIterable$6 as Yl, setAll$1 as Yn, succeedNone as Yo, failCause as Yr, annotate$1 as Ys, UndefinedOr as Yt, getOrElse$1 as Yu, makeCollectorUnsafe as Z, forever as Za, makeUnsafe$5 as Zc, dual as Zd, offerUnsafe as Zi, getSomes as Zl, make$16 as Zn, sync as Zo, flatMap as Zr, die$3 as Zs, Unknown as Zt, getOrUndefined$1 as Zu, QuitError as _, zero$1 as _a, empty$7 as _c, withFiber$1 as _d, onEnd as _i, format$1 as _l, makeFilter as _n, mapEager as _o, Suspend as _r, withParentSpan as _s, Boolean$1 as _t, takeRight as _u, ImageType as a, await_ as aa, hasInterruptsOnly as ac, orElse as ad, fromReadableStream as ai, reportCauseUnsafe as al, encodeTo as an, ignoreCause as ao, pipeThroughDuplex as ar, tryPromise as as, layerWebSocket as at, join$1 as au, layer$8 as b, andThen as ba, mergeAll$2 as bc, setStackTraceLimit as bd, provideService as bi, seconds as bl, optionalKey as bn, matchCauseEffect as bo, isNever as br, exponential as bs, DateTimeUtc as bt, has$3 as bu, NotesError as c, interruptAll as ca, makeDieReason as cc, toArray as cd, map$1 as ci, ParentSpan as cl, is as cn, isEffect as co, fromWritable as cr, uninterruptibleMask as cs, EmptyBodyError as ct, map$6 as cu, layer as d, runIn as da, squash as dc, combine$1 as dd, mapArrayEffect as di, make$34 as dl, isMaxLength as dn, logError as do, Arrays as dr, useSpan as ds, HttpClientErrorSchema as dt, prepend$1 as du, take$1 as ea, filterInterruptors as ec, liftPredicate as ed, pipe as ef, fromChannel as ei, fiberEnterInterruptibleUnsafe as el, decodeTo as en, forkScoped as eo, fromSetCookie as er, tapError as es, SocketError as et, head as eu, make as f, badArgument as fa, CurrentMemoMap as fc, flip$1 as fd, mapEffect as fi, nativeTracer as fl, isMinLength as fn, logFatal as fo, Filter as fr, void_$1 as fs, InvalidUrlError as ft, reduce as fu, layer$1 as g, mebibytes as ga, effectDiscard as gc, contE as gd, mkUint8Array as gi, taggedEnum as gl, make$11 as gn, map$3 as go, PropertySignature as gr, withLogSpan as gs, ArraySchema as gt, take$3 as gu, errorReported as h, gibibytes as ha, effectContext as hc, contA as hd, mkString as hi, TaggedError$1 as hl, isSchemaError as hn, makeSpanScoped as ho, Objects as hr, withFiberSucceed as hs, Any as ht, sort as hu, FileType as i, makeUnsafe$2 as ia, hasInterrupts as ic, none as id, fromQueue as ii, onExitUnsafe as il, encodeSync as in, ignore as io, fromReadable as ir, transposeOption as is, fromWebSocket as it, isReadonlyArrayNonEmpty as iu, Stdio as j, catchFilter$2 as ja, forkUnsafe as jc, combine$2 as jd, tap as ji, makeUnsafe$6 as jl, omit as jn, promise as jo, transform as jr, length as js, Literals as jt, getOrElse as ju, unwrap as k, catchCauseIf as ka, close as kc, symbol$1 as kd, suspend as ki, getUnsafe as kl, withDecodingDefaultKey as kn, orDie$2 as ko, toEncoded$1 as kr, isEmpty$1 as ks, Json as kt, flatMap$6 as ku, Organization as l, interruptAllAs as la, map$4 as lc, Number$5 as ld, mapAccum as li, Tracer as ll, isGreaterThanOrEqualTo as ln, log as lo, make$18 as lr, updateContext as ls, EncodeError as lt, match$4 as lu, errorExitCode as m, fromInputUnsafe as ma, effect as mc, PipeInspectableProto as md, mergeAll as mi, TaggedClass as ml, isSchema as mn, logWarning as mo, Literal$1 as mr, withFiber as ms, TransportError as mt, some as mu, Capture as n, publishUnsafe as na, fromReasons as nc, map$9 as nd, fromIterable$5 as ni, forkUnsafe$1 as nl, decodeUnknownOption as nn, fromResult as no, parseHeader as nr, timeoutOption as ns, SocketOpenError as nt, isArrayNonEmpty as nu, Note as o, getCurrent as oa, interruptors as oc, orElseSome as od, groupedWithin as oi, sync$2 as ol, encodeUnknownEffect as on, interrupt$1 as oo, toArrayBuffer as or, try_ as os, layerWebSocketConstructorGlobal as ot, last$1 as ou, runMain as p, fromInput$2 as pa, buildWithMemoMap as pc, mapInput as pd, mapError as pi, Error$2 as pl, isPattern as pn, logInfo as po, FilterGroup as pr, whileLoop as ps, StatusCodeError as pt, reverse as pu, isStreamSchema as q, flatMapEager as qa, _await as qc, constTrue as qd, failCause$2 as qi, findLast as ql, remove$1 as qn, serviceOption as qo, ensuring as qr, Done as qs, Uint8Array$1 as qt, fromNullishOr as qu, Extraction as r, unbounded as ra, hasDies as rc, match$6 as rd, fromPubSub as ri, makeSpanUnsafe as rl, encodeEffect as rn, gen as ro, toSetCookieHeaders as rr, timeoutOrElse as rs, SocketReadError as rt, isReadonlyArrayEmpty as ru, NoteId as s, interrupt as sa, isNoSuchElementError as sc, some$1 as sd, limitBytes as si, DisablePropagation as sl, fromJsonString as sn, interruptible as so, toUint8Array as sr, uninterruptible as ss, DecodeError as st, lastNonEmpty as su, RpcContracts as t, takeAll as ta, findError as tc, liftThrowable as td, pipeArguments as tf, fromEffect as ti, fiberEnterUninterruptibleUnsafe as tl, decodeUnknownEffect as tn, fromOption as to, isEmpty as tr, timeout as ts, SocketErrorReason as tt, headNonEmpty as tu, LogToStderr as u, interruptAs as ua, prettyErrors as uc, String$6 as ud, mapArray as ui, externalSpan as ul, isInt as un, logDebug as uo, ChildProcessSpawner as ur, updateService as us, HttpClientError as ut, of as uu, Terminal as v, acquireRelease as va, launch as vc, assignProperty$1 as vd, orDie as vi, millis as vl, mutable as vn, mapError$2 as vo, Union$1 as vr, withSpan as vs, BooleanLiterals as vt, assignProperty as vu, String$1 as w, asSome as wa, succeedContext as wc, toJson as wd, runForEachArray as wi, add as wl, toEncoded as wn, onError as wo, optionalKey$1 as wr, isDoneCause as ws, Error$1 as wt, empty$10 as wu, Crypto as x, annotateCurrentSpan as xa, provide$2 as xc, BaseProto as xd, run$1 as xi, toMillis as xl, tag as xn, matchCauseEffectEager as xo, isOptional as xr, min as xs, DateTimeUtcFromString as xt, keys$1 as xu, isQuitError as y, all$1 as ya, merge$3 as yc, getStackTraceLimit as yd, pipeThroughChannel as yi, parts as yl, optional as yn, match as yo, decodeTo$1 as yr, zipWith as ys, Class as yt, get$6 as yu, constEof as z, delay as za, die$4 as zc, isNotNull as zd, mapError$1 as zi, drop as zl, fromIterable$2 as zn, retry as zo, FileSystem as zr, startsWith as zs, Redacted$1 as zt, try_$2 as zu };