tabwright 1.0.0

package/dist/rrweb-recording-relay.test.js

@@ -0,0 +1,85 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { afterEach, describe, expect, test } from 'vitest';
+import { RrwebRecordingRelay, getSavedRrwebRecordingWithEvents, listSavedRrwebRecordings } from './rrweb-recording-relay.js';
+let previousHome;
+let testHome = null;
+function createTempDir(prefix) {
+    const tempRoot = path.join(process.cwd(), 'tmp');
+    fs.mkdirSync(tempRoot, { recursive: true });
+    return fs.mkdtempSync(path.join(tempRoot, prefix));
+}
+function useTempHome() {
+    previousHome = process.env.HOME;
+    testHome = createTempDir('rrweb-recording-relay-home-');
+    process.env.HOME = testHome;
+    return testHome;
+}
+afterEach(() => {
+    if (previousHome === undefined) {
+        delete process.env.HOME;
+    }
+    else {
+        process.env.HOME = previousHome;
+    }
+    previousHome = undefined;
+    if (testHome) {
+        fs.rmSync(testHome, { recursive: true, force: true });
+        testHome = null;
+    }
+});
+describe('RrwebRecordingRelay', () => {
+    test('saves finalized rrweb events metadata and payload', async () => {
+        useTempHome();
+        const startedAt = Date.now() - 1000;
+        const events = [
+            {
+                type: 4,
+                timestamp: startedAt + 200,
+                data: {
+                    href: 'https://example.com/materials/new',
+                    width: 1280,
+                    height: 720,
+                },
+            },
+        ];
+        const relayRef = {};
+        const relay = new RrwebRecordingRelay(async ({ method }) => {
+            if (method === 'startRrwebRecording') {
+                return { success: true, tabId: 42, startedAt, url: 'https://example.com/materials/new' };
+            }
+            if (method === 'stopRrwebRecording') {
+                queueMicrotask(() => {
+                    const currentRelay = relayRef.current;
+                    if (!currentRelay) {
+                        throw new Error('Rrweb recording relay ref is not initialized');
+                    }
+                    currentRelay.handleRrwebRecordingData({
+                        method: 'rrwebRecordingData',
+                        params: {
+                            tabId: 42,
+                            events,
+                            final: true,
+                        },
+                    });
+                });
+                return { success: true, tabId: 42, duration: 1000 };
+            }
+            throw new Error(`Unexpected method: ${method}`);
+        }, () => {
+            return true;
+        });
+        relayRef.current = relay;
+        const startResult = await relay.startRecording({ sessionId: 'pw-tab-rrweb' });
+        expect(startResult.success).toBe(true);
+        const stopResult = await relay.stopRecording({ sessionId: 'pw-tab-rrweb' });
+        expect(stopResult.success).toBe(true);
+        const saved = listSavedRrwebRecordings({ limit: 1 });
+        expect(saved).toHaveLength(1);
+        expect(saved[0].eventCount).toBe(1);
+        expect(saved[0].url).toBe('https://example.com/materials/new');
+        const replay = getSavedRrwebRecordingWithEvents(saved[0].id);
+        expect(replay?.events).toEqual(events);
+    });
+});
+//# sourceMappingURL=rrweb-recording-relay.test.js.map

package/dist/rrweb-recording-relay.test.js.map

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

package/dist/rrweb-recording.d.ts

@@ -0,0 +1,104 @@
+import type { BrowserContext, Page } from '@xmorse/playwright-core';
+import type { RrwebEvent } from './protocol.js';
+export interface StartReplayOptions {
+    page: Page;
+    sessionId?: string;
+    outputPath?: string;
+    relayPort?: number;
+    checkoutEveryNms?: number;
+    maskAllInputs?: boolean;
+    recordCanvas?: boolean;
+    inlineImages?: boolean;
+    collectFonts?: boolean;
+    mousemoveWait?: number;
+}
+export interface StopReplayOptions {
+    page: Page;
+    sessionId?: string;
+    relayPort?: number;
+}
+export interface ReplayState {
+    isRecording: boolean;
+    startedAt?: number;
+    tabId?: number;
+    url?: string;
+}
+export interface SavedReplayRecording {
+    id: string;
+    path: string;
+    startedAt: number;
+    savedAt: number;
+    duration: number;
+    size: number;
+    eventCount: number;
+    tabId: number;
+    sessionId?: string;
+    url?: string;
+}
+interface ReplayRecordingEventsResponse {
+    recording: SavedReplayRecording;
+    events: RrwebEvent[];
+}
+interface ReplayTargetOptions {
+    page?: Page;
+    sessionId?: string;
+}
+interface CreateReplayApiOptions {
+    context: BrowserContext;
+    defaultPage: Page;
+    relayPort: number;
+}
+interface StartReplayWithDefaultsOptions extends Omit<StartReplayOptions, 'relayPort' | 'page' | 'sessionId'>, ReplayTargetOptions {
+}
+interface StopReplayWithDefaultsOptions extends Omit<StopReplayOptions, 'relayPort' | 'page' | 'sessionId'>, ReplayTargetOptions {
+}
+interface IsReplayWithDefaultsOptions extends ReplayTargetOptions {
+}
+interface CancelReplayWithDefaultsOptions extends ReplayTargetOptions {
+}
+export declare function createReplayApi(options: CreateReplayApiOptions): {
+    start: (opts?: StartReplayWithDefaultsOptions) => Promise<ReplayState>;
+    stop: (opts?: StopReplayWithDefaultsOptions) => Promise<{
+        id?: string;
+        path: string;
+        duration: number;
+        size: number;
+        eventCount: number;
+    }>;
+    isRecording: (opts?: IsReplayWithDefaultsOptions) => Promise<ReplayState>;
+    cancel: (opts?: CancelReplayWithDefaultsOptions) => Promise<void>;
+    list: (opts?: {
+        limit?: number;
+    }) => Promise<SavedReplayRecording[]>;
+    events: (opts: {
+        id: string;
+    }) => Promise<ReplayRecordingEventsResponse>;
+};
+export declare function startReplayRecording(options: StartReplayOptions): Promise<ReplayState>;
+export declare function stopReplayRecording(options: StopReplayOptions): Promise<{
+    id?: string;
+    path: string;
+    duration: number;
+    size: number;
+    eventCount: number;
+}>;
+export declare function isReplayRecording(options: {
+    page: Page;
+    sessionId?: string;
+    relayPort?: number;
+}): Promise<ReplayState>;
+export declare function cancelReplayRecording(options: {
+    page: Page;
+    sessionId?: string;
+    relayPort?: number;
+}): Promise<void>;
+export declare function listReplayRecordings(options?: {
+    relayPort?: number;
+    limit?: number;
+}): Promise<SavedReplayRecording[]>;
+export declare function getReplayRecordingEvents(options: {
+    id: string;
+    relayPort?: number;
+}): Promise<ReplayRecordingEventsResponse>;
+export {};
+//# sourceMappingURL=rrweb-recording.d.ts.map

package/dist/rrweb-recording.d.ts.map

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

package/dist/rrweb-recording.js

@@ -0,0 +1,180 @@
+import path from 'node:path';
+import { getLocalRelayHttpBaseUrl } from './relay-client.js';
+function replayHeaders() {
+    const headers = { 'Content-Type': 'application/json' };
+    const token = process.env.TABWRIGHT_TOKEN || process.env.PLAYWRITER_TOKEN;
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    return headers;
+}
+async function getReplayRelayBaseUrl(relayPort) {
+    return await getLocalRelayHttpBaseUrl(relayPort);
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function isStringOrUndefined(value) {
+    return value === undefined || typeof value === 'string';
+}
+function isRrwebEvent(value) {
+    return isRecord(value);
+}
+function isSavedReplayRecording(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value.id === 'string' &&
+        typeof value.path === 'string' &&
+        typeof value.startedAt === 'number' &&
+        typeof value.savedAt === 'number' &&
+        typeof value.duration === 'number' &&
+        typeof value.size === 'number' &&
+        typeof value.eventCount === 'number' &&
+        typeof value.tabId === 'number' &&
+        isStringOrUndefined(value.sessionId) &&
+        isStringOrUndefined(value.url));
+}
+function isListReplayRecordingsResponse(value) {
+    return (isRecord(value) &&
+        Array.isArray(value.recordings) &&
+        value.recordings.every((recording) => {
+            return isSavedReplayRecording(recording);
+        }));
+}
+function isReplayRecordingEventsResponse(value) {
+    return (isRecord(value) &&
+        isSavedReplayRecording(value.recording) &&
+        Array.isArray(value.events) &&
+        value.events.every(isRrwebEvent));
+}
+function withReplayDefaults(options) {
+    const { relayPort, defaultPage, fn } = options;
+    return async (input = {}) => {
+        const targetPage = input.page || defaultPage;
+        const sessionId = input.sessionId || targetPage.sessionId() || undefined;
+        return await fn({ page: targetPage, sessionId, relayPort, ...input });
+    };
+}
+export function createReplayApi(options) {
+    const { relayPort, defaultPage } = options;
+    return {
+        start: withReplayDefaults({
+            relayPort,
+            defaultPage,
+            fn: startReplayRecording,
+        }),
+        stop: withReplayDefaults({
+            relayPort,
+            defaultPage,
+            fn: stopReplayRecording,
+        }),
+        isRecording: withReplayDefaults({
+            relayPort,
+            defaultPage,
+            fn: isReplayRecording,
+        }),
+        cancel: withReplayDefaults({
+            relayPort,
+            defaultPage,
+            fn: cancelReplayRecording,
+        }),
+        list: async (opts) => {
+            return await listReplayRecordings({ ...opts, relayPort });
+        },
+        events: async (opts) => {
+            return await getReplayRecordingEvents({ ...opts, relayPort });
+        },
+    };
+}
+export async function startReplayRecording(options) {
+    const { sessionId, outputPath, relayPort = 19988, checkoutEveryNms, maskAllInputs, recordCanvas, inlineImages, collectFonts, mousemoveWait, } = options;
+    const absoluteOutputPath = outputPath ? path.resolve(outputPath) : undefined;
+    const relayBaseUrl = await getReplayRelayBaseUrl(relayPort);
+    const response = await fetch(`${relayBaseUrl}/rrweb-recording/start`, {
+        method: 'POST',
+        headers: replayHeaders(),
+        body: JSON.stringify({
+            sessionId,
+            outputPath: absoluteOutputPath,
+            checkoutEveryNms,
+            maskAllInputs,
+            recordCanvas,
+            inlineImages,
+            collectFonts,
+            mousemoveWait,
+        }),
+    });
+    const result = (await response.json());
+    if (!result.success) {
+        throw new Error(`Failed to start replay recording: ${result.error}`);
+    }
+    return {
+        isRecording: true,
+        startedAt: result.startedAt,
+        tabId: result.tabId,
+        url: result.url,
+    };
+}
+export async function stopReplayRecording(options) {
+    const { sessionId, relayPort = 19988 } = options;
+    const relayBaseUrl = await getReplayRelayBaseUrl(relayPort);
+    const response = await fetch(`${relayBaseUrl}/rrweb-recording/stop`, {
+        method: 'POST',
+        headers: replayHeaders(),
+        body: JSON.stringify({ sessionId }),
+    });
+    const result = (await response.json());
+    if (!result.success) {
+        throw new Error(`Failed to stop replay recording: ${result.error}`);
+    }
+    return { id: result.id, path: result.path, duration: result.duration, size: result.size, eventCount: result.eventCount };
+}
+export async function isReplayRecording(options) {
+    const { sessionId, relayPort = 19988 } = options;
+    const relayBaseUrl = await getReplayRelayBaseUrl(relayPort);
+    const url = new URL(`${relayBaseUrl}/rrweb-recording/status`);
+    if (sessionId) {
+        url.searchParams.set('sessionId', sessionId);
+    }
+    const response = await fetch(url.toString(), { headers: replayHeaders() });
+    const result = (await response.json());
+    return { isRecording: result.isRecording, startedAt: result.startedAt, tabId: result.tabId, url: result.url };
+}
+export async function cancelReplayRecording(options) {
+    const { sessionId, relayPort = 19988 } = options;
+    const relayBaseUrl = await getReplayRelayBaseUrl(relayPort);
+    const response = await fetch(`${relayBaseUrl}/rrweb-recording/cancel`, {
+        method: 'POST',
+        headers: replayHeaders(),
+        body: JSON.stringify({ sessionId }),
+    });
+    const result = (await response.json());
+    if (!result.success) {
+        throw new Error(`Failed to cancel replay recording: ${result.error}`);
+    }
+}
+export async function listReplayRecordings(options = {}) {
+    const { relayPort = 19988, limit = 50 } = options;
+    const relayBaseUrl = await getReplayRelayBaseUrl(relayPort);
+    const url = new URL(`${relayBaseUrl}/rrweb-recordings`);
+    url.searchParams.set('limit', String(limit));
+    const response = await fetch(url.toString(), { headers: replayHeaders() });
+    const result = (await response.json());
+    if (!response.ok || !isListReplayRecordingsResponse(result)) {
+        throw new Error(`Failed to list replay recordings: ${response.status}`);
+    }
+    return result.recordings;
+}
+export async function getReplayRecordingEvents(options) {
+    const { id, relayPort = 19988 } = options;
+    const relayBaseUrl = await getReplayRelayBaseUrl(relayPort);
+    const response = await fetch(`${relayBaseUrl}/rrweb-recordings/${encodeURIComponent(id)}/events`, {
+        headers: replayHeaders(),
+    });
+    const result = (await response.json());
+    if (!response.ok || !isReplayRecordingEventsResponse(result)) {
+        throw new Error(`Failed to load replay recording events: ${response.status}`);
+    }
+    return result;
+}
+//# sourceMappingURL=rrweb-recording.js.map

package/dist/rrweb-recording.js.map

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

package/dist/scoped-fs.d.ts

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+/**
+ * A sandboxed fs wrapper that restricts all file operations to allowed directories.
+ * Any attempt to access files outside the allowed directories will throw an EPERM error.
+ *
+ * By default, allows access to:
+ * - The base directory captured when the sandbox is created
+ * - /tmp
+ * - os.tmpdir()
+ *
+ * This is used in the MCP VM context to prevent agents from accessing sensitive system files.
+ */
+export declare class ScopedFS {
+    private allowedDirs;
+    private baseDir;
+    constructor(allowedDirs?: string[], baseDir?: string);
+    /**
+     * Check if a resolved path is within any of the allowed directories.
+     */
+    private isPathAllowed;
+    /**
+     * Resolve a path and ensure it stays within allowed directories.
+     * Throws EPERM if the resolved path escapes the sandbox.
+     */
+    private resolvePath;
+    readFileSync: (filePath: fs.PathOrFileDescriptor, options?: any) => any;
+    writeFileSync: (filePath: fs.PathOrFileDescriptor, data: any, options?: any) => void;
+    appendFileSync: (filePath: fs.PathOrFileDescriptor, data: any, options?: any) => void;
+    readdirSync: (dirPath: fs.PathLike, options?: any) => any;
+    mkdirSync: (dirPath: fs.PathLike, options?: any) => any;
+    rmdirSync: (dirPath: fs.PathLike, options?: any) => void;
+    unlinkSync: (filePath: fs.PathLike) => void;
+    statSync: (filePath: fs.PathLike, options?: any) => any;
+    lstatSync: (filePath: fs.PathLike, options?: any) => any;
+    existsSync: (filePath: fs.PathLike) => boolean;
+    accessSync: (filePath: fs.PathLike, mode?: number) => void;
+    copyFileSync: (src: fs.PathLike, dest: fs.PathLike, mode?: number) => void;
+    renameSync: (oldPath: fs.PathLike, newPath: fs.PathLike) => void;
+    chmodSync: (filePath: fs.PathLike, mode: fs.Mode) => void;
+    chownSync: (filePath: fs.PathLike, uid: number, gid: number) => void;
+    utimesSync: (filePath: fs.PathLike, atime: fs.TimeLike, mtime: fs.TimeLike) => void;
+    realpathSync: (filePath: fs.PathLike, options?: any) => any;
+    readlinkSync: (filePath: fs.PathLike, options?: any) => any;
+    symlinkSync: (target: fs.PathLike, linkPath: fs.PathLike, type?: fs.symlink.Type | null) => void;
+    rmSync: (filePath: fs.PathLike, options?: fs.RmOptions) => void;
+    readFile: (filePath: any, ...args: any[]) => void;
+    writeFile: (filePath: any, data: any, ...args: any[]) => void;
+    appendFile: (filePath: any, data: any, ...args: any[]) => void;
+    readdir: (dirPath: any, ...args: any[]) => void;
+    mkdir: (dirPath: any, ...args: any[]) => void;
+    rmdir: (dirPath: any, ...args: any[]) => void;
+    unlink: (filePath: any, callback: any) => void;
+    stat: (filePath: any, ...args: any[]) => void;
+    lstat: (filePath: any, ...args: any[]) => void;
+    access: (filePath: any, ...args: any[]) => void;
+    copyFile: (src: any, dest: any, ...args: any[]) => void;
+    rename: (oldPath: any, newPath: any, callback: any) => void;
+    chmod: (filePath: any, mode: any, callback: any) => void;
+    chown: (filePath: any, uid: any, gid: any, callback: any) => void;
+    rm: (filePath: any, ...args: any[]) => void;
+    exists: (filePath: any, callback: any) => void;
+    createReadStream: (filePath: fs.PathLike, options?: any) => fs.ReadStream;
+    createWriteStream: (filePath: fs.PathLike, options?: any) => fs.WriteStream;
+    watch: (filePath: any, ...args: any[]) => fs.FSWatcher;
+    watchFile: (filePath: any, ...args: any[]) => fs.StatWatcher;
+    unwatchFile: (filePath: any, listener?: any) => void;
+    get promises(): {
+        readFile: (filePath: fs.PathLike, options?: any) => Promise<NonSharedBuffer>;
+        writeFile: (filePath: fs.PathLike, data: any, options?: any) => Promise<void>;
+        appendFile: (filePath: fs.PathLike, data: any, options?: any) => Promise<void>;
+        readdir: (dirPath: fs.PathLike, options?: any) => Promise<string[]>;
+        mkdir: (dirPath: fs.PathLike, options?: any) => Promise<string | undefined>;
+        rmdir: (dirPath: fs.PathLike, options?: any) => Promise<void>;
+        unlink: (filePath: fs.PathLike) => Promise<void>;
+        stat: (filePath: fs.PathLike, options?: any) => Promise<fs.Stats>;
+        lstat: (filePath: fs.PathLike, options?: any) => Promise<fs.Stats>;
+        access: (filePath: fs.PathLike, mode?: number) => Promise<void>;
+        copyFile: (src: fs.PathLike, dest: fs.PathLike, mode?: number) => Promise<void>;
+        rename: (oldPath: fs.PathLike, newPath: fs.PathLike) => Promise<void>;
+        chmod: (filePath: fs.PathLike, mode: fs.Mode) => Promise<void>;
+        chown: (filePath: fs.PathLike, uid: number, gid: number) => Promise<void>;
+        rm: (filePath: fs.PathLike, options?: fs.RmOptions) => Promise<void>;
+        realpath: (filePath: fs.PathLike, options?: any) => Promise<string>;
+        readlink: (filePath: fs.PathLike, options?: any) => Promise<string>;
+        symlink: (target: fs.PathLike, linkPath: fs.PathLike, type?: string) => Promise<void>;
+        utimes: (filePath: fs.PathLike, atime: fs.TimeLike, mtime: fs.TimeLike) => Promise<void>;
+    };
+    constants: typeof fs.constants;
+}
+/**
+ * Create a scoped fs instance with allowed directories.
+ * Defaults to the captured base directory, /tmp, and os.tmpdir() if no directories specified.
+ */
+export declare function createScopedFS(allowedDirs?: string[], baseDir?: string): ScopedFS;
+//# sourceMappingURL=scoped-fs.d.ts.map

package/dist/scoped-fs.d.ts.map

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