@saptools/cf-inspector 0.6.2 → 0.7.0

package/dist/index.d.ts

@@ -170,6 +170,7 @@ interface SnapshotCaptureResult {
     readonly captures: readonly CapturedExpression[];
     readonly stack?: readonly FrameSnapshot[];
     readonly exception?: ExceptionSnapshot;
+    readonly isolate?: InspectorIsolate;
 }
 interface SnapshotResult extends SnapshotCaptureResult {
     readonly pausedDurationMs: number | null;
@@ -184,7 +185,14 @@ interface WatchEvent {
     readonly captures: readonly CapturedExpression[];
     readonly stack?: readonly FrameSnapshot[];
     readonly exception?: ExceptionSnapshot;
+    readonly isolate?: InspectorIsolate;
 }
+type InspectorIsolate = {
+    readonly kind: "main";
+} | {
+    readonly kind: "worker";
+    readonly workerId: string;
+};
 interface ScriptInfo {
     readonly scriptId: string;
     readonly url: string;
@@ -208,6 +216,7 @@ interface InspectorConnectOptions {
     readonly connectTimeoutMs?: number;
     readonly targetIndex?: number;
     readonly workerIndex?: number;
+    readonly workerId?: string;
 }
 
 declare function parseBreakpointSpec(input: string): BreakpointLocation;
@@ -289,8 +298,19 @@ interface InspectorVersion {
     readonly browser: string;
     readonly protocolVersion: string;
 }
+interface InspectorKeepaliveOptions {
+    readonly intervalMs?: number;
+    readonly probeTimeoutMs?: number;
+    readonly failureThreshold?: number;
+    readonly probe?: () => Promise<unknown>;
+}
+interface InspectorKeepalive {
+    readonly failure: Promise<never>;
+    cancel(): void;
+}
 declare function discoverInspectorTargets(host: string, port: number, timeoutMs: number): Promise<readonly InspectorTarget[]>;
 declare function fetchInspectorVersion(host: string, port: number, timeoutMs: number): Promise<InspectorVersion>;
+declare function startInspectorKeepalive(host: string, port: number, options?: InspectorKeepaliveOptions): InspectorKeepalive;
 
 /**
  * Internal coordination flag between the always-on `Debugger.paused` buffer in
@@ -302,7 +322,9 @@ interface PauseWaitGate {
     active: boolean;
 }
 interface DebuggerState {
+    currentPause?: PauseEvent;
     lastResumedAtMs?: number;
+    paused?: boolean;
 }
 interface InspectorSession {
     readonly client: CdpClient;
@@ -311,6 +333,7 @@ interface InspectorSession {
     readonly pauseBuffer: PauseEvent[];
     readonly pauseWaitGate: PauseWaitGate;
     readonly debuggerState: DebuggerState;
+    readonly isolate?: InspectorIsolate;
     readonly targetIndex?: number;
     readonly targetCount?: number;
     readonly workerIndex?: number;
@@ -318,6 +341,16 @@ interface InspectorSession {
     readonly workerDiscoverySupported?: boolean;
     dispose(): Promise<void>;
 }
+interface InspectorSessionGroup {
+    readonly targetIndex: number;
+    readonly targetCount: number;
+    readonly workerDiscoverySupported: boolean;
+    list(): readonly InspectorSession[];
+    onSession(listener: (session: InspectorSession) => void): () => void;
+    onSessionRemoved(listener: (session: InspectorSession) => void): () => void;
+    onError(listener: (error: Error) => void): () => void;
+    dispose(): Promise<void>;
+}
 interface InspectorWorkerTarget {
     readonly sessionId: string;
     readonly workerId: string;
@@ -373,6 +406,40 @@ declare function setBreakpointAtLocation(session: InspectorSession, input: SetBr
 
 declare function waitForPause(session: InspectorSession, options: WaitForPauseOptions): Promise<PauseEvent>;
 
+interface SessionBreakpointSetup {
+    readonly handles: readonly BreakpointHandle[];
+}
+interface IsolatePause {
+    readonly session: InspectorSession;
+    readonly pause: PauseEvent;
+}
+interface FanoutCleanupSummary {
+    readonly attempted: number;
+    readonly cleared: number;
+    readonly resumed: number;
+}
+declare class BreakpointFanout {
+    private readonly records;
+    private readonly setupErrors;
+    private readonly detach;
+    private readonly detachRemoved;
+    private readonly detachError;
+    private activeRace;
+    private pauseReasons;
+    constructor(group: InspectorSessionGroup, setupSession: (session: InspectorSession, trackHandle: (handle: BreakpointHandle) => void) => Promise<SessionBreakpointSetup>, pauseReasons?: readonly string[]);
+    ready(): Promise<void>;
+    trackHandle(session: InspectorSession, handle: BreakpointHandle): void;
+    availableOutcomes(): readonly {
+        readonly session: InspectorSession;
+        readonly setup: SessionBreakpointSetup;
+    }[];
+    waitForFirst(timeoutMs: number, options?: Omit<WaitForPauseOptions, "timeoutMs" | "breakpointIds" | "signal">, signal?: AbortSignal): Promise<IsolatePause>;
+    resumePaused(except?: InspectorSession): Promise<number>;
+    cleanup(timeoutMs?: number, preservePaused?: InspectorSession): Promise<FanoutCleanupSummary>;
+    private resumePausedLosers;
+    private ownsCurrentPause;
+}
+
 type PauseOnExceptionsState = "none" | "uncaught" | "caught" | "all";
 interface EvaluateOnFrameOptions {
     readonly throwOnSideEffect?: boolean;
@@ -398,6 +465,7 @@ declare function releaseObject(session: InspectorSession, objectId: string): Pro
 declare function releaseObjectGroup(session: InspectorSession, objectGroup: string): Promise<void>;
 
 declare function connectInspector(options: InspectorConnectOptions): Promise<InspectorSession>;
+declare function connectInspectorGroup(options: Omit<InspectorConnectOptions, "workerIndex" | "workerId">): Promise<InspectorSessionGroup>;
 
 interface CaptureSnapshotOptions {
     readonly captures?: readonly string[];
@@ -434,6 +502,7 @@ interface LogpointEvent {
     readonly raw?: string;
     readonly truncated?: true;
     readonly originalLength?: number;
+    readonly isolate?: InspectorIsolate;
 }
 
 type LogpointStopReason = "duration" | "signal" | "transport-closed" | "max-events";
@@ -482,4 +551,4 @@ interface OpenedTunnel {
 declare function openOwnedCfTunnel(target: TunnelTarget): Promise<OpenedTunnel>;
 declare function openCfTunnel(target: TunnelTarget): Promise<OpenedTunnel>;
 
-export { type BreakLocation, type BreakpointHandle, type BreakpointLocation, type CallFrameInfo, type CaptureSnapshotOptions, type CapturedExpression, CfInspectorError, type CfInspectorErrorCode, type DebuggerState, type EvaluateOnFrameOptions, type ExactBreakpointHandle, type ExceptionSnapshot, type FrameSnapshot, type GetPossibleBreakpointsOptions, type InspectorConnectOptions, type InspectorSession, type InspectorTarget, type InspectorWorkerTarget, type LogpointConditionOptions, type LogpointEvent, type LogpointStopReason, type LogpointStreamOptions, type LogpointStreamResult, type OpenedTunnel, type PauseEvent, type PauseOnExceptionsState, type RemoteObjectInfo, type RemoteRootSetting, type ResolvedLocation, type ScopeInfo, type ScopeSnapshot, type ScriptInfo, type ScriptLocation, type SetBreakpointAtLocationInput, type SetBreakpointInput, type SnapshotCaptureResult, type SnapshotResult, type StackTraceFrameInfo, type StackTraceIdInfo, type StackTraceInfo, type StepIntoOptions, type TunnelTarget, type VariableSnapshot, type WaitForPauseOptions, type WalkStackOptions, type WatchEvent, buildBreakpointUrlRegex, buildHitCountedCondition, buildLogpointCondition, captureException, captureSnapshot, connectInspector, discoverInspectorTargets, evaluateGlobal, evaluateOnFrame, fetchInspectorVersion, getPossibleBreakpoints, getProperties, getScriptSource, listScripts, openCfTunnel, openOwnedCfTunnel, parseBreakpointSpec, parseRemoteRoot, releaseObject, releaseObjectGroup, removeBreakpoint, resume, runSetupEvals, setAsyncCallStackDepth, setBreakpoint, setBreakpointAtLocation, setPauseOnExceptions, stepInto, stepOut, stepOver, streamLogpoint, validateExpression, waitForPause, walkStack };
+export { type BreakLocation, BreakpointFanout, type BreakpointHandle, type BreakpointLocation, type CallFrameInfo, type CaptureSnapshotOptions, type CapturedExpression, CfInspectorError, type CfInspectorErrorCode, type DebuggerState, type EvaluateOnFrameOptions, type ExactBreakpointHandle, type ExceptionSnapshot, type FrameSnapshot, type GetPossibleBreakpointsOptions, type InspectorConnectOptions, type InspectorIsolate, type InspectorSession, type InspectorSessionGroup, type InspectorTarget, type InspectorWorkerTarget, type LogpointConditionOptions, type LogpointEvent, type LogpointStopReason, type LogpointStreamOptions, type LogpointStreamResult, type OpenedTunnel, type PauseEvent, type PauseOnExceptionsState, type RemoteObjectInfo, type RemoteRootSetting, type ResolvedLocation, type ScopeInfo, type ScopeSnapshot, type ScriptInfo, type ScriptLocation, type SetBreakpointAtLocationInput, type SetBreakpointInput, type SnapshotCaptureResult, type SnapshotResult, type StackTraceFrameInfo, type StackTraceIdInfo, type StackTraceInfo, type StepIntoOptions, type TunnelTarget, type VariableSnapshot, type WaitForPauseOptions, type WalkStackOptions, type WatchEvent, buildBreakpointUrlRegex, buildHitCountedCondition, buildLogpointCondition, captureException, captureSnapshot, connectInspector, connectInspectorGroup, discoverInspectorTargets, evaluateGlobal, evaluateOnFrame, fetchInspectorVersion, getPossibleBreakpoints, getProperties, getScriptSource, listScripts, openCfTunnel, openOwnedCfTunnel, parseBreakpointSpec, parseRemoteRoot, releaseObject, releaseObjectGroup, removeBreakpoint, resume, runSetupEvals, setAsyncCallStackDepth, setBreakpoint, setBreakpointAtLocation, setPauseOnExceptions, startInspectorKeepalive, stepInto, stepOut, stepOver, streamLogpoint, validateExpression, waitForPause, walkStack };