kokorobox-native 0.7.0 → 0.8.0

package/README.md

@@ -19,12 +19,14 @@ macOS, and GNU/Linux. The loader also accepts a development binary through
 import {
   getNativeCapabilities,
   getNetworkContext,
+  getTrafficPresenterPath,
   inspectApplication,
 } from "kokorobox-native";
 
 const capabilities = getNativeCapabilities();
 const network = await getNetworkContext();
 const app = await inspectApplication("/Applications/KokoroBox.app");
+const presenter = getTrafficPresenterPath();
 ```
 
 The full TypeScript declarations are shipped in
@@ -35,6 +37,7 @@ The full TypeScript declarations are shipped in
 | Area | Exports |
 | --- | --- |
 | Capabilities | `getNativeCapabilities` |
+| Traffic presenter | `getTrafficPresenterPath` |
 | Icons | `fileToDataUrl`, `getAppName` |
 | Applications | `inspectApplication`, `scanWindowsApplications`, `findExecutables` |
 | Rules | `fileToStr` |
@@ -80,6 +83,11 @@ use them as a general privileged-command interface. See the repository's
 [platform-services contract](../docs/platform-services.md) for validation and
 platform behavior.
 
+`getTrafficPresenterPath()` returns the presenter executable shipped in the
+same platform package as the loaded native binding. The presenter accepts the
+versioned JSON-lines protocol documented by the `traffic-presenter` crate on
+standard input and terminates when its parent closes that stream.
+
 ## Platform behavior
 
 Use `getNativeCapabilities()` before enabling an optional system feature.

package/index.d.ts

@@ -135,6 +135,8 @@ export function fileToStr(
 ): RuleStringResult;
 export function getAppName(path: string): string;
 export function getNativeCapabilities(): NativeCapabilities;
+/** Resolve the executable shipped beside the current platform binding. */
+export function getTrafficPresenterPath(): string;
 export function findExecutables(options: ExecutableSearchOptions): Promise<ExecutableCandidate[]>;
 export function getLaunchAtLogin(options: LaunchAtLoginOptions): Promise<LaunchAtLoginStatus>;
 export function setLaunchAtLogin(

package/index.js

@@ -3,7 +3,7 @@
 // @ts-nocheck
 
 import { existsSync } from 'node:fs'
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 import { createRequire } from "node:module";
 
 const require = createRequire(import.meta.url);
@@ -15,6 +15,7 @@ const __dirname = new URL(".", import.meta.url).pathname.replace(
 const packageName = "kokorobox-native";
 const binaryName = "kokorobox-native";
 const loadErrors = [];
+let loadedTuple = null;
 
 function requireLocal(tuple) {
   const filename = join(__dirname, `${binaryName}.${tuple}.node`);
@@ -37,7 +38,25 @@ function requirePackage(tuple) {
 }
 
 function requireBinding(tuple) {
-  return requireLocal(tuple) || requirePackage(tuple);
+  const binding = requireLocal(tuple) || requirePackage(tuple);
+  if (binding) loadedTuple = tuple;
+  return binding;
+}
+
+export function getTrafficPresenterPath() {
+  const filename = `kokorobox-traffic-presenter${process.platform === "win32" ? ".exe" : ""}`;
+  const localPath = join(__dirname, filename);
+  if (existsSync(localPath)) return localPath;
+
+  if (loadedTuple) {
+    const packageEntry = require.resolve(`${packageName}-${loadedTuple}`);
+    const packagedPath = join(dirname(packageEntry), filename);
+    if (existsSync(packagedPath)) return packagedPath;
+  }
+
+  throw new Error(
+    `Traffic presenter is missing for ${process.platform} ${process.arch}`,
+  );
 }
 
 function requireNative() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokorobox-native",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "KokoroBox native bridge",
   "type": "module",
   "main": "index.js",
@@ -35,7 +35,8 @@
     "build": "napi build --platform --release --strip --no-js --dts napi.generated.d.ts",
     "build:debug": "napi build --platform --no-js --dts napi.generated.d.ts",
     "create-npm-dirs": "napi create-npm-dirs",
-    "artifacts": "napi artifacts"
+    "artifacts": "napi artifacts",
+    "package-presenters": "node package-presenters.mjs"
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.8.6"
@@ -47,11 +48,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "kokorobox-native-win32-x64-msvc": "0.7.0",
-    "kokorobox-native-win32-arm64-msvc": "0.7.0",
-    "kokorobox-native-darwin-x64": "0.7.0",
-    "kokorobox-native-darwin-arm64": "0.7.0",
-    "kokorobox-native-linux-x64-gnu": "0.7.0",
-    "kokorobox-native-linux-arm64-gnu": "0.7.0"
+    "kokorobox-native-win32-x64-msvc": "0.8.0",
+    "kokorobox-native-win32-arm64-msvc": "0.8.0",
+    "kokorobox-native-darwin-x64": "0.8.0",
+    "kokorobox-native-darwin-arm64": "0.8.0",
+    "kokorobox-native-linux-x64-gnu": "0.8.0",
+    "kokorobox-native-linux-arm64-gnu": "0.8.0"
   }
 }