rust-http-playback-proxy 0.2.0

package/README.md

@@ -0,0 +1,259 @@
+# HTTP Playback Proxy - TypeScript/Node.js Wrapper
+
+TypeScript/Node.js wrapper for the HTTP Playback Proxy Rust binary.
+
+## Installation
+
+```bash
+npm install http-playback-proxy
+```
+
+## Usage
+
+### Recording Mode
+
+```typescript
+import { startRecording } from 'http-playback-proxy';
+
+async function record() {
+  // Start recording proxy (with entry URL)
+  const proxy = await startRecording({
+    entryUrl: 'https://example.com',
+    port: 8080,
+    deviceType: 'mobile',
+    inventoryDir: './inventory',
+  });
+
+  console.log(`Recording proxy started on port ${proxy.port}`);
+
+  // Do your HTTP requests through the proxy (e.g., with a browser)
+  // ...
+
+  // Stop recording after some time (this saves the inventory)
+  setTimeout(async () => {
+    await proxy.stop();
+
+    // Load the recorded inventory
+    const inventory = await proxy.getInventory();
+    console.log(`Recorded ${inventory.resources.length} resources`);
+  }, 10000);
+}
+
+// Example: Start recording without entry URL (manual browsing)
+async function recordWithoutEntryURL() {
+  // All options are optional - uses defaults
+  const proxy = await startRecording({});
+
+  console.log(`Recording proxy started on port ${proxy.port}`);
+  console.log('Configure your browser to use proxy 127.0.0.1:8080');
+  console.log('Then browse to any website...');
+
+  // Stop after some time
+  setTimeout(async () => {
+    await proxy.stop();
+  }, 30000);
+}
+
+record().catch(console.error);
+```
+
+### Playback Mode
+
+```typescript
+import { startPlayback } from 'http-playback-proxy';
+
+async function playback() {
+  // Start playback proxy
+  const proxy = await startPlayback({
+    port: 8080,
+    inventoryDir: './inventory',
+  });
+
+  console.log(`Playback proxy started on port ${proxy.port}`);
+
+  // Do your HTTP requests through the proxy
+  // The proxy will replay the recorded responses with accurate timing
+  // ...
+
+  // Stop playback after some time
+  setTimeout(async () => {
+    await proxy.stop();
+  }, 10000);
+}
+
+playback().catch(console.error);
+```
+
+### Working with Inventory
+
+```typescript
+import { loadInventory, getResourceContentPath } from 'http-playback-proxy';
+
+async function analyzeInventory() {
+  // Load inventory
+  const inventory = await loadInventory('./inventory/inventory.json');
+
+  // Iterate through resources
+  for (const [i, resource] of inventory.resources.entries()) {
+    console.log(`Resource ${i}: ${resource.method} ${resource.url}`);
+    console.log(`  TTFB: ${resource.ttfbMs} ms`);
+    if (resource.statusCode) {
+      console.log(`  Status: ${resource.statusCode}`);
+    }
+
+    // Get content file path
+    if (resource.contentFilePath) {
+      const contentPath = getResourceContentPath('./inventory', resource);
+      console.log(`  Content: ${contentPath}`);
+    }
+  }
+}
+
+analyzeInventory().catch(console.error);
+```
+
+## API Reference
+
+### Types
+
+#### `RecordingOptions`
+```typescript
+interface RecordingOptions {
+  entryUrl?: string;       // Optional: Entry URL to start recording from
+  port?: number;           // Optional: Port to listen on (default: 8080, will auto-search)
+  deviceType?: DeviceType; // Optional: 'desktop' or 'mobile' (default: 'mobile')
+  inventoryDir?: string;   // Optional: Directory to save inventory (default: './inventory')
+}
+```
+
+#### `PlaybackOptions`
+```typescript
+interface PlaybackOptions {
+  port?: number;         // Optional: Port to listen on (default: 8080, will auto-search)
+  inventoryDir?: string; // Optional: Directory containing inventory (default: './inventory')
+}
+```
+
+#### `Inventory`
+```typescript
+interface Inventory {
+  entryUrl?: string;
+  deviceType?: DeviceType;
+  resources: Resource[];
+}
+```
+
+#### `Resource`
+```typescript
+interface Resource {
+  method: string;
+  url: string;
+  ttfbMs: number;
+  mbps?: number;
+  statusCode?: number;
+  errorMessage?: string;
+  rawHeaders?: Record<string, string>;
+  contentEncoding?: ContentEncodingType;
+  contentTypeMime?: string;
+  contentTypeCharset?: string;
+  contentFilePath?: string;
+  contentUtf8?: string;
+  contentBase64?: string;
+  minify?: boolean;
+}
+```
+
+### Functions
+
+#### `startRecording(options: RecordingOptions): Promise<Proxy>`
+Starts a recording proxy.
+
+#### `startPlayback(options: PlaybackOptions): Promise<Proxy>`
+Starts a playback proxy.
+
+#### `Proxy.stop(): Promise<void>`
+Stops the proxy gracefully.
+
+#### `Proxy.isRunning(): boolean`
+Checks if the proxy is still running.
+
+#### `Proxy.wait(): Promise<void>`
+Waits for the proxy to exit.
+
+#### `Proxy.getInventory(): Promise<Inventory>`
+Loads the inventory for this proxy.
+
+#### `loadInventory(path: string): Promise<Inventory>`
+Loads an inventory from a JSON file.
+
+#### `saveInventory(path: string, inventory: Inventory): Promise<void>`
+Saves an inventory to a JSON file.
+
+#### `getResourceContentPath(inventoryDir: string, resource: Resource): string`
+Returns the full path to a resource's content file.
+
+#### `getInventoryPath(inventoryDir: string): string`
+Returns the path to the inventory.json file.
+
+#### `ensureBinary(): Promise<void>`
+Ensures the binary is available, downloading if necessary.
+
+## Binary Distribution
+
+### How Binaries are Located
+
+The TypeScript wrapper searches for binaries in the following order:
+
+1. **Package directory** (`node_modules/http-playback-proxy/bin/<platform>/`) - Production
+   - Binaries are bundled with the npm package via GitHub Actions
+   - Included in the `files` field of package.json
+2. **Cache directory** (`~/.cache/http-playback-proxy/bin/<platform>/`) - Fallback
+   - Used if package binaries are not available
+   - Automatically downloaded on first use
+   - Can be customized via `HTTP_PLAYBACK_PROXY_CACHE_DIR` environment variable
+
+### Package Contents
+
+The npm package includes:
+- `dist/` - Compiled TypeScript code
+- `bin/` - Prebuilt binaries for all supported platforms
+- `README.md` - Documentation
+
+### First-Time Usage
+
+The wrapper automatically ensures the binary is available:
+
+```typescript
+import { startRecording } from 'http-playback-proxy';
+
+async function main() {
+  // Automatically uses packaged binary or downloads if needed
+  const proxy = await startRecording({});
+  // ...
+}
+```
+
+You can also explicitly ensure the binary is available:
+
+```typescript
+import { ensureBinary } from 'http-playback-proxy';
+
+await ensureBinary();
+```
+
+#### `checkBinaryExists(): boolean`
+Checks if the binary exists locally.
+
+#### `downloadBinary(version?: string): Promise<void>`
+Downloads a specific version of the binary from GitHub Releases.
+
+## Environment Variables
+
+- `HTTP_PLAYBACK_PROXY_CACHE_DIR`: Custom cache directory for downloaded binaries
+- `XDG_CACHE_HOME`: XDG cache directory (fallback)
+
+If neither is set, binaries are cached in `~/.cache/http-playback-proxy`.
+
+## License
+
+MIT

package/dist/binary.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Get the version of this TypeScript wrapper
+ */
+export declare function getVersion(): string;
+/**
+ * Get the current platform identifier
+ */
+export declare function getPlatform(): string;
+/**
+ * Get the binary file name for the current platform
+ */
+export declare function getBinaryName(): string;
+/**
+ * Get the expected path to the binary relative to package root
+ */
+export declare function getBinaryPath(): string;
+/**
+ * Get the cache directory for downloaded binaries
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get the package root directory
+ * In development: typescript/dist/ -> typescript/
+ * In production: node_modules/http-playback-proxy/dist/ -> node_modules/http-playback-proxy/
+ */
+export declare function getPackageRoot(): string;
+/**
+ * Check if the binary exists
+ */
+export declare function checkBinaryExists(): boolean;
+/**
+ * Download the binary from GitHub Releases
+ */
+export declare function downloadBinary(version?: string): Promise<void>;
+/**
+ * Ensure the binary is available, downloading if necessary
+ */
+export declare function ensureBinary(): Promise<void>;
+/**
+ * Get the full path to the binary
+ */
+export declare function getFullBinaryPath(): string;
+//# sourceMappingURL=binary.d.ts.map

package/dist/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAQnC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAapC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAepC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAoBvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAc3C;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DpE;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAYlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAc1C"}

package/dist/binary.js

@@ -0,0 +1,241 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersion = getVersion;
+exports.getPlatform = getPlatform;
+exports.getBinaryName = getBinaryName;
+exports.getBinaryPath = getBinaryPath;
+exports.getCacheDir = getCacheDir;
+exports.getPackageRoot = getPackageRoot;
+exports.checkBinaryExists = checkBinaryExists;
+exports.downloadBinary = downloadBinary;
+exports.ensureBinary = ensureBinary;
+exports.getFullBinaryPath = getFullBinaryPath;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const https = __importStar(require("https"));
+const fs_1 = require("fs");
+const tar = __importStar(require("tar"));
+const GITHUB_USER = 'pagespeed-quest';
+const GITHUB_REPO = 'http-playback-proxy';
+const BASE_URL = `https://github.com/${GITHUB_USER}/${GITHUB_REPO}/releases/download`;
+/**
+ * Get the version of this TypeScript wrapper
+ */
+function getVersion() {
+    try {
+        const packageJsonPath = path.join(__dirname, '..', 'package.json');
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        return packageJson.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/**
+ * Get the current platform identifier
+ */
+function getPlatform() {
+    const platform = process.platform;
+    const arch = process.arch;
+    if (platform === 'darwin') {
+        return arch === 'arm64' ? 'darwin-arm64' : 'darwin-amd64';
+    }
+    else if (platform === 'linux') {
+        return arch === 'arm64' ? 'linux-arm64' : 'linux-amd64';
+    }
+    else if (platform === 'win32') {
+        return 'windows-amd64';
+    }
+    throw new Error(`Unsupported platform: ${platform}-${arch}`);
+}
+/**
+ * Get the binary file name for the current platform
+ */
+function getBinaryName() {
+    return process.platform === 'win32' ? 'http-playback-proxy.exe' : 'http-playback-proxy';
+}
+/**
+ * Get the expected path to the binary relative to package root
+ */
+function getBinaryPath() {
+    const platform = getPlatform();
+    return path.join('bin', platform, getBinaryName());
+}
+/**
+ * Get the cache directory for downloaded binaries
+ */
+function getCacheDir() {
+    // Check environment variable first
+    const envCache = process.env.HTTP_PLAYBACK_PROXY_CACHE_DIR;
+    if (envCache) {
+        return envCache;
+    }
+    // Try XDG_CACHE_HOME
+    const xdgCache = process.env.XDG_CACHE_HOME;
+    if (xdgCache) {
+        return path.join(xdgCache, 'http-playback-proxy');
+    }
+    // Fall back to user's home directory
+    return path.join(os.homedir(), '.cache', 'http-playback-proxy');
+}
+/**
+ * Get the package root directory
+ * In development: typescript/dist/ -> typescript/
+ * In production: node_modules/http-playback-proxy/dist/ -> node_modules/http-playback-proxy/
+ */
+function getPackageRoot() {
+    // __dirname in compiled code (dist/) points to dist/
+    // So ../ goes to package root
+    const packageRoot = path.join(__dirname, '..');
+    // Verify this is actually the package root by checking for package.json
+    const packageJsonPath = path.join(packageRoot, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            if (packageJson.name === 'http-playback-proxy') {
+                return packageRoot;
+            }
+        }
+        catch {
+            // Fall through to return default path
+        }
+    }
+    // Fallback to simple relative path
+    return packageRoot;
+}
+/**
+ * Check if the binary exists
+ */
+function checkBinaryExists() {
+    // Check package directory first
+    const packagePath = path.join(getPackageRoot(), getBinaryPath());
+    if (fs.existsSync(packagePath)) {
+        return true;
+    }
+    // Check cache directory
+    const cachePath = path.join(getCacheDir(), getBinaryPath());
+    if (fs.existsSync(cachePath)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Download the binary from GitHub Releases
+ */
+async function downloadBinary(version) {
+    const ver = version || getVersion();
+    const platform = getPlatform();
+    const archiveName = `http-playback-proxy-v${ver}-${platform}.tar.gz`;
+    const url = `${BASE_URL}/v${ver}/${archiveName}`;
+    // Try to download to cache directory
+    const cacheDir = getCacheDir();
+    let targetDir = cacheDir;
+    try {
+        fs.mkdirSync(cacheDir, { recursive: true });
+    }
+    catch (err) {
+        console.warn(`Could not create cache directory, using package directory: ${err}`);
+        targetDir = getPackageRoot();
+    }
+    console.log(`Downloading http-playback-proxy binary for ${platform}...`);
+    console.log(`URL: ${url}`);
+    console.log(`Target: ${targetDir}`);
+    // Download the tar.gz archive
+    const tmpFile = path.join(os.tmpdir(), archiveName);
+    const tmpStream = (0, fs_1.createWriteStream)(tmpFile);
+    await new Promise((resolve, reject) => {
+        https.get(url, (response) => {
+            if (response.statusCode !== 200) {
+                reject(new Error(`Failed to download binary: HTTP ${response.statusCode}`));
+                return;
+            }
+            response.pipe(tmpStream);
+            tmpStream.on('finish', () => {
+                tmpStream.close();
+                resolve();
+            });
+            tmpStream.on('error', reject);
+        }).on('error', reject);
+    });
+    // Extract the tar.gz archive
+    const binDir = path.join(targetDir, 'bin', platform);
+    fs.mkdirSync(binDir, { recursive: true });
+    await tar.extract({
+        file: tmpFile,
+        cwd: binDir,
+    });
+    // Make binary executable on Unix-like systems
+    if (process.platform !== 'win32') {
+        const binaryPath = path.join(binDir, getBinaryName());
+        fs.chmodSync(binaryPath, 0o755);
+    }
+    // Clean up temp file
+    fs.unlinkSync(tmpFile);
+    console.log(`Successfully downloaded and extracted binary to ${targetDir}`);
+}
+/**
+ * Ensure the binary is available, downloading if necessary
+ */
+async function ensureBinary() {
+    if (checkBinaryExists()) {
+        return;
+    }
+    console.log('Pre-built binary not found. Attempting to download from GitHub Releases...');
+    try {
+        await downloadBinary();
+    }
+    catch (err) {
+        throw new Error(`Failed to download binary v${getVersion()}: ${err}`);
+    }
+}
+/**
+ * Get the full path to the binary
+ */
+function getFullBinaryPath() {
+    // Check package directory first
+    const packagePath = path.join(getPackageRoot(), getBinaryPath());
+    if (fs.existsSync(packagePath)) {
+        return packagePath;
+    }
+    // Check cache directory
+    const cachePath = path.join(getCacheDir(), getBinaryPath());
+    if (fs.existsSync(cachePath)) {
+        return cachePath;
+    }
+    throw new Error('Binary not found, please call ensureBinary() first');
+}
+//# sourceMappingURL=binary.js.map

package/dist/binary.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTTP Playback Proxy - TypeScript/Node.js Wrapper
+ *
+ * A wrapper for the HTTP Playback Proxy Rust binary that provides:
+ * - Recording HTTP traffic with accurate timing
+ * - Playing back recorded traffic with precise timing control
+ * - Inventory management for recorded resources
+ */
+export { Proxy, startRecording, startPlayback, loadInventory, saveInventory, getResourceContentPath, getInventoryPath, } from './proxy';
+export { ensureBinary, checkBinaryExists, downloadBinary, getVersion, getPlatform, getBinaryName, } from './binary';
+export type { DeviceType, ContentEncodingType, HttpHeaders, Resource, Inventory, RecordingOptions, PlaybackOptions, ProxyMode, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * HTTP Playback Proxy - TypeScript/Node.js Wrapper
+ *
+ * A wrapper for the HTTP Playback Proxy Rust binary that provides:
+ * - Recording HTTP traffic with accurate timing
+ * - Playing back recorded traffic with precise timing control
+ * - Inventory management for recorded resources
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBinaryName = exports.getPlatform = exports.getVersion = exports.downloadBinary = exports.checkBinaryExists = exports.ensureBinary = exports.getInventoryPath = exports.getResourceContentPath = exports.saveInventory = exports.loadInventory = exports.startPlayback = exports.startRecording = exports.Proxy = void 0;
+var proxy_1 = require("./proxy");
+Object.defineProperty(exports, "Proxy", { enumerable: true, get: function () { return proxy_1.Proxy; } });
+Object.defineProperty(exports, "startRecording", { enumerable: true, get: function () { return proxy_1.startRecording; } });
+Object.defineProperty(exports, "startPlayback", { enumerable: true, get: function () { return proxy_1.startPlayback; } });
+Object.defineProperty(exports, "loadInventory", { enumerable: true, get: function () { return proxy_1.loadInventory; } });
+Object.defineProperty(exports, "saveInventory", { enumerable: true, get: function () { return proxy_1.saveInventory; } });
+Object.defineProperty(exports, "getResourceContentPath", { enumerable: true, get: function () { return proxy_1.getResourceContentPath; } });
+Object.defineProperty(exports, "getInventoryPath", { enumerable: true, get: function () { return proxy_1.getInventoryPath; } });
+var binary_1 = require("./binary");
+Object.defineProperty(exports, "ensureBinary", { enumerable: true, get: function () { return binary_1.ensureBinary; } });
+Object.defineProperty(exports, "checkBinaryExists", { enumerable: true, get: function () { return binary_1.checkBinaryExists; } });
+Object.defineProperty(exports, "downloadBinary", { enumerable: true, get: function () { return binary_1.downloadBinary; } });
+Object.defineProperty(exports, "getVersion", { enumerable: true, get: function () { return binary_1.getVersion; } });
+Object.defineProperty(exports, "getPlatform", { enumerable: true, get: function () { return binary_1.getPlatform; } });
+Object.defineProperty(exports, "getBinaryName", { enumerable: true, get: function () { return binary_1.getBinaryName; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,iCAQiB;AAPf,8FAAA,KAAK,OAAA;AACL,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AACb,sGAAA,aAAa,OAAA;AACb,+GAAA,sBAAsB,OAAA;AACtB,yGAAA,gBAAgB,OAAA;AAGlB,mCAOkB;AANhB,sGAAA,YAAY,OAAA;AACZ,2GAAA,iBAAiB,OAAA;AACjB,wGAAA,cAAc,OAAA;AACd,oGAAA,UAAU,OAAA;AACV,qGAAA,WAAW,OAAA;AACX,uGAAA,aAAa,OAAA"}

package/dist/proxy.d.ts

@@ -0,0 +1,80 @@
+import { ChildProcess } from 'child_process';
+import type { ProxyMode, RecordingOptions, PlaybackOptions, Inventory } from './types';
+/**
+ * Represents a running proxy instance
+ */
+export declare class Proxy {
+    readonly mode: ProxyMode;
+    readonly inventoryDir: string;
+    readonly entryUrl?: string;
+    readonly deviceType?: string;
+    private _port;
+    private _controlPort?;
+    private process?;
+    constructor(mode: ProxyMode, port: number, inventoryDir: string, controlPort?: number, entryUrl?: string, deviceType?: string);
+    /**
+     * Get the actual port number (may differ from requested port if 0 was used)
+     */
+    get port(): number;
+    /**
+     * Get the control API port number (if enabled)
+     */
+    get controlPort(): number | undefined;
+    /**
+     * Update the port number (used internally when OS assigns a port)
+     */
+    updatePort(port: number): void;
+    /**
+     * Update the control port number (used internally when OS assigns a port)
+     */
+    updateControlPort(controlPort: number): void;
+    /**
+     * Set the child process
+     */
+    setProcess(proc: ChildProcess): void;
+    /**
+     * Stop the proxy gracefully
+     * Sends shutdown request via control API if available, otherwise uses SIGTERM
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the proxy is still running
+     */
+    isRunning(): boolean;
+    /**
+     * Wait for the proxy to exit
+     */
+    wait(): Promise<void>;
+    /**
+     * Load the inventory for this proxy
+     * This is useful after recording is complete
+     */
+    getInventory(): Promise<Inventory>;
+}
+/**
+ * Start a recording proxy
+ */
+export declare function startRecording(options: RecordingOptions): Promise<Proxy>;
+/**
+ * Start a playback proxy
+ */
+export declare function startPlayback(options: PlaybackOptions): Promise<Proxy>;
+/**
+ * Load an inventory from a JSON file
+ */
+export declare function loadInventory(inventoryPath: string): Promise<Inventory>;
+/**
+ * Save an inventory to a JSON file
+ */
+export declare function saveInventory(inventoryPath: string, inventory: Inventory): Promise<void>;
+/**
+ * Get the full path to a resource's content file
+ */
+export declare function getResourceContentPath(inventoryDir: string, resource: {
+    contentFilePath?: string;
+}): string;
+/**
+ * Get the path to the inventory.json file
+ */
+export declare function getInventoryPath(inventoryDir: string): string;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAC;AAIpD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEvF;;GAEG;AACH,qBAAa,KAAK;IAChB,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAe;gBAG7B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM;IAUrB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAIpC;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqE3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAcpB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;CAIzC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CA6F9E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,CA0F5E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAG7E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK3G;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/proxy.js

@@ -0,0 +1,389 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Proxy = void 0;
+exports.startRecording = startRecording;
+exports.startPlayback = startPlayback;
+exports.loadInventory = loadInventory;
+exports.saveInventory = saveInventory;
+exports.getResourceContentPath = getResourceContentPath;
+exports.getInventoryPath = getInventoryPath;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const binary_1 = require("./binary");
+/**
+ * Represents a running proxy instance
+ */
+class Proxy {
+    constructor(mode, port, inventoryDir, controlPort, entryUrl, deviceType) {
+        this.mode = mode;
+        this._port = port;
+        this._controlPort = controlPort;
+        this.inventoryDir = inventoryDir;
+        this.entryUrl = entryUrl;
+        this.deviceType = deviceType;
+    }
+    /**
+     * Get the actual port number (may differ from requested port if 0 was used)
+     */
+    get port() {
+        return this._port;
+    }
+    /**
+     * Get the control API port number (if enabled)
+     */
+    get controlPort() {
+        return this._controlPort;
+    }
+    /**
+     * Update the port number (used internally when OS assigns a port)
+     */
+    updatePort(port) {
+        this._port = port;
+    }
+    /**
+     * Update the control port number (used internally when OS assigns a port)
+     */
+    updateControlPort(controlPort) {
+        this._controlPort = controlPort;
+    }
+    /**
+     * Set the child process
+     */
+    setProcess(proc) {
+        this.process = proc;
+    }
+    /**
+     * Stop the proxy gracefully
+     * Sends shutdown request via control API if available, otherwise uses SIGTERM
+     */
+    async stop() {
+        if (!this.process) {
+            throw new Error('Proxy is not running');
+        }
+        return new Promise((resolve, reject) => {
+            if (!this.process) {
+                reject(new Error('Proxy is not running'));
+                return;
+            }
+            // Set up timeout
+            const timeout = setTimeout(() => {
+                if (this.process) {
+                    this.process.kill('SIGKILL');
+                    reject(new Error('Proxy did not stop gracefully, killed forcefully'));
+                }
+            }, 10000);
+            // Listen for exit
+            this.process.once('exit', (code, signal) => {
+                clearTimeout(timeout);
+                // Exit code 0 is expected for clean shutdown
+                // Also accept null exit code and SIGINT signal
+                if (code === 0 || code === null || signal === 'SIGINT') {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Proxy exited with code ${code} signal ${signal}`));
+                }
+            });
+            // Send shutdown request via control API if enabled
+            if (this._controlPort) {
+                const http = require('http');
+                const req = http.request({
+                    hostname: '127.0.0.1',
+                    port: this._controlPort,
+                    path: '/_shutdown',
+                    method: 'POST',
+                }, (res) => {
+                    // Response received, proxy should be shutting down
+                    res.resume(); // Consume response
+                });
+                req.on('error', (err) => {
+                    // If HTTP request fails, fall back to SIGTERM
+                    console.warn(`HTTP shutdown failed: ${err.message}, falling back to SIGTERM`);
+                    try {
+                        this.process?.kill('SIGTERM');
+                    }
+                    catch {
+                        // Ignore if already dead
+                    }
+                });
+                req.end();
+            }
+            else {
+                // No control port, use SIGTERM directly
+                try {
+                    this.process.kill('SIGTERM');
+                }
+                catch {
+                    // Ignore if already dead
+                }
+            }
+        });
+    }
+    /**
+     * Check if the proxy is still running
+     */
+    isRunning() {
+        if (!this.process) {
+            return false;
+        }
+        // Check if process is still alive
+        try {
+            process.kill(this.process.pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Wait for the proxy to exit
+     */
+    async wait() {
+        if (!this.process) {
+            throw new Error('Proxy is not running');
+        }
+        return new Promise((resolve, reject) => {
+            this.process.once('exit', (code) => {
+                if (code === 0) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Proxy exited with code ${code}`));
+                }
+            });
+        });
+    }
+    /**
+     * Load the inventory for this proxy
+     * This is useful after recording is complete
+     */
+    async getInventory() {
+        const inventoryPath = path.join(this.inventoryDir, 'inventory.json');
+        return loadInventory(inventoryPath);
+    }
+}
+exports.Proxy = Proxy;
+/**
+ * Start a recording proxy
+ */
+async function startRecording(options) {
+    await (0, binary_1.ensureBinary)();
+    const binaryPath = (0, binary_1.getFullBinaryPath)();
+    // Set defaults to match CLI behavior
+    const port = options.port !== undefined ? options.port : 18080;
+    const deviceType = options.deviceType || 'mobile';
+    const inventoryDir = options.inventoryDir || './inventory';
+    // Build command
+    const args = ['recording'];
+    // Add entry URL if provided
+    if (options.entryUrl) {
+        args.push(options.entryUrl);
+    }
+    // Add port option (only if explicitly specified and not 0 or default)
+    if (options.port !== undefined && options.port !== 0 && options.port !== 18080) {
+        args.push('--port', port.toString());
+    }
+    // Add device type
+    args.push('--device', deviceType);
+    // Add inventory directory
+    args.push('--inventory', inventoryDir);
+    // Add control port if specified
+    const controlPort = options.controlPort;
+    if (controlPort !== undefined) {
+        args.push('--control-port', controlPort.toString());
+    }
+    // Start the process with piped stdout to capture port info
+    const spawnOptions = {
+        stdio: ['ignore', 'pipe', 'inherit'],
+        detached: false,
+    };
+    if (process.platform === 'win32') {
+        spawnOptions.windowsVerbatimArguments = false;
+    }
+    const proc = (0, child_process_1.spawn)(binaryPath, args, spawnOptions);
+    const proxy = new Proxy('recording', port, inventoryDir, controlPort, options.entryUrl, deviceType);
+    proxy.setProcess(proc);
+    // Capture stdout to extract actual port number when using port 0
+    return new Promise((resolve, reject) => {
+        let resolved = false;
+        const timeout = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                resolve(proxy);
+            }
+        }, 2000);
+        proc.stdout?.on('data', (data) => {
+            const output = data.toString();
+            // Look for "Recording proxy listening on 127.0.0.1:XXXXX" or "Playback proxy listening on 127.0.0.1:XXXXX"
+            const match = output.match(/proxy listening on (?:127\.0\.0\.1|0\.0\.0\.0):(\d+)/i);
+            if (match && match[1]) {
+                const actualPort = parseInt(match[1], 10);
+                proxy.updatePort(actualPort);
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    resolve(proxy);
+                }
+            }
+            // Forward output to console
+            process.stdout.write(data);
+        });
+        proc.on('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                reject(err);
+            }
+        });
+        proc.on('exit', (code) => {
+            if (!resolved && code !== 0) {
+                resolved = true;
+                clearTimeout(timeout);
+                reject(new Error(`Proxy exited with code ${code}`));
+            }
+        });
+    });
+}
+/**
+ * Start a playback proxy
+ */
+async function startPlayback(options) {
+    await (0, binary_1.ensureBinary)();
+    const binaryPath = (0, binary_1.getFullBinaryPath)();
+    // Set defaults
+    const port = options.port !== undefined ? options.port : 18080;
+    const inventoryDir = options.inventoryDir || './inventory';
+    // Verify inventory exists
+    const inventoryPath = getInventoryPath(inventoryDir);
+    if (!fs.existsSync(inventoryPath)) {
+        throw new Error(`Inventory file not found at ${inventoryPath}`);
+    }
+    // Build command
+    const args = ['playback'];
+    // Add port option (only if not default)
+    if (options.port !== undefined && options.port !== 18080) {
+        args.push('--port', port.toString());
+    }
+    // Add inventory directory
+    args.push('--inventory', inventoryDir);
+    // Add control port if specified
+    const controlPort = options.controlPort;
+    if (controlPort !== undefined) {
+        args.push('--control-port', controlPort.toString());
+    }
+    // Start the process with piped stdout to capture port info
+    const spawnOptions = {
+        stdio: ['ignore', 'pipe', 'inherit'],
+        detached: false,
+    };
+    if (process.platform === 'win32') {
+        spawnOptions.windowsVerbatimArguments = false;
+    }
+    const proc = (0, child_process_1.spawn)(binaryPath, args, spawnOptions);
+    const proxy = new Proxy('playback', port, inventoryDir, controlPort);
+    proxy.setProcess(proc);
+    // Capture stdout to extract actual port number when using port 0
+    return new Promise((resolve, reject) => {
+        let resolved = false;
+        const timeout = setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                resolve(proxy);
+            }
+        }, 2000);
+        proc.stdout?.on('data', (data) => {
+            const output = data.toString();
+            // Look for "Playback proxy listening on 127.0.0.1:XXXXX"
+            const match = output.match(/proxy listening on (?:127\.0\.0\.1|0\.0\.0\.0):(\d+)/i);
+            if (match && match[1]) {
+                const actualPort = parseInt(match[1], 10);
+                proxy.updatePort(actualPort);
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timeout);
+                    resolve(proxy);
+                }
+            }
+            // Forward output to console
+            process.stdout.write(data);
+        });
+        proc.on('error', (err) => {
+            if (!resolved) {
+                resolved = true;
+                clearTimeout(timeout);
+                reject(err);
+            }
+        });
+        proc.on('exit', (code) => {
+            if (!resolved && code !== 0) {
+                resolved = true;
+                clearTimeout(timeout);
+                reject(new Error(`Proxy exited with code ${code}`));
+            }
+        });
+    });
+}
+/**
+ * Load an inventory from a JSON file
+ */
+async function loadInventory(inventoryPath) {
+    const data = await fs.promises.readFile(inventoryPath, 'utf8');
+    return JSON.parse(data);
+}
+/**
+ * Save an inventory to a JSON file
+ */
+async function saveInventory(inventoryPath, inventory) {
+    const data = JSON.stringify(inventory, null, 2);
+    await fs.promises.writeFile(inventoryPath, data, 'utf8');
+}
+/**
+ * Get the full path to a resource's content file
+ */
+function getResourceContentPath(inventoryDir, resource) {
+    if (!resource.contentFilePath) {
+        return '';
+    }
+    return path.join(inventoryDir, resource.contentFilePath);
+}
+/**
+ * Get the path to the inventory.json file
+ */
+function getInventoryPath(inventoryDir) {
+    return path.join(inventoryDir, 'inventory.json');
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Device type for recording
+ */
+export type DeviceType = 'desktop' | 'mobile';
+/**
+ * Content encoding type
+ */
+export type ContentEncodingType = 'gzip' | 'compress' | 'deflate' | 'br' | 'identity';
+/**
+ * HTTP headers map
+ */
+export type HttpHeaders = Record<string, string>;
+/**
+ * Represents a single HTTP resource in the inventory
+ */
+export interface Resource {
+    method: string;
+    url: string;
+    ttfbMs: number;
+    mbps?: number;
+    statusCode?: number;
+    errorMessage?: string;
+    rawHeaders?: HttpHeaders;
+    contentEncoding?: ContentEncodingType;
+    contentTypeMime?: string;
+    contentTypeCharset?: string;
+    contentFilePath?: string;
+    contentUtf8?: string;
+    contentBase64?: string;
+    minify?: boolean;
+}
+/**
+ * Represents the complete inventory of recorded resources
+ */
+export interface Inventory {
+    entryUrl?: string;
+    deviceType?: DeviceType;
+    resources: Resource[];
+}
+/**
+ * Options for starting a recording proxy
+ */
+export interface RecordingOptions {
+    entryUrl?: string;
+    port?: number;
+    deviceType?: DeviceType;
+    inventoryDir?: string;
+    controlPort?: number;
+}
+/**
+ * Options for starting a playback proxy
+ */
+export interface PlaybackOptions {
+    port?: number;
+    inventoryDir?: string;
+    controlPort?: number;
+}
+/**
+ * Proxy mode
+ */
+export type ProxyMode = 'recording' | 'playback';
+//# 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;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,GAAG,UAAU,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# 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,65 @@
+{
+  "name": "rust-http-playback-proxy",
+  "version": "0.2.0",
+  "description": "HTTP traffic recording and playback proxy with precise timing control for PageSpeed optimization and performance testing",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "npm run build && node --test dist/test/*.test.js",
+    "test:watch": "npm run build && node --test --watch dist/test/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "http",
+    "https",
+    "proxy",
+    "playback",
+    "recording",
+    "performance",
+    "testing",
+    "mitm",
+    "pagespeed",
+    "web-performance",
+    "timing",
+    "ttfb",
+    "network-simulation",
+    "replay",
+    "rust"
+  ],
+  "author": "PageSpeed Quest",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pagespeed-quest/http-playback-proxy.git",
+    "directory": "typescript"
+  },
+  "homepage": "https://github.com/pagespeed-quest/http-playback-proxy#readme",
+  "bugs": {
+    "url": "https://github.com/pagespeed-quest/http-playback-proxy/issues"
+  },
+  "dependencies": {
+    "tar": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/tar": "^6.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}