taphound 0.2.0-dev.1

package/dist/adapters/filesystem/generation-session-store.d.ts

@@ -0,0 +1,68 @@
+import { type GenerationInFlight, type GenerationSession, type PendingConfirmation } from "../../domain/generation.js";
+import { type GenerationSessionStore } from "../../ports/generation-session-store.js";
+export interface FileSystemGenerationSessionStoreOptions {
+    lockTimeoutMs?: number;
+    lockRetryMs?: number;
+    now?: (() => Date) | undefined;
+    hooks?: FileSystemGenerationSessionStoreHooks;
+}
+export interface FileSystemGenerationSessionStoreHooks {
+    beforeLockStagingWrite?: () => Promise<void> | void;
+    beforeLockInstall?: () => Promise<void> | void;
+    afterLockTombstoneRename?: () => Promise<void> | void;
+    afterStateOpen?: () => Promise<void> | void;
+    beforeStateRename?: () => Promise<void> | void;
+    beforePublishRename?: () => Promise<void> | void;
+    beforeEvidenceInstall?: () => Promise<void> | void;
+    afterEvidenceInstall?: () => Promise<void> | void;
+    afterEvidenceOpen?: (path: string) => Promise<void> | void;
+    afterEvidenceRead?: (path: string) => Promise<void> | void;
+    afterEvidenceDirectoryRead?: (path: string, phase: "beforeTraversal" | "afterTraversal") => Promise<void> | void;
+    afterDirectorySync?: (path: string) => Promise<void> | void;
+}
+export declare class FileSystemGenerationSessionStore implements GenerationSessionStore {
+    private readonly projectRoot;
+    private readonly generationRoot;
+    private readonly locksRoot;
+    private readonly options;
+    private readonly now;
+    private readonly hooks;
+    constructor(projectRoot: string, options?: FileSystemGenerationSessionStoreOptions);
+    readonly create: (input: GenerationSession) => Promise<void>;
+    readonly read: (id: string) => Promise<GenerationSession>;
+    readonly update: (id: string, expectedRevision: number, input: GenerationSession) => Promise<void>;
+    readonly commitSnapshot: (id: string, expectedRevision: number, input: GenerationSession) => Promise<void>;
+    readonly updateConfirmation: (id: string, expectedRevision: number, input: GenerationSession) => Promise<void>;
+    readonly beginStep: (id: string, expectedRevision: number, inFlightInput: GenerationInFlight, approvedConfirmationInput?: PendingConfirmation) => Promise<GenerationSession>;
+    readonly completeStep: (id: string, expectedRevision: number, expectedInFlightInput: GenerationInFlight, input: GenerationSession) => Promise<void>;
+    readonly recover: (id: string, expectedRevision: number, input: GenerationSession) => Promise<void>;
+    readonly beginVerification: (id: string, expectedRevision: number, attemptId: string) => Promise<GenerationSession>;
+    readonly completeVerification: (id: string, expectedRevision: number, input: GenerationSession) => Promise<void>;
+    readonly failVerification: (id: string, expectedRevision: number, input: GenerationSession) => Promise<void>;
+    readonly markBundlePublishable: (id: string, expectedRevision: number, input: GenerationSession) => Promise<void>;
+    readonly writeEvidence: (id: string, relativePath: string, value: unknown) => Promise<void>;
+    readonly writeTextEvidence: (id: string, relativePath: string, value: string) => Promise<void>;
+    readonly produceEvidence: (id: string, relativePath: string, produce: (temporaryPath: string) => Promise<void>) => Promise<void>;
+    readonly readEvidence: (id: string, relativePath: string) => Promise<Buffer>;
+    readonly listEvidence: (id: string) => Promise<readonly {
+        path: string;
+        contentBase64: string;
+        byteLength: number;
+    }[]>;
+    readonly publish: (id: string) => Promise<string>;
+    private readonly ensureGenerationRoot;
+    private readonly writeVerificationTransition;
+    private readonly activeDirectory;
+    private readonly finalDirectory;
+    private readonly lockPath;
+    private readonly syncDirectory;
+    private readonly withLock;
+    private readonly acquireLock;
+    private readonly tryInstallLock;
+    private readonly reapDeadOwnerLock;
+    private readonly releaseLock;
+    private readonly readLockOwner;
+    private readonly fileIdentity;
+    private readonly isProcessAlive;
+    private assertPublishable;
+}