iobroker.prosoft_flow 0.1.0

package/lib/engineBridge.js

@@ -0,0 +1,178 @@
+'use strict';
+const path = require('node:path');
+const fs = require('node:fs');
+const zlib = require('node:zlib');
+const os = require('node:os');
+const crypto = require('node:crypto');
+
+const PACKAGE_PREFIX = 'iobroker.prosoft_flow';
+
+/**
+ * node `process.platform`-`process.arch` -> the .NET RID that names prebuilds/<rid>/.
+ */
+function ridFor(platform, arch) {
+	return (
+		{
+			'win32-x64': 'win-x64',
+			'linux-x64': 'linux-x64',
+			'linux-arm64': 'linux-arm64',
+			'darwin-arm64': 'osx-arm64',
+			'darwin-x64': 'osx-x64',
+		}[`${platform}-${arch}`] || `${platform}-${arch}`
+	);
+}
+
+/**
+ * Artifact name inside publish directory.
+ */
+function devPublishName(platform) {
+	if (platform === 'win32') {
+		return 'prosoft_flow_engine.dll';
+	}
+	return platform === 'darwin' ? 'prosoft_flow_engine.dylib' : 'prosoft_flow_engine.so';
+}
+
+/**
+ * Decompresses <file>.gz if present.
+ */
+function decompress(gzPath, log) {
+	try {
+		const target = gzPath.slice(0, -3); // strip ".gz"
+		if (fs.existsSync(target) && fs.statSync(target).mtimeMs >= fs.statSync(gzPath).mtimeMs) {
+			return target;
+		}
+		const buf = zlib.gunzipSync(fs.readFileSync(gzPath));
+		try {
+			fs.writeFileSync(target, buf);
+			return target;
+		} catch {
+			const dir = path.join(os.tmpdir(), 'iobroker.prosoft_flow-engine');
+			fs.mkdirSync(dir, { recursive: true });
+			const hash = crypto.createHash('sha256').update(buf).digest('hex').slice(0, 16);
+			const cached = path.join(dir, `prosoft_flow_engine-${hash}.node`);
+			if (!fs.existsSync(cached)) {
+				fs.writeFileSync(cached, buf);
+			}
+			return cached;
+		}
+	} catch (e) {
+		if (log && log.debug) {
+			log.debug(`engineBridge: could not decompress ${gzPath}: ${e.message}`);
+		}
+		return null;
+	}
+}
+
+/**
+ * Loads the platform-specific AOT engine addon and returns its Engine surface.
+ */
+function load(log) {
+	const rid = ridFor(process.platform, process.arch);
+	const tried = [];
+
+	const prebuild = path.join(__dirname, '..', 'prebuilds', rid, 'prosoft_flow_engine.node');
+	const bundledGz = `${prebuild}.gz`;
+	const devPublish = path.join(
+		__dirname,
+		'..',
+		'native',
+		'ProsoftEngine.Node',
+		'bin',
+		'Release',
+		'net10.0',
+		rid,
+		'publish',
+		devPublishName(process.platform),
+	);
+	const devDebug = path.join(
+		__dirname,
+		'..',
+		'native',
+		'ProsoftEngine.Node',
+		'bin',
+		'Debug',
+		'net10.0',
+		devPublishName(process.platform),
+	);
+
+	// 1. Prebuild expanded binary
+	if (fs.existsSync(prebuild)) {
+		return unwrap(prebuild, log);
+	}
+	tried.push(prebuild);
+
+	// 2. Bundled compressed binary (.node.gz)
+	if (fs.existsSync(bundledGz)) {
+		const expanded = decompress(bundledGz, log);
+		if (expanded) {
+			return unwrap(expanded, log);
+		}
+		tried.push(`${bundledGz} (decompress failed)`);
+	} else {
+		tried.push(bundledGz);
+	}
+
+	// 3. Dev publish output (Release Native AOT)
+	if (fs.existsSync(devPublish)) {
+		return unwrap(devPublish, log);
+	}
+	tried.push(devPublish);
+
+	// 4. Dev debug output
+	if (fs.existsSync(devDebug)) {
+		return unwrap(devDebug, log);
+	}
+	tried.push(devDebug);
+
+	throw new Error(`Prosoft Flow Engine native addon not found for ${rid}; tried:\n${tried.join('\n')}`);
+}
+
+function unwrap(modulePath, log) {
+	if (log && log.debug) {
+		log.debug(`engineBridge: loading native module from ${modulePath}`);
+	}
+	const mod = require(modulePath);
+	if (!mod.Engine) {
+		throw new Error(`engineBridge: ${modulePath} has no Engine export`);
+	}
+
+	const raw = mod.Engine;
+	return {
+		ping: () => (raw.ping ? raw.ping() : raw.Ping()),
+		version: () => (raw.version ? raw.version() : raw.Version()),
+		onEvent: (cb) => (raw.onEvent ? raw.onEvent(cb) : raw.OnEvent(cb)),
+		init: (cfg) => (raw.init ? raw.init(cfg) : raw.Init(cfg)),
+		start: () => (raw.start ? raw.start() : raw.Start()),
+		stop: () => (raw.stop ? raw.stop() : raw.Stop()),
+		write: (t, v) => (raw.write ? raw.write(t, v) : raw.Write(t, v)),
+		read: (t) => (raw.read ? raw.read(t) : raw.Read(t)),
+		getStats: () => (raw.getStats ? raw.getStats() : raw.GetStats()),
+		getReport: (r) => (raw.getReport ? raw.getReport(r) : raw.GetReport(r)),
+		readReportWithAge: (grp, age) => (raw.readReportWithAge ? raw.readReportWithAge(grp, age) : raw.ReadReportWithAge(grp, age)),
+		getLicenseInfo: (k) => (raw.getLicenseInfo ? raw.getLicenseInfo(k) : raw.GetLicenseInfo(k)),
+		setLicenseKey: (k) => (raw.setLicenseKey ? raw.setLicenseKey(k) : raw.SetLicenseKey(k)),
+		getLicenseState: () => (raw.getLicenseState ? raw.getLicenseState() : raw.GetLicenseState()),
+		getHardwareId: () => (raw.getHardwareId ? raw.getHardwareId() : raw.GetHardwareId()),
+		getEnvironmentType: () => (raw.getEnvironmentType ? raw.getEnvironmentType() : raw.GetEnvironmentType()),
+
+		// PascalCase aliases
+		Ping: () => (raw.ping ? raw.ping() : raw.Ping()),
+		Version: () => (raw.version ? raw.version() : raw.Version()),
+		OnEvent: (cb) => (raw.onEvent ? raw.onEvent(cb) : raw.OnEvent(cb)),
+		Init: (cfg) => (raw.init ? raw.init(cfg) : raw.Init(cfg)),
+		Start: () => (raw.start ? raw.start() : raw.Start()),
+		Stop: () => (raw.stop ? raw.stop() : raw.Stop()),
+		Write: (t, v) => (raw.write ? raw.write(t, v) : raw.Write(t, v)),
+		Read: (t) => (raw.read ? raw.read(t) : raw.Read(t)),
+		GetStats: () => (raw.getStats ? raw.getStats() : raw.GetStats()),
+		GetReport: (r) => (raw.getReport ? raw.getReport(r) : raw.GetReport(r)),
+		ReadReportWithAge: (grp, age) => (raw.readReportWithAge ? raw.readReportWithAge(grp, age) : raw.ReadReportWithAge(grp, age)),
+		GetLicenseInfo: (k) => (raw.getLicenseInfo ? raw.getLicenseInfo(k) : raw.GetLicenseInfo(k)),
+		SetLicenseKey: (k) => (raw.setLicenseKey ? raw.setLicenseKey(k) : raw.SetLicenseKey(k)),
+		GetLicenseState: () => (raw.getLicenseState ? raw.getLicenseState() : raw.GetLicenseState()),
+		GetHardwareId: () => (raw.getHardwareId ? raw.getHardwareId() : raw.GetHardwareId()),
+		GetEnvironmentType: () => (raw.getEnvironmentType ? raw.getEnvironmentType() : raw.GetEnvironmentType()),
+	};
+}
+
+module.exports = { load, ridFor, devPublishName };