simen-keyboard-listener 1.0.8 → 1.0.10

package/dist/index.d.mts

@@ -1,13 +1,16 @@
-type IGlobalKeyState = 'DOWN' | 'UP';
+type IGlobalKeyState = 'DOWN' | 'UP' | 'PERMISSION_LOST';
 interface IGlobalKeyEvent {
     readonly name: string;
     readonly state: IGlobalKeyState;
 }
 type IGlobalKeyDownMap = Record<string, boolean>;
 type IGlobalKeyListener = (event: IGlobalKeyEvent, isDown: IGlobalKeyDownMap) => void;
+type IPermissionLostListener = () => void;
 interface IGlobalKeyboardListener {
     addListener(listener: IGlobalKeyListener): void;
     removeListener(listener: IGlobalKeyListener): void;
+    onPermissionLost(listener: IPermissionLostListener): void;
+    removePermissionLostListener(listener: IPermissionLostListener): void;
     kill(): void;
 }
 /**
@@ -32,5 +35,7 @@ declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
  * Call this before starting the listener to provide better UX when permission is missing.
  */
 declare function checkKeyboardPermission(): boolean;
+declare function getFocusedInputValue(): string | null;
+declare function getFocusedInputSelectedText(): string | null;
 
-export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, checkKeyboardPermission, createGlobalKeyboardListener, getGlobalKeyboardListener };
+export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, checkKeyboardPermission, createGlobalKeyboardListener, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener };

package/dist/index.d.ts

@@ -1,13 +1,16 @@
-type IGlobalKeyState = 'DOWN' | 'UP';
+type IGlobalKeyState = 'DOWN' | 'UP' | 'PERMISSION_LOST';
 interface IGlobalKeyEvent {
     readonly name: string;
     readonly state: IGlobalKeyState;
 }
 type IGlobalKeyDownMap = Record<string, boolean>;
 type IGlobalKeyListener = (event: IGlobalKeyEvent, isDown: IGlobalKeyDownMap) => void;
+type IPermissionLostListener = () => void;
 interface IGlobalKeyboardListener {
     addListener(listener: IGlobalKeyListener): void;
     removeListener(listener: IGlobalKeyListener): void;
+    onPermissionLost(listener: IPermissionLostListener): void;
+    removePermissionLostListener(listener: IPermissionLostListener): void;
     kill(): void;
 }
 /**
@@ -32,5 +35,7 @@ declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
  * Call this before starting the listener to provide better UX when permission is missing.
  */
 declare function checkKeyboardPermission(): boolean;
+declare function getFocusedInputValue(): string | null;
+declare function getFocusedInputSelectedText(): string | null;
 
-export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, checkKeyboardPermission, createGlobalKeyboardListener, getGlobalKeyboardListener };
+export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPermissionLostListener, checkKeyboardPermission, createGlobalKeyboardListener, getFocusedInputSelectedText, getFocusedInputValue, getGlobalKeyboardListener };

package/dist/index.js

@@ -32,11 +32,14 @@ var index_exports = {};
 __export(index_exports, {
   checkKeyboardPermission: () => checkKeyboardPermission,
   createGlobalKeyboardListener: () => createGlobalKeyboardListener,
+  getFocusedInputSelectedText: () => getFocusedInputSelectedText,
+  getFocusedInputValue: () => getFocusedInputValue,
   getGlobalKeyboardListener: () => getGlobalKeyboardListener
 });
 module.exports = __toCommonJS(index_exports);
 var path = __toESM(require("path"));
 var fs = __toESM(require("fs"));
+var import_node_child_process = require("child_process");
 var import_node_module = require("module");
 var import_url = require("url");
 var import_meta = {};
@@ -73,8 +76,11 @@ function getNativeAddon() {
   const localRequire = getRequire();
   if (packageName) {
     try {
-      nativeAddon = localRequire(packageName);
-      return nativeAddon;
+      const candidate = localRequire(packageName);
+      if (candidate && typeof candidate.start === "function" && typeof candidate.stop === "function" && typeof candidate.isRunning === "function" && typeof candidate.checkPermission === "function" && typeof candidate.getFocusedInputValue === "function" && typeof candidate.getFocusedInputSelectedText === "function") {
+        nativeAddon = candidate;
+        return nativeAddon;
+      }
     } catch {
     }
   }
@@ -103,6 +109,7 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
   static _instance = null;
   started = false;
   listeners = /* @__PURE__ */ new Set();
+  permissionLostListeners = /* @__PURE__ */ new Set();
   static getInstance() {
     if (!_NativeKeyboardListener._instance) {
       const addon = getNativeAddon();
@@ -114,6 +121,10 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
     this.listeners.add(listener);
     if (!this.started) {
       const ok = this.addon.start((event) => {
+        if (event.state === "PERMISSION_LOST") {
+          this.handlePermissionLost();
+          return;
+        }
         const listenersCopy = Array.from(this.listeners);
         for (const cb of listenersCopy) {
           try {
@@ -128,6 +139,22 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
       this.started = true;
     }
   }
+  onPermissionLost(listener) {
+    this.permissionLostListeners.add(listener);
+  }
+  removePermissionLostListener(listener) {
+    this.permissionLostListeners.delete(listener);
+  }
+  handlePermissionLost() {
+    this.started = false;
+    const listenersCopy = Array.from(this.permissionLostListeners);
+    for (const cb of listenersCopy) {
+      try {
+        cb();
+      } catch {
+      }
+    }
+  }
   removeListener(listener) {
     this.listeners.delete(listener);
     if (this.listeners.size === 0 && this.started) {
@@ -160,6 +187,7 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
     } finally {
       this.started = false;
       this.listeners.clear();
+      this.permissionLostListeners.clear();
       _NativeKeyboardListener._instance = null;
     }
   }
@@ -184,9 +212,66 @@ function checkKeyboardPermission() {
     return false;
   }
 }
+var lastMacAccessibilitySettingsOpenTs = 0;
+function openMacAccessibilitySettings() {
+  if (process.platform !== "darwin") {
+    return;
+  }
+  const now = Date.now();
+  if (now - lastMacAccessibilitySettingsOpenTs < 15e3) {
+    return;
+  }
+  lastMacAccessibilitySettingsOpenTs = now;
+  try {
+    (0, import_node_child_process.execFileSync)("open", ["x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"], {
+      stdio: "ignore"
+    });
+  } catch {
+  }
+}
+function ensureAccessibilityPermission(addon) {
+  try {
+    if (addon.checkPermission()) {
+      return true;
+    }
+  } catch {
+  }
+  openMacAccessibilitySettings();
+  return false;
+}
+function getFocusedInputValue() {
+  if (process.platform !== "darwin") {
+    return null;
+  }
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) {
+    return null;
+  }
+  try {
+    return addon.getFocusedInputValue();
+  } catch {
+    return null;
+  }
+}
+function getFocusedInputSelectedText() {
+  if (process.platform !== "darwin") {
+    return null;
+  }
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) {
+    return null;
+  }
+  try {
+    return addon.getFocusedInputSelectedText();
+  } catch {
+    return null;
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
+  getFocusedInputSelectedText,
+  getFocusedInputValue,
   getGlobalKeyboardListener
 });

package/dist/index.mjs

@@ -8,6 +8,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 // src/index.ts
 import * as path from "path";
 import * as fs from "fs";
+import { execFileSync } from "child_process";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
 var PLATFORM_PACKAGES = {
@@ -43,8 +44,11 @@ function getNativeAddon() {
   const localRequire = getRequire();
   if (packageName) {
     try {
-      nativeAddon = localRequire(packageName);
-      return nativeAddon;
+      const candidate = localRequire(packageName);
+      if (candidate && typeof candidate.start === "function" && typeof candidate.stop === "function" && typeof candidate.isRunning === "function" && typeof candidate.checkPermission === "function" && typeof candidate.getFocusedInputValue === "function" && typeof candidate.getFocusedInputSelectedText === "function") {
+        nativeAddon = candidate;
+        return nativeAddon;
+      }
     } catch {
     }
   }
@@ -73,6 +77,7 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
   static _instance = null;
   started = false;
   listeners = /* @__PURE__ */ new Set();
+  permissionLostListeners = /* @__PURE__ */ new Set();
   static getInstance() {
     if (!_NativeKeyboardListener._instance) {
       const addon = getNativeAddon();
@@ -84,6 +89,10 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
     this.listeners.add(listener);
     if (!this.started) {
       const ok = this.addon.start((event) => {
+        if (event.state === "PERMISSION_LOST") {
+          this.handlePermissionLost();
+          return;
+        }
         const listenersCopy = Array.from(this.listeners);
         for (const cb of listenersCopy) {
           try {
@@ -98,6 +107,22 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
       this.started = true;
     }
   }
+  onPermissionLost(listener) {
+    this.permissionLostListeners.add(listener);
+  }
+  removePermissionLostListener(listener) {
+    this.permissionLostListeners.delete(listener);
+  }
+  handlePermissionLost() {
+    this.started = false;
+    const listenersCopy = Array.from(this.permissionLostListeners);
+    for (const cb of listenersCopy) {
+      try {
+        cb();
+      } catch {
+      }
+    }
+  }
   removeListener(listener) {
     this.listeners.delete(listener);
     if (this.listeners.size === 0 && this.started) {
@@ -130,6 +155,7 @@ var NativeKeyboardListener = class _NativeKeyboardListener {
     } finally {
       this.started = false;
       this.listeners.clear();
+      this.permissionLostListeners.clear();
       _NativeKeyboardListener._instance = null;
     }
   }
@@ -154,8 +180,65 @@ function checkKeyboardPermission() {
     return false;
   }
 }
+var lastMacAccessibilitySettingsOpenTs = 0;
+function openMacAccessibilitySettings() {
+  if (process.platform !== "darwin") {
+    return;
+  }
+  const now = Date.now();
+  if (now - lastMacAccessibilitySettingsOpenTs < 15e3) {
+    return;
+  }
+  lastMacAccessibilitySettingsOpenTs = now;
+  try {
+    execFileSync("open", ["x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"], {
+      stdio: "ignore"
+    });
+  } catch {
+  }
+}
+function ensureAccessibilityPermission(addon) {
+  try {
+    if (addon.checkPermission()) {
+      return true;
+    }
+  } catch {
+  }
+  openMacAccessibilitySettings();
+  return false;
+}
+function getFocusedInputValue() {
+  if (process.platform !== "darwin") {
+    return null;
+  }
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) {
+    return null;
+  }
+  try {
+    return addon.getFocusedInputValue();
+  } catch {
+    return null;
+  }
+}
+function getFocusedInputSelectedText() {
+  if (process.platform !== "darwin") {
+    return null;
+  }
+  const addon = getNativeAddon();
+  if (!ensureAccessibilityPermission(addon)) {
+    return null;
+  }
+  try {
+    return addon.getFocusedInputSelectedText();
+  } catch {
+    return null;
+  }
+}
 export {
   checkKeyboardPermission,
   createGlobalKeyboardListener,
+  getFocusedInputSelectedText,
+  getFocusedInputValue,
   getGlobalKeyboardListener
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simen-keyboard-listener",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Native global keyboard listener for macOS and Windows",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -45,8 +45,8 @@
     "node-addon-api": "^8.0.0"
   },
   "optionalDependencies": {
-    "@simen-keyboard-listener/darwin-arm64": "1.0.8",
-    "@simen-keyboard-listener/win32-x64": "1.0.8"
+    "@simen-keyboard-listener/darwin-arm64": "1.0.10",
+    "@simen-keyboard-listener/win32-x64": "1.0.10"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",