@velor/remote-mouse 6.4.8

package/server/services/notifier/handleOpenQrBrowserEvent.js

@@ -0,0 +1,40 @@
+import {notify} from "./mapper/notify.js";
+import {
+    NOTIFIER_LEVEL_ERROR,
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_TARGET_ALL
+} from "./createNotifierComposite.js";
+import {
+    PUBSUB_EVENT_ADMIN_CLIENT_OPENED,
+    PUBSUB_EVENT_ADMIN_SERVER_OPEN_FAILED,
+    PUBSUB_EVENT_ADMIN_SERVER_OPENED
+} from "../pubsub/serviceEventConstants.js";
+import { NOTIFICATION_ID_QR } from '../../../utils/notificationSettings.js';
+
+export function handleOpenQrBrowserEvent(notifier, event) {
+    if (event.type === PUBSUB_EVENT_ADMIN_CLIENT_OPENED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_QR,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.qr.title',
+            messageKey: 'notification.qr.clientOpened',
+            ttlMs: 2200,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_SERVER_OPEN_FAILED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_QR,
+            level: NOTIFIER_LEVEL_ERROR,
+            titleKey: 'notification.qr.title',
+            messageKey: 'notification.qr.serverOpenFailed',
+            ttlMs: 3200,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_SERVER_OPENED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_QR,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.qr.title',
+            messageKey: 'notification.qr.serverOpened',
+            ttlMs: 2200,
+        }, {clientId: event.payload?.clientId});
+    }
+}

package/server/services/notifier/handleOpenServerInfoBrowserEvent.js

@@ -0,0 +1,40 @@
+import {notify} from "./mapper/notify.js";
+import {
+    NOTIFIER_LEVEL_ERROR,
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_TARGET_ALL
+} from "./createNotifierComposite.js";
+import {
+    PUBSUB_EVENT_ADMIN_CLIENT_OPENED,
+    PUBSUB_EVENT_ADMIN_SERVER_OPEN_FAILED,
+    PUBSUB_EVENT_ADMIN_SERVER_OPENED
+} from "../pubsub/serviceEventConstants.js";
+import { NOTIFICATION_ID_SERVER_INFO } from '../../../utils/notificationSettings.js';
+
+export function handleOpenServerInfoBrowserEvent(notifier, event) {
+    if (event.type === PUBSUB_EVENT_ADMIN_CLIENT_OPENED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_SERVER_INFO,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.serverInfo.title',
+            messageKey: 'notification.serverInfo.clientOpened',
+            ttlMs: 2200,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_SERVER_OPEN_FAILED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_SERVER_INFO,
+            level: NOTIFIER_LEVEL_ERROR,
+            titleKey: 'notification.serverInfo.title',
+            messageKey: 'notification.serverInfo.serverOpenFailed',
+            ttlMs: 3200,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_SERVER_OPENED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_SERVER_INFO,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.serverInfo.title',
+            messageKey: 'notification.serverInfo.serverOpened',
+            ttlMs: 2200,
+        }, {clientId: event.payload?.clientId});
+    }
+}

package/server/services/notifier/handleRestartServiceEvent.js

@@ -0,0 +1,37 @@
+import {notify} from "./mapper/notify.js";
+import {
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_LEVEL_WARNING,
+    NOTIFIER_TARGET_ALL
+} from "./createNotifierComposite.js";
+import {
+    PUBSUB_EVENT_ADMIN_RESTART_DETECTED,
+    PUBSUB_EVENT_ADMIN_STARTED
+} from "../pubsub/serviceEventConstants.js";
+import {
+    NOTIFICATION_ID_SERVICE_RESTARTED,
+    NOTIFICATION_ID_SERVICE_RESTARTING
+} from '../../../utils/notificationSettings.js';
+
+export function handleRestartServiceEvent(notifier, event) {
+    if (event.type === PUBSUB_EVENT_ADMIN_STARTED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_SERVICE_RESTARTING,
+            level: NOTIFIER_LEVEL_WARNING,
+            titleKey: 'notification.serviceRestarting.title',
+            messageKey: 'notification.serviceRestarting.message',
+            params: {
+                serviceName: event.payload?.serviceName || 'Remote Mouse',
+            },
+            ttlMs: 2200,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_RESTART_DETECTED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_SERVICE_RESTARTED,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.serviceRestarted.title',
+            messageKey: 'notification.serviceRestarted.message',
+            ttlMs: 3000,
+        });
+    }
+}

package/server/services/notifier/handleRotateEntryTokenEvent.js

@@ -0,0 +1,42 @@
+import {notify} from "./mapper/notify.js";
+import {
+    NOTIFIER_LEVEL_ERROR,
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_LEVEL_WARNING,
+    NOTIFIER_TARGET_ALL,
+    NOTIFIER_TARGET_CLIENT
+} from "./createNotifierComposite.js";
+import {
+    PUBSUB_EVENT_ADMIN_REJECTED_DISABLED,
+    PUBSUB_EVENT_ADMIN_ROTATED,
+    PUBSUB_EVENT_ADMIN_UNCHANGED
+} from "../pubsub/serviceEventConstants.js";
+import { NOTIFICATION_ID_ENTRY_TOKEN } from '../../../utils/notificationSettings.js';
+
+export function handleRotateEntryTokenEvent(notifier, event) {
+    if (event.type === PUBSUB_EVENT_ADMIN_REJECTED_DISABLED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_ENTRY_TOKEN,
+            level: NOTIFIER_LEVEL_ERROR,
+            titleKey: 'notification.entryToken.title',
+            messageKey: 'notification.entryToken.disabled',
+            ttlMs: 2800,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_UNCHANGED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_ENTRY_TOKEN,
+            level: NOTIFIER_LEVEL_WARNING,
+            titleKey: 'notification.entryToken.title',
+            messageKey: 'notification.entryToken.unchanged',
+            ttlMs: 2800,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_ROTATED) {
+        notify(notifier, NOTIFIER_TARGET_CLIENT, {
+            notificationId: NOTIFICATION_ID_ENTRY_TOKEN,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.entryToken.title',
+            messageKey: 'notification.entryToken.rotated',
+            ttlMs: 2400,
+        }, {clientId: event.payload?.clientId});
+    }
+}

package/server/services/notifier/handleSessionEvent.js

@@ -0,0 +1,24 @@
+import { notify } from './mapper/notify.js';
+import {
+  NOTIFIER_LEVEL_INFO,
+  NOTIFIER_TARGET_ALL,
+} from './createNotifierComposite.js';
+import { PUBSUB_EVENT_SESSION_CREATED } from '../pubsub/serviceEventConstants.js';
+import { NOTIFICATION_ID_SESSION_CREATED } from '../../../utils/notificationSettings.js';
+
+export function handleSessionEvent(notifier, event) {
+  if (event.type !== PUBSUB_EVENT_SESSION_CREATED) {
+    return;
+  }
+
+  notify(notifier, NOTIFIER_TARGET_ALL, {
+    notificationId: NOTIFICATION_ID_SESSION_CREATED,
+    level: NOTIFIER_LEVEL_INFO,
+    titleKey: 'notification.sessionCreated.title',
+    messageKey: 'notification.sessionCreated.message',
+    params: {
+      address: event.payload?.address || 'unknown',
+    },
+    ttlMs: 2800,
+  });
+}

package/server/services/notifier/handleToggleQrOverlayEvent.js

@@ -0,0 +1,21 @@
+import {notify} from "./mapper/notify.js";
+import {
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_TARGET_ALL
+} from "./createNotifierComposite.js";
+import {PUBSUB_EVENT_ADMIN_TOGGLED} from "../pubsub/serviceEventConstants.js";
+import { NOTIFICATION_ID_QR_OVERLAY } from '../../../utils/notificationSettings.js';
+
+export function handleToggleQrOverlayEvent(notifier, event) {
+    if (event.type !== PUBSUB_EVENT_ADMIN_TOGGLED) {
+        return;
+    }
+
+    notify(notifier, NOTIFIER_TARGET_ALL, {
+        notificationId: NOTIFICATION_ID_QR_OVERLAY,
+        level: NOTIFIER_LEVEL_INFO,
+        titleKey: 'notification.qrOverlay.title',
+        messageKey: event.payload?.visible ? 'notification.qrOverlay.shown' : 'notification.qrOverlay.hidden',
+        ttlMs: 2200,
+    }, {clientId: event.payload?.clientId});
+}

package/server/services/notifier/host-notifier/createLinuxHostNotifier.js

@@ -0,0 +1,23 @@
+import { execFileAsync } from '../../../utils/process.js';
+import {NOTIFIER_LEVEL_ERROR} from '../createNotifierComposite.js';
+
+export function createLinuxHostNotifier({ fallbackNotifier }) {
+  return {
+    notify({ title, message, level, ttlMs }) {
+      const safeTtlMs = Math.max(500, Math.round(ttlMs));
+      void (async () => {
+        const result = await execFileAsync('notify-send', [
+          '-u',
+          level === NOTIFIER_LEVEL_ERROR ? 'critical' : 'normal',
+          '-t',
+          String(safeTtlMs),
+          title,
+          message,
+        ]);
+        if (!result.ok && fallbackNotifier) {
+          fallbackNotifier.notify({ title, message, level, ttlMs: safeTtlMs });
+        }
+      })();
+    },
+  };
+}

package/server/services/notifier/host-notifier/createNodeNotifierHostNotifier.js

@@ -0,0 +1,24 @@
+import nodeNotifier from 'node-notifier';
+
+export function createNodeNotifierHostNotifier() {
+  function sendViaNodeNotifier({ title, message, safeTtlMs }) {
+    try {
+      nodeNotifier.notify({
+        title,
+        message,
+        wait: false,
+        sound: false,
+        timeout: Math.max(1, Math.round(safeTtlMs / 1000)),
+      });
+    } catch (_error) {
+      // Best effort.
+    }
+  }
+
+  return {
+    notify({ title, message, ttlMs }) {
+      const safeTtlMs = Math.max(500, Math.round(ttlMs));
+      sendViaNodeNotifier({ title, message, safeTtlMs });
+    },
+  };
+}

package/server/services/notifier/host-notifier/index.js

@@ -0,0 +1,11 @@
+import os from 'os';
+import { createLinuxHostNotifier } from './createLinuxHostNotifier.js';
+import { createNodeNotifierHostNotifier } from './createNodeNotifierHostNotifier.js';
+
+export function createHostNotifierByPlatform(platform = os.platform()) {
+  const fallbackNotifier = createNodeNotifierHostNotifier();
+  if (platform === 'linux') {
+    return createLinuxHostNotifier({ fallbackNotifier });
+  }
+  return fallbackNotifier;
+}

package/server/services/notifier/mapper/handleForceUpdateCheckEvent.js

@@ -0,0 +1,24 @@
+import {notify} from "./notify.js";
+import {
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_LEVEL_WARNING,
+    NOTIFIER_TARGET_ALL
+} from "../createNotifierComposite.js";
+import {PUBSUB_EVENT_ADMIN_COMPLETED} from "../../pubsub/serviceEventConstants.js";
+import { NOTIFICATION_ID_FORCE_UPDATE_CHECK } from '../../../../utils/notificationSettings.js';
+
+export function handleForceUpdateCheckEvent(notifier, event) {
+    if (event.type !== PUBSUB_EVENT_ADMIN_COMPLETED) {
+        return;
+    }
+
+    notify(notifier, NOTIFIER_TARGET_ALL, {
+        notificationId: NOTIFICATION_ID_FORCE_UPDATE_CHECK,
+        level: event.payload?.hasUpdate ? NOTIFIER_LEVEL_WARNING : NOTIFIER_LEVEL_INFO,
+        titleKey: 'notification.updateCheck.title',
+        messageKey: event.payload?.hasUpdate
+            ? 'notification.updateCheck.available'
+            : 'notification.updateCheck.none',
+        ttlMs: event.payload?.hasUpdate ? 2500 : 2200,
+    }, {clientId: event.payload?.clientId});
+}

package/server/services/notifier/mapper/handleInstallUpdateEvent.js

@@ -0,0 +1,53 @@
+import {notify} from "./notify.js";
+import {
+    NOTIFIER_LEVEL_ERROR,
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_LEVEL_WARNING,
+    NOTIFIER_TARGET_ALL
+} from "../createNotifierComposite.js";
+import {
+    PUBSUB_EVENT_ADMIN_COMPLETED,
+    PUBSUB_EVENT_ADMIN_FAILED,
+    PUBSUB_EVENT_ADMIN_REJECTED_NO_COMMAND,
+    PUBSUB_EVENT_ADMIN_STARTED
+} from "../../pubsub/serviceEventConstants.js";
+import { NOTIFICATION_ID_UPDATE_INSTALL } from '../../../../utils/notificationSettings.js';
+
+export function handleInstallUpdateEvent(notifier, event) {
+    if (event.type === PUBSUB_EVENT_ADMIN_REJECTED_NO_COMMAND) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_UPDATE_INSTALL,
+            level: NOTIFIER_LEVEL_ERROR,
+            titleKey: 'notification.updateInstall.title',
+            messageKey: 'notification.updateInstall.noCommand',
+            ttlMs: 3600,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_STARTED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_UPDATE_INSTALL,
+            level: NOTIFIER_LEVEL_WARNING,
+            titleKey: 'notification.updateInstall.title',
+            messageKey: 'notification.updateInstall.started',
+            ttlMs: 2200,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_COMPLETED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_UPDATE_INSTALL,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.updateInstall.title',
+            messageKey: 'notification.updateInstall.completed',
+            ttlMs: 3200,
+        }, {clientId: event.payload?.clientId});
+    } else if (event.type === PUBSUB_EVENT_ADMIN_FAILED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_UPDATE_INSTALL,
+            level: NOTIFIER_LEVEL_ERROR,
+            titleKey: 'notification.updateInstall.title',
+            messageKey: 'notification.updateInstall.failed',
+            params: {
+                details: event.payload?.details || 'Unknown error',
+            },
+            ttlMs: 5000,
+        }, {clientId: event.payload?.clientId});
+    }
+}

package/server/services/notifier/mapper/handleSocketEvent.js

@@ -0,0 +1,40 @@
+import {notify} from "./notify.js";
+import {
+    NOTIFIER_LEVEL_INFO,
+    NOTIFIER_TARGET_ALL
+} from "../createNotifierComposite.js";
+import {
+    PUBSUB_EVENT_SOCKET_CLIENT_CONNECTED,
+    PUBSUB_EVENT_SOCKET_CLIENT_DISCONNECTED
+} from "../../pubsub/serviceEventConstants.js";
+import {
+    NOTIFICATION_ID_CLIENT_CONNECTED,
+    NOTIFICATION_ID_CLIENT_DISCONNECTED
+} from "../../../../utils/notificationSettings.js";
+
+export function handleSocketEvent(notifier, event) {
+    const clientId = event.payload?.clientId;
+    const shortClientId = String(clientId || '').slice(0, 8);
+
+    if (event.type === PUBSUB_EVENT_SOCKET_CLIENT_CONNECTED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_CLIENT_CONNECTED,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.clientConnected.title',
+            messageKey: 'notification.clientConnected.message',
+            params: {
+                clientId: shortClientId,
+            },
+        }, {clientId});
+    } else if (event.type === PUBSUB_EVENT_SOCKET_CLIENT_DISCONNECTED) {
+        notify(notifier, NOTIFIER_TARGET_ALL, {
+            notificationId: NOTIFICATION_ID_CLIENT_DISCONNECTED,
+            level: NOTIFIER_LEVEL_INFO,
+            titleKey: 'notification.clientDisconnected.title',
+            messageKey: 'notification.clientDisconnected.message',
+            params: {
+                clientId: shortClientId,
+            },
+        }, {clientId});
+    }
+}

package/server/services/notifier/mapper/handleUpdateManagerEvent.js

@@ -0,0 +1,24 @@
+import {notify} from "./notify.js";
+import {
+    NOTIFIER_LEVEL_WARNING,
+    NOTIFIER_TARGET_ALL
+} from "../createNotifierComposite.js";
+import {PUBSUB_EVENT_UPDATE_AVAILABLE} from "../../pubsub/serviceEventConstants.js";
+import { NOTIFICATION_ID_UPDATE_AVAILABLE } from '../../../../utils/notificationSettings.js';
+
+export function handleUpdateManagerEvent(notifier, event) {
+    if (event.type !== PUBSUB_EVENT_UPDATE_AVAILABLE) {
+        return;
+    }
+
+    const result = event.payload?.lastResult || {};
+    notify(notifier, NOTIFIER_TARGET_ALL, {
+        notificationId: NOTIFICATION_ID_UPDATE_AVAILABLE,
+        level: NOTIFIER_LEVEL_WARNING,
+        title: result.title,
+        titleKey: result.title ? undefined : 'notification.update.title',
+        message: result.message,
+        messageKey: result.message ? undefined : 'notification.update.available',
+        ttlMs: result.ttlMs || 8000,
+    });
+}

package/server/services/notifier/mapper/notify.js

@@ -0,0 +1,7 @@
+export function notify(notifier, target, payload, options = {}) {
+    if (!payload?.message && !payload?.messageKey) {
+        return;
+    }
+
+    notifier.target(target).notify(payload, options);
+}

package/server/services/os/index.js

@@ -0,0 +1,23 @@
+import os from 'node:os';
+import {createLinuxOsAdapter} from './platforms/linux/index.js';
+import {createDarwinOsAdapter} from './platforms/darwin/index.js';
+import {createWin32OsAdapter} from './platforms/win32/index.js';
+import {createFallbackAdapter} from './platforms/createFallbackAdapter.js';
+
+export function createOsService() {
+  const platform = os.platform();
+  const adapter = platform === 'linux'
+    ? createLinuxOsAdapter()
+    : platform === 'darwin'
+      ? createDarwinOsAdapter()
+      : platform === 'win32'
+        ? createWin32OsAdapter()
+        : createFallbackAdapter();
+
+  return {
+    platform,
+    app: adapter.app,
+    window: adapter.window,
+    url: adapter.url,
+  };
+}

package/server/services/os/platforms/createFallbackAdapter.js

@@ -0,0 +1,31 @@
+export function createFallbackAdapter() {
+    return {
+        app: {
+            async resolve() {
+                return null;
+            },
+            async openOrFocus() {
+                return false;
+            },
+            async toggleWindow() {
+                return false;
+            },
+            async closeWindow() {
+                return false;
+            },
+        },
+        window: {
+            async toggleActive() {
+                return false;
+            },
+            async closeActive() {
+                return false;
+            },
+        },
+        url: {
+            async open() {
+                return false;
+            },
+        },
+    };
+}

package/server/services/os/platforms/darwin/app.js

@@ -0,0 +1,6 @@
+export {
+  closeDarwinAppWindow as closeAppWindow,
+  openOrFocusDarwinApp as openOrFocusApp,
+  resolveDarwinApp as resolveApp,
+  toggleDarwinAppWindow as toggleAppWindow,
+} from '../../../../os/darwin/app.js';

package/server/services/os/platforms/darwin/index.js

@@ -0,0 +1,21 @@
+import {closeAppWindow, openOrFocusApp, resolveApp, toggleAppWindow} from './app.js';
+import {closeActiveWindow, toggleActiveWindow} from './window.js';
+import {openUrl} from './url.js';
+
+export function createDarwinOsAdapter() {
+  return {
+    app: {
+      resolve: resolveApp,
+      openOrFocus: openOrFocusApp,
+      toggleWindow: toggleAppWindow,
+      closeWindow: closeAppWindow,
+    },
+    window: {
+      toggleActive: toggleActiveWindow,
+      closeActive: closeActiveWindow,
+    },
+    url: {
+      open: openUrl,
+    },
+  };
+}

package/server/services/os/platforms/darwin/scripts.js

@@ -0,0 +1,4 @@
+export {
+  buildActiveWindowScript,
+  buildAppWindowScript as buildWindowScript,
+} from '../../../../os/darwin/applescript.js';

package/server/services/os/platforms/darwin/url.js

@@ -0,0 +1 @@
+export {openDarwinUrl as openUrl} from '../../../../os/darwin/url.js';

package/server/services/os/platforms/darwin/window.js

@@ -0,0 +1,4 @@
+export {
+  closeDarwinActiveWindow as closeActiveWindow,
+  toggleDarwinActiveWindow as toggleActiveWindow,
+} from '../../../../os/darwin/window.js';

package/server/services/os/platforms/linux/app.js

@@ -0,0 +1,6 @@
+export {
+  closeLinuxAppWindow as closeAppWindow,
+  openOrFocusLinuxApp as openOrFocusApp,
+  resolveLinuxApp as resolveApp,
+  toggleLinuxAppWindow as toggleAppWindow,
+} from '../../../../os/linux/app.js';

package/server/services/os/platforms/linux/index.js

@@ -0,0 +1,33 @@
+import {closeAppWindow, openOrFocusApp, resolveApp, toggleAppWindow} from './app.js';
+import {getActiveWindowId, toggleWindow, closeWindow} from './windows.js';
+import {openUrl} from './url.js';
+
+export function createLinuxOsAdapter() {
+  return {
+    app: {
+      resolve: resolveApp,
+      openOrFocus: openOrFocusApp,
+      toggleWindow: toggleAppWindow,
+      closeWindow: closeAppWindow,
+    },
+    window: {
+      async toggleActive() {
+        const activeWindowId = await getActiveWindowId();
+        if (!activeWindowId) {
+          return false;
+        }
+        return toggleWindow(activeWindowId);
+      },
+      async closeActive() {
+        const activeWindowId = await getActiveWindowId();
+        if (!activeWindowId) {
+          return false;
+        }
+        return closeWindow(activeWindowId);
+      },
+    },
+    url: {
+      open: openUrl,
+    },
+  };
+}

package/server/services/os/platforms/linux/url.js

@@ -0,0 +1 @@
+export {openLinuxUrl as openUrl} from '../../../../os/linux/url.js';

package/server/services/os/platforms/linux/windows.js

@@ -0,0 +1,11 @@
+export {
+  activateWindow,
+  closeWindow,
+  findWindows,
+  getActiveWindowId,
+  isWindowMaximized,
+  maximizeWindow,
+  parseWindowIdsFromWmctrl,
+  restoreWindow,
+  toggleWindow,
+} from '../../../../os/linux/windows.js';

package/server/services/os/platforms/win32/app.js

@@ -0,0 +1,6 @@
+export {
+  closeWin32AppWindow as closeAppWindow,
+  openOrFocusWin32App as openOrFocusApp,
+  resolveWin32App as resolveApp,
+  toggleWin32AppWindow as toggleAppWindow,
+} from '../../../../os/win32/app.js';

package/server/services/os/platforms/win32/index.js

@@ -0,0 +1,21 @@
+import {closeAppWindow, openOrFocusApp, resolveApp, toggleAppWindow} from './app.js';
+import {closeActiveWindow, toggleActiveWindow} from './window.js';
+import {openUrl} from './url.js';
+
+export function createWin32OsAdapter() {
+  return {
+    app: {
+      resolve: resolveApp,
+      openOrFocus: openOrFocusApp,
+      toggleWindow: toggleAppWindow,
+      closeWindow: closeAppWindow,
+    },
+    window: {
+      toggleActive: toggleActiveWindow,
+      closeActive: closeActiveWindow,
+    },
+    url: {
+      open: openUrl,
+    },
+  };
+}

package/server/services/os/platforms/win32/overlay.js

@@ -0,0 +1,6 @@
+export {
+  buildQrOverlayPowerShellScript,
+} from '../../../../os/win32/powershell.js';
+export {
+  spawnPowerShellFile,
+} from '../../../../os/win32/process.js';

package/server/services/os/platforms/win32/powershell.js

@@ -0,0 +1,4 @@
+export {
+  buildForegroundWindowPowerShell as buildForegroundWindowScript,
+  buildTitleActivationPowerShell as toTitleScript,
+} from '../../../../os/win32/powershell.js';

package/server/services/os/platforms/win32/url.js

@@ -0,0 +1 @@
+export {openWin32Url as openUrl} from '../../../../os/win32/url.js';

package/server/services/os/platforms/win32/window.js

@@ -0,0 +1,4 @@
+export {
+  closeWin32ActiveWindow as closeActiveWindow,
+  toggleWin32ActiveWindow as toggleActiveWindow,
+} from '../../../../os/win32/window.js';

package/server/services/os/shared.js

@@ -0,0 +1,2 @@
+export {sleep} from "../../../utils/sync.js";
+export {findFirstAvailable} from "../../../utils/predicates.js";

package/server/services/overlay/createNoopOverlay.js

@@ -0,0 +1,13 @@
+export function createNoopOverlay() {
+  return {
+    close: () => {},
+    show: async () => false,
+    hide: () => false,
+    update: async () => {},
+    setSuppressed: () => false,
+    toggle: async () => false,
+    isVisible: () => false,
+    isSuppressed: () => false,
+    getBounds: () => null,
+  };
+}