Class: FormSubmissionVersionRepository

Defined in: server/forms/form-submission-version-repository.ts:29

Repository for version entities in parent-child versioning patterns.

Use for entities that:

• link to a parent entity via parentId
• order versions by versionNumber
• are append-only (immutable once created)

Provides findByParentId, findLatestByParentId, getNextVersionNumber, countByParentId, and an audit-aware create.

ExtendsCopy Anchor Link

• VersionRepository<PrismaClient, FormSubmissionVersions, CreateInput, string, Tx<PrismaClient>>

ConstructorsCopy Anchor Link

ConstructorCopy Anchor Link

new FormSubmissionVersionRepository(prismaClient: PrismaClientLike<Tx<PrismaClient<PrismaClientOptions, never, DefaultArgs>>> & PrismaClient<PrismaClientOptions, never, DefaultArgs>, options?: RepositoryOptions): FormSubmissionVersionRepository;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

FormSubmissionVersionRepository

Inherited fromCopy Anchor Link

VersionRepository.constructor

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.

Inherited fromCopy Anchor Link

VersionRepository.ENTITY_TYPE

logger?Copy Anchor Link

protected readonly optional logger?: Logger;

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

Inherited fromCopy Anchor Link

VersionRepository.logger

prismaClientCopy Anchor Link

protected prismaClient: PrismaClientLike<Tx<PrismaClient<PrismaClientOptions, never, DefaultArgs>>> & PrismaClient<PrismaClientOptions, never, DefaultArgs>;

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

Inherited fromCopy Anchor Link

VersionRepository.prismaClient

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

Inherited fromCopy Anchor Link

VersionRepository.actorId

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;

Inherited fromCopy Anchor Link

VersionRepository.auditCreate

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;

Inherited fromCopy Anchor Link

VersionRepository.auditDelete

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;

Inherited fromCopy Anchor Link

VersionRepository.auditUpdate

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

Inherited fromCopy Anchor Link

VersionRepository.silent

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

Inherited fromCopy Anchor Link

VersionRepository.tx

MethodsCopy Anchor Link

_count()Copy Anchor Link

protected _count(): Promise<number>;

Defined in: server/forms/form-submission-version-repository.ts:55

ReturnsCopy Anchor Link

Promise<number>

OverridesCopy Anchor Link

VersionRepository._count

_countByParentId()Copy Anchor Link

protected _countByParentId(formSubmissionId: string): Promise<number>;

Defined in: server/forms/form-submission-version-repository.ts:85

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<number>

OverridesCopy Anchor Link

VersionRepository._countByParentId

_create()Copy Anchor Link

protected _create(input: CreateInput): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}>;

Defined in: server/forms/form-submission-version-repository.ts:91

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }>

OverridesCopy Anchor Link

VersionRepository._create

_exists()Copy Anchor Link

protected _exists(id: string): Promise<boolean>;

Defined in: server/forms/form-submission-version-repository.ts:48

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<boolean>

OverridesCopy Anchor Link

VersionRepository._exists

_findById()Copy Anchor Link

protected _findById(id: string): Promise<
  | {
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}
| null>;

Defined in: server/forms/form-submission-version-repository.ts:40

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise< | { changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; } | null>

OverridesCopy Anchor Link

VersionRepository._findById

_findByParentId()Copy Anchor Link

protected _findByParentId(formSubmissionId: string): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}[]>;

Defined in: server/forms/form-submission-version-repository.ts:76

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }[]>

OverridesCopy Anchor Link

VersionRepository._findByParentId

_findMany()Copy Anchor Link

protected _findMany(pagination: {
  page: number;
  pageSize: number;
}): Promise<{
  items: {
     changeReason: string | null;
     createdAt: Date;
     createdBy: string | null;
     currentStepKey: string | null;
     data: JsonValue;
     deletedAt: Date | null;
     deletedBy: string | null;
     formSchemaVersionId: string;
     formSubmissionId: string;
     id: string;
     isComplete: boolean;
     lastActivityAt: Date;
     versionNumber: number;
     visitedStepKeys: string[];
  }[];
  total: number;
}>;

Defined in: server/forms/form-submission-version-repository.ts:59

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ items: { changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }[]; total: number; }>

OverridesCopy Anchor Link

VersionRepository._findMany

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

Inherited fromCopy Anchor Link

VersionRepository.consumeSilent

count()Copy Anchor Link

count(): Promise<number>;

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

ReturnsCopy Anchor Link

Promise<number>

Inherited fromCopy Anchor Link

VersionRepository.count

countByParentId()Copy Anchor Link

countByParentId(parentId: string): Promise<number>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<number>

Inherited fromCopy Anchor Link

VersionRepository.countByParentId

create()Copy Anchor Link

create(input: CreateInput): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }>

Inherited fromCopy Anchor Link

VersionRepository.create

exists()Copy Anchor Link

exists(id: string): Promise<boolean>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<boolean>

Inherited fromCopy Anchor Link

VersionRepository.exists

findActiveDraft()Copy Anchor Link

findActiveDraft(formSubmissionId: string): Promise<
  | {
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}
| null>;

Defined in: server/forms/form-submission-version-repository.ts:137

Returns the active (in-flight) draft for a submission, or null if the user has none. The createDraft flow enforces at-most-one active draft per submission, so this is safe to assume single-row.

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise< | { changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; } | null>

findByFormSubmissionId()Copy Anchor Link

findByFormSubmissionId(formSubmissionId: string): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}[]>;

Defined in: server/forms/form-submission-version-repository.ts:116

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }[]>

findById()Copy Anchor Link

findById(id: string): Promise<
  | {
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}
| null>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise< | { changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; } | null>

Inherited fromCopy Anchor Link

VersionRepository.findById

findByIdOrThrow()Copy Anchor Link

findByIdOrThrow(id: string): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }>

Inherited fromCopy Anchor Link

VersionRepository.findByIdOrThrow

findByParentId()Copy Anchor Link

findByParentId(parentId: string): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}[]>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }[]>

Inherited fromCopy Anchor Link

VersionRepository.findByParentId

findLatestByFormSubmissionId()Copy Anchor Link

findLatestByFormSubmissionId(formSubmissionId: string): Promise<
  | {
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}
| null>;

Defined in: server/forms/form-submission-version-repository.ts:122

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise< | { changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; } | null>

findLatestByParentId()Copy Anchor Link

findLatestByParentId(parentId: string): Promise<
  | {
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}
| null>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise< | { changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; } | null>

Inherited fromCopy Anchor Link

VersionRepository.findLatestByParentId

findMany()Copy Anchor Link

findMany(pagination: {
  page: number;
  pageSize: number;
}): Promise<OffsetPaginatedResult<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}>>;

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

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<OffsetPaginatedResult<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }>>

Inherited fromCopy Anchor Link

VersionRepository.findMany

getNextVersionNumber()Copy Anchor Link

getNextVersionNumber(parentId: string): Promise<number>;

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

Next version number = highest versionNumber among the rows _findByParentId returns, plus one. Subclasses typically filter _findByParentId to deletedAt: null, so this counts only live rows.

That is collision-safe only while the subclass never soft-deletes version rows. If a subclass gains a discard/soft-delete path AND its @@unique(parentId, versionNumber) constraint counts soft-deleted rows (Postgres unique indexes do), reusing a discarded row's number will violate the constraint. Such a subclass must override to compute the max over all rows including soft-deleted — see FormSchemaVersionRepository.nextVersionNumber. Promote that into a shared abstract hook here once a second repo needs it.

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<number>

Inherited fromCopy Anchor Link

VersionRepository.getNextVersionNumber

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>

Inherited fromCopy Anchor Link

VersionRepository.logActivity

markComplete()Copy Anchor Link

markComplete(id: string, visitedStepKeys: string[]): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}>;

Defined in: server/forms/form-submission-version-repository.ts:182

Flip a draft to completed. Freezes visitedStepKeys and clears currentStepKey (a completed submission is no longer "on" a step).

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }>

nextVersionNumber()Copy Anchor Link

nextVersionNumber(formSubmissionId: string): Promise<number>;

Defined in: server/forms/form-submission-version-repository.ts:128

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<number>

notFoundError()Copy Anchor Link

protected notFoundError(id: string): Error;

Defined in: server/forms/form-submission-version-repository.ts:36

Create a not-found error. Override to provide custom error types.

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Error

OverridesCopy Anchor Link

VersionRepository.notFoundError

updateDraft()Copy Anchor Link

updateDraft(id: string, patch: {
  currentStepKey?: string | null;
  data?: FormDataRecord;
  visitedStepKeys?: string[];
}): Promise<{
  changeReason: string | null;
  createdAt: Date;
  createdBy: string | null;
  currentStepKey: string | null;
  data: JsonValue;
  deletedAt: Date | null;
  deletedBy: string | null;
  formSchemaVersionId: string;
  formSubmissionId: string;
  id: string;
  isComplete: boolean;
  lastActivityAt: Date;
  versionNumber: number;
  visitedStepKeys: string[];
}>;

Defined in: server/forms/form-submission-version-repository.ts:153

Patch a draft's mutable fields in place. lastActivityAt is bumped on every call so admin views can flag abandoned drafts. Never flips isComplete — that happens via markComplete at submit time.

Caller is expected to have verified the row is still a draft; this method does not re-check isComplete.

ParametersCopy Anchor Link

ReturnsCopy Anchor Link

Promise<{ changeReason: string | null; createdAt: Date; createdBy: string | null; currentStepKey: string | null; data: JsonValue; deletedAt: Date | null; deletedBy: string | null; formSchemaVersionId: string; formSubmissionId: string; id: string; isComplete: boolean; lastActivityAt: Date; versionNumber: number; visitedStepKeys: string[]; }>