feat(media): full Clean Architecture scaffold

Media is now a complete vertical-feature package mirroring auth/blog
structure: entities (models + errors), application (repositories +
use-cases), infrastructure (real Payload-backed + mock siblings),
interface-adapters (per-use-case controllers), DI (symbols + module +
container + bind-production), integrations/api (mediaRouter), factory,
contract suite, and feature integration tests.

Wired into:
- packages/core-api/src/root.ts (added `media: mediaRouter`)
- apps/web-next/src/server/bind-production.ts (calls bindProductionMedia)
- tsconfig.base.json (added @repo/media/api and ./di/bind-production aliases)

56 new tests in @repo/media (13 test files); core-api router test updated
to assert media. procedures. All 26 turbo tasks green.

Refactor log: §2, §4.1, §4.2, §5.1, §6.1
Spec: §6.5

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

packages/media/src/infrastructure/repositories/media.repository.test.ts

@@ -0,0 +1,130 @@
+import { describe, expect, it, vi } from "vitest";
+import { MediaRepository } from "@/infrastructure/repositories/media.repository";
+import { mediaRepositoryContract } from "@/__contracts__/media-repository.contract";
+import { stubPayloadConfig } from "@repo/core-testing/payload/stub-config";
+
+// ---------------------------------------------------------------------------
+// In-memory Payload stub
+// ---------------------------------------------------------------------------
+
+function buildPayloadStub() {
+  const store = new Map<string, Record<string, unknown>>();
+
+  return {
+    find: vi.fn(
+      async ({
+        limit,
+        page,
+      }: {
+        collection: string;
+        limit?: number;
+        page?: number;
+        overrideAccess?: boolean;
+      }) => {
+        let docs = Array.from(store.values());
+        const lim = limit ?? 50;
+        const pg = page ?? 1;
+        const offset = (pg - 1) * lim;
+        docs = docs.slice(offset, offset + lim);
+        return { docs };
+      },
+    ),
+    findByID: vi.fn(
+      async ({ id }: { collection: string; id: string; overrideAccess?: boolean }) => {
+        const doc = store.get(String(id));
+        if (!doc) throw new Error(`Not found: ${id}`);
+        return doc;
+      },
+    ),
+    delete: vi.fn(
+      async ({ id }: { collection: string; id: string; overrideAccess?: boolean }) => {
+        store.delete(String(id));
+        return { id };
+      },
+    ),
+  };
+}
+
+vi.mock("payload", () => ({
+  getPayload: vi.fn(),
+}));
+
+// ---------------------------------------------------------------------------
+// Contract suite
+// ---------------------------------------------------------------------------
+
+describe("MediaRepository", () => {
+  describe("contract", () => {
+    mediaRepositoryContract.run(async () => {
+      const stub = buildPayloadStub();
+      const { getPayload } = await import("payload");
+      (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue(stub);
+      return new MediaRepository(stubPayloadConfig);
+    });
+  });
+
+  // -------------------------------------------------------------------------
+  // Impl-specific tests: Payload doc → domain mapping
+  // -------------------------------------------------------------------------
+
+  describe("getMedia", () => {
+    it("returns undefined when Payload throws (not found)", async () => {
+      const { getPayload } = await import("payload");
+      (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue({
+        findByID: vi.fn().mockRejectedValue(new Error("Not found")),
+      });
+
+      const repo = new MediaRepository(stubPayloadConfig);
+      const result = await repo.getMedia("missing-id");
+      expect(result).toBeUndefined();
+    });
+
+    it("maps Payload doc fields to domain Media", async () => {
+      const { getPayload } = await import("payload");
+      (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue({
+        findByID: vi.fn().mockResolvedValue({
+          id: "p-1",
+          alt: "Test image",
+          url: "https://cdn.example.com/test.png",
+          filename: "test.png",
+          mimeType: "image/png",
+          filesize: 2048,
+          width: 800,
+          height: 600,
+        }),
+      });
+
+      const repo = new MediaRepository(stubPayloadConfig);
+      const result = await repo.getMedia("p-1");
+      expect(result?.id).toBe("p-1");
+      expect(result?.alt).toBe("Test image");
+      expect(result?.width).toBe(800);
+      expect(result?.height).toBe(600);
+    });
+  });
+
+  describe("listMedia", () => {
+    it("returns an array of mapped Media docs", async () => {
+      const { getPayload } = await import("payload");
+      (getPayload as ReturnType<typeof vi.fn>).mockResolvedValue({
+        find: vi.fn().mockResolvedValue({
+          docs: [
+            {
+              id: "m-1",
+              alt: "First",
+              url: "https://cdn.example.com/first.png",
+              filename: "first.png",
+              mimeType: "image/png",
+              filesize: 100,
+            },
+          ],
+        }),
+      });
+
+      const repo = new MediaRepository(stubPayloadConfig);
+      const result = await repo.listMedia();
+      expect(result).toHaveLength(1);
+      expect(result[0]?.id).toBe("m-1");
+    });
+  });
+});