smartcard 3.2.1 → 3.4.0

package/README.md

@@ -16,7 +16,7 @@
 
 Stable PC/SC smart card bindings for Node.js.
 
-Works with Node.js 12+ without recompilation. Built on N-API for long-term stability.
+Works with Node.js 18+ without recompilation. Built on N-API for long-term stability.
 
 ## Getting Started
 
@@ -437,8 +437,8 @@ devices.on('card-inserted', ({ reader, card }) => {
 devices.start();
 ```
 
-### Key Improvements in v2.x
-- Works on Node.js 12, 14, 16, 18, 20, 22, 24+ without recompilation
+### Key Improvements in v2.x/v3.x
+- Works on Node.js 18+ without recompilation (v3.x requires Node.js 18+)
 - Native N-API bindings (no more NAN compatibility issues)
 - Simpler flat event model
 - Full TypeScript definitions

package/dist/lib/control-codes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Control codes and feature constants for PC/SC smart card operations
+ */
+/**
+ * Generate a control code (platform-specific)
+ */
+export declare function SCARD_CTL_CODE(code: number): number;
+export declare const CM_IOCTL_GET_FEATURE_REQUEST: number;
+export declare const FEATURE_VERIFY_PIN_START = 1;
+export declare const FEATURE_VERIFY_PIN_FINISH = 2;
+export declare const FEATURE_MODIFY_PIN_START = 3;
+export declare const FEATURE_MODIFY_PIN_FINISH = 4;
+export declare const FEATURE_GET_KEY_PRESSED = 5;
+export declare const FEATURE_VERIFY_PIN_DIRECT = 6;
+export declare const FEATURE_MODIFY_PIN_DIRECT = 7;
+export declare const FEATURE_MCT_READER_DIRECT = 8;
+export declare const FEATURE_MCT_UNIVERSAL = 9;
+export declare const FEATURE_IFD_PIN_PROPERTIES = 10;
+export declare const FEATURE_ABORT = 11;
+export declare const FEATURE_SET_SPE_MESSAGE = 12;
+export declare const FEATURE_VERIFY_PIN_DIRECT_APP_ID = 13;
+export declare const FEATURE_MODIFY_PIN_DIRECT_APP_ID = 14;
+export declare const FEATURE_WRITE_DISPLAY = 15;
+export declare const FEATURE_GET_KEY = 16;
+export declare const FEATURE_IFD_DISPLAY_PROPERTIES = 17;
+export declare const FEATURE_GET_TLV_PROPERTIES = 18;
+export declare const FEATURE_CCID_ESC_COMMAND = 19;
+/**
+ * Parse feature TLV response from CM_IOCTL_GET_FEATURE_REQUEST
+ */
+export declare function parseFeatures(response: Buffer): Map<number, number>;
+//# sourceMappingURL=control-codes.d.ts.map

package/dist/lib/control-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-codes.d.ts","sourceRoot":"","sources":["../../lib/control-codes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASnD;AAGD,eAAO,MAAM,4BAA4B,QAAuB,CAAC;AAGjE,eAAO,MAAM,wBAAwB,IAAO,CAAC;AAC7C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,wBAAwB,IAAO,CAAC;AAC7C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,uBAAuB,IAAO,CAAC;AAC5C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,yBAAyB,IAAO,CAAC;AAC9C,eAAO,MAAM,qBAAqB,IAAO,CAAC;AAC1C,eAAO,MAAM,0BAA0B,KAAO,CAAC;AAC/C,eAAO,MAAM,aAAa,KAAO,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAO,CAAC;AAC5C,eAAO,MAAM,gCAAgC,KAAO,CAAC;AACrD,eAAO,MAAM,gCAAgC,KAAO,CAAC;AACrD,eAAO,MAAM,qBAAqB,KAAO,CAAC;AAC1C,eAAO,MAAM,eAAe,KAAO,CAAC;AACpC,eAAO,MAAM,8BAA8B,KAAO,CAAC;AACnD,eAAO,MAAM,0BAA0B,KAAO,CAAC;AAC/C,eAAO,MAAM,wBAAwB,KAAO,CAAC;AAE7C;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBnE"}

package/dist/lib/control-codes.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Control codes and feature constants for PC/SC smart card operations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE_CCID_ESC_COMMAND = exports.FEATURE_GET_TLV_PROPERTIES = exports.FEATURE_IFD_DISPLAY_PROPERTIES = exports.FEATURE_GET_KEY = exports.FEATURE_WRITE_DISPLAY = exports.FEATURE_MODIFY_PIN_DIRECT_APP_ID = exports.FEATURE_VERIFY_PIN_DIRECT_APP_ID = exports.FEATURE_SET_SPE_MESSAGE = exports.FEATURE_ABORT = exports.FEATURE_IFD_PIN_PROPERTIES = exports.FEATURE_MCT_UNIVERSAL = exports.FEATURE_MCT_READER_DIRECT = exports.FEATURE_MODIFY_PIN_DIRECT = exports.FEATURE_VERIFY_PIN_DIRECT = exports.FEATURE_GET_KEY_PRESSED = exports.FEATURE_MODIFY_PIN_FINISH = exports.FEATURE_MODIFY_PIN_START = exports.FEATURE_VERIFY_PIN_FINISH = exports.FEATURE_VERIFY_PIN_START = exports.CM_IOCTL_GET_FEATURE_REQUEST = void 0;
+exports.SCARD_CTL_CODE = SCARD_CTL_CODE;
+exports.parseFeatures = parseFeatures;
+/**
+ * Generate a control code (platform-specific)
+ */
+function SCARD_CTL_CODE(code) {
+    if (process.platform === 'win32') {
+        // Windows: (FILE_DEVICE_SMARTCARD << 16) + (code << 2)
+        // FILE_DEVICE_SMARTCARD = 0x31
+        return (0x31 << 16) + (code << 2);
+    }
+    else {
+        // macOS/Linux: 0x42000000 + code
+        return 0x42000000 + code;
+    }
+}
+// Common control codes
+exports.CM_IOCTL_GET_FEATURE_REQUEST = SCARD_CTL_CODE(3400);
+// CCID Feature tags (from CCID spec)
+exports.FEATURE_VERIFY_PIN_START = 0x01;
+exports.FEATURE_VERIFY_PIN_FINISH = 0x02;
+exports.FEATURE_MODIFY_PIN_START = 0x03;
+exports.FEATURE_MODIFY_PIN_FINISH = 0x04;
+exports.FEATURE_GET_KEY_PRESSED = 0x05;
+exports.FEATURE_VERIFY_PIN_DIRECT = 0x06;
+exports.FEATURE_MODIFY_PIN_DIRECT = 0x07;
+exports.FEATURE_MCT_READER_DIRECT = 0x08;
+exports.FEATURE_MCT_UNIVERSAL = 0x09;
+exports.FEATURE_IFD_PIN_PROPERTIES = 0x0a;
+exports.FEATURE_ABORT = 0x0b;
+exports.FEATURE_SET_SPE_MESSAGE = 0x0c;
+exports.FEATURE_VERIFY_PIN_DIRECT_APP_ID = 0x0d;
+exports.FEATURE_MODIFY_PIN_DIRECT_APP_ID = 0x0e;
+exports.FEATURE_WRITE_DISPLAY = 0x0f;
+exports.FEATURE_GET_KEY = 0x10;
+exports.FEATURE_IFD_DISPLAY_PROPERTIES = 0x11;
+exports.FEATURE_GET_TLV_PROPERTIES = 0x12;
+exports.FEATURE_CCID_ESC_COMMAND = 0x13;
+/**
+ * Parse feature TLV response from CM_IOCTL_GET_FEATURE_REQUEST
+ */
+function parseFeatures(response) {
+    const features = new Map();
+    let offset = 0;
+    while (offset + 4 <= response.length) {
+        const tag = response[offset];
+        const length = response[offset + 1];
+        if (length === 4 && offset + 2 + length <= response.length) {
+            // Big-endian control code
+            const controlCode = (response[offset + 2] << 24) |
+                (response[offset + 3] << 16) |
+                (response[offset + 4] << 8) |
+                response[offset + 5];
+            features.set(tag, controlCode);
+        }
+        offset += 2 + length;
+    }
+    return features;
+}
+//# sourceMappingURL=control-codes.js.map

package/dist/lib/control-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-codes.js","sourceRoot":"","sources":["../../lib/control-codes.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,wCASC;AA6BD,sCAsBC;AA/DD;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAY;IACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC/B,uDAAuD;QACvD,+BAA+B;QAC/B,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACJ,iCAAiC;QACjC,OAAO,UAAU,GAAG,IAAI,CAAC;IAC7B,CAAC;AACL,CAAC;AAED,uBAAuB;AACV,QAAA,4BAA4B,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;AAEjE,qCAAqC;AACxB,QAAA,wBAAwB,GAAG,IAAI,CAAC;AAChC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AACjC,QAAA,wBAAwB,GAAG,IAAI,CAAC;AAChC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AACjC,QAAA,uBAAuB,GAAG,IAAI,CAAC;AAC/B,QAAA,yBAAyB,GAAG,IAAI,CAAC;AACjC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AACjC,QAAA,yBAAyB,GAAG,IAAI,CAAC;AACjC,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAC7B,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAClC,QAAA,aAAa,GAAG,IAAI,CAAC;AACrB,QAAA,uBAAuB,GAAG,IAAI,CAAC;AAC/B,QAAA,gCAAgC,GAAG,IAAI,CAAC;AACxC,QAAA,gCAAgC,GAAG,IAAI,CAAC;AACxC,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAC7B,QAAA,eAAe,GAAG,IAAI,CAAC;AACvB,QAAA,8BAA8B,GAAG,IAAI,CAAC;AACtC,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAClC,QAAA,wBAAwB,GAAG,IAAI,CAAC;AAE7C;;GAEG;AACH,SAAgB,aAAa,CAAC,QAAgB;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEpC,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,GAAG,CAAC,GAAG,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACzD,0BAA0B;YAC1B,MAAM,WAAW,GACb,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5B,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5B,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC3B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/lib/devices.d.ts

@@ -0,0 +1,75 @@
+import { EventEmitter } from 'events';
+import type { DeviceEvents, DevicesOptions, Reader } from './types';
+/**
+ * High-level event-driven API for PC/SC devices
+ *
+ * Uses native ReaderMonitor for efficient background monitoring
+ * with ThreadSafeFunction to emit events from worker thread.
+ *
+ * Events:
+ * - 'reader-attached': Emitted when a reader is attached
+ * - 'reader-detached': Emitted when a reader is detached
+ * - 'card-inserted': Emitted when a card is inserted
+ * - 'card-removed': Emitted when a card is removed
+ * - 'error': Emitted on errors
+ */
+export declare class Devices extends EventEmitter {
+    private _monitor;
+    private _context;
+    private _running;
+    private _readers;
+    private _eventQueue;
+    private _Context;
+    private _ReaderMonitor;
+    private _SCARD_STATE_PRESENT;
+    private _SCARD_SHARE_SHARED;
+    private _SCARD_PROTOCOL_T0;
+    private _SCARD_PROTOCOL_T1;
+    /**
+     * Create a new Devices instance
+     * @param options Optional dependencies for testing
+     */
+    constructor(options?: DevicesOptions);
+    /**
+     * Start monitoring for device changes
+     */
+    start(): void;
+    /**
+     * Stop monitoring
+     */
+    stop(): void;
+    /**
+     * List currently known readers
+     */
+    listReaders(): Reader[];
+    /**
+     * Handle events from native monitor
+     * Queues events to prevent race conditions when multiple events arrive concurrently
+     */
+    private _handleEvent;
+    /**
+     * Process a single event (called sequentially via queue)
+     */
+    private _processEvent;
+    /**
+     * Handle reader attached
+     */
+    private _handleReaderAttached;
+    /**
+     * Handle reader detached
+     */
+    private _handleReaderDetached;
+    /**
+     * Handle card inserted
+     */
+    private _handleCardInserted;
+    /**
+     * Handle card removed
+     */
+    private _handleCardRemoved;
+    on<K extends keyof DeviceEvents>(event: K, listener: DeviceEvents[K]): this;
+    once<K extends keyof DeviceEvents>(event: K, listener: DeviceEvents[K]): this;
+    off<K extends keyof DeviceEvents>(event: K, listener: DeviceEvents[K]): this;
+    emit<K extends keyof DeviceEvents>(event: K, ...args: Parameters<DeviceEvents[K]>): boolean;
+}
+//# sourceMappingURL=devices.d.ts.map

package/dist/lib/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../../lib/devices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAIR,YAAY,EACZ,cAAc,EAEd,MAAM,EAGT,MAAM,SAAS,CAAC;AAgBjB;;;;;;;;;;;;GAYG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IACrC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,WAAW,CAAoC;IAGvD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;OAGG;gBACS,OAAO,CAAC,EAAE,cAAc;IAcpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAsBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAkCZ;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAWvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;YACW,aAAa;IA+B3B;;OAEG;YACW,qBAAqB;IA0BnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;YACW,mBAAmB;IAyDjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B,EAAE,CAAC,CAAC,SAAS,MAAM,YAAY,EAC3B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAC1B,IAAI;IAIP,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAC7B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAC1B,IAAI;IAIP,GAAG,CAAC,CAAC,SAAS,MAAM,YAAY,EAC5B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAC1B,IAAI;IAIP,IAAI,CAAC,CAAC,SAAS,MAAM,YAAY,EAC7B,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACrC,OAAO;CAGb"}

package/{lib → dist/lib}/devices.js

@@ -1,29 +1,8 @@
-// @ts-check
-'use strict';
-
-const EventEmitter = require('events');
-const addon = require('../build/Release/smartcard_napi.node');
-
-/**
- * @typedef {import('./index').Reader} Reader
- * @typedef {import('./index').Card} Card
- * @typedef {import('./index').MonitorEvent} MonitorEvent
- * @typedef {import('./index').Context} ContextType
- * @typedef {import('./index').ReaderMonitor} ReaderMonitorType
- */
-
-const { Context, ReaderMonitor } = addon;
-const SCARD_STATE_PRESENT = addon.SCARD_STATE_PRESENT;
-const SCARD_SHARE_SHARED = addon.SCARD_SHARE_SHARED;
-const SCARD_PROTOCOL_T0 = addon.SCARD_PROTOCOL_T0;
-const SCARD_PROTOCOL_T1 = addon.SCARD_PROTOCOL_T1;
-
-/**
- * @typedef {Object} ReaderState
- * @property {boolean} hasCard
- * @property {Card|null} card
- */
-
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Devices = void 0;
+const events_1 = require("events");
+const addon = require('../../build/Release/smartcard_napi.node');
 /**
  * High-level event-driven API for PC/SC devices
  *
@@ -36,24 +15,37 @@ const SCARD_PROTOCOL_T1 = addon.SCARD_PROTOCOL_T1;
  * - 'card-inserted': Emitted when a card is inserted
  * - 'card-removed': Emitted when a card is removed
  * - 'error': Emitted on errors
- *
- * @extends EventEmitter
  */
-class Devices extends EventEmitter {
-    constructor() {
+class Devices extends events_1.EventEmitter {
+    _monitor = null;
+    _context = null;
+    _running = false;
+    _readers = new Map();
+    _eventQueue = Promise.resolve();
+    // Dependencies (can be injected for testing)
+    _Context;
+    _ReaderMonitor;
+    _SCARD_STATE_PRESENT;
+    _SCARD_SHARE_SHARED;
+    _SCARD_PROTOCOL_T0;
+    _SCARD_PROTOCOL_T1;
+    /**
+     * Create a new Devices instance
+     * @param options Optional dependencies for testing
+     */
+    constructor(options) {
         super();
-        /** @type {ReaderMonitorType|null} */
-        this._monitor = null;
-        /** @type {ContextType|null} */
-        this._context = null;
-        /** @type {boolean} */
-        this._running = false;
-        /** @type {Map<string, ReaderState>} */
-        this._readers = new Map();
-        /** @type {Promise<void>} Event queue to serialize event handling */
-        this._eventQueue = Promise.resolve();
+        this._Context = options?.Context ?? addon.Context;
+        this._ReaderMonitor = options?.ReaderMonitor ?? addon.ReaderMonitor;
+        this._SCARD_STATE_PRESENT =
+            options?.SCARD_STATE_PRESENT ?? addon.SCARD_STATE_PRESENT;
+        this._SCARD_SHARE_SHARED =
+            options?.SCARD_SHARE_SHARED ?? addon.SCARD_SHARE_SHARED;
+        this._SCARD_PROTOCOL_T0 =
+            options?.SCARD_PROTOCOL_T0 ?? addon.SCARD_PROTOCOL_T0;
+        this._SCARD_PROTOCOL_T1 =
+            options?.SCARD_PROTOCOL_T1 ?? addon.SCARD_PROTOCOL_T1;
     }
-
     /**
      * Start monitoring for device changes
      */
@@ -61,64 +53,59 @@ class Devices extends EventEmitter {
         if (this._running) {
             return;
         }
-
         try {
             // Create context for card connections
-            this._context = new Context();
-
+            this._context = new this._Context();
             // Create native monitor
-            this._monitor = new ReaderMonitor();
+            this._monitor = new this._ReaderMonitor();
             this._running = true;
-
             // Start native monitoring with callback
             this._monitor.start((event) => {
                 this._handleEvent(event);
             });
-        } catch (err) {
+        }
+        catch (err) {
             this.emit('error', err);
         }
     }
-
     /**
      * Stop monitoring
      */
     stop() {
         this._running = false;
-
         if (this._monitor) {
             try {
                 this._monitor.stop();
-            } catch (err) {
+            }
+            catch {
                 // Ignore stop errors
             }
             this._monitor = null;
         }
-
         // Disconnect any connected cards
-        for (const [name, state] of this._readers) {
+        for (const [, state] of this._readers) {
             if (state.card) {
                 try {
                     state.card.disconnect();
-                } catch (err) {
+                }
+                catch {
                     // Ignore disconnect errors
                 }
             }
         }
         this._readers.clear();
-
         if (this._context) {
             try {
                 this._context.close();
-            } catch (err) {
+            }
+            catch {
                 // Ignore close errors
             }
             this._context = null;
         }
     }
-
     /**
      * List currently known readers
-     * @returns {Reader[]} Array of readers
      */
     listReaders() {
         if (!this._context || !this._context.isValid) {
@@ -126,63 +113,48 @@ class Devices extends EventEmitter {
         }
         try {
             return this._context.listReaders();
-        } catch (err) {
+        }
+        catch {
             return [];
         }
     }
-
     /**
      * Handle events from native monitor
      * Queues events to prevent race conditions when multiple events arrive concurrently
-     * @param {MonitorEvent} event
      */
     _handleEvent(event) {
         // Chain this event onto the queue to serialize processing
         this._eventQueue = this._eventQueue.then(() => this._processEvent(event));
     }
-
     /**
      * Process a single event (called sequentially via queue)
-     * @param {MonitorEvent} event
-     * @returns {Promise<void>}
      */
     async _processEvent(event) {
         if (!this._running) {
             return;
         }
-
         const { type, reader: readerName, state, atr } = event;
-
         switch (type) {
             case 'reader-attached':
                 await this._handleReaderAttached(readerName, state, atr);
                 break;
-
             case 'reader-detached':
                 this._handleReaderDetached(readerName);
                 break;
-
             case 'card-inserted':
                 await this._handleCardInserted(readerName, state, atr);
                 break;
-
             case 'card-removed':
                 this._handleCardRemoved(readerName);
                 break;
-
             case 'error':
                 // readerName contains error message for error events
                 this.emit('error', new Error(readerName));
                 break;
         }
     }
-
     /**
      * Handle reader attached
-     * @param {string} readerName
-     * @param {number} state
-     * @param {Buffer|null} atr
-     * @returns {Promise<void>}
      */
     async _handleReaderAttached(readerName, state, atr) {
         // Initialize reader state
@@ -190,46 +162,33 @@ class Devices extends EventEmitter {
             hasCard: false,
             card: null,
         });
-
         // Create a reader-like object for the event
         const reader = {
             name: readerName,
             state: state,
             atr: atr,
         };
-
         this.emit('reader-attached', reader);
-
         // Check if card is already present
-        if ((state & SCARD_STATE_PRESENT) !== 0) {
+        if ((state & this._SCARD_STATE_PRESENT) !== 0) {
             await this._handleCardInserted(readerName, state, atr);
         }
     }
-
     /**
      * Handle reader detached
-     * @param {string} readerName
      */
     _handleReaderDetached(readerName) {
         const state = this._readers.get(readerName);
-
         // If card was connected, emit card-removed first
         if (state && state.hasCard) {
             this._handleCardRemoved(readerName);
         }
-
         this._readers.delete(readerName);
-
         const reader = { name: readerName };
         this.emit('reader-detached', reader);
     }
-
     /**
      * Handle card inserted
-     * @param {string} readerName
-     * @param {number} eventState
-     * @param {Buffer|null} atr
-     * @returns {Promise<void>}
      */
     async _handleCardInserted(readerName, eventState, atr) {
         let state = this._readers.get(readerName);
@@ -237,77 +196,79 @@ class Devices extends EventEmitter {
             state = { hasCard: false, card: null };
             this._readers.set(readerName, state);
         }
-
         state.hasCard = true;
-
         // Try to connect to the card
         try {
             const readers = this._context.listReaders();
-            const reader = readers.find(r => r.name === readerName);
-
+            const reader = readers.find((r) => r.name === readerName);
             if (reader) {
                 let card;
                 try {
                     // First try with both T=0 and T=1 protocols
-                    card = await reader.connect(
-                        SCARD_SHARE_SHARED,
-                        SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1
-                    );
-                } catch (dualProtocolErr) {
+                    card = await reader.connect(this._SCARD_SHARE_SHARED, this._SCARD_PROTOCOL_T0 | this._SCARD_PROTOCOL_T1);
+                }
+                catch (dualProtocolErr) {
                     // If dual protocol fails (e.g., SCARD_W_UNRESPONSIVE_CARD),
                     // fallback to T=0 only (issue #34)
-                    if (dualProtocolErr.message &&
-                        dualProtocolErr.message.toLowerCase().includes('unresponsive')) {
-                        card = await reader.connect(
-                            SCARD_SHARE_SHARED,
-                            SCARD_PROTOCOL_T0
-                        );
-                    } else {
+                    const err = dualProtocolErr;
+                    if (err.message &&
+                        err.message.toLowerCase().includes('unresponsive')) {
+                        card = await reader.connect(this._SCARD_SHARE_SHARED, this._SCARD_PROTOCOL_T0);
+                    }
+                    else {
                         // Re-throw if it's a different error
                         throw dualProtocolErr;
                     }
                 }
-
                 state.card = card;
-
                 this.emit('card-inserted', {
                     reader: { name: readerName, state: eventState, atr: atr },
                     card: card,
                 });
             }
-        } catch (err) {
+        }
+        catch (err) {
             // Emit error but don't fail
             this.emit('error', err);
         }
     }
-
     /**
      * Handle card removed
-     * @param {string} readerName
      */
     _handleCardRemoved(readerName) {
         const state = this._readers.get(readerName);
         if (!state) {
             return;
         }
-
         const card = state.card;
         state.hasCard = false;
         state.card = null;
-
         if (card) {
             try {
                 card.disconnect();
-            } catch (err) {
+            }
+            catch {
                 // Ignore - card is already removed
             }
         }
-
         this.emit('card-removed', {
             reader: { name: readerName },
             card: card,
         });
     }
+    // Type-safe event emitter overrides
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
 }
-
-module.exports = { Devices };
+exports.Devices = Devices;
+//# sourceMappingURL=devices.js.map

package/dist/lib/devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../lib/devices.ts"],"names":[],"mappings":"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"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Base error class for PC/SC errors
+ */
+export declare class PCSCError extends Error {
+    readonly code: number;
+    constructor(message: string, code: number);
+}
+/**
+ * Error thrown when a card is removed during an operation
+ */
+export declare class CardRemovedError extends PCSCError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when an operation times out
+ */
+export declare class TimeoutError extends PCSCError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when no readers are available
+ */
+export declare class NoReadersError extends PCSCError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when PC/SC service is not running
+ */
+export declare class ServiceNotRunningError extends PCSCError {
+    constructor(message?: string);
+}
+/**
+ * Error thrown when there's a sharing violation
+ */
+export declare class SharingViolationError extends PCSCError {
+    constructor(message?: string);
+}
+/**
+ * Factory function to create the appropriate error class based on PC/SC error code
+ */
+export declare function createPCSCError(message: string, code: number): PCSCError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM5C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;gBAC/B,OAAO,SAAqB;CAI3C;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;gBAC3B,OAAO,SAAwB;CAI9C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;gBAC7B,OAAO,SAAyB;CAI/C;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;gBACrC,OAAO,SAA8B;CAIpD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;gBACpC,OAAO,SAAuC;CAI7D;AAeD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAMxE"}