taro-bluetooth-print 2.15.2 → 2.15.4

package/dist/types/config/PrinterConfigManager.d.ts

@@ -84,6 +84,40 @@ export interface GlobalConfig {
     /** Enable logging */
     enableLogging: boolean;
 }
+/**
+ * Schema version of the export format. Bump when {@link PrinterConfigSnapshot}
+ * adds/removes fields so old exports can be migrated.
+ */
+export declare const PRINTER_CONFIG_EXPORT_VERSION = 1;
+/**
+ * Versioned wrapper around the printer configuration export.
+ * Persist this verbatim (JSON.stringify / parse) for cross-device sync.
+ */
+export interface PrinterConfigSnapshot {
+    /** Schema version (always present). */
+    format: typeof PRINTER_CONFIG_EXPORT_VERSION;
+    /** Timestamp when the snapshot was exported (epoch ms). */
+    exportedAt: number;
+    /** Optional human-readable source identifier (e.g. "pos-terminal-01"). */
+    source?: string;
+    /** Saved printer configurations. */
+    printers: SavedPrinter[];
+    /** Global configuration overrides. */
+    globalConfig: GlobalConfig;
+    /** Last-used printer id (may be null if unset). */
+    lastUsedPrinterId: string | null;
+}
+/**
+ * Result of an import operation — distinguishes "nothing matched" from "rejected".
+ */
+export interface PrinterConfigImportResult {
+    /** Number of printers successfully loaded into the manager. */
+    imported: number;
+    /** Number of printer entries in the snapshot that were skipped (validation failure). */
+    skipped: number;
+    /** Detected snapshot format version. */
+    format: number;
+}
 /**
  * Configuration storage interface
  */
@@ -179,17 +213,34 @@ export declare class PrinterConfigManager {
      */
     loadPrinterConfig(printerId: string): PrintConfig;
     /**
-     * Export all configuration as JSON
+     * Export all configuration as a versioned JSON snapshot.
+     *
+     * The returned string can be persisted to disk, sent over the network, or
+     * shared across devices. Always re-import via {@link import} — never JSON.parse
+     * it yourself, as the snapshot wraps a versioned {@link PrinterConfigSnapshot}.
+     *
+     * @param source - Optional human-readable identifier (e.g. "pos-terminal-01")
+     *                 recorded in the snapshot for diagnostics.
+     * @returns Pretty-printed JSON string
      */
-    export(): string;
+    export(source?: string): string;
     /**
-     * Import configuration from JSON
+     * Import configuration from a versioned JSON snapshot produced by {@link export}.
+     *
+     * Behavior:
+     * - Throws `BluetoothPrintError(INVALID_CONFIGURATION)` on parse / schema failure.
+     * - When `merge === false` (default), existing printers are cleared first.
+     * - Printer entries that fail per-entry validation are skipped (counted in `skipped`).
+     * - Unknown / higher `format` versions throw rather than silently partial-load.
      *
-     * @param json - JSON string to import
-     * @param merge - If true, merge with existing config; if false, replace
-     * @returns Number of printers imported
+     * @param json - JSON string previously produced by `export()`.
+     * @param merge - When true, merge into existing config; when false (default), replace.
+     * @returns Import summary (imported count + skipped count + detected version).
+     * @throws BluetoothPrintError on malformed JSON, missing fields, or unsupported version.
      */
-    import(json: string, merge?: boolean): number;
+    import(json: string, merge?: boolean): PrinterConfigImportResult;
+    /** Lightweight per-entry validator for an imported printer. */
+    private isValidSavedPrinter;
     /**
      * Clear all configuration
      */

package/dist/types/core/BluetoothPrinter.d.ts

@@ -4,6 +4,17 @@ import { BluetoothPrintError } from '../errors/BaseError';
 import { IConnectionManager, IPrintJobManager, ICommandBuilder } from '../services/interfaces';
 import { TextAlign } from '../formatter';
 import { BarcodeFormat } from '../barcode';
+/** Payload for `job-completed` / `job-failed` events. */
+export interface JobResult {
+    /** Source of the completed job: `print` (CommandBuilder pipeline) or `writeRaw` (raw bytes). */
+    source: 'print' | 'writeRaw';
+    /** Total bytes transmitted to the printer. */
+    bytes: number;
+    /** Job end timestamp (epoch ms). */
+    completedAt: number;
+    /** Wall-clock duration of the job in ms (0 for synchronous completion). */
+    durationMs: number;
+}
 /** Printer event map. */
 export interface PrinterEvents {
     'state-change': PrinterState;
@@ -15,6 +26,12 @@ export interface PrinterEvents {
     connected: string;
     disconnected: string;
     'print-complete': void;
+    /** Emitted when a print/writeRaw job successfully completes all bytes. */
+    'job-completed': JobResult;
+    /** Emitted when a print/writeRaw job fails (immediately before re-throwing). */
+    'job-failed': JobResult & {
+        error: BluetoothPrintError;
+    };
 }
 /** Bluetooth Thermal Printer Controller. */
 export declare class BluetoothPrinter extends EventEmitter<PrinterEvents> {
@@ -41,6 +58,12 @@ export declare class BluetoothPrinter extends EventEmitter<PrinterEvents> {
      * Resolve the first constructor argument to an IConnectionManager. An adapter
      * (anything implementing `connect`/`disconnect`/`write`) gets auto-wrapped for
      * backward compatibility; missing/undefined falls back to a default manager.
+     *
+     * Disambiguation: `IConnectionManager` exposes `getState()` (manager-only
+     * method on the interface). Adapters only have `connect`/`disconnect`/`write`.
+     * Using `getState` as the discriminator correctly identifies a pre-built
+     * manager vs. a raw adapter — using `connect` (which both have) silently
+     * re-wrapped managers and broke isConnected() (v2.15.3 fix).
      */
     private resolveConnectionManager;
     /**
@@ -76,6 +99,37 @@ export declare class BluetoothPrinter extends EventEmitter<PrinterEvents> {
         showText?: boolean;
     }): this;
     setOptions(options: IAdapterOptions): this;
+    /**
+     * Write a pre-built byte buffer directly to the connected printer,
+     * bypassing the CommandBuilder entirely. Use this when a driver (such as
+     * TsplDriver, ZplDriver, StarPrinter, CPCL or any custom protocol) emits
+     * its own byte stream and you want the same connection / chunking /
+     * progress / pause pipeline as the standard print() path.
+     *
+     * Unlike print() — which calls commandBuilder.getBuffer() then clears it —
+     * writeRaw() does NOT touch the command queue. It is safe to call between
+     * text() / qr() / cut() calls; those calls continue to accumulate in the
+     * command buffer for the next print() invocation.
+     *
+     * @param buffer  Bytes to send (e.g. `tsplDriver.getBuffer()`)
+     * @param options Optional adapter overrides (chunkSize, delay, retries).
+     *                Forwarded to PrintJobManager.setOptions() before start.
+     * @throws BluetoothPrintError(CONNECTION_FAILED) if not connected
+     * @throws BluetoothPrintError(PRINT_JOB_FAILED) on adapter write failure
+     *
+     * @example
+     * ```ts
+     * // TSPL label printing — full end-to-end flow now works.
+     * const tspl = new TsplDriver()
+     *   .size(60, 40)
+     *   .gap(3)
+     *   .clear()
+     *   .text('Hello', { x: 20, y: 20, font: 3 })
+     *   .print(1, 1);
+     * await printer.writeRaw(tspl.getBuffer());
+     * ```
+     */
+    writeRaw(buffer: Uint8Array, options?: IAdapterOptions): Promise<void>;
     /**
      * Pauses the current print job.
      */

package/dist/types/encoding/GbkTable.d.ts

@@ -1,10 +1,19 @@
 /**
  * GBK Encoding Table - 懒加载版本
  *
- * 优化策略：
- * 1. 默认使用精简版编码表 (gbk-lite.ts，约 3500 常用字)
- * 2. 遇到非常用字时动态加载完整编码表
- * 3. 二分查找代替 Map，大幅减少内存占用
+ * 优化策略（v2.15.4 重新设计）：
+ * 1. 默认使用精简版编码表 (GbkLite.ts，约 106 个最常用汉字)
+ * 2. 命中精简表的字符直接返回（毫秒级）
+ * 3. 未命中时查完整表 (GbkData.ts)
+ * 4. GbkData 通过 vite manualChunks 拆成独立 chunk `chunks/gbk-data-*.js`
+ *    —— 在 dist 输出层面做到了代码分割，但运行时仍然同步可用
+ *
+ * 注意：dynamic import() 方案曾在 v2.15.4-dev 中尝试，但因为
+ * EncodingService.encode() / TemplateRenderer 都是同步 API，
+ * 切换到 dynamic 后会导致中文编码首次失败（'生产日期'/'谢谢惠顾'
+ * 这类字符不在 lite 表中）。v2.15.4-final 选择保留 static import
+ * 来换取 100% backward compat；异步 pre-warm 留给 v2.15.5+ 重构
+ * sync → async encoding API 时再启用。
  *
  * GBK: 23940 个字符映射
  * Big5: 13911 个字符映射
@@ -14,7 +23,7 @@ export declare const gbkToUnicode: Map<number, number>;
 export declare const unicodeToBig5: Map<number, number>;
 export declare const big5ToUnicode: Map<number, number>;
 /**
- * Get GBK bytes for a Unicode character
+ * Get GBK bytes for a Unicode character.
  * 先查精简表，查不到再懒加载完整表
  */
 export declare function getGbkBytes(unicode: number): [number, number] | null;

package/dist/types/index.d.ts

@@ -5,7 +5,7 @@
  * @packageDocumentation
  */
 export { BluetoothPrinter } from './core/BluetoothPrinter';
-export type { PrinterEvents } from './core/BluetoothPrinter';
+export type { PrinterEvents, JobResult } from './core/BluetoothPrinter';
 export { EventEmitter } from './core/EventEmitter';
 export * from './drivers';
 export { TaroAdapter } from './adapters/TaroAdapter';
@@ -49,8 +49,8 @@ export { CommandBuildError, CommandBuildErrorCode } from './errors/CommandBuildE
 export { createBluetoothPrinter, createWebBluetoothPrinter, PrinterFactory, type PrinterFactoryOptions, } from './factory';
 export { DEFAULT_CONFIG, mergeConfig } from './config/PrinterConfig';
 export type { PrinterConfig, AdapterConfig, DriverConfig, LoggingConfig, } from './config/PrinterConfig';
-export { PrinterConfigManager, printerConfigManager } from './config/PrinterConfigManager';
-export type { SavedPrinter, GlobalConfig, IConfigStorage } from './config/PrinterConfigManager';
+export { PrinterConfigManager, printerConfigManager, PRINTER_CONFIG_EXPORT_VERSION, LocalStorage, } from './config/PrinterConfigManager';
+export type { SavedPrinter, GlobalConfig, IConfigStorage, PrintConfig, PrinterConfigSnapshot, PrinterConfigImportResult, } from './config/PrinterConfigManager';
 export { createLoggingPlugin, createRetryPlugin } from './plugins';
 export type { Plugin, PluginHooks, PluginOptions, PluginFactory } from './plugins/PluginTypes';
 export * from './types';

package/dist/types/plugins/builtin/RetryPlugin.d.ts

@@ -1,5 +1,16 @@
 import { PluginFactory, PluginOptions } from '../PluginTypes';
-import { ErrorCode } from '../../errors/BaseError';
+import { BluetoothPrintError, ErrorCode } from '../../errors/BaseError';
+/** Payload passed to the onRetry callback for each retry attempt. */
+export interface RetryAttempt {
+    /** 1-indexed attempt number (1 = first retry after the initial failure). */
+    attempt: number;
+    /** Maximum retries allowed. */
+    maxRetries: number;
+    /** Delay in ms before this retry will be scheduled to run. */
+    delayMs: number;
+    /** The error that triggered this retry. */
+    error: BluetoothPrintError;
+}
 export interface RetryPluginOptions extends PluginOptions {
     /** Maximum retry attempts (default: 3) */
     maxRetries?: number;
@@ -11,6 +22,13 @@ export interface RetryPluginOptions extends PluginOptions {
     backoffMultiplier?: number;
     /** Error codes that should trigger retry */
     retryableErrors?: ErrorCode[];
+    /**
+     * Optional callback invoked BEFORE sleeping for each retry attempt.
+     * Receives the 1-indexed attempt number, the planned delay, and the
+     * triggering error. Use this for surfacing retry state to UIs (toast
+     * "Reconnecting (2/3)…") or for telemetry.
+     */
+    onRetry?: (info: RetryAttempt) => void;
 }
 /**
  * Creates a retry plugin instance

package/dist/types/plugins/index.d.ts

@@ -5,3 +5,4 @@ export { PluginManager } from './PluginManager';
 export type { Plugin, PluginHooks, PluginOptions, PluginFactory } from './PluginTypes';
 export { createLoggingPlugin } from './builtin/LoggingPlugin';
 export { createRetryPlugin } from './builtin/RetryPlugin';
+export type { RetryPluginOptions, RetryAttempt } from './builtin/RetryPlugin';

package/dist/types/services/BatchPrintManager.d.ts

@@ -1,3 +1,4 @@
+import { BluetoothPrintError } from '../errors/BaseError';
 import { EventEmitter } from '../core/EventEmitter';
 /**
  * Batch job entry
@@ -76,6 +77,23 @@ export interface BatchEvents {
         toCount: number;
         savedBytes: number;
     };
+    /** Per-job progress while the batch processor is running. */
+    'batch-progress': {
+        /** Number of bytes the processor has accepted so far (caller-reported). */
+        sent: number;
+        /** Total bytes the processor was asked to handle for this batch. */
+        total: number;
+        /** Job IDs in the current batch. */
+        jobIds: string[];
+    };
+    /** Emitted when the batch processor throws — the entire batch is marked failed. */
+    'batch-failed': {
+        jobIds: string[];
+        bytes: number;
+        error: BluetoothPrintError;
+    };
+    /** Emitted when a previously-failed job is re-queued via retryJob(). */
+    'job-retried': BatchJob;
 }
 /**
  * Batch Print Manager
@@ -102,6 +120,8 @@ export declare class BatchPrintManager extends EventEmitter<BatchEvents> {
     private flushFired;
     private pendingBytes;
     private stats;
+    /** Jobs from the most recent failed batch. Cleared on next successful processBatch(). */
+    private failedJobs;
     /**
      * Last job timestamp for interval timeout tracking
      */
@@ -168,10 +188,36 @@ export declare class BatchPrintManager extends EventEmitter<BatchEvents> {
     /**
      * Process the current batch
      *
-     * @param processor - Function to send batch data to printer
+     * @param processor - Function to send batch data to printer. May return a
+     *                    promise that resolves with the number of bytes sent, or
+     *                    void if the byte count is unknown.
      * @returns Number of jobs processed
      */
-    processBatch(processor: (data: Uint8Array) => Promise<void>): Promise<number>;
+    processBatch(processor: (data: Uint8Array) => Promise<void | number>): Promise<number>;
+    /**
+     * Re-queue a previously-failed job.
+     *
+     * Searches `failedJobs` for the given id; if found, re-inserts the job at the
+     * front of the queue with bumped priority (current max + 1) so it is processed
+     * before other pending jobs. Returns false if no failed job matches.
+     *
+     * Does NOT auto-trigger processBatch — caller decides when to retry.
+     *
+     * @param id - Job ID returned from a prior addJob() call.
+     * @returns true if re-queued, false if no matching failed job.
+     */
+    retryJob(id: string): boolean;
+    /**
+     * Re-queue ALL currently-failed jobs in one call. Returns the count re-queued.
+     */
+    retryAllFailedJobs(): number;
+    /**
+     * Snapshot of the most recent failed batch (empty if last batch succeeded
+     * or no batch has run yet).
+     */
+    getFailedJobs(): BatchJob[];
+    /** Discard the failed-jobs buffer without re-queueing. */
+    clearFailedJobs(): void;
     /**
      * Prepare batch from pending jobs
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taro-bluetooth-print",
-  "version": "2.15.2",
+  "version": "2.15.4",
   "description": "Taro 蓝牙打印库 v2.6 - 轻量级、高性能、跨平台支持微信、支付宝、百度、字节跳动小程序及H5 Web Bluetooth",
   "type": "module",
   "main": "dist/index.cjs.js",
@@ -10,8 +10,7 @@
     ".": {
       "types": "./dist/types/index.d.ts",
       "import": "./dist/index.es.js",
-      "require": "./dist/index.cjs.js",
-      "default": "./dist/index.umd.js"
+      "require": "./dist/index.cjs.js"
     },
     "./core": {
       "types": "./dist/types/core/index.d.ts",
@@ -25,6 +24,10 @@
       "types": "./dist/types/adapters/index.d.ts",
       "import": "./dist/adapters/index.es.js"
     },
+    "./encoding": {
+      "types": "./dist/types/encoding/index.d.ts",
+      "import": "./dist/encoding/index.es.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -36,6 +39,7 @@
   "scripts": {
     "clean": "rimraf dist docs/.vitepress/dist",
     "build": "vite build",
+    "build:umd": "vite build --config vite.umd.config.ts",
     "dev": "vite build --watch",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",

package/src/config/PrinterConfigManager.ts

@@ -91,6 +91,43 @@ export interface GlobalConfig {
   enableLogging: boolean;
 }
 
+/**
+ * Schema version of the export format. Bump when {@link PrinterConfigSnapshot}
+ * adds/removes fields so old exports can be migrated.
+ */
+export const PRINTER_CONFIG_EXPORT_VERSION = 1;
+
+/**
+ * Versioned wrapper around the printer configuration export.
+ * Persist this verbatim (JSON.stringify / parse) for cross-device sync.
+ */
+export interface PrinterConfigSnapshot {
+  /** Schema version (always present). */
+  format: typeof PRINTER_CONFIG_EXPORT_VERSION;
+  /** Timestamp when the snapshot was exported (epoch ms). */
+  exportedAt: number;
+  /** Optional human-readable source identifier (e.g. "pos-terminal-01"). */
+  source?: string;
+  /** Saved printer configurations. */
+  printers: SavedPrinter[];
+  /** Global configuration overrides. */
+  globalConfig: GlobalConfig;
+  /** Last-used printer id (may be null if unset). */
+  lastUsedPrinterId: string | null;
+}
+
+/**
+ * Result of an import operation — distinguishes "nothing matched" from "rejected".
+ */
+export interface PrinterConfigImportResult {
+  /** Number of printers successfully loaded into the manager. */
+  imported: number;
+  /** Number of printer entries in the snapshot that were skipped (validation failure). */
+  skipped: number;
+  /** Detected snapshot format version. */
+  format: number;
+}
+
 /**
  * Configuration storage interface
  */
@@ -424,67 +461,135 @@ export class PrinterConfigManager {
   }
 
   /**
-   * Export all configuration as JSON
+   * Export all configuration as a versioned JSON snapshot.
+   *
+   * The returned string can be persisted to disk, sent over the network, or
+   * shared across devices. Always re-import via {@link import} — never JSON.parse
+   * it yourself, as the snapshot wraps a versioned {@link PrinterConfigSnapshot}.
+   *
+   * @param source - Optional human-readable identifier (e.g. "pos-terminal-01")
+   *                 recorded in the snapshot for diagnostics.
+   * @returns Pretty-printed JSON string
    */
-  export(): string {
-    return JSON.stringify(
-      {
-        printers: Array.from(this.printers.values()),
-        globalConfig: this.globalConfig,
-        lastUsedPrinterId: this.lastUsedPrinterId,
-        exportedAt: Date.now(),
-      },
-      null,
-      2
-    );
+  export(source?: string): string {
+    const snapshot: PrinterConfigSnapshot = {
+      format: PRINTER_CONFIG_EXPORT_VERSION,
+      exportedAt: Date.now(),
+      source,
+      printers: Array.from(this.printers.values()),
+      globalConfig: this.globalConfig,
+      lastUsedPrinterId: this.lastUsedPrinterId,
+    };
+    return JSON.stringify(snapshot, null, 2);
   }
 
   /**
-   * Import configuration from JSON
+   * Import configuration from a versioned JSON snapshot produced by {@link export}.
    *
-   * @param json - JSON string to import
-   * @param merge - If true, merge with existing config; if false, replace
-   * @returns Number of printers imported
+   * Behavior:
+   * - Throws `BluetoothPrintError(INVALID_CONFIGURATION)` on parse / schema failure.
+   * - When `merge === false` (default), existing printers are cleared first.
+   * - Printer entries that fail per-entry validation are skipped (counted in `skipped`).
+   * - Unknown / higher `format` versions throw rather than silently partial-load.
+   *
+   * @param json - JSON string previously produced by `export()`.
+   * @param merge - When true, merge into existing config; when false (default), replace.
+   * @returns Import summary (imported count + skipped count + detected version).
+   * @throws BluetoothPrintError on malformed JSON, missing fields, or unsupported version.
    */
-  import(json: string, merge = false): number {
+  import(json: string, merge = false): PrinterConfigImportResult {
+    if (typeof json !== 'string' || json.length === 0) {
+      throw new BluetoothPrintError(
+        ErrorCode.INVALID_CONFIGURATION,
+        'import() requires a non-empty JSON string'
+      );
+    }
+
+    let parsed: unknown;
     try {
-      const data = JSON.parse(json) as {
-        printers?: SavedPrinter[];
-        globalConfig?: GlobalConfig;
-        lastUsedPrinterId?: string;
-      };
+      parsed = JSON.parse(json);
+    } catch (err) {
+      throw new BluetoothPrintError(
+        ErrorCode.INVALID_CONFIGURATION,
+        `Failed to parse JSON: ${(err as Error).message}`
+      );
+    }
+
+    if (!parsed || typeof parsed !== 'object') {
+      throw new BluetoothPrintError(
+        ErrorCode.INVALID_CONFIGURATION,
+        'Snapshot root must be a JSON object'
+      );
+    }
 
-      let imported = 0;
+    const data = parsed as Partial<PrinterConfigSnapshot>;
 
-      if (!merge) {
-        this.printers.clear();
-      }
+    if (typeof data.format !== 'number') {
+      throw new BluetoothPrintError(
+        ErrorCode.INVALID_CONFIGURATION,
+        'Snapshot is missing required field: format'
+      );
+    }
+    if (data.format > PRINTER_CONFIG_EXPORT_VERSION) {
+      throw new BluetoothPrintError(
+        ErrorCode.INVALID_CONFIGURATION,
+        `Snapshot format ${data.format} is newer than supported version ${PRINTER_CONFIG_EXPORT_VERSION}. Please upgrade the library.`
+      );
+    }
+
+    if (!merge) {
+      this.printers.clear();
+    }
 
-      if (data.printers && Array.isArray(data.printers)) {
-        for (const printer of data.printers) {
-          if (printer.id) {
-            this.printers.set(printer.id, printer);
-            imported++;
-          }
+    let imported = 0;
+    let skipped = 0;
+    if (Array.isArray(data.printers)) {
+      for (const candidate of data.printers) {
+        if (this.isValidSavedPrinter(candidate)) {
+          this.printers.set(candidate.id, candidate);
+          imported++;
+        } else {
+          skipped++;
+          this.logger.warn(
+            `Skipped invalid printer entry during import: ${JSON.stringify(candidate).slice(0, 80)}`
+          );
         }
       }
+    }
 
-      if (data.globalConfig) {
-        this.globalConfig = { ...DEFAULT_GLOBAL_CONFIG, ...data.globalConfig };
-      }
+    if (data.globalConfig && typeof data.globalConfig === 'object') {
+      this.globalConfig = { ...DEFAULT_GLOBAL_CONFIG, ...data.globalConfig };
+    }
 
-      if (data.lastUsedPrinterId && this.printers.has(data.lastUsedPrinterId)) {
-        this.lastUsedPrinterId = data.lastUsedPrinterId;
-      }
+    if (
+      typeof data.lastUsedPrinterId === 'string' &&
+      data.lastUsedPrinterId.length > 0 &&
+      this.printers.has(data.lastUsedPrinterId)
+    ) {
+      this.lastUsedPrinterId = data.lastUsedPrinterId;
+    }
 
-      this.save();
-      this.logger.info(`Imported ${imported} printers`);
+    this.save();
+    this.logger.info(
+      `Imported ${imported} printer(s) (skipped ${skipped}) from format v${data.format}`
+    );
 
-      return imported;
-    } catch (error) {
-      this.logger.error('Failed to import configuration:', error);
-      return 0;
-    }
+    return { imported, skipped, format: data.format };
+  }
+
+  /** Lightweight per-entry validator for an imported printer. */
+  private isValidSavedPrinter(p: unknown): p is SavedPrinter {
+    if (!p || typeof p !== 'object') return false;
+    const r = p as Record<string, unknown>;
+    return (
+      typeof r.id === 'string' &&
+      r.id.length > 0 &&
+      typeof r.deviceId === 'string' &&
+      r.deviceId.length > 0 &&
+      typeof r.name === 'string' &&
+      typeof r.createdAt === 'number' &&
+      typeof r.updatedAt === 'number'
+    );
   }
 
   /**