@ukeyfe/hardware-transport-electron 1.1.13

package/src/types/desktop-api.ts

@@ -0,0 +1,28 @@
+/**
+ * Desktop API types for Electron preload script
+ * These types define the core interface for Noble BLE communication
+ */
+
+// Noble BLE API interface - core BLE functionality
+export interface NobleBleAPI {
+  enumerate: () => Promise<{ id: string; name: string }[]>;
+  getDevice: (uuid: string) => Promise<{ id: string; name: string } | null>;
+  connect: (uuid: string) => Promise<void>;
+  disconnect: (uuid: string) => Promise<void>;
+  subscribe: (uuid: string) => Promise<void>;
+  unsubscribe: (uuid: string) => Promise<void>;
+  write: (uuid: string, data: string) => Promise<void>;
+  onNotification: (callback: (deviceId: string, data: string) => void) => () => void;
+  onDeviceDisconnected: (callback: (device: { id: string; name: string }) => void) => () => void;
+  checkAvailability: () => Promise<{
+    available: boolean;
+    state: string;
+    unsupported: boolean;
+    initialized: boolean;
+  }>;
+}
+
+// Base Desktop API interface - contains only Noble BLE functionality
+export interface DesktopAPI {
+  nobleBle?: NobleBleAPI;
+}

package/src/types/index.ts

@@ -0,0 +1,2 @@
+// Export only type definitions to avoid bundling Noble into renderer process
+export type { DeviceInfo, CharacteristicPair, NobleModule, Logger } from './noble-extended';

package/src/types/noble-extended.ts

@@ -0,0 +1,55 @@
+/*
+ * Extended type definitions for Noble BLE
+ * Supplements @types/noble with additional interfaces
+ */
+
+import type { Peripheral, Characteristic } from '@stoprocent/noble';
+
+// Device info interface for our API
+export interface DeviceInfo {
+  id: string;
+  name: string;
+  state: string;
+}
+
+// Characteristic pair interface
+export interface CharacteristicPair {
+  write: Characteristic;
+  notify: Characteristic;
+}
+
+// Noble module interface for dynamic import
+export interface NobleModule {
+  state: string;
+  startScanning(
+    serviceUUIDs: string[],
+    allowDuplicates: boolean,
+    callback?: (error?: Error) => void
+  ): void;
+  stopScanning(callback?: () => void): void;
+  on(event: 'stateChange', listener: (state: string) => void): void;
+  on(event: 'discover', listener: (peripheral: Peripheral) => void): void;
+  removeListener(event: 'stateChange', listener: (state: string) => void): void;
+  removeListener(event: 'discover', listener: (peripheral: Peripheral) => void): void;
+}
+
+// Logger interface
+export interface Logger {
+  info(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+}
+
+// Safe logger utility
+export function safeLog(
+  logger: Logger | null,
+  level: 'info' | 'debug' | 'error',
+  message: string,
+  ...args: any[]
+): void {
+  if (logger) {
+    logger[level](message, ...args);
+  } else {
+    console[level](`[NobleBLE] ${message}`, ...args);
+  }
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.lib.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "types": [
+      "node",
+      "web-bluetooth"
+    ]
+  },
+  "include": ["./src"]
+}