@cleverence/edge-js-sdk 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs ADDED
@@ -0,0 +1,482 @@
1
+ 'use strict';
2
+
3
+ // src/core/events.ts
4
+ var EventEmitter = class {
5
+ constructor() {
6
+ this.handlers = /* @__PURE__ */ new Map();
7
+ }
8
+ /**
9
+ * Subscribe to an event
10
+ */
11
+ on(event, handler) {
12
+ if (!this.handlers.has(event)) {
13
+ this.handlers.set(event, /* @__PURE__ */ new Set());
14
+ }
15
+ this.handlers.get(event).add(handler);
16
+ return this;
17
+ }
18
+ /**
19
+ * Subscribe to an event once (auto-unsubscribes after first call)
20
+ */
21
+ once(event, handler) {
22
+ const onceHandler = (data) => {
23
+ this.off(event, onceHandler);
24
+ handler(data);
25
+ };
26
+ return this.on(event, onceHandler);
27
+ }
28
+ /**
29
+ * Unsubscribe from an event
30
+ */
31
+ off(event, handler) {
32
+ const eventHandlers = this.handlers.get(event);
33
+ if (eventHandlers) {
34
+ eventHandlers.delete(handler);
35
+ }
36
+ return this;
37
+ }
38
+ /**
39
+ * Emit an event to all subscribers
40
+ */
41
+ emit(event, data) {
42
+ const eventHandlers = this.handlers.get(event);
43
+ if (eventHandlers) {
44
+ eventHandlers.forEach((handler) => {
45
+ try {
46
+ handler(data);
47
+ } catch (err) {
48
+ console.error(`Error in event handler for "${String(event)}":`, err);
49
+ }
50
+ });
51
+ }
52
+ }
53
+ /**
54
+ * Remove all listeners for an event, or all listeners if no event specified
55
+ */
56
+ removeAllListeners(event) {
57
+ if (event) {
58
+ this.handlers.delete(event);
59
+ } else {
60
+ this.handlers.clear();
61
+ }
62
+ return this;
63
+ }
64
+ /**
65
+ * Get listener count for an event
66
+ */
67
+ listenerCount(event) {
68
+ return this.handlers.get(event)?.size ?? 0;
69
+ }
70
+ };
71
+
72
+ // src/core/websocket.ts
73
+ var DEFAULT_WS_OPTIONS = {
74
+ reconnect: true,
75
+ reconnectDelay: 1e3,
76
+ maxReconnectDelay: 3e4,
77
+ pingInterval: 3e4
78
+ };
79
+ var WebSocketManager = class extends EventEmitter {
80
+ constructor(url, options = {}) {
81
+ super();
82
+ this.ws = null;
83
+ this._state = "disconnected";
84
+ this.reconnectAttempts = 0;
85
+ this.reconnectTimer = null;
86
+ this.pingTimer = null;
87
+ this.pendingRequests = /* @__PURE__ */ new Map();
88
+ this.intentionalClose = false;
89
+ this.url = url;
90
+ this.options = { ...DEFAULT_WS_OPTIONS, ...options };
91
+ }
92
+ /**
93
+ * Current connection state
94
+ */
95
+ get state() {
96
+ return this._state;
97
+ }
98
+ /**
99
+ * Whether currently connected
100
+ */
101
+ get isConnected() {
102
+ return this._state === "connected";
103
+ }
104
+ /**
105
+ * Connect to the WebSocket server
106
+ */
107
+ connect() {
108
+ return new Promise((resolve, reject) => {
109
+ if (this._state === "connected" || this._state === "connecting") {
110
+ resolve();
111
+ return;
112
+ }
113
+ this.intentionalClose = false;
114
+ this.setState("connecting");
115
+ try {
116
+ this.ws = new WebSocket(this.url);
117
+ const onOpen = () => {
118
+ this.ws?.removeEventListener("error", onError);
119
+ this.reconnectAttempts = 0;
120
+ this.setState("connected");
121
+ this.startPing();
122
+ this.emit("open", void 0);
123
+ resolve();
124
+ };
125
+ const onError = (event) => {
126
+ this.ws?.removeEventListener("open", onOpen);
127
+ const error = new Error("WebSocket connection failed");
128
+ reject(error);
129
+ };
130
+ this.ws.addEventListener("open", onOpen, { once: true });
131
+ this.ws.addEventListener("error", onError, { once: true });
132
+ this.ws.addEventListener("message", this.handleMessage.bind(this));
133
+ this.ws.addEventListener("close", this.handleClose.bind(this));
134
+ this.ws.addEventListener("error", this.handleError.bind(this));
135
+ } catch (err) {
136
+ this.setState("disconnected");
137
+ reject(err instanceof Error ? err : new Error(String(err)));
138
+ }
139
+ });
140
+ }
141
+ /**
142
+ * Disconnect from the WebSocket server
143
+ */
144
+ disconnect() {
145
+ this.intentionalClose = true;
146
+ this.cleanup();
147
+ this.setState("disconnected");
148
+ this.emit("close", void 0);
149
+ }
150
+ /**
151
+ * Send a message to the server
152
+ */
153
+ send(message) {
154
+ if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
155
+ throw new Error("WebSocket is not connected");
156
+ }
157
+ this.ws.send(JSON.stringify(message));
158
+ }
159
+ /**
160
+ * Send a query and wait for response (request/response pattern)
161
+ */
162
+ request(query, timeoutMs = 1e4) {
163
+ return new Promise((resolve, reject) => {
164
+ const id = this.generateId();
165
+ const timeout = setTimeout(() => {
166
+ this.pendingRequests.delete(id);
167
+ reject(new Error(`Request timeout: ${query}`));
168
+ }, timeoutMs);
169
+ this.pendingRequests.set(id, {
170
+ resolve,
171
+ reject,
172
+ timeout
173
+ });
174
+ try {
175
+ this.send({ type: "query", id, query });
176
+ } catch (err) {
177
+ clearTimeout(timeout);
178
+ this.pendingRequests.delete(id);
179
+ reject(err);
180
+ }
181
+ });
182
+ }
183
+ /**
184
+ * Send a command (fire and forget, but throws if not connected)
185
+ */
186
+ command(message) {
187
+ this.send(message);
188
+ }
189
+ handleMessage(event) {
190
+ try {
191
+ const message = JSON.parse(event.data);
192
+ if (message.type === "response") {
193
+ const pending = this.pendingRequests.get(message.id);
194
+ if (pending) {
195
+ clearTimeout(pending.timeout);
196
+ this.pendingRequests.delete(message.id);
197
+ if (message.success) {
198
+ pending.resolve(message.data.result);
199
+ } else {
200
+ pending.reject(new Error(message.error));
201
+ }
202
+ return;
203
+ }
204
+ }
205
+ if (message.type === "pong") {
206
+ return;
207
+ }
208
+ this.emit("message", message);
209
+ } catch (err) {
210
+ console.error("Failed to parse WebSocket message:", err);
211
+ }
212
+ }
213
+ handleClose() {
214
+ this.cleanup();
215
+ if (this.intentionalClose) {
216
+ this.setState("disconnected");
217
+ return;
218
+ }
219
+ this.emit("close", void 0);
220
+ if (this.options.reconnect) {
221
+ this.scheduleReconnect();
222
+ } else {
223
+ this.setState("disconnected");
224
+ }
225
+ }
226
+ handleError(event) {
227
+ const error = new Error("WebSocket error");
228
+ this.emit("error", error);
229
+ }
230
+ scheduleReconnect() {
231
+ if (this.reconnectTimer) return;
232
+ this.setState("reconnecting");
233
+ const delay = Math.min(
234
+ this.options.reconnectDelay * Math.pow(2, this.reconnectAttempts),
235
+ this.options.maxReconnectDelay
236
+ );
237
+ this.reconnectTimer = setTimeout(async () => {
238
+ this.reconnectTimer = null;
239
+ this.reconnectAttempts++;
240
+ try {
241
+ await this.connect();
242
+ } catch {
243
+ }
244
+ }, delay);
245
+ }
246
+ startPing() {
247
+ this.stopPing();
248
+ this.pingTimer = setInterval(() => {
249
+ if (this.ws?.readyState === WebSocket.OPEN) {
250
+ try {
251
+ this.send({ type: "ping" });
252
+ } catch {
253
+ }
254
+ }
255
+ }, this.options.pingInterval);
256
+ }
257
+ stopPing() {
258
+ if (this.pingTimer) {
259
+ clearInterval(this.pingTimer);
260
+ this.pingTimer = null;
261
+ }
262
+ }
263
+ cleanup() {
264
+ this.stopPing();
265
+ if (this.reconnectTimer) {
266
+ clearTimeout(this.reconnectTimer);
267
+ this.reconnectTimer = null;
268
+ }
269
+ this.pendingRequests.forEach((pending) => {
270
+ clearTimeout(pending.timeout);
271
+ pending.reject(new Error("WebSocket disconnected"));
272
+ });
273
+ this.pendingRequests.clear();
274
+ if (this.ws) {
275
+ const ws = this.ws;
276
+ this.ws = null;
277
+ if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
278
+ ws.close();
279
+ }
280
+ }
281
+ }
282
+ setState(state) {
283
+ if (this._state !== state) {
284
+ this._state = state;
285
+ this.emit("statechange", state);
286
+ }
287
+ }
288
+ generateId() {
289
+ return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
290
+ }
291
+ };
292
+
293
+ // src/types/messages.ts
294
+ var DEFAULT_OPTIONS = {
295
+ url: "ws://localhost:8585",
296
+ autoConnect: true,
297
+ reconnectDelay: 1e3,
298
+ maxReconnectDelay: 3e4,
299
+ pingInterval: 3e4
300
+ };
301
+
302
+ // src/core/client.ts
303
+ var CleverenceEdge = class _CleverenceEdge extends EventEmitter {
304
+ constructor(options = {}) {
305
+ super();
306
+ this._capabilities = null;
307
+ this.options = { ...DEFAULT_OPTIONS, ...options };
308
+ this.ws = new WebSocketManager(this.options.url, {
309
+ reconnect: true,
310
+ reconnectDelay: this.options.reconnectDelay,
311
+ maxReconnectDelay: this.options.maxReconnectDelay,
312
+ pingInterval: this.options.pingInterval
313
+ });
314
+ this.setupWebSocketHandlers();
315
+ if (this.options.autoConnect) {
316
+ setTimeout(() => this.connect().catch(() => {
317
+ }), 0);
318
+ }
319
+ }
320
+ /**
321
+ * Current connection state
322
+ */
323
+ get connectionState() {
324
+ return this.ws.state;
325
+ }
326
+ /**
327
+ * Whether currently connected to the Edge service
328
+ */
329
+ get isConnected() {
330
+ return this.ws.isConnected;
331
+ }
332
+ /**
333
+ * Cached device capabilities (available after connect)
334
+ */
335
+ get capabilities() {
336
+ return this._capabilities;
337
+ }
338
+ /**
339
+ * Connect to the Edge service
340
+ */
341
+ async connect() {
342
+ await this.ws.connect();
343
+ }
344
+ /**
345
+ * Disconnect from the Edge service
346
+ */
347
+ disconnect() {
348
+ this.ws.disconnect();
349
+ }
350
+ // ─────────────────────────────────────────────────────────────────────────────
351
+ // Commands
352
+ // ─────────────────────────────────────────────────────────────────────────────
353
+ /**
354
+ * Trigger a barcode scan programmatically
355
+ */
356
+ async triggerScan() {
357
+ this.ensureConnected();
358
+ this.ws.command({ type: "command", command: "trigger_scan" });
359
+ }
360
+ /**
361
+ * Set enabled barcode symbologies
362
+ */
363
+ async setSymbologies(symbologies) {
364
+ this.ensureConnected();
365
+ this.ws.command({ type: "command", command: "set_symbologies", symbologies });
366
+ }
367
+ /**
368
+ * Start RFID inventory (continuous reading)
369
+ */
370
+ async startRfidInventory(options) {
371
+ this.ensureConnected();
372
+ this.ws.command({ type: "command", command: "start_rfid_inventory", options });
373
+ }
374
+ /**
375
+ * Stop RFID inventory
376
+ */
377
+ async stopRfidInventory() {
378
+ this.ensureConnected();
379
+ this.ws.command({ type: "command", command: "stop_rfid_inventory" });
380
+ }
381
+ // ─────────────────────────────────────────────────────────────────────────────
382
+ // Queries
383
+ // ─────────────────────────────────────────────────────────────────────────────
384
+ /**
385
+ * Get current Edge service status
386
+ */
387
+ async getStatus() {
388
+ this.ensureConnected();
389
+ return this.ws.request("status");
390
+ }
391
+ /**
392
+ * Get device capabilities
393
+ */
394
+ async getCapabilities() {
395
+ this.ensureConnected();
396
+ return this.ws.request("capabilities");
397
+ }
398
+ /**
399
+ * Get current configuration
400
+ */
401
+ async getConfig() {
402
+ this.ensureConnected();
403
+ return this.ws.request("config");
404
+ }
405
+ /**
406
+ * Get RFID tags from current/last inventory
407
+ */
408
+ async getRfidTags() {
409
+ this.ensureConnected();
410
+ return this.ws.request("rfid_tags");
411
+ }
412
+ // ─────────────────────────────────────────────────────────────────────────────
413
+ // Static factory
414
+ // ─────────────────────────────────────────────────────────────────────────────
415
+ /**
416
+ * Create a new CleverenceEdge instance
417
+ */
418
+ static create(options) {
419
+ return new _CleverenceEdge(options);
420
+ }
421
+ // ─────────────────────────────────────────────────────────────────────────────
422
+ // Private methods
423
+ // ─────────────────────────────────────────────────────────────────────────────
424
+ setupWebSocketHandlers() {
425
+ this.ws.on("open", () => {
426
+ this.emit("connect", void 0);
427
+ this.getCapabilities().then((caps) => {
428
+ this._capabilities = caps;
429
+ this.emit("capabilities", caps);
430
+ }).catch(() => {
431
+ });
432
+ });
433
+ this.ws.on("close", () => {
434
+ this.emit("disconnect", void 0);
435
+ });
436
+ this.ws.on("error", (error) => {
437
+ this.emit("error", error);
438
+ });
439
+ this.ws.on("statechange", (state) => {
440
+ if (state === "reconnecting") {
441
+ this.emit("reconnecting", void 0);
442
+ }
443
+ });
444
+ this.ws.on("message", (message) => {
445
+ this.handleServerMessage(message);
446
+ });
447
+ }
448
+ handleServerMessage(message) {
449
+ switch (message.type) {
450
+ case "event":
451
+ this.handleEvent(message.event);
452
+ break;
453
+ case "capabilities":
454
+ this._capabilities = message.data;
455
+ this.emit("capabilities", message.data);
456
+ break;
457
+ case "error":
458
+ this.emit("error", new Error(message.message));
459
+ break;
460
+ }
461
+ }
462
+ handleEvent(event) {
463
+ const parsedEvent = {
464
+ ...event,
465
+ timestamp: typeof event.timestamp === "string" ? new Date(event.timestamp) : event.timestamp
466
+ };
467
+ if (event.type === "scan") {
468
+ this.emit("scan", parsedEvent);
469
+ } else if (event.type === "rfid") {
470
+ this.emit("rfid", parsedEvent);
471
+ }
472
+ }
473
+ ensureConnected() {
474
+ if (!this.isConnected) {
475
+ throw new Error("Not connected to Edge service. Call connect() first.");
476
+ }
477
+ }
478
+ };
479
+
480
+ exports.CleverenceEdge = CleverenceEdge;
481
+ //# sourceMappingURL=index.cjs.map
482
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/core/events.ts","../src/core/websocket.ts","../src/types/messages.ts","../src/core/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * Minimal typed event emitter for browser environments\r\n */\r\n\r\ntype EventHandler<T = unknown> = (data: T) => void;\r\n\r\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\r\nexport class EventEmitter<Events extends Record<string, any> = Record<string, unknown>> {\r\n private handlers: Map<keyof Events, Set<EventHandler<unknown>>> = new Map();\r\n\r\n /**\r\n * Subscribe to an event\r\n */\r\n on<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): this {\r\n if (!this.handlers.has(event)) {\r\n this.handlers.set(event, new Set());\r\n }\r\n this.handlers.get(event)!.add(handler as EventHandler<unknown>);\r\n return this;\r\n }\r\n\r\n /**\r\n * Subscribe to an event once (auto-unsubscribes after first call)\r\n */\r\n once<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): this {\r\n const onceHandler: EventHandler<Events[K]> = (data) => {\r\n this.off(event, onceHandler);\r\n handler(data);\r\n };\r\n return this.on(event, onceHandler);\r\n }\r\n\r\n /**\r\n * Unsubscribe from an event\r\n */\r\n off<K extends keyof Events>(event: K, handler: EventHandler<Events[K]>): this {\r\n const eventHandlers = this.handlers.get(event);\r\n if (eventHandlers) {\r\n eventHandlers.delete(handler as EventHandler<unknown>);\r\n }\r\n return this;\r\n }\r\n\r\n /**\r\n * Emit an event to all subscribers\r\n */\r\n protected emit<K extends keyof Events>(event: K, data: Events[K]): void {\r\n const eventHandlers = this.handlers.get(event);\r\n if (eventHandlers) {\r\n eventHandlers.forEach((handler) => {\r\n try {\r\n handler(data);\r\n } catch (err) {\r\n console.error(`Error in event handler for \"${String(event)}\":`, err);\r\n }\r\n });\r\n }\r\n }\r\n\r\n /**\r\n * Remove all listeners for an event, or all listeners if no event specified\r\n */\r\n removeAllListeners(event?: keyof Events): this {\r\n if (event) {\r\n this.handlers.delete(event);\r\n } else {\r\n this.handlers.clear();\r\n }\r\n return this;\r\n }\r\n\r\n /**\r\n * Get listener count for an event\r\n */\r\n listenerCount(event: keyof Events): number {\r\n return this.handlers.get(event)?.size ?? 0;\r\n }\r\n}\r\n","import { EventEmitter } from './events';\r\nimport type { ClientMessage, ServerMessage, ConnectionState } from '../types';\r\n\r\ninterface WSManagerEvents {\r\n message: ServerMessage;\r\n open: void;\r\n close: void;\r\n error: Error;\r\n statechange: ConnectionState;\r\n}\r\n\r\ninterface WSManagerOptions {\r\n reconnect?: boolean;\r\n reconnectDelay?: number;\r\n maxReconnectDelay?: number;\r\n pingInterval?: number;\r\n}\r\n\r\nconst DEFAULT_WS_OPTIONS: Required<WSManagerOptions> = {\r\n reconnect: true,\r\n reconnectDelay: 1000,\r\n maxReconnectDelay: 30000,\r\n pingInterval: 30000,\r\n};\r\n\r\n/**\r\n * WebSocket connection manager with auto-reconnect and request/response correlation\r\n */\r\nexport class WebSocketManager extends EventEmitter<WSManagerEvents> {\r\n private ws: WebSocket | null = null;\r\n private url: string;\r\n private options: Required<WSManagerOptions>;\r\n private _state: ConnectionState = 'disconnected';\r\n private reconnectAttempts = 0;\r\n private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\r\n private pingTimer: ReturnType<typeof setInterval> | null = null;\r\n private pendingRequests: Map<string, {\r\n resolve: (data: unknown) => void;\r\n reject: (error: Error) => void;\r\n timeout: ReturnType<typeof setTimeout>;\r\n }> = new Map();\r\n private intentionalClose = false;\r\n\r\n constructor(url: string, options: WSManagerOptions = {}) {\r\n super();\r\n this.url = url;\r\n this.options = { ...DEFAULT_WS_OPTIONS, ...options };\r\n }\r\n\r\n /**\r\n * Current connection state\r\n */\r\n get state(): ConnectionState {\r\n return this._state;\r\n }\r\n\r\n /**\r\n * Whether currently connected\r\n */\r\n get isConnected(): boolean {\r\n return this._state === 'connected';\r\n }\r\n\r\n /**\r\n * Connect to the WebSocket server\r\n */\r\n connect(): Promise<void> {\r\n return new Promise((resolve, reject) => {\r\n if (this._state === 'connected' || this._state === 'connecting') {\r\n resolve();\r\n return;\r\n }\r\n\r\n this.intentionalClose = false;\r\n this.setState('connecting');\r\n\r\n try {\r\n this.ws = new WebSocket(this.url);\r\n\r\n const onOpen = () => {\r\n this.ws?.removeEventListener('error', onError);\r\n this.reconnectAttempts = 0;\r\n this.setState('connected');\r\n this.startPing();\r\n this.emit('open', undefined);\r\n resolve();\r\n };\r\n\r\n const onError = (event: Event) => {\r\n this.ws?.removeEventListener('open', onOpen);\r\n const error = new Error('WebSocket connection failed');\r\n reject(error);\r\n };\r\n\r\n this.ws.addEventListener('open', onOpen, { once: true });\r\n this.ws.addEventListener('error', onError, { once: true });\r\n\r\n this.ws.addEventListener('message', this.handleMessage.bind(this));\r\n this.ws.addEventListener('close', this.handleClose.bind(this));\r\n this.ws.addEventListener('error', this.handleError.bind(this));\r\n } catch (err) {\r\n this.setState('disconnected');\r\n reject(err instanceof Error ? err : new Error(String(err)));\r\n }\r\n });\r\n }\r\n\r\n /**\r\n * Disconnect from the WebSocket server\r\n */\r\n disconnect(): void {\r\n this.intentionalClose = true;\r\n this.cleanup();\r\n this.setState('disconnected');\r\n this.emit('close', undefined);\r\n }\r\n\r\n /**\r\n * Send a message to the server\r\n */\r\n send(message: ClientMessage): void {\r\n if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\r\n throw new Error('WebSocket is not connected');\r\n }\r\n this.ws.send(JSON.stringify(message));\r\n }\r\n\r\n /**\r\n * Send a query and wait for response (request/response pattern)\r\n */\r\n request<T>(query: 'status' | 'capabilities' | 'config' | 'rfid_tags', timeoutMs = 10000): Promise<T> {\r\n return new Promise((resolve, reject) => {\r\n const id = this.generateId();\r\n \r\n const timeout = setTimeout(() => {\r\n this.pendingRequests.delete(id);\r\n reject(new Error(`Request timeout: ${query}`));\r\n }, timeoutMs);\r\n\r\n this.pendingRequests.set(id, {\r\n resolve: resolve as (data: unknown) => void,\r\n reject,\r\n timeout,\r\n });\r\n\r\n try {\r\n this.send({ type: 'query', id, query });\r\n } catch (err) {\r\n clearTimeout(timeout);\r\n this.pendingRequests.delete(id);\r\n reject(err);\r\n }\r\n });\r\n }\r\n\r\n /**\r\n * Send a command (fire and forget, but throws if not connected)\r\n */\r\n command(message: Exclude<ClientMessage, { type: 'query' } | { type: 'ping' }>): void {\r\n this.send(message);\r\n }\r\n\r\n private handleMessage(event: MessageEvent): void {\r\n try {\r\n const message = JSON.parse(event.data) as ServerMessage;\r\n\r\n // Handle response to pending request\r\n if (message.type === 'response') {\r\n const pending = this.pendingRequests.get(message.id);\r\n if (pending) {\r\n clearTimeout(pending.timeout);\r\n this.pendingRequests.delete(message.id);\r\n \r\n if (message.success) {\r\n pending.resolve(message.data.result);\r\n } else {\r\n pending.reject(new Error(message.error));\r\n }\r\n return;\r\n }\r\n }\r\n\r\n // Handle pong\r\n if (message.type === 'pong') {\r\n return; // Keepalive response, no action needed\r\n }\r\n\r\n // Emit for other handlers\r\n this.emit('message', message);\r\n } catch (err) {\r\n console.error('Failed to parse WebSocket message:', err);\r\n }\r\n }\r\n\r\n private handleClose(): void {\r\n this.cleanup();\r\n \r\n if (this.intentionalClose) {\r\n this.setState('disconnected');\r\n return;\r\n }\r\n\r\n this.emit('close', undefined);\r\n\r\n if (this.options.reconnect) {\r\n this.scheduleReconnect();\r\n } else {\r\n this.setState('disconnected');\r\n }\r\n }\r\n\r\n private handleError(event: Event): void {\r\n const error = new Error('WebSocket error');\r\n this.emit('error', error);\r\n }\r\n\r\n private scheduleReconnect(): void {\r\n if (this.reconnectTimer) return;\r\n\r\n this.setState('reconnecting');\r\n\r\n // Exponential backoff\r\n const delay = Math.min(\r\n this.options.reconnectDelay * Math.pow(2, this.reconnectAttempts),\r\n this.options.maxReconnectDelay\r\n );\r\n\r\n this.reconnectTimer = setTimeout(async () => {\r\n this.reconnectTimer = null;\r\n this.reconnectAttempts++;\r\n \r\n try {\r\n await this.connect();\r\n } catch {\r\n // connect() will trigger handleClose which schedules another reconnect\r\n }\r\n }, delay);\r\n }\r\n\r\n private startPing(): void {\r\n this.stopPing();\r\n this.pingTimer = setInterval(() => {\r\n if (this.ws?.readyState === WebSocket.OPEN) {\r\n try {\r\n this.send({ type: 'ping' });\r\n } catch {\r\n // Ignore ping errors\r\n }\r\n }\r\n }, this.options.pingInterval);\r\n }\r\n\r\n private stopPing(): void {\r\n if (this.pingTimer) {\r\n clearInterval(this.pingTimer);\r\n this.pingTimer = null;\r\n }\r\n }\r\n\r\n private cleanup(): void {\r\n this.stopPing();\r\n\r\n if (this.reconnectTimer) {\r\n clearTimeout(this.reconnectTimer);\r\n this.reconnectTimer = null;\r\n }\r\n\r\n // Reject all pending requests\r\n this.pendingRequests.forEach((pending) => {\r\n clearTimeout(pending.timeout);\r\n pending.reject(new Error('WebSocket disconnected'));\r\n });\r\n this.pendingRequests.clear();\r\n\r\n if (this.ws) {\r\n const ws = this.ws;\r\n this.ws = null;\r\n // Only close if not already closed/closing\r\n if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {\r\n ws.close();\r\n }\r\n }\r\n }\r\n\r\n private setState(state: ConnectionState): void {\r\n if (this._state !== state) {\r\n this._state = state;\r\n this.emit('statechange', state);\r\n }\r\n }\r\n\r\n private generateId(): string {\r\n return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\r\n }\r\n}\r\n","import type { ScanEvent, RfidEvent } from './events';\r\nimport type { DeviceCapabilities, EdgeStatus, EdgeConfig, RfidInventoryOptions, RfidTag } from './capabilities';\r\n\r\n/**\r\n * Messages sent from SDK (client) to Edge service (server)\r\n */\r\nexport type ClientMessage =\r\n | { type: 'command'; command: 'trigger_scan' }\r\n | { type: 'command'; command: 'set_symbologies'; symbologies: string[] }\r\n | { type: 'command'; command: 'start_rfid_inventory'; options?: RfidInventoryOptions }\r\n | { type: 'command'; command: 'stop_rfid_inventory' }\r\n | { type: 'query'; id: string; query: 'status' }\r\n | { type: 'query'; id: string; query: 'capabilities' }\r\n | { type: 'query'; id: string; query: 'config' }\r\n | { type: 'query'; id: string; query: 'rfid_tags' }\r\n | { type: 'ping' };\r\n\r\n/**\r\n * Messages received from Edge service (server) to SDK (client)\r\n */\r\nexport type ServerMessage =\r\n | { type: 'event'; event: ScanEvent | RfidEvent }\r\n | { type: 'capabilities'; data: DeviceCapabilities }\r\n | { type: 'response'; id: string; success: true; data: ResponseData }\r\n | { type: 'response'; id: string; success: false; error: string }\r\n | { type: 'error'; message: string; code?: string }\r\n | { type: 'pong' };\r\n\r\n/**\r\n * Response data types based on query type\r\n */\r\nexport type ResponseData =\r\n | { query: 'status'; result: EdgeStatus }\r\n | { query: 'capabilities'; result: DeviceCapabilities }\r\n | { query: 'config'; result: EdgeConfig }\r\n | { query: 'rfid_tags'; result: RfidTag[] };\r\n\r\n/**\r\n * Connection state for the WebSocket\r\n */\r\nexport type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';\r\n\r\n/**\r\n * Options for creating a CleverenceEdge instance\r\n */\r\nexport interface EdgeOptions {\r\n /** WebSocket URL. Default: 'ws://localhost:8585' */\r\n url?: string;\r\n /** Auto-connect on instantiation. Default: true */\r\n autoConnect?: boolean;\r\n /** Initial reconnect delay in ms. Default: 1000 */\r\n reconnectDelay?: number;\r\n /** Maximum reconnect delay in ms. Default: 30000 */\r\n maxReconnectDelay?: number;\r\n /** Ping interval for keepalive in ms. Default: 30000 */\r\n pingInterval?: number;\r\n}\r\n\r\n/**\r\n * Default options\r\n */\r\nexport const DEFAULT_OPTIONS: Required<EdgeOptions> = {\r\n url: 'ws://localhost:8585',\r\n autoConnect: true,\r\n reconnectDelay: 1000,\r\n maxReconnectDelay: 30000,\r\n pingInterval: 30000,\r\n};\r\n","import { EventEmitter } from './events';\r\nimport { WebSocketManager } from './websocket';\r\nimport type {\r\n ScanEvent,\r\n RfidEvent,\r\n DeviceCapabilities,\r\n EdgeStatus,\r\n EdgeConfig,\r\n RfidInventoryOptions,\r\n RfidTag,\r\n ConnectionState,\r\n EdgeOptions,\r\n ServerMessage,\r\n} from '../types';\r\nimport { DEFAULT_OPTIONS } from '../types';\r\n\r\n/**\r\n * Events emitted by CleverenceEdge\r\n */\r\ninterface CleverenceEdgeEvents {\r\n scan: ScanEvent;\r\n rfid: RfidEvent;\r\n connect: void;\r\n disconnect: void;\r\n reconnecting: void;\r\n error: Error;\r\n capabilities: DeviceCapabilities;\r\n}\r\n\r\n/**\r\n * CleverenceEdge SDK - Connect to barcode scanners and RFID readers\r\n *\r\n * @example\r\n * ```typescript\r\n * const edge = new CleverenceEdge();\r\n *\r\n * edge.on('scan', (event) => {\r\n * console.log(event.data); // \"012345678905\"\r\n * console.log(event.symbology); // \"ean13\"\r\n * });\r\n *\r\n * edge.on('rfid', (event) => {\r\n * console.log(event.epc); // \"3034257BF400B7800004CB2F\"\r\n * console.log(event.rssi); // -45\r\n * });\r\n *\r\n * await edge.connect();\r\n * ```\r\n */\r\nexport class CleverenceEdge extends EventEmitter<CleverenceEdgeEvents> {\r\n private ws: WebSocketManager;\r\n private options: Required<EdgeOptions>;\r\n private _capabilities: DeviceCapabilities | null = null;\r\n\r\n constructor(options: EdgeOptions = {}) {\r\n super();\r\n this.options = { ...DEFAULT_OPTIONS, ...options };\r\n this.ws = new WebSocketManager(this.options.url, {\r\n reconnect: true,\r\n reconnectDelay: this.options.reconnectDelay,\r\n maxReconnectDelay: this.options.maxReconnectDelay,\r\n pingInterval: this.options.pingInterval,\r\n });\r\n\r\n this.setupWebSocketHandlers();\r\n\r\n if (this.options.autoConnect) {\r\n // Auto-connect on next tick to allow event handlers to be set up\r\n setTimeout(() => this.connect().catch(() => {}), 0);\r\n }\r\n }\r\n\r\n /**\r\n * Current connection state\r\n */\r\n get connectionState(): ConnectionState {\r\n return this.ws.state;\r\n }\r\n\r\n /**\r\n * Whether currently connected to the Edge service\r\n */\r\n get isConnected(): boolean {\r\n return this.ws.isConnected;\r\n }\r\n\r\n /**\r\n * Cached device capabilities (available after connect)\r\n */\r\n get capabilities(): DeviceCapabilities | null {\r\n return this._capabilities;\r\n }\r\n\r\n /**\r\n * Connect to the Edge service\r\n */\r\n async connect(): Promise<void> {\r\n await this.ws.connect();\r\n }\r\n\r\n /**\r\n * Disconnect from the Edge service\r\n */\r\n disconnect(): void {\r\n this.ws.disconnect();\r\n }\r\n\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n // Commands\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Trigger a barcode scan programmatically\r\n */\r\n async triggerScan(): Promise<void> {\r\n this.ensureConnected();\r\n this.ws.command({ type: 'command', command: 'trigger_scan' });\r\n }\r\n\r\n /**\r\n * Set enabled barcode symbologies\r\n */\r\n async setSymbologies(symbologies: string[]): Promise<void> {\r\n this.ensureConnected();\r\n this.ws.command({ type: 'command', command: 'set_symbologies', symbologies });\r\n }\r\n\r\n /**\r\n * Start RFID inventory (continuous reading)\r\n */\r\n async startRfidInventory(options?: RfidInventoryOptions): Promise<void> {\r\n this.ensureConnected();\r\n this.ws.command({ type: 'command', command: 'start_rfid_inventory', options });\r\n }\r\n\r\n /**\r\n * Stop RFID inventory\r\n */\r\n async stopRfidInventory(): Promise<void> {\r\n this.ensureConnected();\r\n this.ws.command({ type: 'command', command: 'stop_rfid_inventory' });\r\n }\r\n\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n // Queries\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Get current Edge service status\r\n */\r\n async getStatus(): Promise<EdgeStatus> {\r\n this.ensureConnected();\r\n return this.ws.request<EdgeStatus>('status');\r\n }\r\n\r\n /**\r\n * Get device capabilities\r\n */\r\n async getCapabilities(): Promise<DeviceCapabilities> {\r\n this.ensureConnected();\r\n return this.ws.request<DeviceCapabilities>('capabilities');\r\n }\r\n\r\n /**\r\n * Get current configuration\r\n */\r\n async getConfig(): Promise<EdgeConfig> {\r\n this.ensureConnected();\r\n return this.ws.request<EdgeConfig>('config');\r\n }\r\n\r\n /**\r\n * Get RFID tags from current/last inventory\r\n */\r\n async getRfidTags(): Promise<RfidTag[]> {\r\n this.ensureConnected();\r\n return this.ws.request<RfidTag[]>('rfid_tags');\r\n }\r\n\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n // Static factory\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n\r\n /**\r\n * Create a new CleverenceEdge instance\r\n */\r\n static create(options?: EdgeOptions): CleverenceEdge {\r\n return new CleverenceEdge(options);\r\n }\r\n\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n // Private methods\r\n // ─────────────────────────────────────────────────────────────────────────────\r\n\r\n private setupWebSocketHandlers(): void {\r\n this.ws.on('open', () => {\r\n this.emit('connect', undefined);\r\n // Fetch capabilities on connect\r\n this.getCapabilities()\r\n .then((caps) => {\r\n this._capabilities = caps;\r\n this.emit('capabilities', caps);\r\n })\r\n .catch(() => {});\r\n });\r\n\r\n this.ws.on('close', () => {\r\n this.emit('disconnect', undefined);\r\n });\r\n\r\n this.ws.on('error', (error) => {\r\n this.emit('error', error);\r\n });\r\n\r\n this.ws.on('statechange', (state) => {\r\n if (state === 'reconnecting') {\r\n this.emit('reconnecting', undefined);\r\n }\r\n });\r\n\r\n this.ws.on('message', (message) => {\r\n this.handleServerMessage(message);\r\n });\r\n }\r\n\r\n private handleServerMessage(message: ServerMessage): void {\r\n switch (message.type) {\r\n case 'event':\r\n this.handleEvent(message.event);\r\n break;\r\n case 'capabilities':\r\n this._capabilities = message.data;\r\n this.emit('capabilities', message.data);\r\n break;\r\n case 'error':\r\n this.emit('error', new Error(message.message));\r\n break;\r\n }\r\n }\r\n\r\n private handleEvent(event: ScanEvent | RfidEvent): void {\r\n // Parse timestamp if it's a string\r\n const parsedEvent = {\r\n ...event,\r\n timestamp: typeof event.timestamp === 'string' \r\n ? new Date(event.timestamp) \r\n : event.timestamp,\r\n };\r\n\r\n if (event.type === 'scan') {\r\n this.emit('scan', parsedEvent as ScanEvent);\r\n } else if (event.type === 'rfid') {\r\n this.emit('rfid', parsedEvent as RfidEvent);\r\n }\r\n }\r\n\r\n private ensureConnected(): void {\r\n if (!this.isConnected) {\r\n throw new Error('Not connected to Edge service. Call connect() first.');\r\n }\r\n }\r\n}\r\n"]}