@speedscale/proxymock 2.3.645

package/README.md

@@ -0,0 +1,62 @@
+# proxymock
+
+A free command-line tool that automatically creates mocks and tests from watching your app run. proxymock is a backend service emulator that lets you run your app as if it were in a live environment.
+
+## What is proxymock?
+
+proxymock allows you to record, visualize, mock, and replay traffic on your local system. It captures your application's interactions with external services and creates realistic mocks that can be used for development and testing without hitting real APIs or databases.
+
+### Key Features
+
+- **Free for Local Development**: Complete functionality available at no cost
+- **Record & Replay**: Capture real traffic from your application and replay it later
+- **Smart Proxy**: Intercepts and mocks outbound requests without code changes
+- **Realistic Mocks**: Generate mocks from actual production-like traffic
+- **Multiple Protocols**: Support for HTTP, HTTPS, gRPC, and other TCP protocols
+- **MCP Integration**: Model Context Protocol support for AI development tools
+
+### Use Cases
+
+- Develop locally without depending on live backend services
+- Test applications when external services are unavailable or unreliable
+- Bypass API rate limits during development
+- Create consistent test environments
+- Generate realistic test data from production traffic
+
+## Installation
+
+```bash
+# Run the latest version
+npx -y @speedscale/proxymock --help
+```
+
+The binary will be automatically downloaded and cached in `~/.speedscale/` on first run.
+
+## Getting Started
+
+For complete setup instructions and tutorials, visit the [proxymock documentation](https://docs.speedscale.com/proxymock/getting-started/quickstart-cli/).
+
+## MCP (Model Context Protocol) Support
+
+proxymock includes an MCP server for integration with AI development tools like Cursor and Claude Desktop. Add the following to your MCP config file and ask your AI coding tool what proxymock can do:
+
+```bash
+{
+  "mcpServers": {
+    "proxymock-simulator": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@speedscale/proxymock",
+        "mcp"
+      ]
+    }
+  }
+}
+```
+
+## Support
+
+Join our [Slack community](https://slack.speedscale.com/).  Seriously, come talk to us.
+

package/bin/proxymock.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+import { spawn } from "child_process";
+import { join, dirname } from "path";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+
+// Determine the binary path
+const INSTALLROOT = process.env.INSTALLROOT || join(homedir(), ".speedscale");
+const binaryPath = join(INSTALLROOT, "proxymock");
+
+function runProxyMock() {
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  child.on("error", (err) => {
+    console.error("Failed to start proxymock:", err);
+    process.exit(1);
+  });
+
+  child.on("exit", (code) => {
+    process.exit(code || 0);
+  });
+}
+
+// Check if proxymock is installed
+if (!existsSync(binaryPath)) {
+  // Run the installation
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = dirname(__filename);
+  const installScript = join(__dirname, "..", "lib", "install.js");
+  const installProcess = spawn("node", [installScript], { stdio: "inherit" });
+
+  installProcess.on("exit", (code) => {
+    if (code !== 0) {
+      console.error("Installation failed");
+      process.exit(1);
+    }
+    // Run proxymock after successful installation
+    runProxyMock();
+  });
+} else {
+  // Binary exists, run it directly
+  runProxyMock();
+}

package/lib/install.js

@@ -0,0 +1,157 @@
+import { get } from "https";
+import {
+  createWriteStream,
+  createReadStream,
+  readFileSync,
+  copyFileSync,
+  unlinkSync,
+  mkdirSync,
+  chmodSync,
+} from "fs";
+import { join, dirname } from "path";
+import { tmpdir, platform, arch, homedir } from "os";
+import { createHash } from "crypto";
+import { fileURLToPath } from "url";
+
+async function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const file = createWriteStream(destPath);
+
+    get(url, (response) => {
+      if (response.statusCode !== 200) {
+        reject(new Error(`Failed to download: ${response.statusCode}`));
+        return;
+      }
+
+      response.pipe(file);
+
+      file.on("finish", () => {
+        file.close(resolve);
+      });
+    }).on("error", reject);
+  });
+}
+
+function getPlatformBinary() {
+  const os = platform();
+  const architecture = arch();
+
+  let osName, archName;
+
+  // Map Node.js platform names to our binary names
+  switch (os) {
+    case "darwin":
+      osName = "darwin";
+      break;
+    case "linux":
+      osName = "linux";
+      break;
+    case "win32":
+      return "proxymock.exe"; // Windows binary doesn't have arch suffix
+    default:
+      throw new Error(`Unsupported platform: ${os}`);
+  }
+
+  // Map Node.js arch names to our binary names
+  switch (architecture) {
+    case "x64":
+      archName = "amd64";
+      break;
+    case "arm64":
+      archName = "arm64";
+      break;
+    default:
+      throw new Error(`Unsupported architecture: ${architecture}`);
+  }
+
+  return `proxymock-${osName}-${archName}`;
+}
+
+async function validateChecksum(filePath, expectedChecksum) {
+  return new Promise((resolve, reject) => {
+    const hash = createHash("sha256");
+    const stream = createReadStream(filePath);
+
+    stream.on("data", (data) => {
+      hash.update(data);
+    });
+
+    stream.on("end", () => {
+      const actualChecksum = hash.digest("hex");
+      resolve(actualChecksum === expectedChecksum);
+    });
+
+    stream.on("error", reject);
+  });
+}
+
+function getPackageVersion() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const packageJson = JSON.parse(
+    readFileSync(join(__dirname, "..", "package.json"), "utf8"),
+  );
+  return packageJson.version;
+}
+
+async function install() {
+  try {
+    // Read version from package.json
+    const npmVersion = getPackageVersion();
+
+    // Convert npm version to proxymock version format
+    // npm: "2.3.660" -> proxymock: "v2.3.660"
+    const proxymockVersion = `v${npmVersion}`;
+
+    const srcfile = getPlatformBinary();
+
+    // Build versioned URL
+    const baseUrl = `https://downloads.speedscale.com/proxymock/${proxymockVersion}`;
+    const srcUrl = `${baseUrl}/${srcfile}`;
+    const shaUrl = `${baseUrl}/${srcfile}.sha256`;
+
+    const INSTALLROOT =
+      process.env.INSTALLROOT || join(homedir(), ".speedscale");
+
+    // Ensure install directory exists
+    mkdirSync(INSTALLROOT, { recursive: true });
+
+    // Download checksum first
+    const tempShaPath = join(tmpdir(), `${srcfile}.sha256`);
+    await downloadFile(shaUrl, tempShaPath);
+    const expectedChecksum = readFileSync(tempShaPath, "utf8")
+      .trim()
+      .split(" ")[0];
+
+    // Download binary
+    const tempBinPath = join(tmpdir(), srcfile);
+    await downloadFile(srcUrl, tempBinPath);
+
+    // Validate checksum
+    const isValid = await validateChecksum(tempBinPath, expectedChecksum);
+
+    if (!isValid) {
+      throw new Error("Checksum validation failed");
+    }
+
+    // Install - always as "proxymock" since npm version provides isolation
+    const dstPath = join(INSTALLROOT, "proxymock");
+    copyFileSync(tempBinPath, dstPath);
+
+    // Make executable on Unix-like systems
+    if (platform() !== "win32") {
+      chmodSync(dstPath, "755");
+    }
+
+    // Cleanup
+    unlinkSync(tempShaPath);
+    unlinkSync(tempBinPath);
+  } catch (error) {
+    console.error("Installation failed:", error.message);
+    process.exit(1);
+  }
+}
+
+// Run installation if this script is executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  install();
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@speedscale/proxymock",
+  "version": "2.3.645",
+  "description": "A free desktop CLI that automatically creates mocks and tests from watching your app run.",
+  "keywords": [
+    "api",
+    "mock",
+    "mocking",
+    "bug",
+    "debug",
+    "environment",
+    "mcp",
+    "observability",
+    "observe",
+    "proxymock",
+    "real",
+    "realistic",
+    "record",
+    "replay",
+    "test",
+    "traffic",
+    "validate"
+  ],
+  "license": "Apache-2.0",
+  "author": "Speedscale <support@speedscale.com>",
+  "type": "module",
+  "bin": {
+    "proxymock": "bin/proxymock.js"
+  },
+  "homepage": "https://proxymock.io/",
+  "bugs": {
+    "url": "https://slack.speedscale.com/"
+  },
+  "scripts": {
+    "test": "node --test || echo 'No tests defined'",
+    "validate": "npm pack && echo 'Package validation complete'"
+  }
+}