test(features): R50 — repo contract suites assert span shape per method

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-07 19:09:50 +02:00
parent a4efceb104
commit d4bc045a28
18 changed files with 293 additions and 54 deletions

View File

@@ -1,4 +1,4 @@
import { it, expect, beforeEach } from "vitest";
import { it, expect, beforeEach, describe } from "vitest";
import { defineContractSuite } from "@repo/core-testing/contract";
import type { IPagesRepository } from "../application/repositories/pages.repository.interface.js";
import type { Page } from "../entities/models/page.js";
@@ -47,7 +47,7 @@ export const CONTRACT_PAGES_SEED: Page[] = [
export const pagesRepositoryContract =
defineContractSuite<IPagesRepository>(
"IPagesRepository",
({ buildSubject }) => {
({ buildSubject, getTracer }) => {
let repo: IPagesRepository;
beforeEach(async () => {
@@ -95,5 +95,29 @@ export const pagesRepositoryContract =
expect(page.status).toBe("draft");
}
});
describe("span emission (R50)", () => {
it("getPageBySlug emits pages.getPageBySlug span with slug attribute", async () => {
if (!getTracer) return;
const tracer = getTracer();
tracer.reset();
await repo.getPageBySlug("about");
const span = tracer.findSpan("pages.getPageBySlug");
expect(span).toBeDefined();
expect(span!.op).toBe("repository");
expect(span!.attributes.slug).toBe("about");
});
it("getPages emits pages.getPages span with op=repository", async () => {
if (!getTracer) return;
const tracer = getTracer();
tracer.reset();
await repo.getPages({ status: "published" });
const span = tracer.findSpan("pages.getPages");
expect(span).toBeDefined();
expect(span!.op).toBe("repository");
expect(span!.attributes.status).toBe("published");
});
});
},
);

View File

@@ -1,4 +1,4 @@
import { it, expect, beforeEach } from "vitest";
import { it, expect, beforeEach, describe } from "vitest";
import { defineContractSuite } from "@repo/core-testing/contract";
import type { ISiteSettingsRepository } from "../application/repositories/site-settings.repository.interface.js";
@@ -11,7 +11,7 @@ import type { ISiteSettingsRepository } from "../application/repositories/site-s
export const siteSettingsRepositoryContract =
defineContractSuite<ISiteSettingsRepository>(
"ISiteSettingsRepository",
({ buildSubject }) => {
({ buildSubject, getTracer }) => {
let repo: ISiteSettingsRepository;
beforeEach(async () => {
@@ -34,5 +34,17 @@ export const siteSettingsRepositoryContract =
typeof settings.siteDescription === "string",
).toBe(true);
});
describe("span emission (R50)", () => {
it("getSiteSettings emits site-settings.getSiteSettings span with op=repository", async () => {
if (!getTracer) return;
const tracer = getTracer();
tracer.reset();
await repo.getSiteSettings();
const span = tracer.findSpan("site-settings.getSiteSettings");
expect(span).toBeDefined();
expect(span!.op).toBe("repository");
});
});
},
);

View File

@@ -1,4 +1,5 @@
import { describe } from "vitest";
import { RecordingTracer } from "@repo/core-testing/instrumentation";
import { MockPagesRepository } from "@/infrastructure/repositories/pages.repository.mock";
import {
pagesRepositoryContract,
@@ -6,7 +7,11 @@ import {
} from "@/__contracts__/pages-repository.contract";
describe("MockPagesRepository", () => {
const tracer = new RecordingTracer();
// Pre-seed with the contract fixtures so the contract assertions find what
// they expect (an "about" published page and a "draft-page" draft page).
pagesRepositoryContract.run(() => new MockPagesRepository(CONTRACT_PAGES_SEED));
pagesRepositoryContract.run(
() => new MockPagesRepository(CONTRACT_PAGES_SEED, tracer),
{ tracer: () => tracer },
);
});

View File

@@ -1,4 +1,5 @@
import { describe, vi } from "vitest";
import { RecordingTracer } from "@repo/core-testing/instrumentation";
import { PagesRepository } from "@/infrastructure/repositories/pages.repository";
import {
pagesRepositoryContract,
@@ -73,11 +74,15 @@ vi.mock("payload", () => ({
describe("PagesRepository", () => {
describe("contract", () => {
pagesRepositoryContract.run(async () => {
const stub = buildPayloadPagesStub(CONTRACT_PAGES_SEED);
const { getPayload } = await import("payload");
(getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
return new PagesRepository(stubPayloadConfig);
});
const tracer = new RecordingTracer();
pagesRepositoryContract.run(
async () => {
const stub = buildPayloadPagesStub(CONTRACT_PAGES_SEED);
const { getPayload } = await import("payload");
(getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
return new PagesRepository(stubPayloadConfig, tracer);
},
{ tracer: () => tracer },
);
});
});

View File

@@ -1,7 +1,12 @@
import { describe } from "vitest";
import { RecordingTracer } from "@repo/core-testing/instrumentation";
import { MockSiteSettingsRepository } from "@/infrastructure/repositories/site-settings.repository.mock";
import { siteSettingsRepositoryContract } from "@/__contracts__/site-settings-repository.contract";
describe("MockSiteSettingsRepository", () => {
siteSettingsRepositoryContract.run(() => new MockSiteSettingsRepository());
const tracer = new RecordingTracer();
siteSettingsRepositoryContract.run(
() => new MockSiteSettingsRepository(tracer),
{ tracer: () => tracer },
);
});

View File

@@ -1,4 +1,5 @@
import { describe, vi } from "vitest";
import { RecordingTracer } from "@repo/core-testing/instrumentation";
import { SiteSettingsRepository } from "@/infrastructure/repositories/site-settings.repository";
import { siteSettingsRepositoryContract } from "@/__contracts__/site-settings-repository.contract";
import { stubPayloadConfig } from "@repo/core-testing/payload/stub-config";
@@ -30,11 +31,15 @@ vi.mock("payload", () => ({
describe("SiteSettingsRepository", () => {
describe("contract", () => {
siteSettingsRepositoryContract.run(async () => {
const stub = buildSiteSettingsStub();
const { getPayload } = await import("payload");
(getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
return new SiteSettingsRepository(stubPayloadConfig);
});
const tracer = new RecordingTracer();
siteSettingsRepositoryContract.run(
async () => {
const stub = buildSiteSettingsStub();
const { getPayload } = await import("payload");
(getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
return new SiteSettingsRepository(stubPayloadConfig, tracer);
},
{ tracer: () => tracer },
);
});
});