import { describe, expect, test } from "vitest"; import { queueNames as directQueueNames } from "./names.js"; import { buildExportJob, buildIdempotentJobId } from "./producers.js"; import { queueNames as publicQueueNames } from "./index.js"; import type { ExportJob, QueueJobDescriptor, QueueJobPayloads } from "./payloads.js"; function assertExportDescriptor(descriptor: QueueJobDescriptor) { return descriptor; } describe("export queue contract", () => { test("exports a stable exports queue name through direct and public surfaces", () => { expect(directQueueNames.exports).toBe("toolctrl.exports"); expect(publicQueueNames.exports).toBe(directQueueNames.exports); }); test("builds an export descriptor matching the typed queue payload map", () => { const descriptor = assertExportDescriptor( buildExportJob({ exportJobId: "export_job_contract_1", tenantId: "tenant_1", requestedByUserId: "user_1", exportType: "members", format: "json", requestId: "req_export_contract_1", complianceGate: { state: "paused", reason: "user-privacy-pause", requestId: "req_pause_contract_1", }, metadata: { requestId: "req_export_contract_1" }, }) ); const payload: ExportJob = descriptor.payload; const mappedPayload: QueueJobPayloads[typeof directQueueNames.exports] = payload; expect(descriptor.queueName).toBe(directQueueNames.exports); expect(descriptor.jobName).toBe("run-export"); expect(mappedPayload).toMatchObject({ kind: "export.run", exportJobId: "export_job_contract_1", requestId: "req_export_contract_1", complianceGate: { state: "paused", reason: "user-privacy-pause", requestId: "req_pause_contract_1", }, }); expect(buildIdempotentJobId(descriptor)).toBe("export_job_contract_1"); }); test("keeps export idempotency tied to exportJobId when compliance gate requestIds change", () => { const activeDescriptor = buildExportJob({ exportJobId: "export_job_contract_idempotent_1", tenantId: "tenant_1", requestedByUserId: "user_1", exportType: "members", format: "json", complianceGate: { state: "active", resumedAt: "2026-01-01T00:00:00.000Z", requestId: "req_resume_contract_1", }, }); const pausedDescriptor = buildExportJob({ exportJobId: "export_job_contract_idempotent_1", tenantId: "tenant_1", requestedByUserId: "user_1", exportType: "members", format: "json", complianceGate: { state: "paused", reason: "workspace-retention-pause", requestId: "req_pause_contract_2", }, }); expect(buildIdempotentJobId(activeDescriptor)).toBe("export_job_contract_idempotent_1"); expect(buildIdempotentJobId(pausedDescriptor)).toBe("export_job_contract_idempotent_1"); expect(buildIdempotentJobId(pausedDescriptor)).not.toBe(pausedDescriptor.payload.complianceGate?.requestId); }); });