tabwright 1.0.0

package/dist/protocol.d.ts

@@ -0,0 +1,248 @@
+import { CDPEventFor, ProtocolMapping } from './cdp-types.js';
+export declare const VERSION = 1;
+export declare const EXTENSION_FEATURE: {
+    readonly heartbeat: "heartbeat-v1";
+    readonly createInitialTab: "create-initial-tab-v1";
+    readonly rrwebRecording: "rrweb-recording-v1";
+    readonly toolbarRecording: "toolbar-recording-v1";
+    readonly multiExtension: "multi-extension-v1";
+};
+export type ExtensionFeature = (typeof EXTENSION_FEATURE)[keyof typeof EXTENSION_FEATURE];
+export declare const CURRENT_EXTENSION_FEATURES: ExtensionFeature[];
+export declare const RELAY_FEATURE: {
+    readonly extensionFeatureNegotiation: "extension-feature-negotiation-v1";
+    readonly capabilityOptions: "capability-options-v1";
+    readonly capabilityAuth: "capability-auth-v1";
+    readonly capabilityAuthAutoTab: "capability-auth-auto-tab-v1";
+    readonly rrwebRecording: "rrweb-recording-v1";
+    readonly multiExtension: "multi-extension-v1";
+};
+export type RelayFeature = (typeof RELAY_FEATURE)[keyof typeof RELAY_FEATURE];
+export declare const RELAY_FEATURES: RelayFeature[];
+export declare const RELAY_REVIEW_FEATURES: RelayFeature[];
+export declare function supportsExtensionFeature(options: {
+    features: readonly string[] | undefined;
+    feature: ExtensionFeature;
+}): boolean;
+export declare function allowsExtensionFeature(options: {
+    features: readonly string[] | undefined;
+    feature: ExtensionFeature;
+}): boolean;
+export declare function parseExtensionFeatures(value: string | undefined): string[] | undefined;
+export declare function requiredExtensionFeatureForMethod(method: string): ExtensionFeature | undefined;
+type ForwardCDPCommand = {
+    [K in keyof ProtocolMapping.Commands]: {
+        id: number;
+        method: 'forwardCDPCommand';
+        params: {
+            method: K;
+            sessionId?: string;
+            params?: ProtocolMapping.Commands[K]['paramsType'][0];
+            source?: 'playwriter';
+        };
+    };
+}[keyof ProtocolMapping.Commands];
+export type ExtensionCommandMessage = ForwardCDPCommand;
+export type ExtensionResponseMessage = {
+    id: number;
+    method?: undefined;
+    result?: any;
+    error?: string;
+};
+/**
+ * This produces a discriminated union for narrowing, similar to ForwardCDPCommand,
+ * but for forwarded CDP events. Uses CDPEvent to maintain proper type extraction.
+ */
+export type ExtensionEventMessage = {
+    [K in keyof ProtocolMapping.Events]: {
+        id?: undefined;
+        method: 'forwardCDPEvent';
+        params: {
+            method: CDPEventFor<K>['method'];
+            sessionId?: string;
+            params?: CDPEventFor<K>['params'];
+        };
+    };
+}[keyof ProtocolMapping.Events];
+export type ExtensionLogMessage = {
+    id?: undefined;
+    method: 'log';
+    params: {
+        level: 'log' | 'debug' | 'info' | 'warn' | 'error';
+        args: string[];
+    };
+};
+export type ExtensionPongMessage = {
+    id?: undefined;
+    method: 'pong';
+};
+export type ServerPingMessage = {
+    method: 'ping';
+    id?: undefined;
+};
+export type RrwebEvent = Record<string, unknown>;
+export type RrwebRecordingDataMessage = {
+    id?: undefined;
+    method: 'rrwebRecordingData';
+    params: {
+        tabId: number;
+        events: RrwebEvent[];
+        final?: boolean;
+    };
+};
+export type RrwebRecordingCancelledMessage = {
+    id?: undefined;
+    method: 'rrwebRecordingCancelled';
+    params: {
+        tabId: number;
+    };
+};
+export type ToolbarRecordingAction = 'status' | 'toggle';
+export type ToolbarRecordingResult = {
+    success: true;
+    isRecording: boolean;
+    startedAt?: number;
+    tabId?: number;
+    id?: string;
+    path?: string;
+    duration?: number;
+    size?: number;
+    replayId?: string;
+    replayPath?: string;
+    replayDuration?: number;
+    replaySize?: number;
+    replayEventCount?: number;
+    warning?: string;
+} | {
+    success: false;
+    isRecording?: boolean;
+    error: string;
+};
+export type ToolbarRecordingRequestMessage = {
+    id?: undefined;
+    method: 'toolbarRecordingRequest';
+    params: {
+        requestId: string;
+        action: ToolbarRecordingAction;
+        sessionId?: string;
+    };
+};
+export type ToolbarRecordingResponseMessage = {
+    id?: undefined;
+    method: 'toolbarRecordingResponse';
+    params: {
+        requestId: string;
+        result: ToolbarRecordingResult;
+    };
+};
+export type ExtensionMessage = ExtensionResponseMessage | ExtensionEventMessage | ExtensionLogMessage | ExtensionPongMessage | RrwebRecordingDataMessage | RrwebRecordingCancelledMessage | ToolbarRecordingRequestMessage;
+export type StartRrwebRecordingParams = {
+    /** CDP tab session ID (pw-tab-*) to identify which tab to record. */
+    sessionId?: string;
+    /** Milliseconds between full snapshot checkouts. Use 0 to disable periodic checkouts. */
+    checkoutEveryNms?: number;
+    maskAllInputs?: boolean;
+    recordCanvas?: boolean;
+    inlineImages?: boolean;
+    collectFonts?: boolean;
+    mousemoveWait?: number;
+};
+/** HTTP body for /rrweb-recording/start endpoint */
+export type StartRrwebRecordingBody = StartRrwebRecordingParams & {
+    outputPath?: string;
+};
+export type StopRrwebRecordingParams = {
+    /** CDP tab session ID (pw-tab-*) to identify which tab to stop recording. */
+    sessionId?: string;
+};
+export type IsRrwebRecordingParams = {
+    /** CDP tab session ID (pw-tab-*) to identify which tab to check. */
+    sessionId?: string;
+};
+export type CancelRrwebRecordingParams = {
+    /** CDP tab session ID (pw-tab-*) to identify which tab to cancel. */
+    sessionId?: string;
+};
+export type StartRrwebRecordingMessage = {
+    id: number;
+    method: 'startRrwebRecording';
+    params: StartRrwebRecordingParams;
+};
+export type StopRrwebRecordingMessage = {
+    id: number;
+    method: 'stopRrwebRecording';
+    params: StopRrwebRecordingParams;
+};
+export type IsRrwebRecordingMessage = {
+    id: number;
+    method: 'isRrwebRecording';
+    params: IsRrwebRecordingParams;
+};
+export type CancelRrwebRecordingMessage = {
+    id: number;
+    method: 'cancelRrwebRecording';
+    params: CancelRrwebRecordingParams;
+};
+export type RrwebRecordingCommandMessage = StartRrwebRecordingMessage | StopRrwebRecordingMessage | IsRrwebRecordingMessage | CancelRrwebRecordingMessage;
+export type StartRrwebRecordingResult = {
+    success: true;
+    tabId: number;
+    startedAt: number;
+    url?: string;
+} | {
+    success: false;
+    error: string;
+};
+/** Result from extension - doesn't include path/size since relay writes the file */
+export type ExtensionStopRrwebRecordingResult = {
+    success: true;
+    tabId: number;
+    duration: number;
+} | {
+    success: false;
+    error: string;
+};
+/** Final result from relay - includes path/size after file is written */
+export type StopRrwebRecordingResult = {
+    success: true;
+    id?: string;
+    tabId: number;
+    duration: number;
+    path: string;
+    size: number;
+    eventCount: number;
+} | {
+    success: false;
+    error: string;
+};
+export type IsRrwebRecordingResult = {
+    isRecording: boolean;
+    tabId?: number;
+    startedAt?: number;
+    url?: string;
+};
+export type CancelRrwebRecordingResult = {
+    success: boolean;
+    error?: string;
+};
+export type GhostBrowserCommandMessage = {
+    id: number;
+    method: 'ghost-browser';
+    params: {
+        /** API namespace: 'ghostPublicAPI' | 'ghostProxies' | 'projects' */
+        namespace: 'ghostPublicAPI' | 'ghostProxies' | 'projects';
+        /** Method name within the namespace */
+        method: string;
+        /** Arguments to pass to the method */
+        args: unknown[];
+    };
+};
+export type GhostBrowserCommandResult = {
+    success: true;
+    result: unknown;
+} | {
+    success: false;
+    error: string;
+};
+export {};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/protocol.js

@@ -0,0 +1,59 @@
+export const VERSION = 1;
+export const EXTENSION_FEATURE = {
+    heartbeat: 'heartbeat-v1',
+    createInitialTab: 'create-initial-tab-v1',
+    rrwebRecording: 'rrweb-recording-v1',
+    toolbarRecording: 'toolbar-recording-v1',
+    multiExtension: 'multi-extension-v1',
+};
+export const CURRENT_EXTENSION_FEATURES = Object.values(EXTENSION_FEATURE);
+export const RELAY_FEATURE = {
+    extensionFeatureNegotiation: 'extension-feature-negotiation-v1',
+    capabilityOptions: 'capability-options-v1',
+    capabilityAuth: 'capability-auth-v1',
+    capabilityAuthAutoTab: 'capability-auth-auto-tab-v1',
+    rrwebRecording: 'rrweb-recording-v1',
+    multiExtension: 'multi-extension-v1',
+};
+export const RELAY_FEATURES = Object.values(RELAY_FEATURE);
+export const RELAY_REVIEW_FEATURES = [
+    RELAY_FEATURE.capabilityOptions,
+    RELAY_FEATURE.capabilityAuth,
+    RELAY_FEATURE.capabilityAuthAutoTab,
+    RELAY_FEATURE.rrwebRecording,
+];
+export function supportsExtensionFeature(options) {
+    return options.features?.includes(options.feature) || false;
+}
+export function allowsExtensionFeature(options) {
+    if (options.features === undefined) {
+        return true;
+    }
+    return supportsExtensionFeature(options);
+}
+export function parseExtensionFeatures(value) {
+    if (!value) {
+        return undefined;
+    }
+    return [
+        ...new Set(value
+            .split(',')
+            .map((feature) => feature.trim())
+            .filter((feature) => {
+            return feature.length > 0;
+        })),
+    ];
+}
+export function requiredExtensionFeatureForMethod(method) {
+    if (method === 'createInitialTab') {
+        return EXTENSION_FEATURE.createInitialTab;
+    }
+    if (method === 'startRrwebRecording' ||
+        method === 'stopRrwebRecording' ||
+        method === 'isRrwebRecording' ||
+        method === 'cancelRrwebRecording') {
+        return EXTENSION_FEATURE.rrwebRecording;
+    }
+    return undefined;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAA;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS,EAAE,cAAc;IACzB,gBAAgB,EAAE,uBAAuB;IACzC,cAAc,EAAE,oBAAoB;IACpC,gBAAgB,EAAE,sBAAsB;IACxC,cAAc,EAAE,oBAAoB;CAC5B,CAAA;AAIV,MAAM,CAAC,MAAM,0BAA0B,GAAuB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAA;AAE9F,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,2BAA2B,EAAE,kCAAkC;IAC/D,iBAAiB,EAAE,uBAAuB;IAC1C,cAAc,EAAE,oBAAoB;IACpC,qBAAqB,EAAE,6BAA6B;IACpD,cAAc,EAAE,oBAAoB;IACpC,cAAc,EAAE,oBAAoB;CAC5B,CAAA;AAIV,MAAM,CAAC,MAAM,cAAc,GAAmB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,aAAa,CAAC,iBAAiB;IAC/B,aAAa,CAAC,cAAc;IAC5B,aAAa,CAAC,qBAAqB;IACnC,aAAa,CAAC,cAAc;CAC7B,CAAA;AAED,MAAM,UAAU,wBAAwB,CAAC,OAGxC;IACC,OAAO,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAGtC;IACC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,wBAAwB,CAAC,OAAO,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAyB;IAC9D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO;QACL,GAAG,IAAI,GAAG,CACR,KAAK;aACF,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAChC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;YAClB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;QAC3B,CAAC,CAAC,CACL;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,MAAc;IAC9D,IAAI,MAAM,KAAK,kBAAkB,EAAE,CAAC;QAClC,OAAO,iBAAiB,CAAC,gBAAgB,CAAA;IAC3C,CAAC;IACD,IACE,MAAM,KAAK,qBAAqB;QAChC,MAAM,KAAK,oBAAoB;QAC/B,MAAM,KAAK,kBAAkB;QAC7B,MAAM,KAAK,sBAAsB,EACjC,CAAC;QACD,OAAO,iBAAiB,CAAC,cAAc,CAAA;IACzC,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/protocol.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.test.d.ts.map

package/dist/protocol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.test.d.ts","sourceRoot":"","sources":["../src/protocol.test.ts"],"names":[],"mappings":""}

package/dist/protocol.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, test } from 'vitest';
+import { CURRENT_EXTENSION_FEATURES, EXTENSION_FEATURE, allowsExtensionFeature, parseExtensionFeatures, requiredExtensionFeatureForMethod, supportsExtensionFeature, } from './protocol.js';
+describe('extension feature negotiation', () => {
+    test('treats a missing feature query as a legacy handshake', () => {
+        expect(parseExtensionFeatures(undefined)).toBeUndefined();
+        expect(supportsExtensionFeature({
+            features: undefined,
+            feature: EXTENSION_FEATURE.heartbeat,
+        })).toBe(false);
+        expect(allowsExtensionFeature({
+            features: undefined,
+            feature: EXTENSION_FEATURE.heartbeat,
+        })).toBe(true);
+        expect(allowsExtensionFeature({
+            features: [],
+            feature: EXTENSION_FEATURE.heartbeat,
+        })).toBe(false);
+    });
+    test('deduplicates advertised features and ignores unknown values safely', () => {
+        const features = parseExtensionFeatures(`${EXTENSION_FEATURE.heartbeat},future-feature-v9,${EXTENSION_FEATURE.heartbeat}`);
+        expect(features).toEqual([EXTENSION_FEATURE.heartbeat, 'future-feature-v9']);
+        expect(supportsExtensionFeature({
+            features,
+            feature: EXTENSION_FEATURE.heartbeat,
+        })).toBe(true);
+        expect(CURRENT_EXTENSION_FEATURES).toContain(EXTENSION_FEATURE.rrwebRecording);
+        expect(requiredExtensionFeatureForMethod('startRrwebRecording')).toBe(EXTENSION_FEATURE.rrwebRecording);
+        expect(requiredExtensionFeatureForMethod('forwardCDPCommand')).toBeUndefined();
+    });
+});
+//# sourceMappingURL=protocol.test.js.map

package/dist/protocol.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.test.js","sourceRoot":"","sources":["../src/protocol.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,iCAAiC,EACjC,wBAAwB,GACzB,MAAM,eAAe,CAAA;AAEtB,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;QACzD,MAAM,CACJ,wBAAwB,CAAC;YACvB,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,iBAAiB,CAAC,SAAS;SACrC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACb,MAAM,CACJ,sBAAsB,CAAC;YACrB,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,iBAAiB,CAAC,SAAS;SACrC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACZ,MAAM,CACJ,sBAAsB,CAAC;YACrB,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,iBAAiB,CAAC,SAAS;SACrC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC9E,MAAM,QAAQ,GAAG,sBAAsB,CACrC,GAAG,iBAAiB,CAAC,SAAS,sBAAsB,iBAAiB,CAAC,SAAS,EAAE,CAClF,CAAA;QAED,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,CAAA;QAC5E,MAAM,CACJ,wBAAwB,CAAC;YACvB,QAAQ;YACR,OAAO,EAAE,iBAAiB,CAAC,SAAS;SACrC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACZ,MAAM,CAAC,0BAA0B,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAA;QAC9E,MAAM,CAAC,iCAAiC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CACnE,iBAAiB,CAAC,cAAc,CACjC,CAAA;QACD,MAAM,CAAC,iCAAiC,CAAC,mBAAmB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;IAChF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/react-source.d.ts

@@ -0,0 +1,57 @@
+import type { Locator, ElementHandle } from '@xmorse/playwright-core';
+import type { ICDPSession } from './cdp-session.js';
+export interface ReactSourceLocation {
+    fileName: string | null;
+    lineNumber: number | null;
+    columnNumber: number | null;
+    componentName: string | null;
+}
+export type ReactSerializedProp = string | number | boolean | null | ReactSerializedProp[] | {
+    [key: string]: ReactSerializedProp;
+};
+export interface ReactComponentHierarchyItem {
+    componentName: string | null;
+    source: Omit<ReactSourceLocation, 'componentName'> | null;
+    props: ReactSerializedProp;
+}
+export interface ReactComponentInfo {
+    componentName: string | null;
+    source: Omit<ReactSourceLocation, 'componentName'> | null;
+    hierarchy: ReactComponentHierarchyItem[];
+    props: ReactSerializedProp;
+}
+type ReactInspectableValue = string | number | boolean | bigint | symbol | null | undefined | object | ((...args: never[]) => ReactInspectableValue);
+type BrowserElement = object;
+interface BippySourceFrame {
+    fileName?: string | null;
+    lineNumber?: number | null;
+    columnNumber?: number | null;
+    functionName?: string | null;
+}
+interface BippyFiber {
+    return?: BippyFiber | null;
+    type?: ReactInspectableValue;
+    memoizedProps?: ReactInspectableValue;
+}
+interface BippyRuntime {
+    getFiberFromHostInstance(el: BrowserElement): BippyFiber | null;
+    getSource(fiber: BippyFiber): Promise<BippySourceFrame | null>;
+    getOwnerStack(fiber: BippyFiber): Promise<BippySourceFrame[]>;
+    getDisplayName(type: ReactInspectableValue): string | null;
+    isCompositeFiber(fiber: BippyFiber): boolean;
+    normalizeFileName(fileName: string): string;
+    isSourceFile(fileName: string): boolean;
+}
+declare global {
+    var __bippy: BippyRuntime | undefined;
+}
+export declare function getReactSource({ locator, cdp: cdpSession, }: {
+    locator: Locator | ElementHandle;
+    cdp: ICDPSession;
+}): Promise<ReactSourceLocation | null>;
+export declare function getReactComponentInfo({ locator, cdp: cdpSession, }: {
+    locator: Locator | ElementHandle;
+    cdp: ICDPSession;
+}): Promise<ReactComponentInfo | null>;
+export {};
+//# sourceMappingURL=react-source.d.ts.map

package/dist/react-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-source.d.ts","sourceRoot":"","sources":["../src/react-source.ts"],"names":[],"mappings":"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"}