Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/packages/queue/src/export-contract.test.ts
T

83 lines
3.0 KiB
TypeScript

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<typeof directQueueNames.exports>) {
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);
});
});