@devicerail/recorder 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./checkpoint.js";
+export * from "./errors.js";
+export * from "./event-log.js";
+export * from "./recorder.js";
+export * from "./source-file.js";
+export * from "./types.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./checkpoint.js";
+export * from "./errors.js";
+export * from "./event-log.js";
+export * from "./recorder.js";
+export * from "./source-file.js";
+export * from "./types.js";

package/dist/recorder.d.ts

@@ -0,0 +1,72 @@
+import { type DeviceRailClient } from "@devicerail/client";
+import type { SystemDescribeResult } from "@devicerail/protocol";
+import { type BundleSourceFile } from "./source-file.js";
+import { type RecorderBundleReceipt, type RecorderCheckpoint, type RecorderPhase } from "./types.js";
+export interface RecorderEventSource {
+    describe(): Promise<SystemDescribeResult>;
+    listEvents(sessionId: string, afterSequence: number | null, limit: number): Promise<readonly unknown[]>;
+    exportSession(sessionId: string): Promise<unknown>;
+    /** Optional negotiated bounded form of the authoritative Session export. */
+    exportSessionPage?(sessionId: string, afterSequence: number | null, limit: number): Promise<unknown>;
+}
+/** Public-protocol adapter; Session lifecycle remains owned by the host. */
+export declare class DeviceRailRecorderEventSource implements RecorderEventSource {
+    #private;
+    constructor(client: DeviceRailClient);
+    describe(): Promise<SystemDescribeResult>;
+    listEvents(sessionId: string, afterSequence: number | null, limit: number): Promise<readonly unknown[]>;
+    exportSession(sessionId: string): Promise<unknown>;
+    exportSessionPage(sessionId: string, afterSequence: number | null, limit: number): Promise<unknown>;
+}
+interface RecorderOpenBase {
+    readonly checkpointPath: string;
+    readonly sessionId: string;
+    readonly signal?: AbortSignal;
+}
+export type RecorderOpenOptions = RecorderOpenBase & ({
+    readonly client: DeviceRailClient;
+    readonly eventSource?: never;
+} | {
+    readonly client?: never;
+    readonly eventSource: RecorderEventSource;
+});
+export interface RecorderCaptureResult {
+    readonly accepted: number;
+    readonly duplicates: number;
+    readonly lastSequence: number | null;
+    readonly phase: RecorderPhase;
+}
+export interface RecorderCaptureOptions {
+    readonly signal?: AbortSignal;
+}
+export interface RecorderCaptureUntilOptions extends RecorderCaptureOptions {
+    readonly pollIntervalMs?: number;
+}
+export interface RecorderFinalizeOptions {
+    readonly executable: string;
+    readonly sourcePath: string;
+    readonly evidenceDirectory: string;
+    readonly outputDirectory: string;
+    readonly signal?: AbortSignal;
+}
+export interface RecorderOfflineOpenOptions {
+    readonly checkpointPath: string;
+}
+/** Durable, resumable consumer of one public Session event stream. */
+export declare class ExecutionRecorder {
+    #private;
+    private constructor();
+    static open(options: RecorderOpenOptions): Promise<ExecutionRecorder>;
+    /** Reopen a sealed/completed checkpoint after the daemon has stopped. */
+    static openOffline(options: RecorderOfflineOpenOptions): Promise<ExecutionRecorder>;
+    get phase(): RecorderPhase;
+    get lastSequence(): number | null;
+    get checkpoint(): RecorderCheckpoint;
+    bundleSource(): BundleSourceFile;
+    captureOnce(options?: RecorderCaptureOptions): Promise<RecorderCaptureResult>;
+    captureUntilSealed(options?: RecorderCaptureUntilOptions): Promise<BundleSourceFile>;
+    seal(options?: RecorderCaptureOptions): Promise<BundleSourceFile>;
+    publishSource(path: string, options?: RecorderCaptureOptions): Promise<void>;
+    finalize(options: RecorderFinalizeOptions): Promise<RecorderBundleReceipt>;
+}
+export {};