@qpjoy/electron-launcher 0.2.0

package/dist/wireguard.d.ts

@@ -0,0 +1,289 @@
+import { buildHdoRouteProbe, type WireGuardServiceIdentity } from '@qpjoy/electron-core-wireguard';
+import type { LauncherRoutePlan } from '@qpjoy/mx-launcher-core';
+export type ElectronLauncherWireGuardAction = 'up' | 'down' | 'restart';
+export type ElectronLauncherWireGuardPathPreference = 'auto' | 'direct' | 'relay' | 'hybrid';
+export type ElectronLauncherWireGuardPath = 'h2i-direct' | 'hdi-relay' | 'h2i-hybrid';
+export interface ElectronLauncherWireGuardRuntimeOptions {
+    userDataDir: string;
+    profileName?: string;
+    installDir?: string;
+    bundledDir?: string | null;
+    allowSystemFallback?: boolean;
+    darwinLaunchDaemon?: boolean | null;
+    darwinServiceIdentity?: WireGuardServiceIdentity;
+    fallbackToAppManaged?: boolean | null;
+}
+export interface ElectronLauncherWireGuardPeerInput extends ElectronLauncherWireGuardRuntimeOptions {
+    routePlan: LauncherRoutePlan;
+    privateKey: string;
+    dnsDomains?: string[];
+    suppressWireGuardDns?: boolean | null;
+    mtu?: number | null;
+    pathPreference?: ElectronLauncherWireGuardPathPreference;
+}
+export interface ElectronLauncherWireGuardProbeInput {
+    targetIp: string;
+    expectedInterfaceName?: string | null;
+    expectedInterfaceAddresses?: string[] | null;
+}
+export interface ElectronLauncherWireGuardEndpointProbeInput {
+    endpoint: string | null | undefined;
+}
+export interface ElectronLauncherWireGuardPeer {
+    address: string;
+    allowedIps: string[];
+    config: string;
+    configPath: string;
+    dns: string[];
+    endpoint: string;
+    endpoints: string[];
+    path: ElectronLauncherWireGuardPath;
+    publicKey: string;
+    publicKeys: string[];
+    routeCidrs: string[];
+    routePriorityCidrs: string[];
+    routeProbe: ReturnType<typeof buildHdoRouteProbe>;
+}
+export declare function prepareLauncherWireGuardPeer(input: ElectronLauncherWireGuardPeerInput): ElectronLauncherWireGuardPeer;
+export declare function resolveLauncherWireGuardRuntime(input: ElectronLauncherWireGuardRuntimeOptions): import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+export declare function connectLauncherWireGuardPeer(input: ElectronLauncherWireGuardPeerInput & {
+    action?: ElectronLauncherWireGuardAction;
+}): Promise<{
+    ok: boolean;
+    action: "up" | "restart";
+    peer: ElectronLauncherWireGuardPeer;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    launchDaemon: import("@qpjoy/electron-core-wireguard").WireGuardLaunchDaemonResult;
+    tunnel: {
+        ok: boolean;
+        configPath: string;
+        routeLogPath: string | null | undefined;
+        routeLogTail: string | null | undefined;
+        message: string;
+    };
+    message: string;
+} | {
+    ok: boolean;
+    action: ElectronLauncherWireGuardAction;
+    peer: ElectronLauncherWireGuardPeer;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    tunnel: import("@qpjoy/electron-core-wireguard").WireGuardTunnelResult;
+    message: string;
+    launchDaemon?: undefined;
+}>;
+export declare function stopLauncherWireGuardPeer(input: ElectronLauncherWireGuardRuntimeOptions): Promise<{
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    configPath: string;
+    runtime?: undefined;
+    status?: undefined;
+    launchDaemon?: undefined;
+    tunnel?: undefined;
+    message?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    configPath: string;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    launchDaemon: import("@qpjoy/electron-core-wireguard").WireGuardLaunchDaemonResult;
+    tunnel: {
+        ok: boolean;
+        configPath: string;
+        routeLogPath: string | null | undefined;
+        routeLogTail: string | null | undefined;
+        message: string;
+    };
+    message: string;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    configPath: string;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    tunnel: import("@qpjoy/electron-core-wireguard").WireGuardTunnelResult;
+    message: string;
+    reason?: undefined;
+    launchDaemon?: undefined;
+}>;
+export declare function repairLauncherWireGuardPeerRoutes(input: ElectronLauncherWireGuardRuntimeOptions): Promise<{
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    configPath: string;
+} | {
+    ok: boolean;
+    configPath: string;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    missingRoutes: string[];
+    message: string;
+    mode: string;
+    interfaceName: string | null;
+    realInterfaceName: string | null;
+    command: string;
+    routeLogPath?: string | null;
+    routeLogTail?: string | null;
+    stdout?: string;
+    stderr?: string;
+    skipped?: undefined;
+    reason?: undefined;
+}>;
+export declare function recoverLauncherWireGuardPeer(input: ElectronLauncherWireGuardRuntimeOptions & {
+    reason?: string | null;
+}): Promise<{
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    recoveryReason: string | null;
+    configPath: string;
+    runtime?: undefined;
+    status?: undefined;
+    action?: undefined;
+    launchDaemon?: undefined;
+    tunnel?: undefined;
+    message?: undefined;
+} | {
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    recoveryReason: string | null;
+    configPath: string;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus;
+    action?: undefined;
+    launchDaemon?: undefined;
+    tunnel?: undefined;
+    message?: undefined;
+} | {
+    action: string;
+    recoveryReason: string | null;
+    ok: boolean;
+    skipped: boolean;
+    reason: string;
+    configPath: string;
+    runtime?: undefined;
+    status?: undefined;
+    launchDaemon?: undefined;
+    tunnel?: undefined;
+    message?: undefined;
+} | {
+    action: string;
+    recoveryReason: string | null;
+    ok: boolean;
+    configPath: string;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    missingRoutes: string[];
+    message: string;
+    mode: string;
+    interfaceName: string | null;
+    realInterfaceName: string | null;
+    command: string;
+    routeLogPath?: string | null;
+    routeLogTail?: string | null;
+    stdout?: string;
+    stderr?: string;
+    skipped?: undefined;
+    reason?: undefined;
+    launchDaemon?: undefined;
+    tunnel?: undefined;
+} | {
+    ok: boolean;
+    action: string;
+    recoveryReason: string | null;
+    configPath: string;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    launchDaemon: import("@qpjoy/electron-core-wireguard").WireGuardLaunchDaemonResult;
+    tunnel: {
+        ok: boolean;
+        configPath: string;
+        routeLogPath: string | null | undefined;
+        routeLogTail: string | null | undefined;
+        message: string;
+    };
+    message: string;
+    skipped?: undefined;
+    reason?: undefined;
+} | {
+    ok: boolean;
+    action: string;
+    recoveryReason: string | null;
+    configPath: string;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    status: import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | null;
+    tunnel: import("@qpjoy/electron-core-wireguard").WireGuardTunnelResult;
+    message: string;
+    skipped?: undefined;
+    reason?: undefined;
+    launchDaemon?: undefined;
+}>;
+export declare function getLauncherWireGuardPeerStatus(input: ElectronLauncherWireGuardRuntimeOptions): import("@qpjoy/electron-core-wireguard").WireGuardTunnelStatus | {
+    ok: boolean;
+    active: boolean;
+    configPath: string;
+    error: string;
+} | {
+    launchDaemon: import("@qpjoy/electron-core-wireguard").WireGuardLaunchDaemonStatus;
+    ok: boolean;
+    active: boolean;
+    mode: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus["method"];
+    interfaceName: string | null;
+    realInterfaceName: string | null;
+    configPath: string;
+    addresses: string[];
+    allowedIps: string[];
+    missingRoutes: string[];
+    routeProbes: import("@qpjoy/electron-core-wireguard").WireGuardRouteProbeStatus[];
+    routeLogPath: string | null;
+    routeLogTail: string | null;
+    peers: import("@qpjoy/electron-core-wireguard").WireGuardPeerRuntimeStatus[];
+    routes: string[];
+    ifconfig: string | null;
+    rawDump: string | null;
+    runtime: import("@qpjoy/electron-core-wireguard").WireGuardConnectionRuntimeStatus;
+    serviceState?: string | null;
+    error?: string | null;
+} | {
+    launchDaemon: import("@qpjoy/electron-core-wireguard").WireGuardLaunchDaemonStatus;
+    ok: false;
+    active: false;
+    configPath: string;
+    error: string;
+} | null;
+export declare function probeLauncherWireGuardRoute(input: ElectronLauncherWireGuardProbeInput): {
+    ok: boolean;
+    targetIp: string;
+    interfaceName: string | null;
+    gateway: string | null;
+    viaLoopback: boolean;
+    expectedInterfaceName: string | null;
+    raw: string | null;
+    error: string | null;
+};
+export declare function probeLauncherWireGuardEndpoint(input: ElectronLauncherWireGuardEndpointProbeInput): {
+    ok: boolean;
+    endpoint: string | null;
+    host: string | null;
+    interfaceName: null;
+    gateway: null;
+    viaProxyTun: boolean;
+    raw: null;
+    error: string;
+} | {
+    ok: boolean;
+    endpoint: string;
+    host: string;
+    interfaceName: string | null;
+    gateway: string | null;
+    viaProxyTun: boolean;
+    raw: string | null;
+    error: string | null;
+};
+export declare function launcherWireGuardConfigPath(input: ElectronLauncherWireGuardRuntimeOptions): string;
+export declare function defaultBundledWireGuardDir(): string;