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_ 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); }); });