node-native-win-utils 1.3.2-alpha.2 → 1.3.3

package/README.md

@@ -1,350 +1,758 @@
-[![License][license-src]][license-href]
+
+[![License][license-src]][license-href] 
+
+ [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/ryner)
+
+  
+
+#### USDT TRC20 - TYAJ3K3MZraJhWimxxeCKcJ2SYABkVsrzi
+####  USDT TON - UQDokuYZXr4OHvfslDqUoFYcp1_F8tcjQPk_TvqSSDk7SIa7
+####  BTC - 1A3mNKFdWKXZ7Bcnez8LbWbYHgck1g4GeV
+####  NOT - UQDokuYZXr4OHvfslDqUoFYcp1_F8tcjQPk_TvqSSDk7SIa7
+
+  
+
+####  Will be very thankful for any support
+
+  
 
 # Node Native Win Utils
 
+  
+
 I did it for myself because I didn't feel like dealing with libraries like 'node-ffi' to implement this functionality. Maybe someone will find it useful. It's WINDOWS OS ONLY
 
+  
+
 This package is a native addon for Node.js that allows you to perform various utility operations on Windows systems. It includes key event listeners, window data retrieval, window screenshot capture functionality, mouse movement, mouse click, mouse drag, and typing functionality, also I included precompiled libs of OpenCV(core, imgcodecs, imgproc)
 
+  
+
+# VESRION 1.3.3
+
+Added a new function to simulate button press and release (`keyPress`), introduced an enumeration `KeyCodesHelper` with the most common key codes, and fixed a bug where the `typeString` function was not working with languages other than English.
+
+  
+
 # Installation
 
+  
+
 You can install the package using npm:
 
+  
+
 ```shell
 
+  
+
 npm  install  node-native-win-utils
 
+  
+
 ```
 
+  
+
 # Usage
 
+  
+
 ## Importing the Package
 
+  
+
 To use the package, import the necessary functions, types, and classes:
 
+  
+
 ```javascript
+
 import {
-  keyDownHandler,
-  keyUpHandler,
-  getWindowData,
-  captureWindow,
-  captureWindowN,
-  mouseMove,
-  mouseClick,
-  mouseDrag,
-  typeString,
-  OpenCV,
-} from "node-native-win-utils";
+
+keyDownHandler,
+
+keyUpHandler,
+
+getWindowData,
+
+captureWindow,
+
+captureWindowN,
+
+mouseMove,
+
+mouseClick,
+
+mouseDrag,
+
+typeString,
+
+OpenCV,
+
+} from  "node-native-win-utils";
+
 ```
 
+  
+
 ## Key Event Listeners
 
+  
+
 The package provides `keyDownHandler` and `keyUpHandler` functions, which allow you to register callbacks for key down and key up events, respectively. The callbacks receive the `keyCode` as a parameter:
 
+  
+
 ```javascript
+
 keyDownHandler((keyCode) => {
-  console.log("Key down:", keyCode);
+
+console.log("Key down:", keyCode);
+
 });
 
+  
+
 // Key down: 8
 
+  
+
 keyUpHandler((keyCode) => {
-  console.log("Key up:", keyCode);
+
+console.log("Key up:", keyCode);
+
 });
 
+  
+
 // Key up: 8
+
 ```
 
+## Key Press
+
+  
+
+The keyPress function allows you to simulate a key press event. Provide the keyCode as a parameter and optionally the number of times to press the key:
+
+  
+
+```javascript
+
+keyPress(65); // Press 'A' key once
+
+  
+
+keyPress(65, 3); // Press 'A' key three times
+
+```
+
+## Key Code Helper
+
+  
+
+The KeyCodeHelper enum provides a set of key codes that can be used with key event functions:
+
+  
+
+```javascript
+
+  
+
+import { KeyCodeHelper } from  "node-native-win-utils";
+
+  
+
+console.log(KeyCodeHelper.A); // Outputs the key code for 'A'
+
+```
+
+  
+
 ## Window Data
 
+  
+
 The `getWindowData` function retrieves information about a specific window identified by its name. It returns an object with properties `width`, `height`, `x`, and `y`, representing the window dimensions and position:
 
+  
+
 ```javascript
-const windowData = getWindowData("Window Name");
+
+const  windowData  =  getWindowData("Window Name");
+
+  
 
 console.log("Window data:", windowData);
 
+  
+
 // Window data: { width: 800, height: 600, x: 50, y: 50 }
+
 ```
 
+  
+
 ## Window Capture
 
+  
+
 The `captureWindow` function allows you to capture a screenshot of a specific window identified by its name. Provide the window name and the output path as parameters:
 
+  
+
 ```javascript
+
 captureWindow("Window Name", "output.png");
 
+  
+
 // Output: output.png with a screenshot of the window
+
 ```
 
+  
+
 ## Mouse Movement
 
+  
+
 The `mouseMove` function allows you to move the mouse to a specific position on the screen. Provide the `posX` and `posY` coordinates as parameters:
 
+  
+
 ```javascript
+
 mouseMove(100, 200);
+
 ```
 
+  
+
 ## Mouse Click
 
+  
+
 The `mouseClick` function allows you to perform a mouse click event. Optionally, you can specify the mouse button as a parameter (`"left"`, `"middle"`, or `"right"`). If no button is specified, a left mouse click is performed by default:
 
+  
+
 ```javascript
+
 mouseClick(); // Left mouse click
 
+  
+
 mouseClick("right"); // Right mouse click
+
 ```
 
+  
+
 ## Mouse Drag
 
+  
+
 The `mouseDrag` function allows you to simulate dragging the mouse from one position to another. Provide the starting and ending coordinates (`startX`, `startY`, `endX`, `endY`) as parameters. Optionally, you can specify the speed at which the mouse should be dragged:
 
+  
+
 ```javascript
+
 mouseDrag(100, 200, 300, 400);
 
+  
+
 mouseDrag(100, 200, 300, 400, 100); // Drag with speed 100
+
 ```
 
+  
+
 ## Typing
 
+  
+
 The `typeString` function allows you to simulate typing a string of characters. Provide the string to type as the `stringToType` parameter. Optionally, you can specify
 
+  
+
 a delay between each character (in milliseconds) using the `delay` parameter:
 
+  
+
 ```javascript
+
 typeString("Hello, world!");
 
+  
+
 typeString("Hello, world!", 100); // Type with a delay of 100ms between characters
+
 ```
 
+  
+
 ## Key Listener Class
 
+  
+
 The `KeyListener` class extends the EventEmitter class and simplifies working with the `keyDownHandler` and `keyUpHandler` functions. You can register event listeners for the "keyDown" and "keyUp" events using the `on` method:
 
+  
+
 ```javascript
-const listener = new KeyListener();
+
+const  listener  =  new  KeyListener();
+
+  
 
 listener.on("keyDown", (data) => {
-  console.log("Key down:", data.keyCode, data.keyName);
+
+console.log("Key down:", data.keyCode, data.keyName);
+
 });
 
+  
+
 // Key down: 8 Backspace
 
+  
+
 listener.on("keyUp", (data) => {
-  console.log("Key up:", data.keyCode, data.keyName);
+
+console.log("Key up:", data.keyCode, data.keyName);
+
 });
 
+  
+
 // Key up: 8 Backspace
+
 ```
 
+  
+
 ## OpenCV
 
+  
+
 The `OpenCV` class extends the capabilities of the native addon package by providing various image processing functionalities. It allows users to perform operations such as matching templates, blurring images, converting color formats, drawing rectangles, getting image regions, and writing images to files.
 
+  
+
 #### Constructor
 
+  
+
 ```typescript
-const image = new  OpenCV(image: string | ImageData)
+
+const  image  =  new  OpenCV(image: string  |  ImageData)
+
 ```
 
+  
+
 Creates a new instance of the `OpenCV` class with the specified image data. The `image` parameter can be either a file path (string) or an existing `ImageData` object.
 
+  
+
 #### Properties
 
+  
+
 ##### `imageData: ImageData`
 
+  
+
 Holds the underlying image data that will be used for image processing operations.
 
+  
+
 ##### `width: number`
 
+  
+
 Read-only property that returns the width of the image in pixels.
 
+  
+
 ##### `height: number`
 
+  
+
 Read-only property that returns the height of the image in pixels.
 
+  
+
 #### Methods
 
+  
+
 ##### `matchTemplate(template: ImageData, method?: number | null, mask?: ImageData): OpenCV`
 
+  
+
 Matches a template image with the current image and returns a new `OpenCV` instance containing the result.
 
-- `template: ImageData`: The template image data to be matched.
-- `method?: number | null`: (Optional) The matching method to be used. If not provided, the default method will be used.(currently no implemented)
-- `mask?: ImageData`: (Optional) An optional mask image data to be used during the matching process.
+  
+
+-  `template: ImageData`: The template image data to be matched.
+
+-  `method?: number | null`: (Optional) The matching method to be used. If not provided, the default method will be used.(currently no implemented)
+
+-  `mask?: ImageData`: (Optional) An optional mask image data to be used during the matching process.
+
+  
 
 ##### `blur(sizeX: number, sizeY: number): OpenCV`
 
+  
+
 Applies a blur filter to the current image and returns a new `OpenCV` instance containing the blurred result.
 
-- `sizeX: number`: The size of the blur kernel in the X direction.
-- `sizeY: number`: The size of the blur kernel in the Y direction.
+  
+
+-  `sizeX: number`: The size of the blur kernel in the X direction.
+
+-  `sizeY: number`: The size of the blur kernel in the Y direction.
+
+  
 
 ##### `bgrToGray(): OpenCV`
 
+  
+
 Converts the current image from the BGR color format to grayscale and returns a new `OpenCV` instance containing the grayscale result.
 
+  
+
 ##### `drawRectangle(start: Point, end: Point, rgb: Color, thickness: number): OpenCV`
 
+  
+
 Draws a rectangle on the current image and returns a new `OpenCV` instance containing the modified result.
 
-- `start: Point`: The starting point (top-left) of the rectangle.
-- `end: Point`: The ending point (bottom-right) of the rectangle.
-- `rgb: Color`: The color of the rectangle in the RGB format (e.g., `{ r: 255, g: 0, b: 0 }` for red).
-- `thickness: number`: The thickness of the rectangle's border.
+  
+
+-  `start: Point`: The starting point (top-left) of the rectangle.
+
+-  `end: Point`: The ending point (bottom-right) of the rectangle.
+
+-  `rgb: Color`: The color of the rectangle in the RGB format (e.g., `{ r: 255, g: 0, b: 0 }` for red).
+
+-  `thickness: number`: The thickness of the rectangle's border.
+
+  
 
 ##### `getRegion(region: ROI): OpenCV`
 
+  
+
 Extracts a region of interest (ROI) from the current image and returns a new `OpenCV` instance containing the extracted region.
 
-- `region: ROI`: An object specifying the region of interest with properties `x`, `y`, `width`, `height`.
+  
+
+-  `region: ROI`: An object specifying the region of interest with properties `x`, `y`, `width`, `height`.
+
+  
 
 ##### `imwrite(path: string): void`
 
+  
+
 Writes the current image to a file specified by the `path`.
 
-- `path: string`: The file path where the image will be saved.
+  
+
+-  `path: string`: The file path where the image will be saved.
+
+  
 
 ## Functions
 
-| Function       | Parameters                                                                   | Return Type  |
-| -------------- | ---------------------------------------------------------------------------- | ------------ |
-| keyDownHandler | `callback: (keyCode: number) => void`                                        | `void`       |
-| keyUpHandler   | `callback: (keyCode: number) => void`                                        | `void`       |
-| getWindowData  | `windowName: string`                                                         | `WindowData` |
-| captureWindow  | `windowName: string, outputPath: string`                                     | `void`       |
-| mouseMove      | `posX: number, posY: number`                                                 | `boolean`    |
-| mouseClick     | `button?: "left" \| "middle" \| "right"`                                     | `boolean`    |
-| mouseDrag      | `startX: number, startY: number, endX: number, endY: number, speed?: number` | `boolean`    |
-| typeString     | `stringToType: string, delay?: number`                                       | `boolean`    |
-| captureWindowN | `windowName: string`                                                         | `Buffer`     |
+  
+
+| Function        | Parameters                                                                                   | Return Type |
+|-----------------|----------------------------------------------------------------------------------------------|-------------|
+| keyDownHandler  | `callback: (keyCode: number) => void`                                                         | `void`      |
+| keyUpHandler    | `callback: (keyCode: number) => void`                                                         | `void`      |
+| getWindowData   | `windowName: string`                                                                         | `WindowData`|
+| captureWindow   | `windowName: string, outputPath: string`                                                      | `void`      |
+| mouseMove       | `posX: number, posY: number`                                                                  | `boolean`   |
+| mouseClick      | `button?: "left" \| "middle" \| "right"`                                                      | `boolean`   |
+| mouseDrag       | `startX: number, startY: number, endX: number, endY: number, speed?: number`                | `boolean`   |
+| typeString      | `stringToType: string, delay?: number`                                                        | `boolean`   |
+| captureWindowN  | `windowName: string`                                                                         | `Buffer`    |
+| keyPress        | `keyCode: number, repeat?: number`                                                           | `boolean`   |
+
+
+  
 
 ## Examples
 
+  
+
 Here are some examples of using the package:
 
+  
+
 ```javascript
+
 // Example usage of the OpenCV class
-import { OpenCV } from "node-native-win-utils";
 
-const image = new OpenCV("path/to/image.png");
+import { OpenCV } from  "node-native-win-utils";
+
+  
+
+const  image  =  new  OpenCV("path/to/image.png");
+
+  
+
+const  template  =  new  OpenCV("path/to/template.png");
+
+const  matchedImage  =  image.matchTemplate(template.imageData);
+
+  
+
+const  blurredImage  =  image.blur(5, 5);
+
+  
+
+const  grayscaleImage  =  image.bgrToGray();
 
-const template = new OpenCV("path/to/template.png");
-const matchedImage = image.matchTemplate(template.imageData);
+  
 
-const blurredImage = image.blur(5, 5);
+const  regionOfInterest  = { x:  100, y:  100, width:  200, height:  150 };
 
-const grayscaleImage = image.bgrToGray();
+const  regionImage  =  image.getRegion(regionOfInterest);
 
-const regionOfInterest = { x: 100, y: 100, width: 200, height: 150 };
-const regionImage = image.getRegion(regionOfInterest);
+  
+
+const  redColor  = { r:  255, g:  0, b:  0 };
+
+const  thickRectangle  =  image.drawRectangle(
+
+{ x:  50, y:  50 },
+
+{ x:  150, y:  150 },
+
+redColor,
+
+3
 
-const redColor = { r: 255, g: 0, b: 0 };
-const thickRectangle = image.drawRectangle(
-  { x: 50, y: 50 },
-  { x: 150, y: 150 },
-  redColor,
-  3
 );
 
+  
+
 matchedImage.imwrite("output/matched.png");
+
 blurredImage.imwrite("output/blurred.png");
+
 grayscaleImage.imwrite("output/grayscale.png");
+
 regionImage.imwrite("output/region.png");
+
 thickRectangle.imwrite("output/thick_rectangle.png");
+
 ```
 
+  
+
 ```javascript
+
 // If you want to aply blur and convert to gray then do it that order:
+
 image.blur(5, 5).bgrToGray();
+
 // Otherwise you will get an error.
+
 ```
 
+  
+
 Please note that the above example demonstrates the usage of different methods available in the `OpenCV` class. Make sure to replace `"path/to/image.png"` and `"path/to/template.png"` with actual image file paths.
 
+  
+
 ```javascript
+
 import {
-  keyDownHandler,
-  keyUpHandler,
-  getWindowData,
-  captureWindow,
-  mouseMove,
-  mouseClick,
-  mouseDrag,
-  typeString,
-  KeyListener,
-} from "node-native-win-utils";
+
+keyDownHandler,
+
+keyUpHandler,
+
+getWindowData,
+
+captureWindow,
+
+mouseMove,
+
+mouseClick,
+
+mouseDrag,
+
+typeString,
+
+KeyListener,
+
+} from  "node-native-win-utils";
+
+  
 
 // Register key event handlers
 
+  
+
 keyDownHandler((keyCode) => {
-  console.log("Key down:", keyCode);
+
+console.log("Key down:", keyCode);
+
 });
 
+  
+
 // Key down: 123
 
+  
+
 keyUpHandler((keyCode) => {
-  console.log("Key up:", keyCode);
+
+console.log("Key up:", keyCode);
+
 });
 
+  
+
 // Key up: 123
 
+  
+
 // Retrieve window data
 
-const windowData = getWindowData("My Window");
+  
+
+const  windowData  =  getWindowData("My Window");
+
+  
 
 console.log("Window data:", windowData);
 
+  
+
 // Window data: { width: 1024, height: 768, x: 100, y: 100 }
 
+  
+
 // Capture window screenshot
 
+  
+
 captureWindow("My Window", "output.png");
 
+  
+
 // Output: output.png with a screenshot of the window
 
+  
+
 // Move the mouse
 
+  
+
 mouseMove(100, 200);
 
+  
+
 // Perform mouse click
 
+  
+
 mouseClick(); // Left mouse click
 
+  
+
 mouseClick("right"); // Right mouse click
 
+  
+
 // Simulate mouse drag
 
+  
+
 mouseDrag(100, 200, 300, 400);
 
+  
+
 mouseDrag(100, 200, 300, 400, 100); // Drag with speed 100
 
+  
+
 // Simulate typing
 
+  
+
 typeString("Hello, world!");
 
+  
+
 typeString("Hello, world!", 100); // Type with a delay of 100ms between characters
 
+  
+
 // Use KeyListener class
 
-const listener = new KeyListener();
+  
+
+const  listener  =  new  KeyListener();
+
+  
 
 listener.on("keyDown", (data) => {
-  console.log("Key down:", data.keyCode, data.keyName);
+
+console.log("Key down:", data.keyCode, data.keyName);
+
 });
 
-// Key down: 8 Backspace
+  
+
+// Key down: keyCode keyName
+
+  
 
 listener.on("keyUp", (data) => {
-  console.log("Key up:", data.keyCode, data.keyName);
+
+console.log("Key up:", data.keyCode, data.keyName);
+
 });
 
-// Key up: 8 Backspace
+  
+
+// Key up: keyCode keyName
+
+  
+  
+
 ```
 
-P.S.: As my knowledge of C++ is just brief, most of the C++ code is written with help of GPT-3.5 and GPT-4
+# TODO
+
+  
+
+- Write proper tests
+
+- Add more useful functions
+
+- Fix issue with Windows scale for font,text,apps
+
+  
 
 [OpenCV License](https://github.com/opencv/opencv/blob/master/LICENSE)
+[MIT License](https://github.com/RynerNO/node-native-win-utils/blob/main/LICENSE)
+  
 
 [license-src]: https://img.shields.io/github/license/nuxt-modules/icon.svg?style=for-the-badge&colorA=18181B&colorB=28CF8D
+
 [license-href]: https://github.com/RynerNO/node-native-win-utils/blob/main/LICENSE

package/binding.gyp

@@ -40,7 +40,7 @@
             "defines": ["NAPI_CPP_EXCEPTIONS"],
             "cflags!": ["-fno-exceptions"],
             "cflags_cc!": ["-fno-rtti"],
-            "cflags": ["/std:c++17"]
+            "cflags": ["/std:c++21"]
         }
     ]
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import EventEmitter = require("events");
+import { KeyCodeHelper } from "./keyCodes";
 /**
  * Represents the data of a window.
  */
@@ -80,6 +81,7 @@ export type BgrToGray = (image: ImageData) => ImageData;
 export type DrawRectangle = (image: ImageData, start: Point, end: Point, rgb: Color, thickness: number) => ImageData;
 export type GetRegion = (image: ImageData, region: ROI) => ImageData;
 declare const keyDownHandler: KeyDownHandler, keyUpHandler: KeyUpHandler, getWindowData: GetWindowData, captureWindowN: CaptureWindow, mouseMove: MouseMove, mouseClick: MouseClick, mouseDrag: MouseDrag, typeString: TypeString;
+declare const rawPressKey: PressKey;
 /**
  * Captures a window and saves it to a file.
  * @param windowName - The name of the window to capture.
@@ -172,5 +174,5 @@ export declare class OpenCV {
      */
     imwrite(path: string): void;
 }
-declare function keyPress(keyCode: number, repeat?: number): Promise<unknown>;
-export { keyDownHandler, keyUpHandler, getWindowData, captureWindow, captureWindowN, mouseMove, mouseClick, mouseDrag, typeString, keyPress };
+declare function keyPress(keyCode: number, repeat?: number): Promise<boolean>;
+export { keyDownHandler, keyUpHandler, getWindowData, captureWindow, captureWindowN, mouseMove, mouseClick, mouseDrag, typeString, keyPress, rawPressKey, KeyCodeHelper };

package/dist/index.js

@@ -3,14 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.typeString = exports.mouseDrag = exports.mouseClick = exports.mouseMove = exports.captureWindowN = exports.getWindowData = exports.keyUpHandler = exports.keyDownHandler = exports.OpenCV = exports.KeyListener = void 0;
+exports.KeyCodeHelper = exports.rawPressKey = exports.typeString = exports.mouseDrag = exports.mouseClick = exports.mouseMove = exports.captureWindowN = exports.getWindowData = exports.keyUpHandler = exports.keyDownHandler = exports.OpenCV = exports.KeyListener = void 0;
 exports.captureWindow = captureWindow;
 exports.keyPress = keyPress;
 const EventEmitter = require("events");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const bindings = require("node-gyp-build")(path_1.default.resolve(__dirname, ".."));
-const keyCodes_1 = __importDefault(require("./keyCodes"));
+const keyCodes_1 = require("./keyCodes");
+Object.defineProperty(exports, "KeyCodeHelper", { enumerable: true, get: function () { return keyCodes_1.KeyCodeHelper; } });
 const { keyDownHandler, keyUpHandler, getWindowData, captureWindowN, mouseMove, mouseClick, mouseDrag, typeString, pressKey, imread, imwrite, matchTemplate, blur, bgrToGray, drawRectangle, getRegion, } = bindings;
 exports.keyDownHandler = keyDownHandler;
 exports.keyUpHandler = keyUpHandler;
@@ -20,6 +21,8 @@ exports.mouseMove = mouseMove;
 exports.mouseClick = mouseClick;
 exports.mouseDrag = mouseDrag;
 exports.typeString = typeString;
+const rawPressKey = pressKey;
+exports.rawPressKey = rawPressKey;
 /**
  * Captures a window and saves it to a file.
  * @param windowName - The name of the window to capture.
@@ -41,14 +44,14 @@ class KeyListener extends EventEmitter {
     constructor() {
         super();
         keyDownHandler((keyCode) => {
-            const keyName = keyCodes_1.default.get(keyCode.toString());
+            const keyName = keyCodes_1.keyCodes.get(keyCode.toString());
             this.emit("keyDown", {
                 keyCode,
                 keyName,
             });
         });
         keyUpHandler((keyCode) => {
-            const keyName = keyCodes_1.default.get(keyCode.toString());
+            const keyName = keyCodes_1.keyCodes.get(keyCode.toString());
             this.emit("keyUp", {
                 keyCode,
                 keyName,
@@ -145,10 +148,15 @@ exports.OpenCV = OpenCV;
 function keyPress(keyCode, repeat) {
     return new Promise((resolve, reject) => {
         if (!repeat) {
-            return resolve(pressKey(keyCode));
+            let result = rawPressKey(keyCode);
+            if (!result)
+                reject('Something went wrong');
+            return resolve(true);
         }
         for (let i = 0; i < repeat; i++) {
-            pressKey(keyCode);
+            let result = rawPressKey(keyCode);
+            if (!result)
+                reject('Something went wrong');
         }
         return resolve(true);
     });

package/dist/keyCodes.d.ts

@@ -1,2 +1,101 @@
-declare const _default: Map<string, string>;
-export default _default;
+export declare const keyCodes: Map<string, string>;
+export declare enum KeyCodeHelper {
+    "Backspace" = 8,
+    "Tab" = 9,
+    "Enter" = 13,
+    "Shift" = 16,
+    "Ctrl" = 17,
+    "Alt" = 18,
+    "CapsLock" = 20,
+    "Escape" = 27,
+    "Space" = 32,
+    "PageUp" = 33,
+    "PageDown" = 34,
+    "End" = 35,
+    "Home" = 36,
+    "ArrowLeft" = 37,
+    "ArrowUp" = 38,
+    "ArrowRight" = 39,
+    "ArrowDown" = 40,
+    "Insert" = 45,
+    "Delete" = 46,
+    "Zero" = 48,
+    "One" = 49,
+    "Two" = 50,
+    "Three" = 51,
+    "Four" = 52,
+    "Five" = 53,
+    "Six" = 54,
+    "Seven" = 55,
+    "Eight" = 56,
+    "Nine" = 57,
+    "A" = 65,
+    "B" = 66,
+    "C" = 67,
+    "D" = 68,
+    "E" = 69,
+    "F" = 70,
+    "G" = 71,
+    "H" = 72,
+    "I" = 73,
+    "J" = 74,
+    "K" = 75,
+    "L" = 76,
+    "M" = 77,
+    "N" = 78,
+    "O" = 79,
+    "P" = 80,
+    "Q" = 81,
+    "R" = 82,
+    "S" = 83,
+    "T" = 84,
+    "U" = 85,
+    "V" = 86,
+    "W" = 87,
+    "X" = 88,
+    "Y" = 89,
+    "Z" = 90,
+    "MetaLeft" = 91,
+    "MetaRight" = 92,
+    "ContextMenu" = 93,
+    "Numpad0" = 96,
+    "Numpad1" = 97,
+    "Numpad2" = 98,
+    "Numpad3" = 99,
+    "Numpad4" = 100,
+    "Numpad5" = 101,
+    "Numpad6" = 102,
+    "Numpad7" = 103,
+    "Numpad8" = 104,
+    "Numpad9" = 105,
+    "NumpadMultiply" = 106,
+    "NumpadAdd" = 107,
+    "NumpadSubtract" = 109,
+    "NumpadDecimal" = 110,
+    "NumpadDivide" = 111,
+    "F1" = 112,
+    "F2" = 113,
+    "F3" = 114,
+    "F4" = 115,
+    "F5" = 116,
+    "F6" = 117,
+    "F7" = 118,
+    "F8" = 119,
+    "F9" = 120,
+    "F10" = 121,
+    "F11" = 122,
+    "F12" = 123,
+    "NumLock" = 144,
+    "ScrollLock" = 145,
+    "Semicolon" = 186,
+    "Equal" = 187,
+    "Comma" = 188,
+    "Minus" = 189,
+    "Period" = 190,
+    "Slash" = 191,
+    "Backquote" = 192,
+    "BracketLeft" = 219,
+    "Backslash" = 220,
+    "BracketRight" = 221,
+    "Quote" = 222
+}

package/dist/keyCodes.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = new Map(Object.entries({
+exports.KeyCodeHelper = exports.keyCodes = void 0;
+exports.keyCodes = new Map(Object.entries({
     8: "Backspace",
     9: "Tab",
     13: "Enter",
@@ -100,3 +101,104 @@ exports.default = new Map(Object.entries({
     221: "BracketRight",
     222: "Quote",
 }));
+var KeyCodeHelper;
+(function (KeyCodeHelper) {
+    KeyCodeHelper[KeyCodeHelper["Backspace"] = 8] = "Backspace";
+    KeyCodeHelper[KeyCodeHelper["Tab"] = 9] = "Tab";
+    KeyCodeHelper[KeyCodeHelper["Enter"] = 13] = "Enter";
+    KeyCodeHelper[KeyCodeHelper["Shift"] = 16] = "Shift";
+    KeyCodeHelper[KeyCodeHelper["Ctrl"] = 17] = "Ctrl";
+    KeyCodeHelper[KeyCodeHelper["Alt"] = 18] = "Alt";
+    KeyCodeHelper[KeyCodeHelper["CapsLock"] = 20] = "CapsLock";
+    KeyCodeHelper[KeyCodeHelper["Escape"] = 27] = "Escape";
+    KeyCodeHelper[KeyCodeHelper["Space"] = 32] = "Space";
+    KeyCodeHelper[KeyCodeHelper["PageUp"] = 33] = "PageUp";
+    KeyCodeHelper[KeyCodeHelper["PageDown"] = 34] = "PageDown";
+    KeyCodeHelper[KeyCodeHelper["End"] = 35] = "End";
+    KeyCodeHelper[KeyCodeHelper["Home"] = 36] = "Home";
+    KeyCodeHelper[KeyCodeHelper["ArrowLeft"] = 37] = "ArrowLeft";
+    KeyCodeHelper[KeyCodeHelper["ArrowUp"] = 38] = "ArrowUp";
+    KeyCodeHelper[KeyCodeHelper["ArrowRight"] = 39] = "ArrowRight";
+    KeyCodeHelper[KeyCodeHelper["ArrowDown"] = 40] = "ArrowDown";
+    KeyCodeHelper[KeyCodeHelper["Insert"] = 45] = "Insert";
+    KeyCodeHelper[KeyCodeHelper["Delete"] = 46] = "Delete";
+    KeyCodeHelper[KeyCodeHelper["Zero"] = 48] = "Zero";
+    KeyCodeHelper[KeyCodeHelper["One"] = 49] = "One";
+    KeyCodeHelper[KeyCodeHelper["Two"] = 50] = "Two";
+    KeyCodeHelper[KeyCodeHelper["Three"] = 51] = "Three";
+    KeyCodeHelper[KeyCodeHelper["Four"] = 52] = "Four";
+    KeyCodeHelper[KeyCodeHelper["Five"] = 53] = "Five";
+    KeyCodeHelper[KeyCodeHelper["Six"] = 54] = "Six";
+    KeyCodeHelper[KeyCodeHelper["Seven"] = 55] = "Seven";
+    KeyCodeHelper[KeyCodeHelper["Eight"] = 56] = "Eight";
+    KeyCodeHelper[KeyCodeHelper["Nine"] = 57] = "Nine";
+    KeyCodeHelper[KeyCodeHelper["A"] = 65] = "A";
+    KeyCodeHelper[KeyCodeHelper["B"] = 66] = "B";
+    KeyCodeHelper[KeyCodeHelper["C"] = 67] = "C";
+    KeyCodeHelper[KeyCodeHelper["D"] = 68] = "D";
+    KeyCodeHelper[KeyCodeHelper["E"] = 69] = "E";
+    KeyCodeHelper[KeyCodeHelper["F"] = 70] = "F";
+    KeyCodeHelper[KeyCodeHelper["G"] = 71] = "G";
+    KeyCodeHelper[KeyCodeHelper["H"] = 72] = "H";
+    KeyCodeHelper[KeyCodeHelper["I"] = 73] = "I";
+    KeyCodeHelper[KeyCodeHelper["J"] = 74] = "J";
+    KeyCodeHelper[KeyCodeHelper["K"] = 75] = "K";
+    KeyCodeHelper[KeyCodeHelper["L"] = 76] = "L";
+    KeyCodeHelper[KeyCodeHelper["M"] = 77] = "M";
+    KeyCodeHelper[KeyCodeHelper["N"] = 78] = "N";
+    KeyCodeHelper[KeyCodeHelper["O"] = 79] = "O";
+    KeyCodeHelper[KeyCodeHelper["P"] = 80] = "P";
+    KeyCodeHelper[KeyCodeHelper["Q"] = 81] = "Q";
+    KeyCodeHelper[KeyCodeHelper["R"] = 82] = "R";
+    KeyCodeHelper[KeyCodeHelper["S"] = 83] = "S";
+    KeyCodeHelper[KeyCodeHelper["T"] = 84] = "T";
+    KeyCodeHelper[KeyCodeHelper["U"] = 85] = "U";
+    KeyCodeHelper[KeyCodeHelper["V"] = 86] = "V";
+    KeyCodeHelper[KeyCodeHelper["W"] = 87] = "W";
+    KeyCodeHelper[KeyCodeHelper["X"] = 88] = "X";
+    KeyCodeHelper[KeyCodeHelper["Y"] = 89] = "Y";
+    KeyCodeHelper[KeyCodeHelper["Z"] = 90] = "Z";
+    KeyCodeHelper[KeyCodeHelper["MetaLeft"] = 91] = "MetaLeft";
+    KeyCodeHelper[KeyCodeHelper["MetaRight"] = 92] = "MetaRight";
+    KeyCodeHelper[KeyCodeHelper["ContextMenu"] = 93] = "ContextMenu";
+    KeyCodeHelper[KeyCodeHelper["Numpad0"] = 96] = "Numpad0";
+    KeyCodeHelper[KeyCodeHelper["Numpad1"] = 97] = "Numpad1";
+    KeyCodeHelper[KeyCodeHelper["Numpad2"] = 98] = "Numpad2";
+    KeyCodeHelper[KeyCodeHelper["Numpad3"] = 99] = "Numpad3";
+    KeyCodeHelper[KeyCodeHelper["Numpad4"] = 100] = "Numpad4";
+    KeyCodeHelper[KeyCodeHelper["Numpad5"] = 101] = "Numpad5";
+    KeyCodeHelper[KeyCodeHelper["Numpad6"] = 102] = "Numpad6";
+    KeyCodeHelper[KeyCodeHelper["Numpad7"] = 103] = "Numpad7";
+    KeyCodeHelper[KeyCodeHelper["Numpad8"] = 104] = "Numpad8";
+    KeyCodeHelper[KeyCodeHelper["Numpad9"] = 105] = "Numpad9";
+    KeyCodeHelper[KeyCodeHelper["NumpadMultiply"] = 106] = "NumpadMultiply";
+    KeyCodeHelper[KeyCodeHelper["NumpadAdd"] = 107] = "NumpadAdd";
+    KeyCodeHelper[KeyCodeHelper["NumpadSubtract"] = 109] = "NumpadSubtract";
+    KeyCodeHelper[KeyCodeHelper["NumpadDecimal"] = 110] = "NumpadDecimal";
+    KeyCodeHelper[KeyCodeHelper["NumpadDivide"] = 111] = "NumpadDivide";
+    KeyCodeHelper[KeyCodeHelper["F1"] = 112] = "F1";
+    KeyCodeHelper[KeyCodeHelper["F2"] = 113] = "F2";
+    KeyCodeHelper[KeyCodeHelper["F3"] = 114] = "F3";
+    KeyCodeHelper[KeyCodeHelper["F4"] = 115] = "F4";
+    KeyCodeHelper[KeyCodeHelper["F5"] = 116] = "F5";
+    KeyCodeHelper[KeyCodeHelper["F6"] = 117] = "F6";
+    KeyCodeHelper[KeyCodeHelper["F7"] = 118] = "F7";
+    KeyCodeHelper[KeyCodeHelper["F8"] = 119] = "F8";
+    KeyCodeHelper[KeyCodeHelper["F9"] = 120] = "F9";
+    KeyCodeHelper[KeyCodeHelper["F10"] = 121] = "F10";
+    KeyCodeHelper[KeyCodeHelper["F11"] = 122] = "F11";
+    KeyCodeHelper[KeyCodeHelper["F12"] = 123] = "F12";
+    KeyCodeHelper[KeyCodeHelper["NumLock"] = 144] = "NumLock";
+    KeyCodeHelper[KeyCodeHelper["ScrollLock"] = 145] = "ScrollLock";
+    KeyCodeHelper[KeyCodeHelper["Semicolon"] = 186] = "Semicolon";
+    KeyCodeHelper[KeyCodeHelper["Equal"] = 187] = "Equal";
+    KeyCodeHelper[KeyCodeHelper["Comma"] = 188] = "Comma";
+    KeyCodeHelper[KeyCodeHelper["Minus"] = 189] = "Minus";
+    KeyCodeHelper[KeyCodeHelper["Period"] = 190] = "Period";
+    KeyCodeHelper[KeyCodeHelper["Slash"] = 191] = "Slash";
+    KeyCodeHelper[KeyCodeHelper["Backquote"] = 192] = "Backquote";
+    KeyCodeHelper[KeyCodeHelper["BracketLeft"] = 219] = "BracketLeft";
+    KeyCodeHelper[KeyCodeHelper["Backslash"] = 220] = "Backslash";
+    KeyCodeHelper[KeyCodeHelper["BracketRight"] = 221] = "BracketRight";
+    KeyCodeHelper[KeyCodeHelper["Quote"] = 222] = "Quote";
+})(KeyCodeHelper || (exports.KeyCodeHelper = KeyCodeHelper = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-native-win-utils",
-  "version": "1.3.2-alpha.2",
+  "version": "1.3.3",
   "author": "RynerNO",
   "license": "MIT",
   "repository": "https://github.com/RynerNO/node-native-win-utils.git",
@@ -32,7 +32,8 @@
   "gypfile": true,
   "scripts": {
     "install": "node-gyp-build",
-    "build": "node-gyp clean && prebuildify --napi && tsc"
+    "build": "node-gyp clean && prebuildify --napi && tsc",
+    "test": "jest"
   },
   "dependencies": {
     "node-addon-api": "^6.1.0",
@@ -40,6 +41,7 @@
     "node-gyp-build": "4.8.0"
   },
   "devDependencies": {
-    "@types/node": "^20.2.5"
+    "@types/node": "^20.2.5",
+    "jest": "^29.7.0"
   }
 }

package/src/cpp/keyboard.cpp

@@ -164,44 +164,41 @@ Napi::Value SetKeyUpCallback(const Napi::CallbackInfo &info)
   return env.Undefined();
 }
 
-Napi::Value TypeString(const Napi::CallbackInfo &info)
-{
-  Napi::Env env = info.Env();
+Napi::Value TypeString(const Napi::CallbackInfo &info) {
+    Napi::Env env = info.Env();
 
-  if (info.Length() < 1 || !info[0].IsString())
-  {
-    Napi::TypeError::New(env, "You should provide a string to type").ThrowAsJavaScriptException();
-    return Napi::Boolean::New(env, false);
-  }
-  int delay = 15;
-  std::string text = info[0].As<Napi::String>();
-  if (info.Length() > 1 && info[1].IsNumber())
-  {
-    delay = info[1].As<Napi::Number>();
-  }
-  // Convert the string to wide string
-  std::wstring wideText(text.begin(), text.end());
+    if (info.Length() < 1 || !info[0].IsString()) {
+        Napi::TypeError::New(env, "You should provide a string to type").ThrowAsJavaScriptException();
+        return Napi::Boolean::New(env, false);
+    }
 
-  // Simulate typing by sending keyboard events
-  for (const wchar_t &character : wideText)
-  {
-    INPUT keyboardInput = {0};
-    keyboardInput.type = INPUT_KEYBOARD;
-    keyboardInput.ki.wVk = 0;
-    keyboardInput.ki.wScan = character;
-    keyboardInput.ki.dwFlags = KEYEVENTF_UNICODE;
-    keyboardInput.ki.time = 0; // System will provide the timestamp
+    int delay = 15;
+    std::u16string text = info[0].As<Napi::String>().Utf16Value();
+    if (info.Length() > 1 && info[1].IsNumber()) {
+        delay = info[1].As<Napi::Number>().Int32Value();
+    }
 
-    SendInput(1, &keyboardInput, sizeof(keyboardInput));
+    for (const auto &character : text) {
+        INPUT keyboardInput = {0};
+        keyboardInput.type = INPUT_KEYBOARD;
+        keyboardInput.ki.wVk = 0;
+        keyboardInput.ki.wScan = character;
+        keyboardInput.ki.dwFlags = KEYEVENTF_UNICODE;
+        keyboardInput.ki.time = 0;
+        keyboardInput.ki.dwExtraInfo = 0;
 
-    keyboardInput.ki.dwFlags = KEYEVENTF_UNICODE | KEYEVENTF_KEYUP;
-    SendInput(1, &keyboardInput, sizeof(keyboardInput));
+        // Press the key
+        SendInput(1, &keyboardInput, sizeof(INPUT));
 
-    // Sleep for 15 milliseconds between each character input
-    Sleep(delay);
-  }
+        // Release the key
+        keyboardInput.ki.dwFlags = KEYEVENTF_UNICODE | KEYEVENTF_KEYUP;
+        SendInput(1, &keyboardInput, sizeof(INPUT));
 
-  return Napi::Boolean::New(env, true);
+        // Sleep for the specified delay between keystrokes
+        Sleep(delay);
+    }
+
+    return Napi::Boolean::New(env, true);
 }
 
 // Function to simulate key press and release using provided key code