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/di/bind-production.ts

@@ -0,0 +1,13 @@
+import type { SanitizedConfig } from "payload";
+import { mediaContainer } from "./container";
+import { MEDIA_SYMBOLS } from "./symbols";
+import { MediaRepository } from "../infrastructure/repositories/media.repository";
+
+export function bindProductionMedia(config: SanitizedConfig): void {
+  if (mediaContainer.isBound(MEDIA_SYMBOLS.IMediaRepository)) {
+    mediaContainer.unbind(MEDIA_SYMBOLS.IMediaRepository);
+  }
+  mediaContainer
+    .bind(MEDIA_SYMBOLS.IMediaRepository)
+    .toConstantValue(new MediaRepository(config));
+}

packages/media/src/di/container.test.ts

@@ -0,0 +1,52 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { mediaContainer } from "@/di/container";
+import { MEDIA_SYMBOLS } from "@/di/symbols";
+import { MediaModule } from "@/di/module";
+import { MockMediaRepository } from "@/infrastructure/repositories/media.repository.mock";
+import type { IMediaRepository } from "@/application/repositories/media.repository.interface";
+
+describe("mediaContainer", () => {
+  beforeEach(() => {
+    mediaContainer.unbindAll();
+    mediaContainer.load(MediaModule);
+  });
+
+  afterEach(() => {
+    mediaContainer.unbindAll();
+  });
+
+  it("resolves IMediaRepository to MockMediaRepository by default binding", () => {
+    const repo = mediaContainer.get<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository);
+    expect(repo).toBeInstanceOf(MockMediaRepository);
+  });
+
+  it("resolves IGetMediaController as a function", () => {
+    const ctrl = mediaContainer.get(MEDIA_SYMBOLS.IGetMediaController);
+    expect(typeof ctrl).toBe("function");
+  });
+
+  it("resolves IListMediaController as a function", () => {
+    const ctrl = mediaContainer.get(MEDIA_SYMBOLS.IListMediaController);
+    expect(typeof ctrl).toBe("function");
+  });
+
+  it("resolves IDeleteMediaController as a function", () => {
+    const ctrl = mediaContainer.get(MEDIA_SYMBOLS.IDeleteMediaController);
+    expect(typeof ctrl).toBe("function");
+  });
+
+  it("resolves IGetMediaUseCase as a function", () => {
+    const uc = mediaContainer.get(MEDIA_SYMBOLS.IGetMediaUseCase);
+    expect(typeof uc).toBe("function");
+  });
+
+  it("resolves IListMediaUseCase as a function", () => {
+    const uc = mediaContainer.get(MEDIA_SYMBOLS.IListMediaUseCase);
+    expect(typeof uc).toBe("function");
+  });
+
+  it("resolves IDeleteMediaUseCase as a function", () => {
+    const uc = mediaContainer.get(MEDIA_SYMBOLS.IDeleteMediaUseCase);
+    expect(typeof uc).toBe("function");
+  });
+});

packages/media/src/di/container.ts

@@ -0,0 +1,6 @@
+import "reflect-metadata";
+import { Container } from "inversify";
+import { MediaModule } from "./module";
+
+export const mediaContainer = new Container({ defaultScope: "Singleton" });
+mediaContainer.load(MediaModule);

packages/media/src/di/module.ts

@@ -0,0 +1,69 @@
+import { ContainerModule, type interfaces } from "inversify";
+
+import type { IMediaRepository } from "../application/repositories/media.repository.interface";
+import { MockMediaRepository } from "../infrastructure/repositories/media.repository.mock";
+import {
+  getMediaUseCase,
+  type IGetMediaUseCase,
+} from "../application/use-cases/get-media.use-case";
+import {
+  listMediaUseCase,
+  type IListMediaUseCase,
+} from "../application/use-cases/list-media.use-case";
+import {
+  deleteMediaUseCase,
+  type IDeleteMediaUseCase,
+} from "../application/use-cases/delete-media.use-case";
+import {
+  getMediaController,
+  type IGetMediaController,
+} from "../interface-adapters/controllers/get-media.controller";
+import {
+  listMediaController,
+  type IListMediaController,
+} from "../interface-adapters/controllers/list-media.controller";
+import {
+  deleteMediaController,
+  type IDeleteMediaController,
+} from "../interface-adapters/controllers/delete-media.controller";
+import { MEDIA_SYMBOLS } from "./symbols";
+
+export const MediaModule = new ContainerModule((bind: interfaces.Bind) => {
+  bind<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository).to(MockMediaRepository);
+
+  bind<IGetMediaUseCase>(MEDIA_SYMBOLS.IGetMediaUseCase).toDynamicValue((ctx) =>
+    getMediaUseCase(
+      ctx.container.get<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository),
+    ),
+  );
+
+  bind<IListMediaUseCase>(MEDIA_SYMBOLS.IListMediaUseCase).toDynamicValue((ctx) =>
+    listMediaUseCase(
+      ctx.container.get<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository),
+    ),
+  );
+
+  bind<IDeleteMediaUseCase>(MEDIA_SYMBOLS.IDeleteMediaUseCase).toDynamicValue((ctx) =>
+    deleteMediaUseCase(
+      ctx.container.get<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository),
+    ),
+  );
+
+  bind<IGetMediaController>(MEDIA_SYMBOLS.IGetMediaController).toDynamicValue((ctx) =>
+    getMediaController(
+      ctx.container.get<IGetMediaUseCase>(MEDIA_SYMBOLS.IGetMediaUseCase),
+    ),
+  );
+
+  bind<IListMediaController>(MEDIA_SYMBOLS.IListMediaController).toDynamicValue((ctx) =>
+    listMediaController(
+      ctx.container.get<IListMediaUseCase>(MEDIA_SYMBOLS.IListMediaUseCase),
+    ),
+  );
+
+  bind<IDeleteMediaController>(MEDIA_SYMBOLS.IDeleteMediaController).toDynamicValue((ctx) =>
+    deleteMediaController(
+      ctx.container.get<IDeleteMediaUseCase>(MEDIA_SYMBOLS.IDeleteMediaUseCase),
+    ),
+  );
+});

packages/media/src/di/symbols.ts

@@ -0,0 +1,11 @@
+export const MEDIA_SYMBOLS = {
+  IMediaRepository: Symbol.for("media:IMediaRepository"),
+  // Use cases
+  IGetMediaUseCase: Symbol.for("media:IGetMediaUseCase"),
+  IListMediaUseCase: Symbol.for("media:IListMediaUseCase"),
+  IDeleteMediaUseCase: Symbol.for("media:IDeleteMediaUseCase"),
+  // Controllers
+  IGetMediaController: Symbol.for("media:IGetMediaController"),
+  IListMediaController: Symbol.for("media:IListMediaController"),
+  IDeleteMediaController: Symbol.for("media:IDeleteMediaController"),
+} as const;