Abstract Class: BaseRepository<TClient, TTx = `TClient`>

Defined in: server/persistence/base-repository.ts:54

Base repository providing transaction routing, audit-field helpers, and opt-in activity logging. Extend one of the specialized classes instead of using this directly:

• ReadRepository — read-only
• WriteRepository — create + update (append-only)
• CrudRepository — full CRUD (most common)
• VersionRepository — parent-child versioning

TClient is the consumer's generated Prisma client (for model accessors on this.tx). TTx is the transaction handle type (the inner argument of prisma.$transaction(fn)); it defaults to TClient because modern Prisma transaction handles are structurally compatible with the top-level client apart from the $-prefixed control methods.

Extended byCopy Anchor Link

• ReadRepository
• DecisionLogRepository
• BackgroundJobRunRepository
• DataTableViewsRepository
• FormSchemaRuleRepository
• SavedReportsRepository
• ReportScheduleRepository

Type ParametersCopy Anchor Link

ConstructorsCopy Anchor Link

ConstructorCopy Anchor Link

new BaseRepository<TClient, TTx = TClient>(prismaClient: PrismaClientLike<TTx> & TClient, options?: RepositoryOptions): BaseRepository<TClient, TTx>;

Defined in: server/persistence/base-repository.ts:68

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

BaseRepository<TClient, TTx>

PropertiesCopy Anchor Link

ENTITY_TYPE?Copy Anchor Link

protected readonly optional ENTITY_TYPE?: string;

Defined in: server/persistence/base-repository.ts:61

Set ENTITY_TYPE in child repositories to enable automatic activity logging. When set, create/update/delete operations auto-log unless silenced with .silent. Requires an activity model on the consumer's Prisma schema.

logger?Copy Anchor Link

protected readonly optional logger?: Logger;

Defined in: server/persistence/base-repository.ts:64

prismaClientCopy Anchor Link

protected prismaClient: PrismaClientLike<TTx> & TClient;

Defined in: server/persistence/base-repository.ts:69

AccessorsCopy Anchor Link

actorIdCopy Anchor Link

Get SignatureCopy Anchor Link

get protected actorId(): string | null | undefined;

Defined in: server/persistence/base-repository.ts:76

ReturnsCopy Anchor Link

string | null | undefined

auditCreateCopy Anchor Link

Get SignatureCopy Anchor Link

get protected auditCreate(): {
  createdBy: string | null | undefined;
  updatedBy: string | null | undefined;
};

Defined in: server/persistence/base-repository.ts:90

ReturnsCopy Anchor Link

{
  createdBy: string | null | undefined;
  updatedBy: string | null | undefined;
}

createdByCopy Anchor Link

createdBy: string | null | undefined = actorId;

updatedByCopy Anchor Link

updatedBy: string | null | undefined = actorId;

auditDeleteCopy Anchor Link

Get SignatureCopy Anchor Link

get protected auditDelete(): {
  deletedAt: Date;
  deletedBy: string | null | undefined;
};

Defined in: server/persistence/base-repository.ts:99

ReturnsCopy Anchor Link

{
  deletedAt: Date;
  deletedBy: string | null | undefined;
}

deletedAtCopy Anchor Link

deletedAt: Date;

deletedByCopy Anchor Link

deletedBy: string | null | undefined;

auditUpdateCopy Anchor Link

Get SignatureCopy Anchor Link

get protected auditUpdate(): {
  updatedBy: string | null | undefined;
};

Defined in: server/persistence/base-repository.ts:95

ReturnsCopy Anchor Link

{
  updatedBy: string | null | undefined;
}

updatedByCopy Anchor Link

updatedBy: string | null | undefined;

silentCopy Anchor Link

Get SignatureCopy Anchor Link

get silent(): this;

Defined in: server/persistence/base-repository.ts:115

Suppress activity logging for the next mutation call. One-shot: the flag is consumed by the next create/update/delete.

ExampleCopy Anchor Link

await repo.silent.update(id, data);   // no activity logged
await repo.update(id, data);          // activity logged normally

ReturnsCopy Anchor Link

this

txCopy Anchor Link

Get SignatureCopy Anchor Link

get protected tx(): TTx;

Defined in: server/persistence/base-repository.ts:86

The current Prisma handle: the active transaction if one is running on this async context, otherwise the raw client.

ReturnsCopy Anchor Link

TTx

MethodsCopy Anchor Link

consumeSilent()Copy Anchor Link

protected consumeSilent(): boolean;

Defined in: server/persistence/base-repository.ts:128

Consume and reset the silent flag. Called by template methods.

ReturnsCopy Anchor Link

boolean

logActivity()Copy Anchor Link

protected logActivity(
   _entityId: string, 
   _action: string, 
   _metadata?: Record<string, unknown>
): Promise<void>;

Defined in: server/persistence/base-repository.ts:140

Log an activity entry.

NOTE: This is not implemented because there's no activity model implemented in taproot yet! https://linear.app/kaizenlabs/issue/ENG-7846/add-activity-log-tables

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<void>