fix: reject non-array needs with clear error

src/data-expander.ts

@@ -129,6 +129,7 @@ export function needsComplex (data: any) {
 export function needsEach (jobName: string, gitlabData: any) {
     const jobData = gitlabData[jobName];
     if (!jobData.needs) return;
+    assert(Array.isArray(jobData.needs), chalk`{blueBright ${jobName}} {yellow needs:} must be an array`);
 
     for (const [i, n] of Object.entries<any>(jobData.needs)) {
         jobData.needs[i] = needsComplex(n);

tests/test-cases/needs-not-array/.gitlab-ci.yml

@@ -0,0 +1,9 @@
+---
+build-job:
+  script:
+    - echo "build"
+
+dev-job:
+  needs: build-job
+  script:
+    - echo "dev"

tests/test-cases/needs-not-array/integration.test.ts

@@ -0,0 +1,18 @@
+import {WriteStreamsMock} from "../../../src/write-streams.js";
+import {handler} from "../../../src/handler.js";
+import {initSpawnSpy} from "../../mocks/utils.mock.js";
+import {WhenStatics} from "../../mocks/when-statics.js";
+import chalk from "chalk-template";
+
+beforeAll(() => {
+    initSpawnSpy(WhenStatics.all);
+});
+
+test.concurrent("needs-not-array <dev-job>", async () => {
+    const writeStreams = new WriteStreamsMock();
+
+    await expect(handler({
+        cwd: "tests/test-cases/needs-not-array",
+        stateDir: ".gitlab-ci-local-needs-not-array",
+    }, writeStreams)).rejects.toThrow(chalk`{blueBright dev-job} {yellow needs:} must be an array`);
+});