93 lines
3 KiB
TypeScript
93 lines
3 KiB
TypeScript
import type { AssertableState } from "./utils/assertable-state";
|
|
|
|
export interface ClientState {
|
|
files: Map<string, string>;
|
|
clientFiles: Map<string, string>[];
|
|
manifests: Record<string, string>[];
|
|
canonical: Record<string, string>;
|
|
bytes: Map<string, Uint8Array>;
|
|
}
|
|
|
|
/** A scenario's independent, complete expected state. Keys survive moves;
|
|
* a new key must receive a previously unseen UUID, including after deletion. */
|
|
export interface ExpectedDocument {
|
|
key: string;
|
|
path: string;
|
|
conflict?: boolean;
|
|
content: string | number[];
|
|
}
|
|
|
|
export type TestStep =
|
|
| { type: "create"; client: number; path: string; content: string }
|
|
| { type: "update"; client: number; path: string; content: string }
|
|
| { type: "rename"; client: number; oldPath: string; newPath: string }
|
|
| {
|
|
type: "rename-next-write";
|
|
client: number;
|
|
oldPath: string;
|
|
newPath: string;
|
|
}
|
|
| { type: "delete"; client: number; path: string }
|
|
| { type: "sync"; client?: number }
|
|
| { type: "disable-sync"; client: number }
|
|
| { type: "enable-sync"; client: number }
|
|
| { type: "pause-server" }
|
|
| { type: "resume-server" }
|
|
| {
|
|
type: "resume-server-until-history-then-pause";
|
|
client: number;
|
|
syncType: "CREATE" | "UPDATE" | "DELETE";
|
|
path: string;
|
|
}
|
|
| { type: "barrier" }
|
|
| { type: "assert-consistent"; verify?: (state: AssertableState) => void }
|
|
| { type: "pause-websocket"; client: number }
|
|
| { type: "resume-websocket"; client: number }
|
|
| {
|
|
type:
|
|
| "pause-observation"
|
|
| "resume-observation"
|
|
| "wait-for-observation";
|
|
client: number;
|
|
}
|
|
| { type: "drop-next-create-response"; client: number }
|
|
| { type: "wait-for-dropped-create-response"; client: number }
|
|
| { type: "sleep"; ms: number }
|
|
| { type: "reset"; client: number }
|
|
| { type: "create-bytes"; client: number; path: string; bytes: number[] }
|
|
| {
|
|
type: "drop-response";
|
|
client: number;
|
|
kind: "create" | "content" | "manifest";
|
|
point?: "before" | "after";
|
|
}
|
|
| { type: "wait-for-response-drop"; client: number }
|
|
| { type: "delay-notifications" | "flush-notifications"; client: number }
|
|
| {
|
|
type: "remember-identity" | "assert-identity";
|
|
path: string;
|
|
key: string;
|
|
}
|
|
| {
|
|
type: "assert-files";
|
|
expected: Record<string, string>;
|
|
absent?: string[];
|
|
count?: number;
|
|
}
|
|
| { type: "assert-markers"; markers: string[]; removed?: string[] }
|
|
| { type: "assert-documents"; expected: ExpectedDocument[] }
|
|
| { type: "crash-server" }
|
|
| { type: "restart-server" };
|
|
|
|
export interface TestDefinition {
|
|
description?: string;
|
|
clients: number;
|
|
steps: TestStep[];
|
|
}
|
|
|
|
export interface TestResult {
|
|
success: boolean;
|
|
error?: string;
|
|
duration?: number;
|
|
diagnostics?: unknown;
|
|
}
|