simen-keyboard-listener 1.0.0 → 1.0.1

package/dist/index.d.mts

@@ -0,0 +1,27 @@
+type IGlobalKeyState = 'DOWN' | 'UP';
+interface IGlobalKeyEvent {
+    readonly name: string;
+    readonly state: IGlobalKeyState;
+}
+type IGlobalKeyDownMap = Record<string, boolean>;
+type IGlobalKeyListener = (event: IGlobalKeyEvent, isDown: IGlobalKeyDownMap) => void;
+interface IGlobalKeyboardListener {
+    addListener(listener: IGlobalKeyListener): void;
+    removeListener(listener: IGlobalKeyListener): void;
+    kill(): void;
+}
+/**
+ * Get the global keyboard listener singleton.
+ * The listener is shared across all consumers - use addListener/removeListener
+ * to subscribe to key events.
+ *
+ * @throws Error if platform is not supported (only macOS and Windows are supported)
+ */
+declare function getGlobalKeyboardListener(): IGlobalKeyboardListener;
+/**
+ * @deprecated Use getGlobalKeyboardListener() instead for singleton access.
+ * This function is kept for backward compatibility but now returns the singleton.
+ */
+declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
+
+export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, createGlobalKeyboardListener, getGlobalKeyboardListener };

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+type IGlobalKeyState = 'DOWN' | 'UP';
+interface IGlobalKeyEvent {
+    readonly name: string;
+    readonly state: IGlobalKeyState;
+}
+type IGlobalKeyDownMap = Record<string, boolean>;
+type IGlobalKeyListener = (event: IGlobalKeyEvent, isDown: IGlobalKeyDownMap) => void;
+interface IGlobalKeyboardListener {
+    addListener(listener: IGlobalKeyListener): void;
+    removeListener(listener: IGlobalKeyListener): void;
+    kill(): void;
+}
+/**
+ * Get the global keyboard listener singleton.
+ * The listener is shared across all consumers - use addListener/removeListener
+ * to subscribe to key events.
+ *
+ * @throws Error if platform is not supported (only macOS and Windows are supported)
+ */
+declare function getGlobalKeyboardListener(): IGlobalKeyboardListener;
+/**
+ * @deprecated Use getGlobalKeyboardListener() instead for singleton access.
+ * This function is kept for backward compatibility but now returns the singleton.
+ */
+declare function createGlobalKeyboardListener(): IGlobalKeyboardListener;
+
+export { type IGlobalKeyDownMap, type IGlobalKeyEvent, type IGlobalKeyListener, type IGlobalKeyState, type IGlobalKeyboardListener, createGlobalKeyboardListener, getGlobalKeyboardListener };

package/dist/index.js

@@ -0,0 +1,167 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createGlobalKeyboardListener: () => createGlobalKeyboardListener,
+  getGlobalKeyboardListener: () => getGlobalKeyboardListener
+});
+module.exports = __toCommonJS(index_exports);
+var path = __toESM(require("path"));
+var fs = __toESM(require("fs"));
+var import_node_module = require("module");
+var import_url = require("url");
+var import_meta = {};
+function getModulePaths() {
+  if (typeof import_meta !== "undefined" && import_meta.url) {
+    const filename = (0, import_url.fileURLToPath)(import_meta.url);
+    const dirname2 = path.dirname(filename);
+    const require2 = (0, import_node_module.createRequire)(import_meta.url);
+    return { dirname: dirname2, require: require2 };
+  }
+  return {
+    dirname: __dirname,
+    require
+  };
+}
+var modulePaths = getModulePaths();
+function getNativeAddonPath() {
+  const platformArch = `${process.platform}-${process.arch}`;
+  const baseDir = modulePaths.dirname;
+  const possiblePaths = [
+    // Prebuilt binaries (preferred)
+    path.join(baseDir, "..", "prebuilds", platformArch, "simen_keyboard_listener.node"),
+    // Build output from node-gyp
+    path.join(baseDir, "native", "build", "Release", "simen_keyboard_listener.node"),
+    path.join(baseDir, "native", "build", "Debug", "simen_keyboard_listener.node"),
+    // Source native directory (for development)
+    path.join(baseDir, "..", "src", "native", "build", "Release", "simen_keyboard_listener.node"),
+    path.join(baseDir, "..", "src", "native", "build", "Debug", "simen_keyboard_listener.node")
+  ];
+  for (const addonPath of possiblePaths) {
+    if (fs.existsSync(addonPath)) {
+      return addonPath;
+    }
+  }
+  throw new Error(
+    `simen-keyboard-listener: Native addon not found for ${platformArch}. Searched paths: ${possiblePaths.join(", ")}`
+  );
+}
+var nativeAddon = null;
+function getNativeAddon() {
+  if (nativeAddon) {
+    return nativeAddon;
+  }
+  const addonPath = getNativeAddonPath();
+  nativeAddon = modulePaths.require(addonPath);
+  return nativeAddon;
+}
+var NativeKeyboardListener = class _NativeKeyboardListener {
+  constructor(addon) {
+    this.addon = addon;
+  }
+  static _instance = null;
+  started = false;
+  listeners = /* @__PURE__ */ new Set();
+  static getInstance() {
+    if (!_NativeKeyboardListener._instance) {
+      const addon = getNativeAddon();
+      _NativeKeyboardListener._instance = new _NativeKeyboardListener(addon);
+    }
+    return _NativeKeyboardListener._instance;
+  }
+  addListener(listener) {
+    this.listeners.add(listener);
+    if (!this.started) {
+      const ok = this.addon.start((event) => {
+        const listenersCopy = Array.from(this.listeners);
+        for (const cb of listenersCopy) {
+          try {
+            cb(event, {});
+          } catch {
+          }
+        }
+      });
+      if (!ok) {
+        throw new Error("Failed to start native keyboard listener (permission denied or unsupported platform)");
+      }
+      this.started = true;
+    }
+  }
+  removeListener(listener) {
+    this.listeners.delete(listener);
+    if (this.listeners.size === 0 && this.started) {
+      this.kill();
+    }
+  }
+  kill() {
+    if (this.listeners.size > 0) {
+      return;
+    }
+    try {
+      if (this.started && this.addon.isRunning()) {
+        this.addon.stop();
+      }
+    } catch {
+    } finally {
+      this.started = false;
+    }
+  }
+  /**
+   * Force stop the listener regardless of remaining listeners.
+   * Use with caution - this will affect all consumers.
+   */
+  forceKill() {
+    try {
+      if (this.started && this.addon.isRunning()) {
+        this.addon.stop();
+      }
+    } catch {
+    } finally {
+      this.started = false;
+      this.listeners.clear();
+      _NativeKeyboardListener._instance = null;
+    }
+  }
+};
+function getGlobalKeyboardListener() {
+  if (process.platform !== "darwin" && process.platform !== "win32") {
+    throw new Error(`Unsupported platform for global keyboard listener: ${process.platform}`);
+  }
+  return NativeKeyboardListener.getInstance();
+}
+function createGlobalKeyboardListener() {
+  return getGlobalKeyboardListener();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createGlobalKeyboardListener,
+  getGlobalKeyboardListener
+});

package/dist/index.mjs

@@ -0,0 +1,137 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/index.ts
+import * as path from "path";
+import * as fs from "fs";
+import { createRequire } from "module";
+import { fileURLToPath } from "url";
+function getModulePaths() {
+  if (typeof import.meta !== "undefined" && import.meta.url) {
+    const filename = fileURLToPath(import.meta.url);
+    const dirname2 = path.dirname(filename);
+    const require2 = createRequire(import.meta.url);
+    return { dirname: dirname2, require: require2 };
+  }
+  return {
+    dirname: __dirname,
+    require: __require
+  };
+}
+var modulePaths = getModulePaths();
+function getNativeAddonPath() {
+  const platformArch = `${process.platform}-${process.arch}`;
+  const baseDir = modulePaths.dirname;
+  const possiblePaths = [
+    // Prebuilt binaries (preferred)
+    path.join(baseDir, "..", "prebuilds", platformArch, "simen_keyboard_listener.node"),
+    // Build output from node-gyp
+    path.join(baseDir, "native", "build", "Release", "simen_keyboard_listener.node"),
+    path.join(baseDir, "native", "build", "Debug", "simen_keyboard_listener.node"),
+    // Source native directory (for development)
+    path.join(baseDir, "..", "src", "native", "build", "Release", "simen_keyboard_listener.node"),
+    path.join(baseDir, "..", "src", "native", "build", "Debug", "simen_keyboard_listener.node")
+  ];
+  for (const addonPath of possiblePaths) {
+    if (fs.existsSync(addonPath)) {
+      return addonPath;
+    }
+  }
+  throw new Error(
+    `simen-keyboard-listener: Native addon not found for ${platformArch}. Searched paths: ${possiblePaths.join(", ")}`
+  );
+}
+var nativeAddon = null;
+function getNativeAddon() {
+  if (nativeAddon) {
+    return nativeAddon;
+  }
+  const addonPath = getNativeAddonPath();
+  nativeAddon = modulePaths.require(addonPath);
+  return nativeAddon;
+}
+var NativeKeyboardListener = class _NativeKeyboardListener {
+  constructor(addon) {
+    this.addon = addon;
+  }
+  static _instance = null;
+  started = false;
+  listeners = /* @__PURE__ */ new Set();
+  static getInstance() {
+    if (!_NativeKeyboardListener._instance) {
+      const addon = getNativeAddon();
+      _NativeKeyboardListener._instance = new _NativeKeyboardListener(addon);
+    }
+    return _NativeKeyboardListener._instance;
+  }
+  addListener(listener) {
+    this.listeners.add(listener);
+    if (!this.started) {
+      const ok = this.addon.start((event) => {
+        const listenersCopy = Array.from(this.listeners);
+        for (const cb of listenersCopy) {
+          try {
+            cb(event, {});
+          } catch {
+          }
+        }
+      });
+      if (!ok) {
+        throw new Error("Failed to start native keyboard listener (permission denied or unsupported platform)");
+      }
+      this.started = true;
+    }
+  }
+  removeListener(listener) {
+    this.listeners.delete(listener);
+    if (this.listeners.size === 0 && this.started) {
+      this.kill();
+    }
+  }
+  kill() {
+    if (this.listeners.size > 0) {
+      return;
+    }
+    try {
+      if (this.started && this.addon.isRunning()) {
+        this.addon.stop();
+      }
+    } catch {
+    } finally {
+      this.started = false;
+    }
+  }
+  /**
+   * Force stop the listener regardless of remaining listeners.
+   * Use with caution - this will affect all consumers.
+   */
+  forceKill() {
+    try {
+      if (this.started && this.addon.isRunning()) {
+        this.addon.stop();
+      }
+    } catch {
+    } finally {
+      this.started = false;
+      this.listeners.clear();
+      _NativeKeyboardListener._instance = null;
+    }
+  }
+};
+function getGlobalKeyboardListener() {
+  if (process.platform !== "darwin" && process.platform !== "win32") {
+    throw new Error(`Unsupported platform for global keyboard listener: ${process.platform}`);
+  }
+  return NativeKeyboardListener.getInstance();
+}
+function createGlobalKeyboardListener() {
+  return getGlobalKeyboardListener();
+}
+export {
+  createGlobalKeyboardListener,
+  getGlobalKeyboardListener
+};

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "simen-keyboard-listener",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Native global keyboard listener for macOS and Windows",
-  "main": "./lib/index.js",
-  "module": "./lib/index.mjs",
-  "types": "./lib/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./lib/index.d.ts",
-      "import": "./lib/index.mjs",
-      "require": "./lib/index.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
     }
   },
   "files": [
-    "lib",
+    "dist",
     "prebuilds",
     "src/native"
   ],