node-web-gpio 1.0.10 → 1.0.14

package/dist/index.d.ts

@@ -1,24 +1,53 @@
 /// <reference types="node" />
-import { EventEmitter } from "events";
+import { EventEmitter } from 'events';
+/** ポート番号 */
 declare type PortNumber = number;
+/** ポート名 */
 declare type PortName = string;
+/** ピン名 */
 declare type PinName = string;
-declare type DirectionMode = "in" | "out";
+/** 入出力方向 */
+declare type DirectionMode = 'in' | 'out';
+/** GPIO 値 0: LOW / 1: HIGH */
 declare type GPIOValue = 0 | 1;
+/**
+ * GPIO チェンジイベント
+ */
 interface GPIOChangeEvent {
+    /** 入出力値 */
     readonly value: GPIOValue;
+    /** ポート */
     readonly port: GPIOPort;
 }
+/**
+ * GPIO チェンジイベントハンドラ
+ */
 interface GPIOChangeEventHandler {
+    /** イベント */
     (event: GPIOChangeEvent): void;
 }
+/**
+ * GPIO
+ */
 export declare class GPIOAccess extends EventEmitter {
+    /** ポート */
     private readonly _ports;
+    /** GPIO チェンジイベントハンドラ */
     onchange: GPIOChangeEventHandler | undefined;
+    /**
+     * Creates an instance of GPIOAccess.
+     * @param ports ポート番号
+     */
     constructor(ports?: GPIOPortMap);
+    /**
+     * ポート情報取得処理
+     * @return 現在のポート情報
+     */
     get ports(): GPIOPortMap;
     /**
      * Unexport all exported GPIO ports.
+     * 全てのポート開放をする
+     * @return ポート開放結果
      */
     unexportAll(): Promise<void>;
 }
@@ -27,30 +56,97 @@ export declare class GPIOAccess extends EventEmitter {
  */
 export declare class GPIOPortMap extends Map<PortNumber, GPIOPort> {
 }
+/**
+ * GPIO ポート
+ */
 export declare class GPIOPort extends EventEmitter {
+    /** ポート番号 */
     private readonly _portNumber;
+    /** ポーリング間隔 */
     private readonly _pollingInterval;
+    /** 入出力方向 */
     private _direction;
+    /** エクスポート */
     private _exported;
+    /** エクスポートリトライ回数 */
     private _exportRetry;
+    /** 入出力値 */
     private _value;
+    /** タイムアウト値 */
     private _timeout;
+    /** GPIO チェンジイベントハンドラ */
     onchange: GPIOChangeEventHandler | undefined;
+    /**
+     * Creates an instance of GPIOPort.
+     * @param portNumber ポート番号
+     */
     constructor(portNumber: PortNumber);
+    /**
+     * ポート番号取得処理
+     * @return 現在のポート番号
+     */
     get portNumber(): PortNumber;
+    /**
+     * ポート名取得処理
+     * @return 現在のポート名
+     */
     get portName(): PortName;
+    /**
+     * ピン名取得処理
+     * @return 現在のピン名
+     */
     get pinName(): PinName;
+    /**
+     * GPIO 入出力方向 getter
+     * @return 現在のGPIO 入出力方向
+     */
     get direction(): DirectionMode;
+    /**
+     * GPIO export の有無 getter
+     * @return 現在のGPIO 出力
+     */
     get exported(): boolean;
+    /**
+     * GPIO 出力処理
+     * @param direction GPIO 入出力方向
+     * @return export 処理の完了
+     */
     export(direction: DirectionMode): Promise<void>;
+    /**
+     * Unexport exported GPIO ports.
+     * ポート開放をする
+     * @return ポート開放処理の完了
+     */
     unexport(): Promise<void>;
+    /**
+     * 入力値読み取り処理
+     * @return 読み取り処理の完了
+     */
     read(): Promise<GPIOValue>;
+    /**
+     * 出力値書き込み処理
+     * @return 読み取り処理の完了
+     */
     write(value: GPIOValue): Promise<void>;
 }
+/**
+ * 無効なアクセスエラー
+ */
 export declare class InvalidAccessError extends Error {
+    /**
+     * Creates an instance of InvalidAccessError.
+     * @param message エラーメッセージ
+     */
     constructor(message: string);
 }
+/**
+ * 操作エラー
+ */
 export declare class OperationError extends Error {
+    /**
+     * Creates an instance of OperationError.
+     * @param message エラーメッセージ
+     */
     constructor(message: string);
 }
 export declare function requestGPIOAccess(): Promise<GPIOAccess>;

package/dist/index.js

@@ -8,36 +8,68 @@ const path = require("path");
  * Interval of file system polling, in milliseconds.
  */
 const PollingInterval = 100;
-const SysfsGPIOPath = "/sys/class/gpio";
+/**
+ * GPIO パス
+ */
+const SysfsGPIOPath = '/sys/class/gpio';
+/**
+ * GPIO ポートマップサイズ
+ */
 const GPIOPortMapSizeMax = 1024;
+/**
+ * Uint16 Max サイズ
+ */
 const Uint16Max = 65535;
-function parseUint16(string) {
-    const n = Number.parseInt(string, 10);
+/**
+ *
+ * Uint16型変換処理
+ * @param parseString 変換文字列
+ * @return Uint16型変換値
+ */
+function parseUint16(parseString) {
+    const n = Number.parseInt(parseString, 10);
     if (0 <= n && n <= Uint16Max)
         return n;
     else
         throw new RangeError(`Must be between 0 and ${Uint16Max}.`);
 }
+/**
+ * GPIO
+ */
 class GPIOAccess extends events_1.EventEmitter {
+    /** ポート */
+    _ports;
+    /** GPIO チェンジイベントハンドラ */
+    onchange;
+    /**
+     * Creates an instance of GPIOAccess.
+     * @param ports ポート番号
+     */
     constructor(ports) {
         super();
         this._ports = ports == null ? new GPIOPortMap() : ports;
-        this._ports.forEach(port => port.on("change", event => {
-            this.emit("change", event);
+        this._ports.forEach((port) => port.on('change', (event) => {
+            this.emit('change', event);
         }));
-        this.on("change", (event) => {
+        this.on('change', (event) => {
             if (this.onchange !== undefined)
                 this.onchange(event);
         });
     }
+    /**
+     * ポート情報取得処理
+     * @return 現在のポート情報
+     */
     get ports() {
         return this._ports;
     }
     /**
      * Unexport all exported GPIO ports.
+     * 全てのポート開放をする
+     * @return ポート開放結果
      */
     async unexportAll() {
-        await Promise.all([...this.ports.values()].map(port => port.exported ? port.unexport() : undefined));
+        await Promise.all([...this.ports.values()].map((port) => port.exported ? port.unexport() : undefined));
     }
 }
 exports.GPIOAccess = GPIOAccess;
@@ -47,39 +79,87 @@ exports.GPIOAccess = GPIOAccess;
 class GPIOPortMap extends Map {
 }
 exports.GPIOPortMap = GPIOPortMap;
+/**
+ * GPIO ポート
+ */
 class GPIOPort extends events_1.EventEmitter {
+    /** ポート番号 */
+    _portNumber;
+    /** ポーリング間隔 */
+    _pollingInterval;
+    /** 入出力方向 */
+    _direction;
+    /** エクスポート */
+    _exported;
+    /** エクスポートリトライ回数 */
+    _exportRetry;
+    /** 入出力値 */
+    _value;
+    /** タイムアウト値 */
+    _timeout;
+    /** GPIO チェンジイベントハンドラ */
+    onchange;
+    /**
+     * Creates an instance of GPIOPort.
+     * @param portNumber ポート番号
+     */
     constructor(portNumber) {
         super();
         this._portNumber = parseUint16(portNumber.toString());
         this._pollingInterval = PollingInterval;
-        this._direction = new OperationError("Unknown direction.");
-        this._exported = new OperationError("Unknown export.");
+        this._direction = new OperationError('Unknown direction.');
+        this._exported = new OperationError('Unknown export.');
         this._exportRetry = 0;
-        this.on("change", (event) => {
+        this.on('change', (event) => {
             if (this.onchange !== undefined)
                 this.onchange(event);
         });
     }
+    /**
+     * ポート番号取得処理
+     * @return 現在のポート番号
+     */
     get portNumber() {
         return this._portNumber;
     }
+    /**
+     * ポート名取得処理
+     * @return 現在のポート名
+     */
     get portName() {
         return `gpio${this.portNumber}`;
     }
+    /**
+     * ピン名取得処理
+     * @return 現在のピン名
+     */
     get pinName() {
         // NOTE: Unknown pinName.
-        return "";
+        return '';
     }
+    /**
+     * GPIO 入出力方向 getter
+     * @return 現在のGPIO 入出力方向
+     */
     get direction() {
         if (this._direction instanceof OperationError)
             throw this._direction;
         return this._direction;
     }
+    /**
+     * GPIO export の有無 getter
+     * @return 現在のGPIO 出力
+     */
     get exported() {
         if (this._exported instanceof OperationError)
             throw this._exported;
         return this._exported;
     }
+    /**
+     * GPIO 出力処理
+     * @param direction GPIO 入出力方向
+     * @return export 処理の完了
+     */
     async export(direction) {
         if (!/^(in|out)$/.test(direction)) {
             throw new InvalidAccessError(`Must be "in" or "out".`);
@@ -94,10 +174,10 @@ class GPIOPort extends events_1.EventEmitter {
         try {
             clearInterval(this._timeout);
             if (!this.exported) {
-                await fs_1.promises.writeFile(path.join(SysfsGPIOPath, "export"), String(this.portNumber));
+                await fs_1.promises.writeFile(path.join(SysfsGPIOPath, 'export'), String(this.portNumber));
             }
-            await fs_1.promises.writeFile(path.join(SysfsGPIOPath, this.portName, "direction"), direction);
-            if (direction === "in") {
+            await fs_1.promises.writeFile(path.join(SysfsGPIOPath, this.portName, 'direction'), direction);
+            if (direction === 'in') {
                 this._timeout = setInterval(
                 // eslint-disable-next-line
                 this.read.bind(this), this._pollingInterval);
@@ -106,7 +186,7 @@ class GPIOPort extends events_1.EventEmitter {
         catch (error) {
             if (this._exportRetry == 0) {
                 await sleep(100);
-                console.warn("May be the first time port access. Retry..");
+                console.warn('May be the first time port access. Retry..');
                 ++this._exportRetry;
                 await this.export(direction);
             }
@@ -117,26 +197,35 @@ class GPIOPort extends events_1.EventEmitter {
         this._direction = direction;
         this._exported = true;
     }
+    /**
+     * Unexport exported GPIO ports.
+     * ポート開放をする
+     * @return ポート開放処理の完了
+     */
     async unexport() {
         clearInterval(this._timeout);
         try {
-            await fs_1.promises.writeFile(path.join(SysfsGPIOPath, "unexport"), String(this.portNumber));
+            await fs_1.promises.writeFile(path.join(SysfsGPIOPath, 'unexport'), String(this.portNumber));
         }
         catch (error) {
             throw new OperationError(error);
         }
         this._exported = false;
     }
+    /**
+     * 入力値読み取り処理
+     * @return 読み取り処理の完了
+     */
     async read() {
-        if (!(this.exported && this.direction === "in")) {
+        if (!(this.exported && this.direction === 'in')) {
             throw new InvalidAccessError(`The exported must be true and value of direction must be "in".`);
         }
         try {
-            const buffer = await fs_1.promises.readFile(path.join(SysfsGPIOPath, this.portName, "value"));
+            const buffer = await fs_1.promises.readFile(path.join(SysfsGPIOPath, this.portName, 'value'));
             const value = parseUint16(buffer.toString());
             if (this._value !== value) {
                 this._value = value;
-                this.emit("change", { value, port: this });
+                this.emit('change', { value, port: this });
             }
             return value;
         }
@@ -144,12 +233,16 @@ class GPIOPort extends events_1.EventEmitter {
             throw new OperationError(error);
         }
     }
+    /**
+     * 出力値書き込み処理
+     * @return 読み取り処理の完了
+     */
     async write(value) {
-        if (!(this.exported && this.direction === "out")) {
+        if (!(this.exported && this.direction === 'out')) {
             throw new InvalidAccessError(`The exported must be true and value of direction must be "out".`);
         }
         try {
-            await fs_1.promises.writeFile(path.join(SysfsGPIOPath, this.portName, "value"), parseUint16(value.toString()).toString());
+            await fs_1.promises.writeFile(path.join(SysfsGPIOPath, this.portName, 'value'), parseUint16(value.toString()).toString());
         }
         catch (error) {
             throw new OperationError(error);
@@ -157,14 +250,28 @@ class GPIOPort extends events_1.EventEmitter {
     }
 }
 exports.GPIOPort = GPIOPort;
+/**
+ * 無効なアクセスエラー
+ */
 class InvalidAccessError extends Error {
+    /**
+     * Creates an instance of InvalidAccessError.
+     * @param message エラーメッセージ
+     */
     constructor(message) {
         super(message);
         this.name = this.constructor.name;
     }
 }
 exports.InvalidAccessError = InvalidAccessError;
+/**
+ * 操作エラー
+ */
 class OperationError extends Error {
+    /**
+     * Creates an instance of OperationError.
+     * @param message エラーメッセージ
+     */
     constructor(message) {
         super(message);
         this.name = this.constructor.name;
@@ -174,13 +281,18 @@ exports.OperationError = OperationError;
 // Web GPIOの仕様に基づく意図的なasync関数の使用なので、ルールを無効化
 // eslint-disable-next-line
 async function requestGPIOAccess() {
-    const ports = new GPIOPortMap([...Array(GPIOPortMapSizeMax).keys()].map(portNumber => [
+    const ports = new GPIOPortMap([...Array(GPIOPortMapSizeMax).keys()].map((portNumber) => [
         portNumber,
-        new GPIOPort(portNumber)
+        new GPIOPort(portNumber),
     ]));
     return new GPIOAccess(ports);
 }
 exports.requestGPIOAccess = requestGPIOAccess;
+/**
+ * 待機 関数
+ * @param ms スリープ時間（ミリ秒）
+ * @return 待機完了
+ */
 function sleep(ms) {
     return new Promise((resolve) => {
         return setTimeout(resolve, ms);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-web-gpio",
-  "version": "1.0.10",
+  "version": "1.0.14",
   "description": "GPIO access with Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,16 +14,24 @@
   "author": "Kohei Watanabe <kou029w@gmail.com>",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^16.0.0",
-    "@typescript-eslint/eslint-plugin": "^5.0.0",
-    "@typescript-eslint/parser": "^5.0.0",
-    "eslint": "^8.0.0",
+    "@types/node": "^16.11.11",
+    "@typescript-eslint/eslint-plugin": "^5.5.0",
+    "@typescript-eslint/parser": "^5.5.0",
+    "eslint": "^8.4.0",
+    "husky": "^7.0.4",
+    "lint-staged": "^12.1.2",
+    "prettier": "^2.5.1",
+    "typedoc": "^0.22.10",
     "typescript": "^4.2.3"
   },
   "scripts": {
     "build": "tsc",
     "lint": "eslint index.ts",
-    "prepare": "rm -rf dist && npm run build"
+    "prepare": "husky install && rm -rf dist && npm run build",
+    "precommit": "lint-staged",
+    "docs": "npm run remove:docs && npm run typedoc -- --options typedoc.json --exclude '**/*.spec.ts' ./ README.md",
+    "typedoc": "typedoc",
+    "remove:docs": "rm -rf docs"
   },
   "keywords": [
     "gpio",