kokorobox-native 0.12.0 → 0.14.0

package/README.md

@@ -46,7 +46,7 @@ The full TypeScript declarations are shipped in
 | macOS application routing | `applyMacosApplicationRouting`, `getMacosApplicationRoutingStatus`, `stopMacosApplicationRouting`, `openMacosApplicationRoutingSettings` |
 | Core permissions | `getCorePrivilegeStatus`, `setCorePrivileges` |
 | Privileged operations | `runServiceLifecycleElevated`, `cleanupLegacyMacosService`, `stopMacosManagedService`, `repairManagedFilePermissions` |
-| Windows | `getCurrentUserSid`, `isRunningAsAdmin`, `relaunchCurrentApplicationWithPrivilege`, `setupFirewallRules` |
+| Windows | `getCurrentUserSid`, `isRunningAsAdmin`, `relaunchCurrentApplicationWithPrivilege`, `ensureKokoroBoxCoreFirewall` |
 
 `inspectApplication` validates the input for the current platform and resolves
 it to a routing identifier: an executable path on Windows and Linux, or a code
@@ -59,6 +59,10 @@ list.
 tools. It returns canonical paths for stable deduplication; prefix matching is
 available only when explicitly requested.
 
+`ensureKokoroBoxCoreFirewall` accepts the two Mihomo executable paths and the
+KokoroBox application path. Native fixes the three rule names and validates
+the executable basenames before changing Windows Firewall state.
+
 `fileToStr` converts a rule file and returns each generated output keyed by its
 behavior, metadata for those outputs, and rules that were skipped. Its optional
 `RuleConvertOptions` accepts Mihomo, General, Egern, and sing-box targets and
@@ -108,7 +112,6 @@ support than the package itself:
 
 | Capability | Supported platforms |
 | --- | --- |
-| `networkDnsMutation` | macOS |
 | `serviceLifecycle` | Windows, macOS, Linux |
 | `managedFilePermissions` | macOS, Linux |
 | `windowsPrivilegeRelaunch` | Windows |

package/index.d.ts

@@ -1,8 +1,3 @@
-export interface FirewallRule {
-  name: string;
-  applicationPath: string;
-}
-
 export interface UwpLoopbackApp {
   sid: string;
   packageName: string;
@@ -20,7 +15,6 @@ export interface NativeCapabilities {
   launchAtLogin: boolean;
   networkContext: boolean;
   networkMonitor: boolean;
-  networkDnsMutation: boolean;
   serviceLifecycle: boolean;
   managedFilePermissions: boolean;
   macosServiceManagement: boolean;
@@ -29,6 +23,7 @@ export interface NativeCapabilities {
   windowsUwpLoopback: boolean;
   coreFilePrivileges: boolean;
   serviceIdentity: boolean;
+  linuxTerminalProxy: boolean;
 }
 
 export interface ExecutableSearchOptions {
@@ -188,6 +183,10 @@ export function fileToStr(
 ): RuleStringResult;
 export function getAppName(path: string): string;
 export function getNativeCapabilities(): NativeCapabilities;
+/** Write KokoroBox's Linux user-session proxy file and update systemd --user over D-Bus. */
+export function setTerminalProxyEnvironment(host: string, port: number, bypass: string[]): Promise<boolean>;
+/** Remove only KokoroBox's Linux user-session proxy file and clear its session variables. */
+export function clearTerminalProxyEnvironment(): Promise<boolean | null>;
 /** Resolve the executable shipped beside the current platform binding. */
 export function getTrafficPresenterPath(): string;
 export function findExecutables(options: ExecutableSearchOptions): Promise<ExecutableCandidate[]>;
@@ -197,8 +196,6 @@ export function setLaunchAtLogin(
   enabled: boolean,
 ): Promise<LaunchAtLoginStatus>;
 export function getNetworkContext(): Promise<NetworkContext>;
-/** Set DNS on the active macOS network service; [] restores automatic DNS. */
-export function setActiveNetworkDns(servers: string[]): Promise<void>;
 /** Resolve when the native network snapshot changes, or `undefined` on timeout. */
 export function waitForNetworkContextChange(
   previous: NetworkContext,
@@ -292,6 +289,10 @@ export function scanWindowsApplications(
 ): Promise<ApplicationScanResult>;
 export function getCurrentUserSid(): string;
 export function isRunningAsAdmin(): boolean;
-export function setupFirewallRules(rules: FirewallRule[]): void;
+export function ensureKokoroBoxCoreFirewall(
+  mihomoPath: string,
+  mihomoAlphaPath: string,
+  applicationPath: string,
+): void;
 export function listUwpLoopbackApps(): UwpLoopbackApp[];
 export function setUwpLoopbackExemption(sid: string, enabled: boolean): void;

package/index.js

@@ -100,11 +100,12 @@ export const fileToDataUrl = nativeBinding.fileToDataUrl;
 export const fileToStr = nativeBinding.fileToStr;
 export const getAppName = nativeBinding.getAppName;
 export const getNativeCapabilities = nativeBinding.getNativeCapabilities;
+export const setTerminalProxyEnvironment = nativeBinding.setTerminalProxyEnvironment;
+export const clearTerminalProxyEnvironment = nativeBinding.clearTerminalProxyEnvironment;
 export const findExecutables = nativeBinding.findExecutables;
 export const getLaunchAtLogin = nativeBinding.getLaunchAtLogin;
 export const setLaunchAtLogin = nativeBinding.setLaunchAtLogin;
 export const getNetworkContext = nativeBinding.getNetworkContext;
-export const setActiveNetworkDns = nativeBinding.setActiveNetworkDns;
 export const waitForNetworkContextChange = nativeBinding.waitForNetworkContextChange;
 export const getMacosManagedServiceStatus = nativeBinding.getMacosManagedServiceStatus;
 export const registerMacosManagedService = nativeBinding.registerMacosManagedService;
@@ -126,7 +127,7 @@ export const inspectApplication = nativeBinding.inspectApplication;
 export const scanWindowsApplications = nativeBinding.scanWindowsApplications;
 export const getCurrentUserSid = nativeBinding.getCurrentUserSid;
 export const isRunningAsAdmin = nativeBinding.isRunningAsAdmin;
-export const setupFirewallRules = nativeBinding.setupFirewallRules;
+export const ensureKokoroBoxCoreFirewall = nativeBinding.ensureKokoroBoxCoreFirewall;
 export const listUwpLoopbackApps = nativeBinding.listUwpLoopbackApps;
 export const setUwpLoopbackExemption = nativeBinding.setUwpLoopbackExemption;
 export const ServiceIdentity = nativeBinding.ServiceIdentity;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokorobox-native",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "KokoroBox native bridge",
   "type": "module",
   "main": "index.js",
@@ -48,11 +48,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "kokorobox-native-win32-x64-msvc": "0.12.0",
-    "kokorobox-native-win32-arm64-msvc": "0.12.0",
-    "kokorobox-native-darwin-x64": "0.12.0",
-    "kokorobox-native-darwin-arm64": "0.12.0",
-    "kokorobox-native-linux-x64-gnu": "0.12.0",
-    "kokorobox-native-linux-arm64-gnu": "0.12.0"
+    "kokorobox-native-win32-x64-msvc": "0.14.0",
+    "kokorobox-native-win32-arm64-msvc": "0.14.0",
+    "kokorobox-native-darwin-x64": "0.14.0",
+    "kokorobox-native-darwin-arm64": "0.14.0",
+    "kokorobox-native-linux-x64-gnu": "0.14.0",
+    "kokorobox-native-linux-arm64-gnu": "0.14.0"
   }
 }