103 lines
4.2 KiB
TypeScript
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);
|
|
});
|
|
});
|