@ukeyfe/hardware-core 1.1.24 → 1.1.26

package/src/utils/tracing.ts

@@ -0,0 +1,238 @@
+/**
+ * SDK Tracing Utilities
+ * Tracks object instances and request call chains across multiple SDK instances
+ */
+
+import { LoggerNames, getLogger } from './logger';
+
+// Global counters (cross-SDK instances)
+
+const Log = getLogger(LoggerNames.Core);
+
+let globalInstanceCounter = 0;
+let sdkInstanceCounter = 0;
+
+/**
+ * Generate SDK instance ID
+ * @returns Format: "SDK-<number>-<timestamp>"
+ * @example "SDK-1-123456"
+ */
+export function generateSdkInstanceId(): string {
+  sdkInstanceCounter++;
+  const timestamp = Date.now().toString().slice(-6);
+  return `SDK-${sdkInstanceCounter}-${timestamp}`;
+}
+
+/**
+ * Generate globally unique instance ID
+ * @param type Instance type (Device, DeviceCommands, BaseMethod, etc.)
+ * @param sdkInstanceId SDK instance ID (optional)
+ * @returns Format: <SDK>.<type>-<number>-<timestamp>
+ * @example "SDK-1.Device-1-123456" or "Device-1-123456"
+ */
+export function generateInstanceId(type: string, sdkInstanceId?: string): string {
+  globalInstanceCounter++;
+  const timestamp = Date.now().toString().slice(-6);
+  const baseId = `${type}-${globalInstanceCounter}-${timestamp}`;
+  return sdkInstanceId ? `${sdkInstanceId}.${baseId}` : baseId;
+}
+
+// Request context management
+
+/**
+ * Request context information
+ */
+export interface RequestContext {
+  /** Request unique ID (reuses BaseMethod.responseID) */
+  responseID: number;
+  /** SDK instance ID */
+  sdkInstanceId?: string;
+  /** API method name */
+  methodName: string;
+  /** Device connection ID */
+  connectId?: string;
+  /** Device instance ID */
+  deviceInstanceId?: string;
+  /** DeviceCommands instance ID */
+  commandsInstanceId?: string;
+  /** Parent request ID (for nested calls like allNetworkGetAddress) */
+  parentResponseID?: number;
+  /** Request start time */
+  startTime: number;
+  /** Request end time */
+  endTime?: number;
+  /** Request status */
+  status?: 'pending' | 'running' | 'success' | 'error' | 'cancelled';
+  /** Error message */
+  error?: string;
+}
+
+/**
+ * SDK instance tracing context
+ */
+export interface SdkTracingContext {
+  /** SDK instance ID */
+  sdkInstanceId: string;
+  /** Creation timestamp */
+  createdAt: number;
+  /** Active requests */
+  activeRequests: Map<number, RequestContext>;
+}
+
+// Global SDK instance tracking map
+const sdkInstances = new Map<string, SdkTracingContext>();
+
+// Global request map (cross-SDK instances for quick lookup)
+const globalActiveRequests = new Map<number, RequestContext>();
+
+/**
+ * Create SDK instance tracing context
+ */
+export function createSdkTracingContext(): SdkTracingContext {
+  const sdkInstanceId = generateSdkInstanceId();
+  const context: SdkTracingContext = {
+    sdkInstanceId,
+    createdAt: Date.now(),
+    activeRequests: new Map(),
+  };
+
+  sdkInstances.set(sdkInstanceId, context);
+
+  return context;
+}
+
+/**
+ * Create and register request context
+ * @param responseID Request ID (reuses BaseMethod.responseID)
+ * @param methodName API method name
+ * @param options Additional options
+ */
+export function createRequestContext(
+  responseID: number,
+  methodName: string,
+  options?: {
+    sdkInstanceId?: string;
+    connectId?: string;
+    deviceInstanceId?: string;
+    commandsInstanceId?: string;
+    parentResponseID?: number;
+  }
+): RequestContext {
+  const context: RequestContext = {
+    responseID,
+    sdkInstanceId: options?.sdkInstanceId,
+    methodName,
+    connectId: options?.connectId,
+    deviceInstanceId: options?.deviceInstanceId,
+    commandsInstanceId: options?.commandsInstanceId,
+    parentResponseID: options?.parentResponseID,
+    startTime: Date.now(),
+    status: 'pending',
+  };
+
+  // Register to global map
+  globalActiveRequests.set(context.responseID, context);
+
+  // Register to SDK instance map
+  if (options?.sdkInstanceId) {
+    const sdkContext = sdkInstances.get(options.sdkInstanceId);
+    if (sdkContext) {
+      sdkContext.activeRequests.set(context.responseID, context);
+    }
+  }
+
+  return context;
+}
+
+/**
+ * Update request context
+ */
+export function updateRequestContext(responseID: number, updates: Partial<RequestContext>): void {
+  const context = globalActiveRequests.get(responseID);
+  if (context) {
+    Object.assign(context, updates);
+  }
+}
+
+/**
+ * Complete request context
+ */
+export function completeRequestContext(responseID: number, error?: Error): void {
+  const context = globalActiveRequests.get(responseID);
+  if (context) {
+    context.endTime = Date.now();
+    context.status = error ? 'error' : 'success';
+    if (error) {
+      context.error = error.message;
+      Log.error(
+        `[RequestContext] [completeRequestContext] Error: ${formatRequestContext(context)}`
+      );
+    }
+
+    // Remove from active list
+    globalActiveRequests.delete(responseID);
+
+    // Remove from SDK instance
+    if (context.sdkInstanceId) {
+      const sdkContext = sdkInstances.get(context.sdkInstanceId);
+      if (sdkContext) {
+        sdkContext.activeRequests.delete(responseID);
+      }
+    }
+  }
+}
+
+// Query API
+
+/**
+ * Get active requests for specific Device instance
+ */
+export function getActiveRequestsByDeviceInstance(deviceInstanceId: string): RequestContext[] {
+  return Array.from(globalActiveRequests.values()).filter(
+    ctx => ctx.deviceInstanceId === deviceInstanceId
+  );
+}
+
+// Format output
+
+/**
+ * Format request context for logging
+ */
+export function formatRequestContext(context: RequestContext): string {
+  const duration = context.endTime
+    ? context.endTime - context.startTime
+    : Date.now() - context.startTime;
+
+  const parts = [
+    `[req:${context.responseID}]`,
+    context.sdkInstanceId ? `sdk=${context.sdkInstanceId}` : null,
+    `method=${context.methodName}`,
+    context.connectId ? `connectId=${context.connectId}` : null,
+    context.deviceInstanceId ? `deviceInst=${context.deviceInstanceId}` : null,
+    context.commandsInstanceId ? `commandsInst=${context.commandsInstanceId}` : null,
+    context.parentResponseID ? `parent=${context.parentResponseID}` : null,
+    `duration=${duration}ms`,
+    `status=${context.status}`,
+    `error=${context.error}`,
+  ].filter(Boolean);
+
+  return parts.join(' ');
+}
+
+// Cleanup and reset
+
+/**
+ * Cleanup specific SDK instance
+ */
+export function cleanupSdkInstance(sdkInstanceId: string): void {
+  const sdkContext = sdkInstances.get(sdkInstanceId);
+  if (sdkContext) {
+    // Remove SDK requests from global active requests
+    for (const responseID of sdkContext.activeRequests.keys()) {
+      globalActiveRequests.delete(responseID);
+    }
+
+    // Remove SDK instance
+    sdkInstances.delete(sdkInstanceId);
+  }
+}

package/dist/api/EmmcFileWrite.d.ts

@@ -1,13 +0,0 @@
-import { FirmwareUpdateBaseMethod } from './firmware/FirmwareUpdateBaseMethod';
-import type { PROTO } from '../constants';
-type EmmcFileWriteParams = PROTO.FirmwareUpload & {
-    filePath: string;
-};
-export default class EmmcFileWrite extends FirmwareUpdateBaseMethod<EmmcFileWriteParams> {
-    init(): void;
-    run(): Promise<{
-        filePath: string;
-    }>;
-}
-export {};
-//# sourceMappingURL=EmmcFileWrite.d.ts.map

package/dist/api/EmmcFileWrite.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EmmcFileWrite.d.ts","sourceRoot":"","sources":["../../src/api/EmmcFileWrite.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAM1C,KAAK,mBAAmB,GAAG,KAAK,CAAC,cAAc,GAAG;IAEhD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,wBAAwB,CAAC,mBAAmB,CAAC;IACtF,IAAI;IAiBE,GAAG;;;CAeV"}

package/dist/types/api/emmcFileWrite.d.ts

@@ -1,8 +0,0 @@
-import type { Params, Response } from '../params';
-export interface EmmcFileWriteParams {
-    payload: ArrayBuffer;
-    filePath: string;
-    hash?: string;
-}
-export declare function emmcFileWrite(connectId: string | undefined, params: Params<EmmcFileWriteParams>): Response<number>;
-//# sourceMappingURL=emmcFileWrite.d.ts.map

package/dist/types/api/emmcFileWrite.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emmcFileWrite.d.ts","sourceRoot":"","sources":["../../../src/types/api/emmcFileWrite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,CAAC,OAAO,UAAU,aAAa,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,MAAM,CAAC,mBAAmB,CAAC,GAClC,QAAQ,CAAC,MAAM,CAAC,CAAC"}

package/src/api/EmmcFileWrite.ts

@@ -1,49 +0,0 @@
-import { RebootType } from '@ukeyfe/hardware-transport';
-import { validateParams } from './helpers/paramsValidator';
-import { UI_REQUEST } from '../events/ui-request';
-import { FirmwareUpdateBaseMethod } from './firmware/FirmwareUpdateBaseMethod';
-import type { PROTO } from '../constants';
-
-/**
- * 简单封装的 EMMC 文件写入方法
- * - 仅调用 emmcCommonUpdateProcess，将指定二进制内容写入到给定 emmc 路径
- */
-type EmmcFileWriteParams = PROTO.FirmwareUpload & {
-  /** 目标写入路径（需以 `0:` 开头，例如 `0:updates/firmware.bin`） */
-  filePath: string;
-};
-
-export default class EmmcFileWrite extends FirmwareUpdateBaseMethod<EmmcFileWriteParams> {
-  init() {
-    const { payload } = this;
-    // 仅做基本参数校验，不引入任何接口条件判断
-    validateParams(payload, [
-      { name: 'payload', type: 'buffer', required: true },
-      { name: 'filePath', type: 'string', required: true },
-    ]);
-
-    this.allowDeviceMode = [UI_REQUEST.BOOTLOADER, UI_REQUEST.NOT_INITIALIZE];
-    this.useDevicePassphraseState = false;
-
-    this.params = {
-      payload: payload.payload,
-      filePath: payload.filePath,
-    };
-  }
-
-  async run() {
-    const { payload, filePath } = this.params;
-    await this.enterBootloaderMode();
-    await this.emmcCommonUpdateProcess({ payload, filePath });
-    // 写入完成后执行正常重启
-    try {
-      await this.reboot(RebootType.Normal);
-    } catch (e) {
-      // 重启失败不影响写入结果，保守记录但不抛出
-    }
-
-    return {
-      filePath,
-    };
-  }
-}

package/src/types/api/emmcFileWrite.ts

@@ -1,12 +0,0 @@
-import type { Params, Response } from '../params';
-
-export interface EmmcFileWriteParams {
-  payload: ArrayBuffer;
-  filePath: string; // e.g. '0:boot/bootloader.bin'
-  hash?: string;
-}
-
-export declare function emmcFileWrite(
-  connectId: string | undefined,
-  params: Params<EmmcFileWriteParams>
-): Response<number>;