feat: add intake method to blockCodecov (#2078)

## PR Checklist

- [x] Addresses an existing open issue: fixes #2076
- [x] That issue was marked as [`status: accepting
prs`](https://github.com/JoshuaKGoldberg/create-typescript-app/issues?q=is%3Aopen+is%3Aissue+label%3A%22status%3A+accepting+prs%22)
- [x] Steps in
[CONTRIBUTING.md](https://github.com/JoshuaKGoldberg/create-typescript-app/blob/main/.github/CONTRIBUTING.md)
were taken

## Overview

Attempts to load an existing `ci.yml` as JSON and find the Codecov step.
If that step exists and has an `env`, hooray!

🎁

Author: JoshuaKGoldberg

package.json

@@ -37,9 +37,9 @@
 		"*": "prettier --ignore-unknown --write"
 	},
 	"dependencies": {
-		"bingo": "^0.5.11",
-		"bingo-fs": "^0.5.4",
-		"bingo-stratum": "^0.5.8",
+		"bingo": "^0.5.12",
+		"bingo-fs": "^0.5.5",
+		"bingo-stratum": "^0.5.9",
 		"cached-factory": "^0.1.0",
 		"cspell-populate-words": "^0.3.0",
 		"execa": "^9.5.2",
@@ -86,7 +86,7 @@
 		"@vitest/eslint-plugin": "1.1.38",
 		"all-contributors-cli": "6.26.1",
 		"bingo-requests": "0.5.5",
-		"bingo-stratum-testers": "0.5.7",
+		"bingo-stratum-testers": "0.5.8",
 		"bingo-testers": "0.5.7",
 		"console-fail-test": "0.5.0",
 		"cspell": "8.17.5",

pnpm-lock.yaml

@@ -1,5 +1,6 @@
-import { testBlock } from "bingo-stratum-testers";
-import { describe, expect, test } from "vitest";
+import { testBlock, testIntake } from "bingo-stratum-testers";
+import jsYaml from "js-yaml";
+import { describe, expect, it, test } from "vitest";
 
 import { blockCodecov } from "./blockCodecov.js";
 import { optionsBase } from "./options.fakes.js";
@@ -52,7 +53,7 @@ describe("blockCodecov", () => {
 		`);
 	});
 
-	test("transition mode", () => {
+	test("transition mode without files", () => {
 		const creation = testBlock(blockCodecov, {
 			mode: "transition",
 			options: optionsBase,
@@ -163,4 +164,140 @@ describe("blockCodecov", () => {
 			      	}
 			      `);
 	});
+
+	describe("intake", () => {
+		it("returns undefined when ci.yml does not exist", () => {
+			const actual = testIntake(blockCodecov, {
+				files: {
+					".github": {
+						workflows: {},
+					},
+				},
+			});
+
+			expect(actual).toBeUndefined();
+		});
+
+		it("returns undefined when ci.yml contains invalid yml", () => {
+			const actual = testIntake(blockCodecov, {
+				files: {
+					".github": {
+						workflows: {
+							"ci.yml": ["invalid yml!"],
+						},
+					},
+				},
+			});
+
+			expect(actual).toBeUndefined();
+		});
+
+		it("returns undefined when ci.yml does not contain a test job", () => {
+			const actual = testIntake(blockCodecov, {
+				files: {
+					".github": {
+						workflows: {
+							"ci.yml": [
+								jsYaml.dump({
+									jobs: {
+										other: {
+											name: "Other",
+											steps: [],
+										},
+									},
+								}),
+							],
+						},
+					},
+				},
+			});
+
+			expect(actual).toBeUndefined();
+		});
+
+		it("returns undefined when ci.yml contains a test job with only non-string uses", () => {
+			const actual = testIntake(blockCodecov, {
+				files: {
+					".github": {
+						workflows: {
+							"ci.yml": [
+								jsYaml.dump({
+									jobs: {
+										test: {
+											name: "Test",
+											steps: [
+												{
+													uses: { not: "a string" },
+												},
+											],
+										},
+									},
+								}),
+							],
+						},
+					},
+				},
+			});
+
+			expect(actual).toBeUndefined();
+		});
+
+		it("returns undefined env when ci.yml contains a test job with no env in its codecov step", () => {
+			const actual = testIntake(blockCodecov, {
+				files: {
+					".github": {
+						workflows: {
+							"ci.yml": [
+								jsYaml.dump({
+									jobs: {
+										test: {
+											name: "Test",
+											steps: [
+												{
+													uses: "codecov/codecov-action@v3",
+												},
+											],
+										},
+									},
+								}),
+							],
+						},
+					},
+				},
+			});
+
+			expect(actual).toEqual({ env: undefined });
+		});
+
+		it("returns env when ci.yml contains a test job with env in its codecov step", () => {
+			const env = {
+				CODECOV_TOKEN: "${{ secrets.CODECOV_TOKEN }}",
+			};
+			const actual = testIntake(blockCodecov, {
+				files: {
+					".github": {
+						workflows: {
+							"ci.yml": [
+								jsYaml.dump({
+									jobs: {
+										test: {
+											name: "Test",
+											steps: [
+												{
+													env,
+													uses: "codecov/codecov-action@v3",
+												},
+											],
+										},
+									},
+								}),
+							],
+						},
+					},
+				},
+			});
+
+			expect(actual).toEqual({ env });
+		});
+	});
 });