Files
clean-architecture-frontend…/tests/unit/http-operation-v2-v3-parity.test.ts
T
DongHyeonkaandClaude Opus 5.5 c9360638fd test(contracts): require installed V2 operation rows to match their V3 descriptors (07-03)
FE-REG-API governs the V2 rows but the V3 descriptors execute, so a V3 path
or limit change passed every check. The test compares method, path, success
statuses, response limit, auth profile and replay policy per operationId.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 00:09:11 +09:00

57 lines
2.1 KiB
TypeScript

import { describe, expect, it } from "vitest";
import type {
ApiOperation,
RestOperationV2,
} from "../../src/contracts/api-operations.ts";
import { INSTALLED_CONTRACT_CONTRIBUTIONS } from "../../src/features/installed-contract-contributions.ts";
import { API_OPERATIONS } from "../../src/features/installed-feature-contracts.ts";
// 07-03 (D-7). FE-REG-API governs the V2 rows while the V3 descriptors are
// what executes. Until V2 is generated from V3, both copies must agree.
const RETRY_SEMANTICS_FOR_REPLAY_POLICY = Object.freeze({
SAFE: "SAFE",
IDEMPOTENT: "IDEMPOTENT",
KEYED_COMMAND: "KEYED",
NON_REPLAYABLE: "NEVER",
} as const);
const v3ByOperationId = new Map(
INSTALLED_CONTRACT_CONTRIBUTIONS.flatMap((contribution) =>
contribution.http.map(
(descriptor) => [descriptor.contract.operationId, descriptor] as const,
),
),
);
const v2Rows = (Object.values(API_OPERATIONS) as readonly ApiOperation[]).filter(
(operation): operation is RestOperationV2 => operation.contractVersion === 2,
);
describe("HTTP operation V2 rows and V3 descriptors", () => {
it("declare the same method, path, statuses, limit, auth profile and replay policy", () => {
for (const row of v2Rows) {
const descriptor = v3ByOperationId.get(row.operationId);
expect(descriptor, `${row.operationId} has no V3 descriptor`).toBeDefined();
if (!descriptor) continue;
expect(
{
method: descriptor.contract.method,
path: descriptor.contract.pathTemplate,
successStatuses: [...descriptor.contract.acceptedStatuses],
maxResponseBytes: descriptor.frontend.responseByteLimit,
authProfileId: descriptor.frontend.authProfileId,
retrySemantics: descriptor.contract.retrySemantics,
},
row.operationId,
).toEqual({
method: row.method,
path: row.path,
successStatuses: [...row.successStatuses],
maxResponseBytes: row.maxResponseBytes,
authProfileId: row.authProfileId,
retrySemantics: RETRY_SEMANTICS_FOR_REPLAY_POLICY[row.replayPolicy],
});
}
});
});