chore: engine npm package

Author: NathanFlurry

engine/package.json

@@ -33,6 +33,7 @@
 	},
 	"resolutions": {
 		"rivetkit": "workspace:*",
+		"@rivetkit/engine": "workspace:*",
 		"@rivetkit/react": "workspace:*",
 		"@rivetkit/next-js": "workspace:*",
 		"@rivetkit/db": "workspace:*",

package.json

@@ -16,6 +16,7 @@ packages:
   - frontend/packages/icons/
   - frontend/packages/shared-data/
   - rivetkit-typescript/packages/*
+  - rivetkit-typescript/packages/engine/npm/*
   - rivetkit-swift/examples/*/server
   - scripts/release
   - scripts/tests

pnpm-lock.yaml

@@ -0,0 +1,17 @@
+export interface ResolvedEngineBinary {
+	packageName: string;
+	packageDir: string;
+	binaryPath: string;
+	version: string;
+}
+
+export declare function getInstalledVersion(): string;
+export declare function getEnginePackageNameForPlatform(
+	platform?: NodeJS.Platform,
+	arch?: typeof process.arch,
+): string;
+export declare function resolveEngineBinaryFor(
+	platform?: NodeJS.Platform,
+	arch?: typeof process.arch,
+): ResolvedEngineBinary;
+export declare function resolveEngineBinary(): ResolvedEngineBinary;

pnpm-workspace.yaml

@@ -0,0 +1,62 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+
+const PLATFORM_PACKAGES = {
+	"darwin:arm64": "@rivetkit/engine-darwin-arm64",
+	"darwin:x64": "@rivetkit/engine-darwin-x64",
+	"linux:x64": "@rivetkit/engine-linux-x64-musl",
+	"win32:x64": "@rivetkit/engine-win32-x64-gnu",
+};
+
+export function getInstalledVersion() {
+	const packageJsonPath = new URL("./package.json", import.meta.url);
+	const packageJson = JSON.parse(
+		fs.readFileSync(packageJsonPath, "utf8"),
+	);
+	return packageJson.version;
+}
+
+export function getEnginePackageNameForPlatform(platform = process.platform, arch = process.arch) {
+	const packageName = PLATFORM_PACKAGES[`${platform}:${arch}`];
+	if (!packageName) {
+		throw new Error(
+			`unsupported platform for Rivet Engine npm package: ${platform}/${arch}`,
+		);
+	}
+	return packageName;
+}
+
+export function resolveEngineBinaryFor(platform = process.platform, arch = process.arch) {
+	const packageName = getEnginePackageNameForPlatform(platform, arch);
+	const packageJsonPath = require.resolve(`${packageName}/package.json`);
+	const packageDir = path.dirname(packageJsonPath);
+	const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+	const binaryRelativePath = packageJson.rivet?.binary;
+
+	if (!binaryRelativePath) {
+		throw new Error(
+			`missing rivet.binary field in ${packageName}/package.json`,
+		);
+	}
+
+	const binaryPath = path.join(packageDir, binaryRelativePath);
+	if (!fs.existsSync(binaryPath)) {
+		throw new Error(
+			`Rivet Engine binary package ${packageName} is installed but the binary is missing at ${binaryPath}`,
+		);
+	}
+
+	return {
+		packageName,
+		packageDir,
+		binaryPath,
+		version: getInstalledVersion(),
+	};
+}
+
+export function resolveEngineBinary() {
+	return resolveEngineBinaryFor();
+}

rivetkit-typescript/packages/engine/index.d.ts

@@ -0,0 +1,12 @@
+{
+	"name": "@rivetkit/engine-darwin-arm64",
+	"version": "2.2.1",
+	"description": "Rivet Engine binary for macOS arm64",
+	"license": "Apache-2.0",
+	"os": ["darwin"],
+	"cpu": ["arm64"],
+	"files": ["rivet-engine"],
+	"rivet": {
+		"binary": "rivet-engine"
+	}
+}

rivetkit-typescript/packages/engine/index.js

@@ -0,0 +1,12 @@
+{
+	"name": "@rivetkit/engine-darwin-x64",
+	"version": "2.2.1",
+	"description": "Rivet Engine binary for macOS x64",
+	"license": "Apache-2.0",
+	"os": ["darwin"],
+	"cpu": ["x64"],
+	"files": ["rivet-engine"],
+	"rivet": {
+		"binary": "rivet-engine"
+	}
+}

rivetkit-typescript/packages/engine/npm/darwin-arm64/package.json

@@ -0,0 +1,12 @@
+{
+	"name": "@rivetkit/engine-linux-x64-musl",
+	"version": "2.2.1",
+	"description": "Rivet Engine binary for Linux x64",
+	"license": "Apache-2.0",
+	"os": ["linux"],
+	"cpu": ["x64"],
+	"files": ["rivet-engine"],
+	"rivet": {
+		"binary": "rivet-engine"
+	}
+}

rivetkit-typescript/packages/engine/npm/darwin-x64/package.json

@@ -0,0 +1,12 @@
+{
+	"name": "@rivetkit/engine-win32-x64-gnu",
+	"version": "2.2.1",
+	"description": "Rivet Engine binary for Windows x64 GNU",
+	"license": "Apache-2.0",
+	"os": ["win32"],
+	"cpu": ["x64"],
+	"files": ["rivet-engine.exe"],
+	"rivet": {
+		"binary": "rivet-engine.exe"
+	}
+}