kokorobox-native 0.8.3 → 0.9.0

package/index.d.ts

@@ -12,8 +12,10 @@ export interface NativeCapabilities {
   windowsFirewall: boolean;
   launchAtLogin: boolean;
   networkContext: boolean;
+  networkMonitor: boolean;
   macosServiceManagement: boolean;
   coreFilePrivileges: boolean;
+  serviceIdentity: boolean;
 }
 
 export interface ExecutableSearchOptions {
@@ -57,6 +59,8 @@ export interface LaunchAtLoginStatus {
 
 /** Best-effort active-network state. Unavailable fields are omitted instead of guessed. */
 export interface NetworkContext {
+  /** Whether the operating system currently has a usable default route. */
+  online: boolean;
   defaultInterface?: string;
   /** Active network-service name. Currently populated on macOS and Linux. */
   defaultService?: string;
@@ -71,6 +75,42 @@ export interface CorePrivilegeStatus {
   granted: boolean;
 }
 
+export interface ServiceIdentityOptions {
+  /** OS credential namespace, for example `com.amamiyakokoro.KokoroBox`. */
+  service: string;
+  account: string;
+  /** Mode-0600 fallback used only when Linux Secret Service is unavailable. */
+  linuxFallbackPath?: string;
+}
+
+export interface LegacyServiceIdentity {
+  keyId?: string;
+  publicKey: string;
+  privateKey: string;
+}
+
+export interface ServiceIdentityInfo {
+  keyId: string;
+  publicKey: string;
+  backend:
+    | "windows-credential-manager"
+    | "macos-keychain"
+    | "linux-secret-service"
+    | "linux-protected-file";
+}
+
+/** Opaque native signer. Private key material is never exposed by this object. */
+export class ServiceIdentity {
+  getInfo(): ServiceIdentityInfo;
+  sign(data: string): string;
+}
+
+export function openServiceIdentity(
+  options: ServiceIdentityOptions,
+  legacy?: LegacyServiceIdentity,
+): Promise<ServiceIdentity>;
+export function deleteServiceIdentity(options: ServiceIdentityOptions): Promise<void>;
+
 export interface ApplicationInfo {
   executablePath: string;
   executableName: string;
@@ -144,6 +184,11 @@ export function setLaunchAtLogin(
   enabled: boolean,
 ): Promise<LaunchAtLoginStatus>;
 export function getNetworkContext(): Promise<NetworkContext>;
+/** Resolve when the native network snapshot changes, or `undefined` on timeout. */
+export function waitForNetworkContextChange(
+  previous: NetworkContext,
+  timeoutMs?: number,
+): Promise<NetworkContext | null>;
 /** Query a LaunchDaemon plist embedded in the calling macOS application. */
 export function getMacosManagedServiceStatus(plistName: string): MacOSManagedServiceStatus;
 export function registerMacosManagedService(plistName: string): MacOSManagedServiceStatus;

package/index.js

@@ -104,6 +104,7 @@ export const findExecutables = nativeBinding.findExecutables;
 export const getLaunchAtLogin = nativeBinding.getLaunchAtLogin;
 export const setLaunchAtLogin = nativeBinding.setLaunchAtLogin;
 export const getNetworkContext = nativeBinding.getNetworkContext;
+export const waitForNetworkContextChange = nativeBinding.waitForNetworkContextChange;
 export const getMacosManagedServiceStatus = nativeBinding.getMacosManagedServiceStatus;
 export const registerMacosManagedService = nativeBinding.registerMacosManagedService;
 export const unregisterMacosManagedService = nativeBinding.unregisterMacosManagedService;
@@ -119,3 +120,6 @@ export const runElevated = nativeBinding.runElevated;
 export const launchElevated = nativeBinding.launchElevated;
 export const launchUnelevated = nativeBinding.launchUnelevated;
 export const setupFirewallRules = nativeBinding.setupFirewallRules;
+export const ServiceIdentity = nativeBinding.ServiceIdentity;
+export const openServiceIdentity = nativeBinding.openServiceIdentity;
+export const deleteServiceIdentity = nativeBinding.deleteServiceIdentity;

package/package.json

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