@aptre/bldr-saucer 0.1.0

package/CMakeLists.txt

@@ -0,0 +1,44 @@
+cmake_minimum_required(VERSION 3.16)
+project(bldr_saucer LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 23)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+
+# Dependency source directories (default to go mod vendor paths).
+if(NOT DEFINED SAUCER_SOURCE_DIR)
+    set(SAUCER_SOURCE_DIR "${CMAKE_SOURCE_DIR}/vendor/github.com/aperturerobotics/saucer")
+endif()
+if(NOT DEFINED YAMUX_SOURCE_DIR)
+    set(YAMUX_SOURCE_DIR "${CMAKE_SOURCE_DIR}/vendor/github.com/aperturerobotics/cpp-yamux")
+endif()
+
+# Saucer options.
+set(saucer_static ON CACHE BOOL "" FORCE)
+set(saucer_serializer "Glaze" CACHE STRING "" FORCE)
+set(saucer_no_version_check ON CACHE BOOL "" FORCE)
+set(saucer_examples OFF CACHE BOOL "" FORCE)
+set(saucer_tests OFF CACHE BOOL "" FORCE)
+
+# cpp-yamux options.
+set(YAMUX_BUILD_TESTS OFF CACHE BOOL "" FORCE)
+
+add_subdirectory(${SAUCER_SOURCE_DIR} ${CMAKE_BINARY_DIR}/_deps/saucer)
+add_subdirectory(${YAMUX_SOURCE_DIR} ${CMAKE_BINARY_DIR}/_deps/yamux)
+
+add_executable(bldr-saucer
+    src/main.cpp
+    src/pipe_client.cpp
+    src/fetch_proto.cpp
+    src/scheme_forwarder.cpp
+)
+
+target_link_libraries(bldr-saucer PRIVATE saucer::saucer yamux)
+target_compile_features(bldr-saucer PRIVATE cxx_std_23)
+
+# Platform-specific socket libraries.
+if(WIN32)
+    target_link_libraries(bldr-saucer PRIVATE ws2_32)
+endif()
+
+install(TARGETS bldr-saucer RUNTIME DESTINATION bin)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aperture Robotics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# bldr-saucer
+
+Native webview bridge for Bldr using [Saucer](https://github.com/saucer/saucer).
+
+## Building from Source
+
+### Prerequisites
+
+- CMake 3.16+
+- Ninja (recommended)
+- C++23 compatible compiler
+- OpenSSL 3.x
+- Platform-specific webview dependencies (see Saucer docs)
+
+### macOS
+
+```bash
+brew install cmake ninja openssl@3
+cmake -G Ninja -B build
+cmake --build build
+```
+
+### Linux
+
+```bash
+sudo apt-get install cmake ninja-build libssl-dev libgtk-3-dev libwebkit2gtk-4.1-dev
+cmake -G Ninja -B build
+cmake --build build
+```
+
+### Windows
+
+```bash
+cmake -G Ninja -B build
+cmake --build build
+```
+
+## NPM Package
+
+This project is distributed as an npm package with prebuilt binaries:
+
+```bash
+npm install @aptre/bldr-saucer
+# or
+bun add @aptre/bldr-saucer
+```
+
+## Repository
+
+https://github.com/aperturerobotics/bldr-saucer
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,106 @@
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+/**
+ * Get the path to the bldr-saucer binary.
+ *
+ * Tries platform-specific npm package first, then falls back to
+ * source-built binary if BLDR_SAUCER_FROM_SOURCE is set or binary
+ * doesn't exist.
+ *
+ * @returns {string} Path to the bldr-saucer binary
+ * @throws {Error} If no binary is found
+ */
+function getBinaryPath() {
+  // Check for forced source build
+  if (process.env.BLDR_SAUCER_FROM_SOURCE === "true") {
+    return getSourceBinaryPath();
+  }
+
+  // Try platform-specific package
+  const platformBinary = getPlatformBinaryPath();
+  if (platformBinary && fs.existsSync(platformBinary)) {
+    return platformBinary;
+  }
+
+  // Fallback to source-built binary
+  const sourceBinary = getSourceBinaryPath();
+  if (sourceBinary && fs.existsSync(sourceBinary)) {
+    return sourceBinary;
+  }
+
+  throw new Error(
+    `bldr-saucer binary not found for platform ${os.platform()}-${os.arch()}. ` +
+    `Try running with BLDR_SAUCER_FROM_SOURCE=true to build from source.`
+  );
+}
+
+/**
+ * Get the platform-specific package binary path.
+ * @returns {string|null}
+ */
+function getPlatformBinaryPath() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  let packageName;
+  switch (`${platform}-${arch}`) {
+    case "darwin-arm64":
+      packageName = "@aptre/bldr-saucer-darwin-arm64";
+      break;
+    case "darwin-x64":
+      packageName = "@aptre/bldr-saucer-darwin-x64";
+      break;
+    case "linux-x64":
+      packageName = "@aptre/bldr-saucer-linux-x64";
+      break;
+    case "linux-arm64":
+      packageName = "@aptre/bldr-saucer-linux-arm64";
+      break;
+    case "win32-x64":
+      packageName = "@aptre/bldr-saucer-win32-x64";
+      break;
+    default:
+      return null;
+  }
+
+  try {
+    const packagePath = require.resolve(`${packageName}/package.json`);
+    const binDir = path.join(path.dirname(packagePath), "bin");
+    const binaryName = platform === "win32" ? "bldr-saucer.exe" : "bldr-saucer";
+    return path.join(binDir, binaryName);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Get the source-built binary path.
+ * @returns {string}
+ */
+function getSourceBinaryPath() {
+  const platform = os.platform();
+  const binaryName = platform === "win32" ? "bldr-saucer.exe" : "bldr-saucer";
+  return path.join(__dirname, "build", binaryName);
+}
+
+/**
+ * Check if the binary exists.
+ * @returns {boolean}
+ */
+function hasBinary() {
+  try {
+    getBinaryPath();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+module.exports = {
+  getBinaryPath,
+  getPlatformBinaryPath,
+  getSourceBinaryPath,
+  hasBinary,
+};

package/install.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+// Skip if binary exists and we're not forcing source build
+if (process.env.BLDR_SAUCER_SKIP_BINARY === "true") {
+  console.log("bldr-saucer: Skipping install (BLDR_SAUCER_SKIP_BINARY=true)");
+  process.exit(0);
+}
+
+// Check if platform binary exists
+const { getPlatformBinaryPath } = require("./index.js");
+const platformBinary = getPlatformBinaryPath();
+if (platformBinary && fs.existsSync(platformBinary)) {
+  console.log("bldr-saucer: Using prebuilt binary");
+  process.exit(0);
+}
+
+// Check for forced source build
+if (process.env.BLDR_SAUCER_FROM_SOURCE !== "true") {
+  console.log(
+    "bldr-saucer: No prebuilt binary for this platform. " +
+    "Set BLDR_SAUCER_FROM_SOURCE=true to build from source."
+  );
+  process.exit(0);
+}
+
+console.log("bldr-saucer: Building from source...");
+
+// Check for required tools
+function hasCommand(cmd) {
+  try {
+    execFileSync("which", [cmd], { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+if (!hasCommand("cmake")) {
+  console.error("bldr-saucer: cmake is required but not found");
+  process.exit(1);
+}
+
+if (!hasCommand("ninja")) {
+  console.error("bldr-saucer: ninja is required but not found");
+  process.exit(1);
+}
+
+const srcDir = __dirname;
+const buildDir = path.join(srcDir, "build");
+
+// Create build directory
+if (!fs.existsSync(buildDir)) {
+  fs.mkdirSync(buildDir, { recursive: true });
+}
+
+// Run CMake configure
+console.log("bldr-saucer: Configuring...");
+try {
+  execFileSync("cmake", ["-G", "Ninja", "-B", "build"], {
+    cwd: srcDir,
+    stdio: "inherit",
+  });
+} catch (e) {
+  console.error("bldr-saucer: CMake configure failed");
+  process.exit(1);
+}
+
+// Run CMake build
+console.log("bldr-saucer: Building...");
+try {
+  execFileSync("cmake", ["--build", "build"], {
+    cwd: srcDir,
+    stdio: "inherit",
+  });
+} catch (e) {
+  console.error("bldr-saucer: CMake build failed");
+  process.exit(1);
+}
+
+// Verify binary exists
+const platform = os.platform();
+const binaryName = platform === "win32" ? "bldr-saucer.exe" : "bldr-saucer";
+const binaryPath = path.join(buildDir, binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(`bldr-saucer: Binary not found at ${binaryPath}`);
+  process.exit(1);
+}
+
+console.log("bldr-saucer: Build successful!");

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@aptre/bldr-saucer",
+  "version": "0.1.0",
+  "description": "Native webview bridge for Bldr using Saucer",
+  "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aperturerobotics/bldr-saucer.git"
+  },
+  "keywords": [
+    "webview",
+    "saucer",
+    "native",
+    "bldr"
+  ],
+  "author": "Aptre",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/aperturerobotics/bldr-saucer/issues"
+  },
+  "homepage": "https://github.com/aperturerobotics/bldr-saucer#readme",
+  "scripts": {
+    "postinstall": "node install.js",
+    "gen": "bun run go:aptre -- generate",
+    "gen:force": "bun run go:aptre -- generate --force",
+    "go:aptre": "go run -mod=mod github.com/aperturerobotics/common/cmd/aptre"
+  },
+  "optionalDependencies": {
+    "@aptre/bldr-saucer-darwin-arm64": "0.1.0",
+    "@aptre/bldr-saucer-darwin-x64": "0.1.0",
+    "@aptre/bldr-saucer-linux-x64": "0.1.0",
+    "@aptre/bldr-saucer-linux-arm64": "0.1.0",
+    "@aptre/bldr-saucer-win32-x64": "0.1.0"
+  },
+  "files": [
+    "index.js",
+    "install.js",
+    "src/**/*",
+    "cmake/**/*",
+    "CMakeLists.txt"
+  ],
+  "devDependencies": {
+    "@aptre/common": "^0.30.1"
+  },
+  "dependencies": {
+    "@aptre/protobuf-es-lite": "^0.5.2"
+  }
+}