Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/apps/worker/src/group-runtime.test.ts
T

103 lines
4.2 KiB
TypeScript

import { describe, expect, test } from "vitest";
import { queueNames } from "@hivegrid/queue";
import {
DEFAULT_GROUP_CONCURRENCY,
InvalidWorkerQueueGroupError,
bootstrapWorkerGroup,
resolveGroupConcurrency,
resolveQueueNamesForGroup,
resolveWorkerQueueGroup,
} from "./group-runtime.js";
describe("resolveWorkerQueueGroup", () => {
test("returns the validated group when env is set", () => {
expect(resolveWorkerQueueGroup({ WORKER_QUEUE_GROUP: "mail" })).toBe("mail");
});
test("throws when env is missing", () => {
expect(() => resolveWorkerQueueGroup({})).toThrow(InvalidWorkerQueueGroupError);
});
test("throws when env is unknown", () => {
expect(() => resolveWorkerQueueGroup({ WORKER_QUEUE_GROUP: "all" })).toThrow(InvalidWorkerQueueGroupError);
});
test("error message lists every valid group", () => {
try {
resolveWorkerQueueGroup({ WORKER_QUEUE_GROUP: "bogus" });
throw new Error("should have thrown");
} catch (error) {
expect(error).toBeInstanceOf(InvalidWorkerQueueGroupError);
const message = (error as Error).message;
for (const group of ["general", "mail", "import", "webhook", "plugin"]) {
expect(message).toContain(group);
}
expect(message).toContain("docs/ops/worker-queues.md");
}
});
});
describe("resolveQueueNamesForGroup", () => {
test("mail group resolves to email queue", () => {
expect(resolveQueueNamesForGroup("mail")).toEqual([queueNames.email]);
});
test("general group includes notifications + maintenance + fileScan + filePreview", () => {
expect(resolveQueueNamesForGroup("general")).toEqual([queueNames.notifications, queueNames.maintenance, queueNames.fileScan, queueNames.filePreview]);
});
test("import group includes dedicated KWP, generic imports, and exports", () => {
expect(resolveQueueNamesForGroup("import")).toEqual([queueNames.kwpImports, queueNames.imports, queueNames.exports]);
});
test("webhook group covers browser automation", () => {
expect(resolveQueueNamesForGroup("webhook")).toEqual([queueNames.browserAutomation]);
});
test("plugin group resolves to plugin-invoke queue", () => {
expect(resolveQueueNamesForGroup("plugin")).toEqual([queueNames.pluginInvoke]);
});
});
describe("resolveGroupConcurrency", () => {
test("falls back to documented defaults when env is unset", () => {
expect(resolveGroupConcurrency("general", {})).toBe(DEFAULT_GROUP_CONCURRENCY.general);
expect(resolveGroupConcurrency("mail", {})).toBe(DEFAULT_GROUP_CONCURRENCY.mail);
expect(resolveGroupConcurrency("import", {})).toBe(DEFAULT_GROUP_CONCURRENCY.import);
expect(resolveGroupConcurrency("webhook", {})).toBe(DEFAULT_GROUP_CONCURRENCY.webhook);
expect(resolveGroupConcurrency("plugin", {})).toBe(DEFAULT_GROUP_CONCURRENCY.plugin);
});
test("honours WORKER_CONCURRENCY_PLUGIN override", () => {
expect(resolveGroupConcurrency("plugin", { WORKER_CONCURRENCY_PLUGIN: "12" })).toBe(12);
});
test("honours explicit WORKER_CONCURRENCY_<GROUP> override", () => {
expect(resolveGroupConcurrency("webhook", { WORKER_CONCURRENCY_WEBHOOK: "40" })).toBe(40);
expect(resolveGroupConcurrency("mail", { WORKER_CONCURRENCY_MAIL: "8" })).toBe(8);
});
test("ignores non-numeric or zero/negative overrides and uses default", () => {
expect(resolveGroupConcurrency("mail", { WORKER_CONCURRENCY_MAIL: "abc" })).toBe(DEFAULT_GROUP_CONCURRENCY.mail);
expect(resolveGroupConcurrency("mail", { WORKER_CONCURRENCY_MAIL: "0" })).toBe(DEFAULT_GROUP_CONCURRENCY.mail);
expect(resolveGroupConcurrency("mail", { WORKER_CONCURRENCY_MAIL: "-5" })).toBe(DEFAULT_GROUP_CONCURRENCY.mail);
});
});
describe("bootstrapWorkerGroup", () => {
test("returns a fully-resolved record for valid env", () => {
expect(
bootstrapWorkerGroup({ WORKER_QUEUE_GROUP: "import", WORKER_CONCURRENCY_IMPORT: "2" })
).toEqual({
group: "import",
queueNames: [queueNames.kwpImports, queueNames.imports, queueNames.exports],
concurrency: 2,
concurrencyEnvVar: "WORKER_CONCURRENCY_IMPORT",
});
});
test("rejects invalid group", () => {
expect(() => bootstrapWorkerGroup({ WORKER_QUEUE_GROUP: "" })).toThrow(InvalidWorkerQueueGroupError);
});
});