resultar 3.7.0 → 3.9.0

package/dist/index.js

@@ -918,129 +918,6 @@ var ServiceTagValue = class {
 };
 /** Creates a service tag that can be requested with `yield*` inside `ResultTask.gen`. */
 const serviceTag = (identifier) => new ServiceTagValue(identifier);
-const applySuccessContinuation = (continuation, exit) => {
-	switch (continuation._tag) {
-		case "Map": try {
-			return {
-				current: void 0,
-				currentExit: success(continuation.f(exit.value))
-			};
-		} catch (error) {
-			return {
-				current: void 0,
-				currentExit: died(error)
-			};
-		}
-		case "FlatMap": try {
-			return {
-				current: continuation.f(exit.value),
-				currentExit: void 0
-			};
-		} catch (error) {
-			return {
-				current: void 0,
-				currentExit: died(error)
-			};
-		}
-		case "Tap": try {
-			const res = continuation.f(exit.value);
-			return ResultTask.toTapContinuationStep(res, () => ResultTask.succeed(exit.value), exit);
-		} catch (error) {
-			return {
-				current: void 0,
-				currentExit: died(error)
-			};
-		}
-		case "MapError": return {
-			current: void 0,
-			currentExit: exit
-		};
-		case "TapError": return {
-			current: void 0,
-			currentExit: exit
-		};
-		case "CatchAll": return {
-			current: void 0,
-			currentExit: exit
-		};
-		default: return {
-			current: void 0,
-			currentExit: exit
-		};
-	}
-};
-const applyFailureContinuation = (continuation, exit) => {
-	switch (continuation._tag) {
-		case "MapError":
-			if (exit.cause._tag === "Fail") try {
-				return {
-					current: void 0,
-					currentExit: failed(continuation.f(exit.cause.error))
-				};
-			} catch (error) {
-				return {
-					current: void 0,
-					currentExit: died(error)
-				};
-			}
-			return {
-				current: void 0,
-				currentExit: exit
-			};
-		case "TapError":
-			if (exit.cause._tag === "Fail") try {
-				const failError = exit.cause.error;
-				const res = continuation.f(failError);
-				return ResultTask.toTapContinuationStep(res, () => ResultTask.fail(failError), exit);
-			} catch (error) {
-				return {
-					current: void 0,
-					currentExit: died(error)
-				};
-			}
-			return {
-				current: void 0,
-				currentExit: exit
-			};
-		case "CatchAll":
-			if (exit.cause._tag === "Sequential") return {
-				current: void 0,
-				currentExit: died(new ResultTaskCauseError(exit.cause))
-			};
-			if (exit.cause._tag === "Fail") try {
-				return {
-					current: continuation.f(exit.cause.error),
-					currentExit: void 0
-				};
-			} catch (error) {
-				return {
-					current: void 0,
-					currentExit: died(error)
-				};
-			}
-			return {
-				current: void 0,
-				currentExit: exit
-			};
-		case "Map": return {
-			current: void 0,
-			currentExit: exit
-		};
-		case "FlatMap": return {
-			current: void 0,
-			currentExit: exit
-		};
-		case "Tap": return {
-			current: void 0,
-			currentExit: exit
-		};
-		default: return {
-			current: void 0,
-			currentExit: exit
-		};
-	}
-};
-const applyContinuation = (continuation, exit) => exit._tag === "Success" ? applySuccessContinuation(continuation, exit) : applyFailureContinuation(continuation, exit);
 const executeInstruction = async (instruction, continuations, context) => {
 	switch (instruction._tag) {
 		case "FlatMap":
@@ -1101,8 +978,129 @@ var ResultTask = class ResultTask extends Pipeable {
 		} : instructionOrExecute;
 		this.execute = (context) => ResultTask.runTaskLoop(this, context);
 	}
-	/** @internal */
-	static toTapContinuationStep(res, onSuccess, passThroughExit) {
+	static #applySuccessContinuation(continuation, exit) {
+		switch (continuation._tag) {
+			case "Map": try {
+				return {
+					current: void 0,
+					currentExit: success(continuation.f(exit.value))
+				};
+			} catch (error) {
+				return {
+					current: void 0,
+					currentExit: died(error)
+				};
+			}
+			case "FlatMap": try {
+				return {
+					current: continuation.f(exit.value),
+					currentExit: void 0
+				};
+			} catch (error) {
+				return {
+					current: void 0,
+					currentExit: died(error)
+				};
+			}
+			case "Tap": try {
+				const res = continuation.f(exit.value);
+				return ResultTask.#toTapContinuationStep(res, () => ResultTask.succeed(exit.value), exit);
+			} catch (error) {
+				return {
+					current: void 0,
+					currentExit: died(error)
+				};
+			}
+			case "MapError": return {
+				current: void 0,
+				currentExit: exit
+			};
+			case "TapError": return {
+				current: void 0,
+				currentExit: exit
+			};
+			case "CatchAll": return {
+				current: void 0,
+				currentExit: exit
+			};
+			default: return {
+				current: void 0,
+				currentExit: exit
+			};
+		}
+	}
+	static #applyFailureContinuation(continuation, exit) {
+		switch (continuation._tag) {
+			case "MapError":
+				if (exit.cause._tag === "Fail") try {
+					return {
+						current: void 0,
+						currentExit: failed(continuation.f(exit.cause.error))
+					};
+				} catch (error) {
+					return {
+						current: void 0,
+						currentExit: died(error)
+					};
+				}
+				return {
+					current: void 0,
+					currentExit: exit
+				};
+			case "TapError":
+				if (exit.cause._tag === "Fail") try {
+					const failError = exit.cause.error;
+					const res = continuation.f(failError);
+					return ResultTask.#toTapContinuationStep(res, () => ResultTask.fail(failError), exit);
+				} catch (error) {
+					return {
+						current: void 0,
+						currentExit: died(error)
+					};
+				}
+				return {
+					current: void 0,
+					currentExit: exit
+				};
+			case "CatchAll":
+				if (exit.cause._tag === "Sequential") return {
+					current: void 0,
+					currentExit: died(new ResultTaskCauseError(exit.cause))
+				};
+				if (exit.cause._tag === "Fail") try {
+					return {
+						current: continuation.f(exit.cause.error),
+						currentExit: void 0
+					};
+				} catch (error) {
+					return {
+						current: void 0,
+						currentExit: died(error)
+					};
+				}
+				return {
+					current: void 0,
+					currentExit: exit
+				};
+			case "Map": return {
+				current: void 0,
+				currentExit: exit
+			};
+			case "FlatMap": return {
+				current: void 0,
+				currentExit: exit
+			};
+			case "Tap": return {
+				current: void 0,
+				currentExit: exit
+			};
+			default: return {
+				current: void 0,
+				currentExit: exit
+			};
+		}
+	}
+	static #toTapContinuationStep(res, onSuccess, passThroughExit) {
 		if (res instanceof ResultTask) return {
 			current: res.flatMap(onSuccess),
 			currentExit: void 0
@@ -1132,7 +1130,7 @@ var ResultTask = class ResultTask extends Pipeable {
 				const nextContinuation = continuations.pop();
 				if (nextContinuation === void 0) return currentExit;
 				const resolvedExit = context.signal.aborted && currentExit._tag === "Success" ? interrupted(context.signal) : currentExit;
-				const step = applyContinuation(nextContinuation, resolvedExit);
+				const step = resolvedExit._tag === "Success" ? ResultTask.#applySuccessContinuation(nextContinuation, resolvedExit) : ResultTask.#applyFailureContinuation(nextContinuation, resolvedExit);
 				current = step.current;
 				currentExit = step.currentExit;
 			}
@@ -1224,8 +1222,8 @@ var ResultTask = class ResultTask extends Pipeable {
 			return interruptSuccess(await scope.close(interruptSuccess(exit, context.signal)), context.signal);
 		});
 	}
-	/** Creates a service tag that can be requested with `yield*` inside `ResultTask.gen`. */
 	static service(identifier) {
+		if (identifier === void 0) return (name) => new ServiceTagValue(name);
 		return new ServiceTagValue(identifier);
 	}
 	/** Builds a task from a generator and short-circuits on the first failed task. */
@@ -1410,6 +1408,12 @@ var ResultTask = class ResultTask extends Pipeable {
 		const pending = /* @__PURE__ */ new Set();
 		let closing = void 0;
 		return {
+			addFinalizer: (release) => {
+				if (closing !== void 0) throw new Error("Cannot acquire into a closing ResultTask scope");
+				scope.add((exit) => ResultTask.runExit(ResultTask.gen(function* () {
+					yield* release(exit);
+				})));
+			},
 			use: (task) => new ResultTask(async (context) => {
 				if (closing !== void 0) return died(/* @__PURE__ */ new Error("Cannot execute in a closed ResultTask scope"));
 				const attempt = new TaskScope();

package/dist/llms.txt

@@ -0,0 +1,11 @@
+# Resultar 3.9.0
+
+Documentation bundled with this package version. Installed declarations remain authoritative.
+
+- [Agent guide](agent/SKILL.md)
+- [API semantics](agent/references/api.md)
+- [Services and HTTP scopes](agent/references/services.md)
+- [Compiled core example](agent/examples/workflow.mjs)
+- [Companion versions used to write this guide](agent/versions.json)
+
+Read companion packages' installed READMEs when their versions differ from versions.json.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resultar",
-  "version": "3.7.0",
+  "version": "3.9.0",
   "description": "Result pattern for TypeScript",
   "keywords": [
     "error-handling",
@@ -43,13 +43,13 @@
   "devDependencies": {
     "@stryker-mutator/core": "10.0.0",
     "@stryker-mutator/vitest-runner": "10.0.0",
-    "@types/node": "26.5.0",
+    "@types/node": "26.5.1",
     "@vitest/coverage-v8": "4.1.11",
     "@vitest/ui": "4.1.11",
-    "fallow": "3.23.0",
+    "fallow": "3.25.0",
     "tsx": "4.23.13",
     "typescript": "7.0.2",
-    "vite-plus": "0.3.0",
+    "vite-plus": "0.3.2",
     "vitest": "4.1.11"
   },
   "peerDependencies": {
@@ -71,7 +71,7 @@
   ],
   "scripts": {
     "analyze": "fallow",
-    "build": "vp pack",
+    "build": "vp pack && node ../../scripts/build-agent-guide.mjs",
     "check": "vp check",
     "check:full": "pnpm run build && pnpm run check && vp test run --coverage",
     "fmt": "vp fmt",