simen-keyboard-listener 1.1.26 → 1.1.27

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Simen
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 Simen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,185 +1,185 @@
-# simen-keyboard-listener
-
-Native global keyboard listener for macOS and Windows. Captures keyboard events system-wide, including special keys like FN that cannot be detected via standard DOM events.
-
-## Installation
-
-```bash
-npm install simen-keyboard-listener
-```
-
-The package uses `optionalDependencies` to automatically install the correct native binary for your platform. Supported platforms:
-
-| Package | Platform |
-|---------|----------|
-| `@simen-keyboard-listener/darwin-arm64` | macOS Apple Silicon |
-| `@simen-keyboard-listener/win32-x64` | Windows x64 |
-
-### For Electron/Bundler Projects
-
-If you're using webpack, electron-builder, or other bundlers, you may need to configure them to include the native addon:
-
-**electron-builder (package.json):**
-```json
-{
-  "build": {
-    "files": [
-      "node_modules/@simen-keyboard-listener/**/*"
-    ]
-  }
-}
-```
-
-**webpack (webpack.config.js):**
-```javascript
-module.exports = {
-  externals: {
-    '@simen-keyboard-listener/darwin-arm64': 'commonjs @simen-keyboard-listener/darwin-arm64',
-    '@simen-keyboard-listener/win32-x64': 'commonjs @simen-keyboard-listener/win32-x64',
-  }
-};
-```
-
-## Usage
-
-```typescript
-import { getGlobalKeyboardListener } from 'simen-keyboard-listener';
-
-const listener = getGlobalKeyboardListener();
-
-listener.addListener((event, isDown) => {
-  console.log(`Key: ${event.name}, State: ${event.state}`);
-});
-
-// Later, to stop listening:
-listener.removeListener(myListener);
-```
-
-## 开发与构建
-
-### 构建原生模块
-
-本项目包含 C++ 和 Swift 原生代码，需要编译为平台特定的二进制文件。构建脚本会自动处理编译和文件复制。
-
-#### 一键构建（推荐）
-
-自动检测当前平台并构建：
-
-```bash
-npm run prebuild
-```
-
-此命令会：
-- 自动检测当前操作系统和架构
-- macOS：编译 Swift 辅助文件 + 构建原生模块 + 复制到 `packages/darwin-arm64/`
-- Windows：构建原生模块 + 复制到 `packages/win32-x64/`
-
-#### 手动指定平台构建
-
-**Windows 平台：**
-```bash
-npm run prebuild:win
-```
-
-**macOS 平台：**
-```bash
-npm run prebuild:mac
-```
-
-#### 仅复制已构建的文件
-
-如果已经构建完成，只需要复制文件到 packages 目录：
-
-```bash
-npm run copy-native win32-x64    # Windows
-npm run copy-native darwin-arm64 # macOS
-```
-
-#### 完整构建流程
-
-如果需要构建 TypeScript 代码和原生模块：
-
-```bash
-npm run build
-```
-
-这会执行：
-1. 编译 Swift 文件（macOS）
-2. 构建原生模块（node-gyp）
-3. 编译 TypeScript 代码
-
-### 发布流程
-
-发布所有平台包到 npm：
-
-```bash
-npm run publish:all
-```
-
-发布脚本会：
-1. 同步所有平台包的版本号
-2. 检查 `.node` 文件是否存在
-3. 依次发布各平台包
-4. 最后发布主包
-
-**注意：** 发布前需要确保所有平台的 `.node` 文件都已构建并复制到对应的 `packages/` 目录。
-
-## API
-
-### `getGlobalKeyboardListener(): IGlobalKeyboardListener`
-
-Returns the singleton keyboard listener instance.
-
-### `IGlobalKeyboardListener`
-
-- `addListener(listener: IGlobalKeyListener): void` - Add a key event listener
-- `removeListener(listener: IGlobalKeyListener): void` - Remove a listener
-- `kill(): void` - Stop the listener (only when no listeners remain)
-
-### `IGlobalKeyEvent`
-
-```typescript
-interface IGlobalKeyEvent {
-  readonly name: string;   // e.g. "FN", "LEFT SHIFT", "A", "ESCAPE"
-  readonly state: 'DOWN' | 'UP';
-}
-```
-
-### Context APIs (macOS & Windows)
-
-这些 API 在 macOS 和 Windows 上都可用：
-
-- `getSelectedTextSmart(): string | null` - 获取选中文本（必要时模拟 Cmd+C / Ctrl+C）
-- `getContextJSON(): string | null` - 获取完整上下文（JSON）
-- `getFrontmostAppInfo(): IAppInfo | null` - 获取前台应用信息
-- `getFocusedElementInfo(): IElementInfo | null` - 获取焦点元素信息
-- `getFocusedTextInfo(): ITextInfo | null` - 获取文本信息（选中/输入框等）
-- `getFocusedDOMInfo(): IDOMInfo | null` - 获取浏览器 DOM 信息（仅浏览器应用）
-
-**平台差异：**
-- macOS: 使用 Accessibility API，需要辅助功能权限
-- Windows: 使用 UI Automation API，无需特殊权限
-
-## Supported Keys
-
-- **Modifiers**: FN (macOS), SHIFT, CTRL, ALT, META (Cmd/Win)
-- **Letters**: A-Z
-- **Numbers**: 0-9
-- **Function keys**: F1-F12 (Windows)
-- **Special**: ESCAPE, SPACE, RETURN, TAB, BACKSPACE, DELETE
-- **Arrows**: UP, DOWN, LEFT, RIGHT
-
-## Platform Support
-
-- macOS ARM64 (Apple Silicon)
-- Windows x64
-
-## Requirements
-
-- Node.js >= 18.0.0
-- macOS: Accessibility permission required
-- Windows: No special permissions needed
-
-## License
-
-MIT
+# simen-keyboard-listener
+
+Native global keyboard listener for macOS and Windows. Captures keyboard events system-wide, including special keys like FN that cannot be detected via standard DOM events.
+
+## Installation
+
+```bash
+npm install simen-keyboard-listener
+```
+
+The package uses `optionalDependencies` to automatically install the correct native binary for your platform. Supported platforms:
+
+| Package | Platform |
+|---------|----------|
+| `@simen-keyboard-listener/darwin-arm64` | macOS Apple Silicon |
+| `@simen-keyboard-listener/win32-x64` | Windows x64 |
+
+### For Electron/Bundler Projects
+
+If you're using webpack, electron-builder, or other bundlers, you may need to configure them to include the native addon:
+
+**electron-builder (package.json):**
+```json
+{
+  "build": {
+    "files": [
+      "node_modules/@simen-keyboard-listener/**/*"
+    ]
+  }
+}
+```
+
+**webpack (webpack.config.js):**
+```javascript
+module.exports = {
+  externals: {
+    '@simen-keyboard-listener/darwin-arm64': 'commonjs @simen-keyboard-listener/darwin-arm64',
+    '@simen-keyboard-listener/win32-x64': 'commonjs @simen-keyboard-listener/win32-x64',
+  }
+};
+```
+
+## Usage
+
+```typescript
+import { getGlobalKeyboardListener } from 'simen-keyboard-listener';
+
+const listener = getGlobalKeyboardListener();
+
+listener.addListener((event, isDown) => {
+  console.log(`Key: ${event.name}, State: ${event.state}`);
+});
+
+// Later, to stop listening:
+listener.removeListener(myListener);
+```
+
+## 开发与构建
+
+### 构建原生模块
+
+本项目包含 C++ 和 Swift 原生代码，需要编译为平台特定的二进制文件。构建脚本会自动处理编译和文件复制。
+
+#### 一键构建（推荐）
+
+自动检测当前平台并构建：
+
+```bash
+npm run prebuild
+```
+
+此命令会：
+- 自动检测当前操作系统和架构
+- macOS：编译 Swift 辅助文件 + 构建原生模块 + 复制到 `packages/darwin-arm64/`
+- Windows：构建原生模块 + 复制到 `packages/win32-x64/`
+
+#### 手动指定平台构建
+
+**Windows 平台：**
+```bash
+npm run prebuild:win
+```
+
+**macOS 平台：**
+```bash
+npm run prebuild:mac
+```
+
+#### 仅复制已构建的文件
+
+如果已经构建完成，只需要复制文件到 packages 目录：
+
+```bash
+npm run copy-native win32-x64    # Windows
+npm run copy-native darwin-arm64 # macOS
+```
+
+#### 完整构建流程
+
+如果需要构建 TypeScript 代码和原生模块：
+
+```bash
+npm run build
+```
+
+这会执行：
+1. 编译 Swift 文件（macOS）
+2. 构建原生模块（node-gyp）
+3. 编译 TypeScript 代码
+
+### 发布流程
+
+发布所有平台包到 npm：
+
+```bash
+npm run publish:all
+```
+
+发布脚本会：
+1. 同步所有平台包的版本号
+2. 检查 `.node` 文件是否存在
+3. 依次发布各平台包
+4. 最后发布主包
+
+**注意：** 发布前需要确保所有平台的 `.node` 文件都已构建并复制到对应的 `packages/` 目录。
+
+## API
+
+### `getGlobalKeyboardListener(): IGlobalKeyboardListener`
+
+Returns the singleton keyboard listener instance.
+
+### `IGlobalKeyboardListener`
+
+- `addListener(listener: IGlobalKeyListener): void` - Add a key event listener
+- `removeListener(listener: IGlobalKeyListener): void` - Remove a listener
+- `kill(): void` - Stop the listener (only when no listeners remain)
+
+### `IGlobalKeyEvent`
+
+```typescript
+interface IGlobalKeyEvent {
+  readonly name: string;   // e.g. "FN", "LEFT SHIFT", "A", "ESCAPE"
+  readonly state: 'DOWN' | 'UP';
+}
+```
+
+### Context APIs (macOS & Windows)
+
+这些 API 在 macOS 和 Windows 上都可用：
+
+- `getSelectedTextSmart(): string | null` - 获取选中文本（必要时模拟 Cmd+C / Ctrl+C）
+- `getContextJSON(): string | null` - 获取完整上下文（JSON）
+- `getFrontmostAppInfo(): IAppInfo | null` - 获取前台应用信息
+- `getFocusedElementInfo(): IElementInfo | null` - 获取焦点元素信息
+- `getFocusedTextInfo(): ITextInfo | null` - 获取文本信息（选中/输入框等）
+- `getFocusedDOMInfo(): IDOMInfo | null` - 获取浏览器 DOM 信息（仅浏览器应用）
+
+**平台差异：**
+- macOS: 使用 Accessibility API，需要辅助功能权限
+- Windows: 使用 UI Automation API，无需特殊权限
+
+## Supported Keys
+
+- **Modifiers**: FN (macOS), SHIFT, CTRL, ALT, META (Cmd/Win)
+- **Letters**: A-Z
+- **Numbers**: 0-9
+- **Function keys**: F1-F12 (Windows)
+- **Special**: ESCAPE, SPACE, RETURN, TAB, BACKSPACE, DELETE
+- **Arrows**: UP, DOWN, LEFT, RIGHT
+
+## Platform Support
+
+- macOS ARM64 (Apple Silicon)
+- Windows x64
+
+## Requirements
+
+- Node.js >= 18.0.0
+- macOS: Accessibility permission required
+- Windows: No special permissions needed
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -916,13 +916,25 @@ declare function getGlobalKeyboardListener(): IGlobalKeyboardListener;
 declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
 /**
  * Check if the app has permission to listen to global keyboard events.
- * - On macOS: checks accessibility permission (System Preferences > Security & Privacy > Accessibility)
+ * - On macOS: uses multi-layer detection — CGPreflightListenEventAccess
+ *   (Input Monitoring) OR AXIsProcessTrusted (Accessibility). This ensures
+ *   correct behavior on macOS 14 (where AXIsProcessTrusted may be unreliable
+ *   for signed apps) and macOS 15/26 (where only Accessibility is needed).
  * - On Windows: always returns true (no special permission needed)
  * - On other platforms: returns false
  *
  * Call this before starting the listener to provide better UX when permission is missing.
  */
 declare function checkKeyboardPermission(): boolean;
+/**
+ * Request Input Monitoring permission on macOS.
+ * Calls CGRequestListenEventAccess which triggers the system permission prompt
+ * on first call. This is separate from Accessibility permission.
+ * - On macOS: returns true if already granted, false if user needs to grant it
+ * - On Windows: always returns true
+ * - On other platforms: returns false
+ */
+declare function requestKeyboardPermission(): boolean;
 /**
  * Check if the currently focused element is editable
  * @returns true if focused element is editable, false otherwise
@@ -994,4 +1006,4 @@ declare function setBlockSystemHotkeys(block: boolean): void;
  */
 declare function setBlockedShortcuts(shortcuts: string[]): void;
 
-export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IFrontmostInfo, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPageContextInfo, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getFrontmostInfo, getGlobalKeyboardListener, getPageContext, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isEditable, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys, setBlockedShortcuts };
+export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IFrontmostInfo, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPageContextInfo, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getFrontmostInfo, getGlobalKeyboardListener, getPageContext, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isEditable, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, requestKeyboardPermission, setBlockSystemHotkeys, setBlockedShortcuts };

package/dist/index.d.ts

@@ -916,13 +916,25 @@ declare function getGlobalKeyboardListener(): IGlobalKeyboardListener;
 declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
 /**
  * Check if the app has permission to listen to global keyboard events.
- * - On macOS: checks accessibility permission (System Preferences > Security & Privacy > Accessibility)
+ * - On macOS: uses multi-layer detection — CGPreflightListenEventAccess
+ *   (Input Monitoring) OR AXIsProcessTrusted (Accessibility). This ensures
+ *   correct behavior on macOS 14 (where AXIsProcessTrusted may be unreliable
+ *   for signed apps) and macOS 15/26 (where only Accessibility is needed).
  * - On Windows: always returns true (no special permission needed)
  * - On other platforms: returns false
  *
  * Call this before starting the listener to provide better UX when permission is missing.
  */
 declare function checkKeyboardPermission(): boolean;
+/**
+ * Request Input Monitoring permission on macOS.
+ * Calls CGRequestListenEventAccess which triggers the system permission prompt
+ * on first call. This is separate from Accessibility permission.
+ * - On macOS: returns true if already granted, false if user needs to grant it
+ * - On Windows: always returns true
+ * - On other platforms: returns false
+ */
+declare function requestKeyboardPermission(): boolean;
 /**
  * Check if the currently focused element is editable
  * @returns true if focused element is editable, false otherwise
@@ -994,4 +1006,4 @@ declare function setBlockSystemHotkeys(block: boolean): void;
  */
 declare function setBlockedShortcuts(shortcuts: string[]): void;
 
-export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IFrontmostInfo, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPageContextInfo, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getFrontmostInfo, getGlobalKeyboardListener, getPageContext, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isEditable, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, setBlockSystemHotkeys, setBlockedShortcuts };
+export { type IAgentContext$1 as IAgentContext, type IAgentContextOptions$1 as IAgentContextOptions, type IClipboardContent$1 as IClipboardContent, type IDesktopItem$1 as IDesktopItem, type IExecuteOptions$1 as IExecuteOptions, type IExecuteResult$1 as IExecuteResult, type IFileContent$1 as IFileContent, type IFileMetadata$1 as IFileMetadata, type IFinderContext, type IFinderItem, type IFinderSelection, type IFinderWindow, type IFinderWindowInfo, type IFinderWindowItem, type IFrontmostApp$1 as IFrontmostApp, type IFrontmostInfo, type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, type IPageContextInfo, type IPermissionLostListener, type IReadFileOptions$1 as IReadFileOptions, type IRecentFile$1 as IRecentFile, type IRunningApp$1 as IRunningApp, type ISelectedItem$1 as ISelectedItem, type ISystemContext$1 as ISystemContext, checkKeyboardPermission, createGlobalKeyboardListener, escapeForAppleScript, executeAndParse$1 as executeAndParse, executeAppleScript, executeAppleScriptLines, executeMultilineAndParse$1 as executeMultilineAndParse, getAgentContext$1 as getAgentContext, getClipboardContent$1 as getClipboardContent, getClipboardText$1 as getClipboardText, getDesktopItems, getDesktopPath, getFileMetadata, getFilesMetadata, getFinderContext, getFinderCurrentFolder, getFinderSelection, getFinderWindows, getFocusedValue, getFrontmostApp$1 as getFrontmostApp, getFrontmostFromRunning, getFrontmostInfo, getGlobalKeyboardListener, getPageContext, getRecentDocuments, getRecentFiles, getRunningApps, getSelectedTextSmart, getSystemContext$1 as getSystemContext, isAppRunning, isEditable, isOsascriptAvailable, index as powershell, readFileContent, readMultipleFiles, requestKeyboardPermission, setBlockSystemHotkeys, setBlockedShortcuts };

package/dist/index.js

@@ -65,6 +65,7 @@ __export(index_exports, {
   powershell: () => powershell_exports,
   readFileContent: () => readFileContent,
   readMultipleFiles: () => readMultipleFiles,
+  requestKeyboardPermission: () => requestKeyboardPermission,
   setBlockSystemHotkeys: () => setBlockSystemHotkeys,
   setBlockedShortcuts: () => setBlockedShortcuts
 });
@@ -2470,6 +2471,17 @@ function checkKeyboardPermission() {
     return false;
   }
 }
+function requestKeyboardPermission() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) {
+    return false;
+  }
+  try {
+    const addon = getNativeAddon();
+    return addon.requestListenPermission?.() ?? false;
+  } catch {
+    return false;
+  }
+}
 var lastMacAccessibilitySettingsOpenTs = 0;
 function openMacAccessibilitySettings() {
   if (!IS_MACOS2) {
@@ -2604,6 +2616,7 @@ function setBlockedShortcuts(shortcuts) {
   powershell,
   readFileContent,
   readMultipleFiles,
+  requestKeyboardPermission,
   setBlockSystemHotkeys,
   setBlockedShortcuts
 });

package/dist/index.mjs

@@ -2411,6 +2411,17 @@ function checkKeyboardPermission() {
     return false;
   }
 }
+function requestKeyboardPermission() {
+  if (!IS_MACOS2 && !IS_WINDOWS2) {
+    return false;
+  }
+  try {
+    const addon = getNativeAddon();
+    return addon.requestListenPermission?.() ?? false;
+  } catch {
+    return false;
+  }
+}
 var lastMacAccessibilitySettingsOpenTs = 0;
 function openMacAccessibilitySettings() {
   if (!IS_MACOS2) {
@@ -2544,6 +2555,7 @@ export {
   powershell_exports as powershell,
   readFileContent,
   readMultipleFiles,
+  requestKeyboardPermission,
   setBlockSystemHotkeys,
   setBlockedShortcuts
 };

package/package.json

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