feat(features): add bind-dev-seed binders for auth/marketing-pages/navigation/media

Mirrors the canonical blog pattern landed earlier on this branch.

Per feature:
- src/__seeds__/dev.ts — lazy buildDev<Entities>() function using the
  feature's existing factory for sensible defaults
- src/di/bind-dev-seed.ts — bindDevSeed<Feature>() async function that
  rebinds the repo symbol(s) to a populated MockXRepository via
  .toConstantValue
- src/di/bind-dev-seed.test.ts — 3+ tests per feature (populates,
  reachable by id/slug, idempotent)
- package.json — adds ./di/bind-dev-seed subpath export

Tests + use cases continue to construct mocks directly; the seed never
runs from a *.test.ts path. App boot wiring (USE_DEV_SEED env branch)
follows in a separate commit.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-06 19:04:33 +02:00
parent e6560bc9cb
commit 10479c4d55
16 changed files with 603 additions and 4 deletions

View File

@@ -0,0 +1,38 @@
import { mediaFactory } from "../__factories__/media.factory.js";
import type { Media } from "../entities/models/media.js";
/**
* Realistic media seed for dev mode + storybook stories.
*
* Built from `mediaFactory` so factory defaults take care of boring fields
* and we only override what makes the data look like a real media library.
*
* Lazily produced so importing this module is side-effect-free — the
* factory's sequence counter only advances when a binder calls
* `buildDevMedia()`.
*/
export function buildDevMedia(): Media[] {
return [
mediaFactory.build({
id: "placeholder-1",
alt: "Hero background image",
url: "/dev/placeholder-1.jpg",
filename: "placeholder-1.jpg",
mimeType: "image/jpeg",
}),
mediaFactory.build({
id: "placeholder-2",
alt: "Team photo",
url: "/dev/placeholder-2.jpg",
filename: "placeholder-2.jpg",
mimeType: "image/jpeg",
}),
mediaFactory.build({
id: "placeholder-3",
alt: "Product screenshot",
url: "/dev/placeholder-3.png",
filename: "placeholder-3.png",
mimeType: "image/png",
}),
];
}

View File

@@ -0,0 +1,71 @@
import "reflect-metadata";
import { afterEach, beforeEach, describe, expect, it } from "vitest";
import { bindDevSeedMedia } from "@/di/bind-dev-seed";
import { mediaContainer } from "@/di/container";
import { MEDIA_SYMBOLS } from "@/di/symbols";
import { MockMediaRepository } from "@/infrastructure/repositories/media.repository.mock";
import type { IMediaRepository } from "@/application/repositories/media.repository.interface";
describe("bindDevSeedMedia", () => {
// Each test starts from the default empty-mock binding and tears down
// afterwards so the global mediaContainer state stays clean for siblings.
beforeEach(() => {
if (mediaContainer.isBound(MEDIA_SYMBOLS.IMediaRepository)) {
mediaContainer.unbind(MEDIA_SYMBOLS.IMediaRepository);
}
mediaContainer
.bind<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository)
.to(MockMediaRepository);
});
afterEach(() => {
if (mediaContainer.isBound(MEDIA_SYMBOLS.IMediaRepository)) {
mediaContainer.unbind(MEDIA_SYMBOLS.IMediaRepository);
}
mediaContainer
.bind<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository)
.to(MockMediaRepository);
});
it("populates the repository with the dev media entries", async () => {
await bindDevSeedMedia();
const repo = mediaContainer.get<IMediaRepository>(
MEDIA_SYMBOLS.IMediaRepository,
);
const all = await repo.listMedia();
expect(all.length).toBeGreaterThan(0);
});
it("seeds placeholder-1 reachable by id", async () => {
await bindDevSeedMedia();
const repo = mediaContainer.get<IMediaRepository>(
MEDIA_SYMBOLS.IMediaRepository,
);
const item = await repo.getMedia("placeholder-1");
expect(item).toBeDefined();
expect(item?.url).toBe("/dev/placeholder-1.jpg");
expect(item?.alt).toBe("Hero background image");
});
it("is idempotent — calling twice rebuilds a fresh populated repo", async () => {
await bindDevSeedMedia();
const before = mediaContainer.get<IMediaRepository>(
MEDIA_SYMBOLS.IMediaRepository,
);
const beforeCount = (await before.listMedia()).length;
await bindDevSeedMedia();
const after = mediaContainer.get<IMediaRepository>(
MEDIA_SYMBOLS.IMediaRepository,
);
const afterCount = (await after.listMedia()).length;
expect(afterCount).toBe(beforeCount);
// It's a fresh instance — not the previous one.
expect(after).not.toBe(before);
});
});

View File

@@ -0,0 +1,30 @@
import { mediaContainer } from "./container.js";
import { MEDIA_SYMBOLS } from "./symbols.js";
import { MockMediaRepository } from "../infrastructure/repositories/media.repository.mock.js";
import { buildDevMedia } from "../__seeds__/dev.js";
import type { IMediaRepository } from "../application/repositories/media.repository.interface.js";
/**
* Replace the default empty mock with a populated one for dev mode + storybook.
*
* Call this from app boot when `USE_DEV_SEED=true`, mutually exclusive with
* `bindProductionMedia(config)`. Tests must NOT call this — they construct
* `new MockMediaRepository()` directly and seed via factories per-test.
*
* Idempotent: safe to call multiple times; each call rebuilds a fresh
* populated repo and rebinds the symbol.
*/
export async function bindDevSeedMedia(): Promise<void> {
if (mediaContainer.isBound(MEDIA_SYMBOLS.IMediaRepository)) {
mediaContainer.unbind(MEDIA_SYMBOLS.IMediaRepository);
}
const repo = new MockMediaRepository();
for (const media of buildDevMedia()) {
await repo._store(media);
}
mediaContainer
.bind<IMediaRepository>(MEDIA_SYMBOLS.IMediaRepository)
.toConstantValue(repo);
}