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

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

packages/auth/src/__contracts__/users-repository.contract.ts

@@ -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 { IUsersRepository } from "../application/repositories/users.repository.interface.js";
 import { userFactory } from "../__factories__/user.factory.js";
@@ -6,7 +6,7 @@ import { userFactory } from "../__factories__/user.factory.js";
 export const usersRepositoryContract =
   defineContractSuite<IUsersRepository>(
     "IUsersRepository",
-    ({ buildSubject }) => {
+    ({ buildSubject, getTracer }) => {
       let repo: IUsersRepository;
 
       beforeEach(async () => {
@@ -52,5 +52,40 @@ export const usersRepositoryContract =
         expect(created.id).toBe(seed.id);
         expect(created.username).toBe("carol");
       });
+
+      describe("span emission (R50)", () => {
+        it("getUser emits users.getUser span with id attribute", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          await repo.getUser("nonexistent");
+          const span = tracer.findSpan("users.getUser");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+          expect(span!.attributes.id).toBe("nonexistent");
+        });
+
+        it("getUserByUsername emits users.getUserByUsername span", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          await repo.getUserByUsername("alice");
+          const span = tracer.findSpan("users.getUserByUsername");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+        });
+
+        it("createUser emits users.createUser span with id attribute", async () => {
+          if (!getTracer) return;
+          const tracer = getTracer();
+          tracer.reset();
+          const seed = userFactory.build({ username: "span-test-user" });
+          await repo.createUser(seed);
+          const span = tracer.findSpan("users.createUser");
+          expect(span).toBeDefined();
+          expect(span!.op).toBe("repository");
+          expect(span!.attributes.id).toBe(seed.id);
+        });
+      });
     },
   );

packages/auth/src/infrastructure/repositories/users.repository.mock.test.ts

@@ -1,8 +1,13 @@
 import { describe } from "vitest";
+import { RecordingTracer } from "@repo/core-testing/instrumentation";
 import { MockUsersRepository } from "@/infrastructure/repositories/users.repository.mock";
 import { usersRepositoryContract } from "@/__contracts__/users-repository.contract";
 
 describe("MockUsersRepository", () => {
+  const tracer = new RecordingTracer();
   // Start with empty store so contract tests run from a clean slate.
-  usersRepositoryContract.run(() => new MockUsersRepository([]));
+  usersRepositoryContract.run(
+    () => new MockUsersRepository([], tracer),
+    { tracer: () => tracer },
+  );
 });

packages/auth/src/infrastructure/repositories/users.repository.test.ts

@@ -1,4 +1,5 @@
 import { describe, vi, beforeEach } from "vitest";
+import { RecordingTracer } from "@repo/core-testing/instrumentation";
 import { UsersRepository } from "@/infrastructure/repositories/users.repository";
 import { usersRepositoryContract } from "@/__contracts__/users-repository.contract";
 import { stubPayloadConfig } from "@repo/core-testing/payload/stub-config";
@@ -48,15 +49,20 @@ function buildPayloadStub() {
 
 describe("UsersRepository", () => {
   describe("contract", () => {
+    const tracer = new RecordingTracer();
+
     beforeEach(() => {
       vi.clearAllMocks();
     });
 
-    usersRepositoryContract.run(async () => {
-      const stub = buildPayloadStub();
-      const { getPayload } = await import("payload");
-      (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
-      return new UsersRepository(stubPayloadConfig);
-    });
+    usersRepositoryContract.run(
+      async () => {
+        const stub = buildPayloadStub();
+        const { getPayload } = await import("payload");
+        (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
+        return new UsersRepository(stubPayloadConfig, tracer);
+      },
+      { tracer: () => tracer },
+    );
   });
 });