Add example of the API addressing the issue #30

examples/example.js

@@ -1,9 +1,16 @@
 "use strict";
 
 const pcsclite = require('../lib/pcsclite');
+const {
+	SCARD_SCOPE_USER,
+	SCARD_SCOPE_TERMINAL,
+	SCARD_SCOPE_SYSTEM,
+	SCARD_SCOPE_GLOBAL,
+} = require('../lib/constants');
 
 
-const pcsc = pcsclite();
+// const pcsc = pcsclite(); // without options (scope defaults to SCARD_SCOPE_SYSTEM)
+const pcsc = pcsclite({ scope: SCARD_SCOPE_USER }); // overwriting default scope
 
 pcsc.on('reader', (reader) => {
 

examples/public.js

@@ -0,0 +1,90 @@
+"use strict";
+
+const pcsclite = require('@pokusew/pcsclite');
+const {
+	SCARD_SCOPE_USER,
+	SCARD_SCOPE_TERMINAL,
+	SCARD_SCOPE_SYSTEM,
+	SCARD_SCOPE_GLOBAL,
+} = require('@pokusew/pcsclite/lib/constants');
+
+
+// const pcsc = pcsclite(); // without options (scope defaults to SCARD_SCOPE_SYSTEM)
+const pcsc = pcsclite({ scope: SCARD_SCOPE_USER }); // overwriting default scope
+
+pcsc.on('reader', (reader) => {
+
+	console.log('New reader detected', reader.name);
+
+	reader.on('error', err => {
+		console.log('Error(', reader.name, '):', err.message);
+	});
+
+	reader.on('status', (status) => {
+
+		console.log('Status(', reader.name, '):', status);
+
+		// check what has changed
+		const changes = reader.state ^ status.state;
+
+		if (!changes) {
+			return;
+		}
+
+		if ((changes & reader.SCARD_STATE_EMPTY) && (status.state & reader.SCARD_STATE_EMPTY)) {
+
+			console.log("card removed");
+
+			reader.disconnect(reader.SCARD_LEAVE_CARD, err => {
+
+				if (err) {
+					console.log(err);
+					return;
+				}
+
+				console.log('Disconnected');
+
+			});
+
+		}
+		else if ((changes & reader.SCARD_STATE_PRESENT) && (status.state & reader.SCARD_STATE_PRESENT)) {
+
+			console.log("card inserted");
+
+			reader.connect({ share_mode: reader.SCARD_SHARE_SHARED }, (err, protocol) => {
+
+				if (err) {
+					console.log(err);
+					return;
+				}
+
+				console.log('Protocol(', reader.name, '):', protocol);
+
+				reader.transmit(Buffer.from([0x00, 0xB0, 0x00, 0x00, 0x20]), 40, protocol, (err, data) => {
+
+					if (err) {
+						console.log(err);
+						return;
+					}
+
+					console.log('Data received', data);
+					reader.close();
+					pcsc.close();
+
+				});
+
+			});
+
+		}
+
+	});
+
+	reader.on('end', () => {
+		console.log('Reader', reader.name, 'removed');
+	});
+
+});
+
+pcsc.on('error', err => {
+	console.log('PCSC error', err.message);
+});

lib/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+
+const {
+	SCARD_SCOPE_USER,
+	SCARD_SCOPE_TERMINAL,
+	SCARD_SCOPE_SYSTEM,
+	SCARD_SCOPE_GLOBAL,
+} = require('../build/Release/pcsclite.node');
+
+module.exports = {
+	SCARD_SCOPE_USER,
+	SCARD_SCOPE_TERMINAL,
+	SCARD_SCOPE_SYSTEM,
+	SCARD_SCOPE_GLOBAL,
+};

lib/pcsclite.js

@@ -8,7 +8,7 @@ const EventEmitter = require('events');
 // see https://github.com/nodejs/node-gyp/issues/263, https://github.com/nodejs/node-gyp/issues/631
 const pcsclite = require('../build/Release/pcsclite.node');
 
-const { PCSCLite, CardReader } = pcsclite;
+const { PCSCLite, CardReader, SCARD_SCOPE_SYSTEM } = pcsclite;
 
 
 inherits(PCSCLite, EventEmitter);
@@ -45,11 +45,16 @@ function diff(a, b) {
 
 }
 
-module.exports = function () {
+module.exports = function (options = {}) {
 
 	const readers = {};
 
-	const p = new PCSCLite();
+	// const scope = options.scope ?? SCARD_SCOPE_SYSTEM;
+	// ^ this syntax above (null coalescing operator) would need transpiler as it is not available in the Node.js yet
+	const scope = options.scope !== undefined && options.scope !== null ? options.scope : SCARD_SCOPE_SYSTEM;
+
+	// TODO: consider alternative approach > allow call with undefined and the C++ side will supply the default value
+	const p = new PCSCLite(scope);
 
 	p.readers = readers;
 
@@ -128,7 +133,8 @@ CardReader.prototype.connect = function (options, cb) {
 
 	if (!this.connected) {
 		this._connect(options.share_mode, options.protocol, cb);
-	} else {
+	}
+	else {
 		cb();
 	}
 
@@ -147,7 +153,8 @@ CardReader.prototype.disconnect = function (disposition, cb) {
 
 	if (this.connected) {
 		this._disconnect(disposition, cb);
-	} else {
+	}
+	else {
 		cb();
 	}
 
@@ -187,7 +194,8 @@ CardReader.prototype.SCARD_CTL_CODE = function (code) {
 
 	if (isWin) {
 		return (0x31 << 16 | (code) << 2);
-	} else {
+	}
+	else {
 		return 0x42000000 + (code);
 	}