@walkrstudio/recorder 0.2.0

package/dist/static-server.js

@@ -0,0 +1,212 @@
+import { execSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as http from "node:http";
+import * as https from "node:https";
+import { createRequire } from "node:module";
+import * as net from "node:net";
+import { dirname, extname, join, resolve } from "node:path";
+const PROXY_PREFIX = "/__target__";
+function rewriteWalkthroughUrl(walkthrough, targetOrigin) {
+    return {
+        ...walkthrough,
+        originalUrl: walkthrough.url,
+        url: walkthrough.url.replace(targetOrigin, PROXY_PREFIX),
+    };
+}
+async function getFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.listen(0, () => {
+            const addr = server.address();
+            if (!addr || typeof addr === "string") {
+                server.close();
+                reject(new Error("Failed to get free port"));
+                return;
+            }
+            const port = addr.port;
+            server.close(() => resolve(port));
+        });
+        server.on("error", reject);
+    });
+}
+const MIME_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".mjs": "application/javascript; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".eot": "application/vnd.ms-fontobject",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".wasm": "application/wasm",
+    ".map": "application/json",
+};
+/**
+ * Rewrite absolute paths in proxied text responses so that sub-resource
+ * requests (scripts, styles, fetches) route back through the proxy.
+ */
+function rewriteAbsolutePaths(content, contentType) {
+    if (contentType.includes("html")) {
+        let html = content
+            .replace(/((?:src|href|action|poster|formaction|icon|manifest|ping|background)\s*=\s*)(["'])\/(?!\/|__target__)/gi, `$1$2${PROXY_PREFIX}/`)
+            .replace(/\burl\(\s*["']?\/(?!\/|__target__)/g, (m) => m.replace("/", `${PROXY_PREFIX}/`))
+            .replace(/(["'`])\/(?!\/|__target__)([a-zA-Z@._][\w@._-]*\/)/g, `$1${PROXY_PREFIX}/$2`)
+            .replace(/(["'`])\/(?!\/|__target__)([a-zA-Z@._][\w@._-]+\.\w{2,})/g, `$1${PROXY_PREFIX}/$2`);
+        if (!/<base\b/i.test(html)) {
+            html = html.replace(/(<head[^>]*>)/i, `$1<base href="${PROXY_PREFIX}/">`);
+        }
+        return html;
+    }
+    if (contentType.includes("css")) {
+        return content
+            .replace(/\burl\(\s*["']?\/(?!\/|__target__)/g, (m) => m.replace("/", `${PROXY_PREFIX}/`))
+            .replace(/(@import\s+["'])\/(?!\/|__target__)/g, `$1${PROXY_PREFIX}/`);
+    }
+    return content
+        .replace(/(["'`])\/(?!\/|__target__)([a-zA-Z@._][\w@._-]*\/)/g, `$1${PROXY_PREFIX}/$2`)
+        .replace(/(["'`])\/(?!\/|__target__)([a-zA-Z@._][\w@._-]+\.\w{2,})/g, `$1${PROXY_PREFIX}/$2`);
+}
+function isTextResponse(contentType) {
+    return (contentType.includes("text/") ||
+        contentType.includes("javascript") ||
+        contentType.includes("json") ||
+        contentType.includes("css"));
+}
+function ensureStudioBuild(studioRoot) {
+    const distIndex = resolve(studioRoot, "dist", "index.html");
+    if (fs.existsSync(distIndex))
+        return;
+    execSync("npx vite build", {
+        cwd: studioRoot,
+        stdio: "inherit",
+    });
+    if (!fs.existsSync(distIndex)) {
+        throw new Error(`Studio build failed: ${distIndex} not found after vite build`);
+    }
+}
+function proxyRequest(targetOrigin, targetPath, req, res) {
+    const targetUrl = new URL(targetPath, targetOrigin);
+    const transport = targetUrl.protocol === "https:" ? https : http;
+    const headers = { ...req.headers };
+    headers.host = targetUrl.host;
+    headers["accept-encoding"] = "identity";
+    const proxyReq = transport.request(targetUrl, {
+        method: req.method,
+        headers,
+    }, (proxyRes) => {
+        const contentType = proxyRes.headers["content-type"] ?? "";
+        if (isTextResponse(contentType)) {
+            const chunks = [];
+            proxyRes.on("data", (chunk) => chunks.push(chunk));
+            proxyRes.on("end", () => {
+                const raw = Buffer.concat(chunks).toString("utf-8");
+                const rewritten = rewriteAbsolutePaths(raw, contentType);
+                const responseHeaders = { ...proxyRes.headers };
+                delete responseHeaders["content-length"];
+                delete responseHeaders["content-encoding"];
+                responseHeaders["cache-control"] = "no-store";
+                delete responseHeaders.etag;
+                res.writeHead(proxyRes.statusCode ?? 200, responseHeaders);
+                res.end(rewritten);
+            });
+        }
+        else {
+            const responseHeaders = { ...proxyRes.headers };
+            responseHeaders["cache-control"] = "no-store";
+            delete responseHeaders.etag;
+            res.writeHead(proxyRes.statusCode ?? 200, responseHeaders);
+            proxyRes.pipe(res);
+        }
+    });
+    proxyReq.on("error", (err) => {
+        res.writeHead(502);
+        res.end(`Proxy error: ${err.message}`);
+    });
+    req.pipe(proxyReq);
+}
+export async function startStaticServer(walkthrough) {
+    const require = createRequire(import.meta.url);
+    const studioRoot = dirname(require.resolve("@walkrstudio/studio/package.json"));
+    ensureStudioBuild(studioRoot);
+    let targetOrigin = "";
+    try {
+        targetOrigin = new URL(walkthrough.url).origin;
+    }
+    catch { }
+    const proxied = targetOrigin ? rewriteWalkthroughUrl(walkthrough, targetOrigin) : walkthrough;
+    const walkthroughJson = JSON.stringify(proxied, null, 2);
+    const distDir = resolve(studioRoot, "dist");
+    const port = await getFreePort();
+    const server = http.createServer((req, res) => {
+        const urlPath = req.url?.split("?")[0] ?? "/";
+        // Serve walkthrough.json from memory
+        if (urlPath === "/walkthrough.json") {
+            res.writeHead(200, {
+                "content-type": "application/json; charset=utf-8",
+                "cache-control": "no-store",
+            });
+            res.end(walkthroughJson);
+            return;
+        }
+        // Proxy /__target__/* to target origin
+        if (targetOrigin && urlPath.startsWith(PROXY_PREFIX)) {
+            const targetPath = urlPath.slice(PROXY_PREFIX.length) || "/";
+            proxyRequest(targetOrigin, targetPath, req, res);
+            return;
+        }
+        // Serve static files from dist
+        let filePath = join(distDir, urlPath === "/" ? "index.html" : urlPath);
+        // SPA fallback: if file doesn't exist and no extension, serve index.html
+        if (!fs.existsSync(filePath)) {
+            const ext = extname(filePath);
+            if (!ext) {
+                filePath = join(distDir, "index.html");
+            }
+        }
+        if (!fs.existsSync(filePath)) {
+            res.writeHead(404);
+            res.end("Not Found");
+            return;
+        }
+        const stat = fs.statSync(filePath);
+        if (stat.isDirectory()) {
+            filePath = join(filePath, "index.html");
+            if (!fs.existsSync(filePath)) {
+                res.writeHead(404);
+                res.end("Not Found");
+                return;
+            }
+        }
+        const ext = extname(filePath).toLowerCase();
+        const mime = MIME_TYPES[ext] ?? "application/octet-stream";
+        res.writeHead(200, {
+            "content-type": mime,
+            "content-length": stat.size,
+            "cache-control": "no-store",
+        });
+        fs.createReadStream(filePath).pipe(res);
+    });
+    await new Promise((resolve, reject) => {
+        server.listen(port, "127.0.0.1", () => resolve());
+        server.on("error", reject);
+    });
+    return {
+        port,
+        url: `http://127.0.0.1:${port}`,
+        close() {
+            server.close();
+        },
+    };
+}
+//# sourceMappingURL=static-server.js.map

package/dist/static-server.js.map

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

package/dist/streaming-encoder.d.ts

@@ -0,0 +1,26 @@
+import type { RecordResult } from "./types.js";
+interface StreamingEncoderOptions {
+    format: "mp4" | "gif" | "webm";
+    fps: number;
+    width: number;
+    height: number;
+    outputPath: string;
+    onProgress?: (percent: number) => void;
+    expectedFrames?: number;
+}
+export declare class StreamingEncoder {
+    private child;
+    private exitPromise;
+    private frameCount;
+    private readonly fps;
+    private readonly totalSeconds;
+    private readonly onProgress?;
+    private readonly outputPath;
+    constructor(options: StreamingEncoderOptions);
+    private parseProgress;
+    write(frame: Buffer): Promise<void>;
+    finish(): Promise<RecordResult>;
+    abort(): void;
+}
+export {};
+//# sourceMappingURL=streaming-encoder.d.ts.map

package/dist/streaming-encoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-encoder.d.ts","sourceRoot":"","sources":["../src/streaming-encoder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,UAAU,uBAAuB;IAC/B,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,OAAO,EAAE,uBAAuB;IAgC5C,OAAO,CAAC,aAAa;IAef,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAarC,KAAK,IAAI,IAAI;CAGd"}

package/dist/streaming-encoder.js

@@ -0,0 +1,89 @@
+import { spawn } from "node:child_process";
+export class StreamingEncoder {
+    child;
+    exitPromise;
+    frameCount = 0;
+    fps;
+    totalSeconds;
+    onProgress;
+    outputPath;
+    constructor(options) {
+        this.outputPath = options.outputPath;
+        this.onProgress = options.onProgress;
+        this.fps = options.fps;
+        this.totalSeconds = (options.expectedFrames ?? 0) / Math.max(1, options.fps);
+        const args = buildFfmpegArgs(options);
+        this.child = spawn("ffmpeg", args, {
+            stdio: ["pipe", "ignore", "pipe"],
+        });
+        this.exitPromise = new Promise((resolve, reject) => {
+            this.child.on("close", (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`ffmpeg exited with code ${code}`));
+                }
+            });
+            this.child.on("error", reject);
+        });
+        // Absorb stdin errors — they surface via exitPromise when ffmpeg exits
+        this.child.stdin?.on("error", () => { });
+        if (this.child.stderr && this.onProgress) {
+            this.child.stderr.on("data", (chunk) => {
+                this.parseProgress(chunk.toString());
+            });
+        }
+    }
+    parseProgress(output) {
+        if (!this.onProgress || this.totalSeconds <= 0)
+            return;
+        const match = /time=(\d+):(\d+):(\d+(?:\.\d+)?)/.exec(output);
+        if (!match)
+            return;
+        const hours = Number(match[1]);
+        const minutes = Number(match[2]);
+        const seconds = Number(match[3]);
+        const elapsedSeconds = hours * 3600 + minutes * 60 + seconds;
+        const percent = Math.max(0, Math.min(100, (elapsedSeconds / this.totalSeconds) * 100));
+        this.onProgress(percent);
+    }
+    async write(frame) {
+        const stdin = this.child.stdin;
+        if (!stdin || stdin.destroyed) {
+            throw new Error("ffmpeg stdin is not writable");
+        }
+        const ok = stdin.write(frame);
+        if (!ok) {
+            await new Promise((resolve) => stdin.once("drain", resolve));
+        }
+        this.frameCount++;
+    }
+    async finish() {
+        this.child.stdin?.end();
+        await this.exitPromise;
+        this.onProgress?.(100);
+        return {
+            outputPath: this.outputPath,
+            duration: Math.round((this.frameCount / this.fps) * 1000),
+            frameCount: this.frameCount,
+        };
+    }
+    abort() {
+        this.child.kill("SIGTERM");
+    }
+}
+function buildFfmpegArgs(options) {
+    const { format, fps, outputPath } = options;
+    // Input: read concatenated JPEG frames from stdin (JPEG is self-delimiting)
+    const inputArgs = ["-y", "-f", "image2pipe", "-c:v", "mjpeg", "-r", String(fps), "-i", "pipe:0"];
+    if (format === "gif") {
+        return [...inputArgs, "-vf", "fps=15,scale=1280:-1:flags=lanczos", outputPath];
+    }
+    if (format === "webm") {
+        return [...inputArgs, "-c:v", "libvpx-vp9", outputPath];
+    }
+    // mp4
+    return [...inputArgs, "-c:v", "libx264", "-pix_fmt", "yuv420p", outputPath];
+}
+//# sourceMappingURL=streaming-encoder.js.map

package/dist/streaming-encoder.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,15 @@
+export interface RecordOptions {
+    width?: number;
+    height?: number;
+    fps?: number;
+    format?: "mp4" | "gif" | "webm" | "embed";
+    output?: string;
+    realtime?: boolean;
+    onProgress?: (percent: number) => void;
+}
+export interface RecordResult {
+    outputPath: string;
+    duration: number;
+    frameCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@walkrstudio/recorder",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "@walkrstudio/studio": "^0.3.0",
+    "@walkrstudio/core": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.14"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "biome check src",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "dev": "tsc -p tsconfig.json --watch"
+  }
+}