bayes-platform: Skill for Claude Code

Custom repository

Services do not use TypeORM. Persistence goes through an @Injectable() {Entity}Repository whose public methods are named for the operation. The repository reads the TypeORM manager from TransactionService at call time, so a call inside transactionService.run() joins that transaction.

This skill explains how to add one. It does not replace:

• .cursor/rules/api-custom-repositories.mdc — the rule Cursor applies on service and repository files
• .claude/skills/crud-generator/SKILL.md — emits a repository as part of full CRUD boilerplate
• ADR 0020 — why TypeORM stays out of services

Many existing services still inject Repository<T>. Do not copy them.

Add a repository

Create apps/api/src/domains/{domain}/{entity}.repository.ts:

import { Injectable } from "@nestjs/common"
import type { Repository } from "typeorm"
// biome-ignore lint/style/useImportType: Required at runtime for NestJS DI
import { TransactionService } from "@/common/transaction/transaction.service"
import { Project } from "./project.entity"

export type ProjectRecord = {
  id: string
  organizationId: string
  name: string
}

@Injectable()
export class ProjectRepository {
  constructor(private readonly transactionService: TransactionService) {}

  async createProject(params: { organizationId: string; name: string }): Promise<ProjectRecord> {
    const saved = await this.repo().save(this.repo().create(params))
    return { id: saved.id, organizationId: saved.organizationId, name: saved.name }
  }

  private repo(): Repository<Project> {
    return this.transactionService.getManager().getRepository(Project)
  }
}

Rules for that file:

• TransactionService is a value import with the biome-ignore comment. A type-only import is undefined at runtime and Nest cannot inject it.
• Call getManager().getRepository(Entity) inside the method (via a private repo()), not in the constructor. getManager() returns the manager stored for the current transactionService.run(), or the default manager outside one.
• Public methods take and return plain values, records, or the entity. They do not accept or return Repository<T>, SelectQueryBuilder, FindOperator, or EntityManager.
• Name the method for the operation (createProject, findSummariesByProject, softDelete). Do not expose find, save, or create.
• Raw SQL, when it is needed, uses this.transactionService.getManager().query(...) so it joins the same transaction. See platform-role.repository.ts.