Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
/**
* ProjectionStateRepository - Projection repository interface for projector cursors.
*
* Owns persistence operations for projection cursor state used to resume
* incremental event projection.
*
* @module ProjectionStateRepository
*/
import { IsoDateTime, NonNegativeInt } from "@akeru/contracts";
import * as Option from "effect/Option";
import * as Schema from "effect/Schema";
import * as Context from "effect/Context";
import type * as Effect from "effect/Effect";
import type { ProjectionRepositoryError } from "../Errors.ts";
export const ProjectionState = Schema.Struct({
projector: Schema.String,
lastAppliedSequence: NonNegativeInt,
updatedAt: IsoDateTime,
});
export type ProjectionState = typeof ProjectionState.Type;
export const GetProjectionStateInput = Schema.Struct({
projector: Schema.String,
});
export type GetProjectionStateInput = typeof GetProjectionStateInput.Type;
/**
* ProjectionStateRepositoryShape - Service API for projector state records.
*/
export interface ProjectionStateRepositoryShape {
/**
* Insert or replace a projection cursor row.
*
* Upserts by projector name.
*/
readonly upsert: (row: ProjectionState) => Effect.Effect<void, ProjectionRepositoryError>;
/** Insert or replace projector cursors in one statement. Empty batches do nothing. */
readonly upsertMany: (
rows: ReadonlyArray<ProjectionState>,
) => Effect.Effect<void, ProjectionRepositoryError>;
/**
* Read projection cursor state for a projector key.
*/
readonly getByProjector: (
input: GetProjectionStateInput,
) => Effect.Effect<Option.Option<ProjectionState>, ProjectionRepositoryError>;
/**
* List all projector cursor rows.
*/
readonly listAll: () => Effect.Effect<ReadonlyArray<ProjectionState>, ProjectionRepositoryError>;
/**
* Read the minimum applied sequence across all projectors.
*
* Returns `null` when no projector state rows exist.
*/
readonly minLastAppliedSequence: () => Effect.Effect<number | null, ProjectionRepositoryError>;
}
/**
* ProjectionStateRepository - Service tag for projection cursor persistence.
*/
export class ProjectionStateRepository extends Context.Service<
ProjectionStateRepository,
ProjectionStateRepositoryShape
>()("akeru-bot/persistence/Services/ProjectionState/ProjectionStateRepository") {}