@saptools/cf-inspector 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -30,24 +30,80 @@ interface BreakpointHandle {
     readonly urlRegex: string;
     readonly resolvedLocations: readonly ResolvedLocation[];
 }
-interface ResolvedLocation {
+interface ScriptLocation {
     readonly scriptId: string;
-    readonly url?: string;
     readonly lineNumber: number;
     readonly columnNumber?: number;
 }
+interface BreakLocation extends ScriptLocation {
+    readonly type?: string;
+}
+interface ResolvedLocation extends ScriptLocation {
+    readonly url?: string;
+}
+interface GetPossibleBreakpointsOptions {
+    readonly start: ScriptLocation;
+    readonly end?: ScriptLocation;
+    readonly restrictToFunction?: boolean;
+}
+interface SetBreakpointAtLocationInput {
+    readonly location: ScriptLocation;
+    readonly condition?: string;
+}
+interface ExactBreakpointHandle {
+    readonly breakpointId: string;
+    readonly requestedLocation: ScriptLocation;
+    readonly actualLocation: ScriptLocation;
+}
+interface RemoteObjectInfo {
+    readonly type: string;
+    readonly subtype?: string;
+    readonly className?: string;
+    readonly completeness?: "truncated" | "unavailable";
+    readonly value?: unknown;
+    readonly unserializableValue?: string;
+    readonly description?: string;
+    readonly deepSerializedValue?: unknown;
+    readonly objectId?: string;
+    readonly preview?: unknown;
+    readonly customPreview?: unknown;
+}
+interface StackTraceIdInfo {
+    readonly id: string;
+    readonly debuggerId?: string;
+}
+interface StackTraceFrameInfo {
+    readonly functionName: string;
+    readonly scriptId: string;
+    readonly url: string;
+    readonly lineNumber: number;
+    readonly columnNumber: number;
+}
+interface StackTraceInfo {
+    readonly description?: string;
+    readonly callFrames: readonly StackTraceFrameInfo[];
+    readonly parent?: StackTraceInfo;
+    readonly parentId?: StackTraceIdInfo;
+}
 interface CallFrameInfo {
     readonly callFrameId: string;
     readonly functionName: string;
+    readonly scriptId?: string;
+    readonly functionLocation?: ScriptLocation;
     readonly url?: string;
     readonly lineNumber: number;
     readonly columnNumber: number;
     readonly scopeChain: readonly ScopeInfo[];
+    readonly thisObject?: RemoteObjectInfo;
+    readonly returnValue?: RemoteObjectInfo;
 }
 interface ScopeInfo {
     readonly type: string;
     readonly objectId?: string;
+    readonly object?: RemoteObjectInfo;
     readonly name?: string;
+    readonly startLocation?: ScriptLocation;
+    readonly endLocation?: ScriptLocation;
 }
 interface PauseEvent {
     readonly reason: string;
@@ -55,6 +111,9 @@ interface PauseEvent {
     readonly callFrames: readonly CallFrameInfo[];
     readonly receivedAtMs?: number;
     readonly data?: unknown;
+    readonly asyncStackTrace?: StackTraceInfo;
+    readonly asyncStackTraceId?: StackTraceIdInfo;
+    readonly asyncCallStackTraceId?: StackTraceIdInfo;
 }
 interface VariableSnapshot {
     readonly name: string;
@@ -129,6 +188,19 @@ interface WatchEvent {
 interface ScriptInfo {
     readonly scriptId: string;
     readonly url: string;
+    readonly startLine?: number;
+    readonly startColumn?: number;
+    readonly endLine?: number;
+    readonly endColumn?: number;
+    readonly executionContextId?: number;
+    readonly hash?: string;
+    readonly buildId?: string;
+    readonly executionContextAuxData?: unknown;
+    readonly sourceMapURL?: string;
+    readonly hasSourceURL?: boolean;
+    readonly isModule?: boolean;
+    readonly length?: number;
+    readonly stackTrace?: StackTraceInfo;
 }
 interface InspectorConnectOptions {
     readonly port: number;
@@ -168,6 +240,11 @@ interface CdpClientOptions {
     readonly requestTimeoutMs?: number;
     readonly connectTimeoutMs?: number;
 }
+interface CdpWaitOptions<T> {
+    readonly timeoutMs: number;
+    readonly predicate?: (params: T) => boolean;
+    readonly signal?: AbortSignal;
+}
 declare class CdpClient {
     private readonly transport;
     private readonly requestTimeoutMs;
@@ -184,16 +261,16 @@ declare class CdpClient {
     static connect(options: CdpClientOptions): Promise<CdpClient>;
     send<TResult = unknown>(method: string, params?: Record<string, unknown>): Promise<TResult>;
     on(method: string, listener: (params: unknown) => void): () => void;
-    waitFor<T = unknown>(method: string, options?: {
-        readonly timeoutMs: number;
-        readonly predicate?: (params: T) => boolean;
-    }): Promise<T>;
+    waitFor<T = unknown>(method: string, options?: CdpWaitOptions<T>): Promise<T>;
+    private createEventWait;
+    private eventMatches;
     onClose(listener: (err: Error) => void): () => void;
     dispose(): void;
     get isClosed(): boolean;
     private handleResponse;
     private createRequestTimer;
     private createWaitTimeoutError;
+    private createWaitAbortError;
     private sendPayload;
     private markClosed;
 }
@@ -285,17 +362,24 @@ interface WaitForPauseOptions {
     readonly pauseReasons?: readonly string[];
     readonly unmatchedPausePolicy?: "wait-for-resume" | "fail";
     readonly onUnmatchedPause?: (pause: PauseEvent) => void;
+    readonly signal?: AbortSignal;
 }
 
 declare function buildHitCountedCondition(hitCount: number, counterKey: string, userCondition: string | undefined): string;
 declare function setBreakpoint(session: InspectorSession, input: SetBreakpointInput): Promise<BreakpointHandle>;
 declare function removeBreakpoint(session: InspectorSession, breakpointId: string): Promise<void>;
+declare function getPossibleBreakpoints(session: InspectorSession, options: GetPossibleBreakpointsOptions): Promise<readonly BreakLocation[]>;
+declare function setBreakpointAtLocation(session: InspectorSession, input: SetBreakpointAtLocationInput): Promise<ExactBreakpointHandle>;
 
 declare function waitForPause(session: InspectorSession, options: WaitForPauseOptions): Promise<PauseEvent>;
 
 type PauseOnExceptionsState = "none" | "uncaught" | "caught" | "all";
 interface EvaluateOnFrameOptions {
     readonly throwOnSideEffect?: boolean;
+    readonly objectGroup?: string;
+}
+interface StepIntoOptions {
+    readonly breakOnAsyncCall?: boolean;
 }
 declare function resume(session: InspectorSession): Promise<void>;
 declare function setPauseOnExceptions(session: InspectorSession, state: PauseOnExceptionsState): Promise<void>;
@@ -305,6 +389,12 @@ declare function runSetupEvals(session: InspectorSession, expressions: readonly
 declare function listScripts(session: InspectorSession): readonly ScriptInfo[];
 declare function validateExpression(session: InspectorSession, expression: string): Promise<void>;
 declare function getProperties(session: InspectorSession, objectId: string): Promise<readonly CdpProperty[]>;
+declare function getScriptSource(session: InspectorSession, scriptId: string): Promise<string>;
+declare function stepInto(session: InspectorSession, options?: StepIntoOptions): Promise<void>;
+declare function stepOver(session: InspectorSession): Promise<void>;
+declare function stepOut(session: InspectorSession): Promise<void>;
+declare function releaseObject(session: InspectorSession, objectId: string): Promise<void>;
+declare function releaseObjectGroup(session: InspectorSession, objectGroup: string): Promise<void>;
 
 declare function connectInspector(options: InspectorConnectOptions): Promise<InspectorSession>;
 
@@ -373,6 +463,10 @@ interface TunnelTarget {
     readonly org: string;
     readonly space: string;
     readonly app: string;
+    readonly process?: string;
+    readonly instance?: number;
+    readonly nodePid?: number;
+    readonly allowSshEnableRestart?: boolean;
     readonly tunnelReadyTimeoutMs?: number;
     readonly preferredPort?: number;
     readonly verbose?: boolean;
@@ -384,6 +478,7 @@ interface OpenedTunnel {
     readonly handle?: DebuggerHandle;
     dispose(): Promise<void>;
 }
+declare function openOwnedCfTunnel(target: TunnelTarget): Promise<OpenedTunnel>;
 declare function openCfTunnel(target: TunnelTarget): Promise<OpenedTunnel>;
 
-export { type BreakpointHandle, type BreakpointLocation, type CallFrameInfo, type CaptureSnapshotOptions, type CapturedExpression, CfInspectorError, type CfInspectorErrorCode, type DebuggerState, type EvaluateOnFrameOptions, type ExceptionSnapshot, type FrameSnapshot, 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 RemoteRootSetting, type ResolvedLocation, type ScopeInfo, type ScopeSnapshot, type ScriptInfo, type SetBreakpointInput, type SnapshotCaptureResult, type SnapshotResult, type TunnelTarget, type VariableSnapshot, type WaitForPauseOptions, type WalkStackOptions, type WatchEvent, buildBreakpointUrlRegex, buildHitCountedCondition, buildLogpointCondition, captureException, captureSnapshot, connectInspector, discoverInspectorTargets, evaluateGlobal, evaluateOnFrame, fetchInspectorVersion, getProperties, listScripts, openCfTunnel, parseBreakpointSpec, parseRemoteRoot, removeBreakpoint, resume, runSetupEvals, setBreakpoint, setPauseOnExceptions, streamLogpoint, validateExpression, waitForPause, walkStack };
+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, setBreakpoint, setBreakpointAtLocation, setPauseOnExceptions, stepInto, stepOut, stepOver, streamLogpoint, validateExpression, waitForPause, walkStack };