Initial commit

turbo/generators/templates/feature/src/di/bind-dev-seed.test.ts.hbs

@@ -0,0 +1,56 @@
+import "reflect-metadata";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { NoopTracer, NoopLogger } from "@repo/core-shared/instrumentation";
+import { bindDevSeed{{pascalCase name}} } from "@/di/bind-dev-seed";
+import { {{camelCase name}}Container } from "@/di/container";
+import { {{constantCase name}}_SYMBOLS } from "@/di/symbols";
+import { Mock{{pascalCase entity}}Repository } from "@/infrastructure/repositories/{{kebabCase entity}}.repository.mock";
+import type { I{{pascalCase entity}}Repository } from "@/application/repositories/{{kebabCase entity}}.repository.interface";
+
+const noop = { tracer: new NoopTracer(), logger: new NoopLogger() };
+
+describe("bindDevSeed{{pascalCase name}}", () => {
+  beforeEach(() => {
+    if ({{camelCase name}}Container.isBound({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)) {
+      {{camelCase name}}Container.unbind({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository);
+    }
+    {{camelCase name}}Container
+      .bind<I{{pascalCase entity}}Repository>({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)
+      .to(Mock{{pascalCase entity}}Repository);
+  });
+
+  afterEach(() => {
+    if ({{camelCase name}}Container.isBound({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)) {
+      {{camelCase name}}Container.unbind({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository);
+    }
+    {{camelCase name}}Container
+      .bind<I{{pascalCase entity}}Repository>({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)
+      .to(Mock{{pascalCase entity}}Repository);
+  });
+
+  it("populates the repository with the dev seed", async () => {
+    await bindDevSeed{{pascalCase name}}(noop);
+
+    const repo = {{camelCase name}}Container.get<I{{pascalCase entity}}Repository>(
+      {{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository,
+    );
+    const found = await repo.get{{pascalCase entity}}("dev-1");
+
+    expect(found).not.toBeNull();
+    expect(found?.id).toBe("dev-1");
+  });
+
+  it("is idempotent — calling twice rebuilds a fresh populated repo", async () => {
+    await bindDevSeed{{pascalCase name}}(noop);
+    const before = {{camelCase name}}Container.get<I{{pascalCase entity}}Repository>(
+      {{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository,
+    );
+
+    await bindDevSeed{{pascalCase name}}(noop);
+    const after = {{camelCase name}}Container.get<I{{pascalCase entity}}Repository>(
+      {{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository,
+    );
+
+    expect(after).not.toBe(before);
+  });
+});

turbo/generators/templates/feature/src/di/bind-dev-seed.ts.hbs

@@ -0,0 +1,100 @@
+import {
+  withSpan,
+  withCapture,
+  INSTRUMENTATION_SYMBOLS,
+  type ITracer,
+  type ILogger,
+} from "@repo/core-shared/instrumentation";
+import type { BindContext } from "@repo/core-shared/di";
+import {
+  assertFeatureConformance,
+  wireUseCase,
+} from "@repo/core-shared/conformance";
+import { {{camelCase name}}Manifest } from "../feature.manifest";
+import { {{camelCase name}}Container } from "./container";
+import { {{constantCase name}}_SYMBOLS } from "./symbols";
+import { Mock{{pascalCase entity}}Repository } from "../infrastructure/repositories/{{kebabCase entity}}.repository.mock";
+import { buildDev{{pascalCase entity}}Map } from "../__seeds__/dev";
+import { get{{pascalCase entity}}UseCase } from "../application/use-cases/get-{{kebabCase entity}}.use-case";
+import { get{{pascalCase entity}}Controller } from "../interface-adapters/controllers/get-{{kebabCase entity}}.controller";
+import type { I{{pascalCase entity}}Repository } from "../application/repositories/{{kebabCase entity}}.repository.interface";
+
+/**
+ * Replace the default mock with a populated one for dev mode + storybook.
+ *
+ * Mutually exclusive with `bindProduction{{pascalCase name}}(ctx)`.
+ * Tests must NOT call this — they construct `new Mock{{pascalCase entity}}Repository()`
+ * 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 bindDevSeed{{pascalCase name}}(ctx: BindContext): Promise<void> {
+  const { tracer, logger, bus, queue, realtime, realtimeRegistry } = ctx;
+
+  // Bind shared instrumentation into feature container
+  if ({{camelCase name}}Container.isBound(INSTRUMENTATION_SYMBOLS.TRACER)) {
+    {{camelCase name}}Container.unbind(INSTRUMENTATION_SYMBOLS.TRACER);
+  }
+  if ({{camelCase name}}Container.isBound(INSTRUMENTATION_SYMBOLS.LOGGER)) {
+    {{camelCase name}}Container.unbind(INSTRUMENTATION_SYMBOLS.LOGGER);
+  }
+  {{camelCase name}}Container.bind<ITracer>(INSTRUMENTATION_SYMBOLS.TRACER).toConstantValue(tracer);
+  {{camelCase name}}Container.bind<ILogger>(INSTRUMENTATION_SYMBOLS.LOGGER).toConstantValue(logger);
+
+  if ({{camelCase name}}Container.isBound({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)) {
+    {{camelCase name}}Container.unbind({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository);
+  }
+  const repo = new Mock{{pascalCase entity}}Repository(buildDev{{pascalCase entity}}Map(), tracer, logger);
+  {{camelCase name}}Container
+    .bind<I{{pascalCase entity}}Repository>({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)
+    .toConstantValue(repo);
+
+  // Use case
+  const wrappedGet{{pascalCase entity}} = wireUseCase({
+    container: {{camelCase name}}Container,
+    symbol: {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}UseCase,
+    factory: get{{pascalCase entity}}UseCase,
+    deps: [repo],
+    feature: "{{kebabCase name}}",
+    layer: "use-case",
+    name: "get{{pascalCase entity}}",
+    tracer,
+    logger,
+  });
+
+  if ({{camelCase name}}Container.isBound({{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller)) {
+    {{camelCase name}}Container.unbind({{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller);
+  }
+  {{camelCase name}}Container
+    .bind({{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller)
+    .toConstantValue(
+      withSpan(
+        tracer,
+        { name: "{{camelCase name}}.get{{pascalCase entity}}", op: "controller" },
+        withCapture(
+          logger,
+          { feature: "{{kebabCase name}}", layer: "controller", name: "{{camelCase name}}.get{{pascalCase entity}}" },
+          get{{pascalCase entity}}Controller(wrappedGet{{pascalCase entity}}),
+        ),
+      ),
+    );
+  // bus + queue are passed through; generated handlers consume them at the anchors below.
+  void bus;
+  void queue;
+  void realtime;
+  void realtimeRegistry;
+  // <gen:event-handlers>
+  // <gen:jobs>
+  // <gen:realtime-handlers>
+
+  // Boot-time conformance check (dev-seed mode).
+  assertFeatureConformance(
+    {{camelCase name}}Container,
+    {{camelCase name}}Manifest,
+    {
+      get{{pascalCase entity}}: {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}UseCase,
+    },
+    ctx,
+  );
+}

turbo/generators/templates/feature/src/di/bind-production.ts.hbs

@@ -0,0 +1,91 @@
+import {
+  withSpan,
+  withCapture,
+  INSTRUMENTATION_SYMBOLS,
+  type ITracer,
+  type ILogger,
+} from "@repo/core-shared/instrumentation";
+import type { BindProductionContext } from "@repo/core-shared/di";
+import {
+  assertFeatureConformance,
+  wireUseCase,
+} from "@repo/core-shared/conformance";
+import { {{camelCase name}}Container } from "./container";
+import { {{constantCase name}}_SYMBOLS } from "./symbols";
+import { {{camelCase name}}Manifest } from "../feature.manifest";
+import { {{pascalCase entity}}Repository } from "../infrastructure/repositories/{{kebabCase entity}}.repository";
+import { get{{pascalCase entity}}UseCase } from "../application/use-cases/get-{{kebabCase entity}}.use-case";
+import { get{{pascalCase entity}}Controller } from "../interface-adapters/controllers/get-{{kebabCase entity}}.controller";
+
+export function bindProduction{{pascalCase name}}(ctx: BindProductionContext): void {
+  const { config, tracer, logger, bus, queue, realtime, realtimeRegistry } = ctx;
+
+  // Bind shared instrumentation into feature container
+  if ({{camelCase name}}Container.isBound(INSTRUMENTATION_SYMBOLS.TRACER)) {
+    {{camelCase name}}Container.unbind(INSTRUMENTATION_SYMBOLS.TRACER);
+  }
+  if ({{camelCase name}}Container.isBound(INSTRUMENTATION_SYMBOLS.LOGGER)) {
+    {{camelCase name}}Container.unbind(INSTRUMENTATION_SYMBOLS.LOGGER);
+  }
+  {{camelCase name}}Container.bind<ITracer>(INSTRUMENTATION_SYMBOLS.TRACER).toConstantValue(tracer);
+  {{camelCase name}}Container.bind<ILogger>(INSTRUMENTATION_SYMBOLS.LOGGER).toConstantValue(logger);
+
+  // Real repository
+  if ({{camelCase name}}Container.isBound({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)) {
+    {{camelCase name}}Container.unbind({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository);
+  }
+  const repo = new {{pascalCase entity}}Repository(config, tracer, logger);
+  {{camelCase name}}Container
+    .bind({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository)
+    .toConstantValue(repo);
+
+  // Use case
+  const wrappedGet{{pascalCase entity}} = wireUseCase({
+    container: {{camelCase name}}Container,
+    symbol: {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}UseCase,
+    factory: get{{pascalCase entity}}UseCase,
+    deps: [repo],
+    feature: "{{kebabCase name}}",
+    layer: "use-case",
+    name: "get{{pascalCase entity}}",
+    tracer,
+    logger,
+  });
+
+  // Controller — wrapped with span at bind time
+  if ({{camelCase name}}Container.isBound({{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller)) {
+    {{camelCase name}}Container.unbind({{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller);
+  }
+  {{camelCase name}}Container
+    .bind({{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller)
+    .toConstantValue(
+      withSpan(
+        tracer,
+        { name: "{{camelCase name}}.get{{pascalCase entity}}", op: "controller" },
+        withCapture(
+          logger,
+          { feature: "{{kebabCase name}}", layer: "controller", name: "{{camelCase name}}.get{{pascalCase entity}}" },
+          get{{pascalCase entity}}Controller(wrappedGet{{pascalCase entity}}),
+        ),
+      ),
+    );
+  // bus + queue are passed through; generated handlers consume them at the anchors below.
+  void bus;
+  void queue;
+  void realtime;
+  void realtimeRegistry;
+  // <gen:event-handlers>
+  // <gen:jobs>
+  // <gen:realtime-handlers>
+
+  // Boot-time conformance check: refuses to start if any use-case binding
+  // is missing a required brand (withSpan / withCapture / withAudit).
+  assertFeatureConformance(
+    {{camelCase name}}Container,
+    {{camelCase name}}Manifest,
+    {
+      get{{pascalCase entity}}: {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}UseCase,
+    },
+    ctx,
+  );
+}

turbo/generators/templates/feature/src/di/container.test.ts.hbs

@@ -0,0 +1,40 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { {{camelCase name}}Container } from "./container";
+import { {{constantCase name}}_SYMBOLS } from "./symbols";
+import { {{pascalCase name}}Module } from "./module";
+import { Mock{{pascalCase entity}}Repository } from "@/infrastructure/repositories/{{kebabCase entity}}.repository.mock";
+import type { I{{pascalCase entity}}Repository } from "@/application/repositories/{{kebabCase entity}}.repository.interface";
+import type { IGet{{pascalCase entity}}UseCase } from "@/application/use-cases/get-{{kebabCase entity}}.use-case";
+import type { IGet{{pascalCase entity}}Controller } from "@/interface-adapters/controllers/get-{{kebabCase entity}}.controller";
+
+describe("{{camelCase name}}Container", () => {
+  beforeEach(() => {
+    {{camelCase name}}Container.unbindAll();
+    {{camelCase name}}Container.load({{pascalCase name}}Module);
+  });
+
+  afterEach(() => {
+    {{camelCase name}}Container.unbindAll();
+  });
+
+  it("resolves I{{pascalCase entity}}Repository to Mock{{pascalCase entity}}Repository", () => {
+    const repo = {{camelCase name}}Container.get<I{{pascalCase entity}}Repository>(
+      {{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository,
+    );
+    expect(repo).toBeInstanceOf(Mock{{pascalCase entity}}Repository);
+  });
+
+  it("resolves IGet{{pascalCase entity}}UseCase as a function", () => {
+    const useCase = {{camelCase name}}Container.get<IGet{{pascalCase entity}}UseCase>(
+      {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}UseCase,
+    );
+    expect(typeof useCase).toBe("function");
+  });
+
+  it("resolves IGet{{pascalCase entity}}Controller as a function", () => {
+    const controller = {{camelCase name}}Container.get<IGet{{pascalCase entity}}Controller>(
+      {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller,
+    );
+    expect(typeof controller).toBe("function");
+  });
+});

turbo/generators/templates/feature/src/di/container.ts.hbs

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

turbo/generators/templates/feature/src/di/module.ts.hbs

@@ -0,0 +1,39 @@
+import { ContainerModule, type interfaces } from "inversify";
+
+import type { I{{pascalCase entity}}Repository } from "../application/repositories/{{kebabCase entity}}.repository.interface";
+import { Mock{{pascalCase entity}}Repository } from "../infrastructure/repositories/{{kebabCase entity}}.repository.mock";
+import {
+  get{{pascalCase entity}}UseCase,
+  type IGet{{pascalCase entity}}UseCase,
+} from "../application/use-cases/get-{{kebabCase entity}}.use-case";
+import {
+  get{{pascalCase entity}}Controller,
+  type IGet{{pascalCase entity}}Controller,
+} from "../interface-adapters/controllers/get-{{kebabCase entity}}.controller";
+import { {{constantCase name}}_SYMBOLS } from "./symbols";
+
+export const {{pascalCase name}}Module = new ContainerModule((bind: interfaces.Bind) => {
+  bind<I{{pascalCase entity}}Repository>({{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository).to(
+    Mock{{pascalCase entity}}Repository,
+  );
+
+  bind<IGet{{pascalCase entity}}UseCase>(
+    {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}UseCase,
+  ).toDynamicValue((ctx) =>
+    get{{pascalCase entity}}UseCase(
+      ctx.container.get<I{{pascalCase entity}}Repository>(
+        {{constantCase name}}_SYMBOLS.I{{pascalCase entity}}Repository,
+      ),
+    ),
+  );
+
+  bind<IGet{{pascalCase entity}}Controller>(
+    {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}Controller,
+  ).toDynamicValue((ctx) =>
+    get{{pascalCase entity}}Controller(
+      ctx.container.get<IGet{{pascalCase entity}}UseCase>(
+        {{constantCase name}}_SYMBOLS.IGet{{pascalCase entity}}UseCase,
+      ),
+    ),
+  );
+});

turbo/generators/templates/feature/src/di/symbols.ts.hbs

@@ -0,0 +1,10 @@
+export const {{constantCase name}}_SYMBOLS = {
+  I{{pascalCase entity}}Repository: Symbol.for("{{kebabCase name}}:I{{pascalCase entity}}Repository"),
+  // Use cases
+  IGet{{pascalCase entity}}UseCase: Symbol.for("{{kebabCase name}}:IGet{{pascalCase entity}}UseCase"),
+  // Controllers
+  IGet{{pascalCase entity}}Controller: Symbol.for("{{kebabCase name}}:IGet{{pascalCase entity}}Controller"),
+  // <gen:event-handler-symbols>
+  // <gen:job-symbols>
+  // <gen:realtime-handler-symbols>
+} as const;