@wdywdy/electric-open-platform 0.0.0-stage → 1.0.0

package/dist/esm/core/errors.js

@@ -0,0 +1,108 @@
+/**
+ * Error model for the Mtsci (snd02) open platform.
+ *
+ * Every failure — transport, OAuth or business return code — surfaces as an
+ * `ElectricOpenPlatformError` so callers can branch on `code` instead of
+ * parsing `message` strings.
+ */
+export const PlatformCodes = {
+    OK: '0',
+    NOT_LOGGED_IN: '-1',
+    FAILED: '1',
+    TOKEN_EXPIRED: '2',
+    BOX_OFFLINE: '1001',
+    ILLEGAL_PARAM: '1002',
+    ILLEGAL_OWNERSHIP: '1003',
+    REMOTE_CONTROL_FORBIDDEN: '1004',
+    INCOMPLETE_PROPERTY: '1005',
+    VERIFY_FAILED: '1006',
+    ALREADY_EXISTS: '1007',
+    NOT_FOUND: '1008',
+    OVER_LIMIT: '1009',
+    DUPLICATE_OPERATION: '1010',
+};
+const CODE_MESSAGES = {
+    '-1': '未登录或会话已过期',
+    '1': '接口调用失败',
+    '2': 'accessToken 已过期',
+    '1001': '设备不在线',
+    '1002': '不合法的参数',
+    '1003': '不合法的归属',
+    '1004': '不允许远程控制',
+    '1005': '不完整的设备属性',
+    '1006': '校验失败（例如密码错误）',
+    '1007': '资源已存在',
+    '1008': '相关资源不存在',
+    '1009': '资源超过最大限制',
+    '1010': '不能重复操作',
+};
+/** Failure classes that never come from the platform itself. */
+export const TransportCodes = {
+    /** The device could not reach the server at all. */
+    NETWORK: 'E_NETWORK',
+    /** The server answered with a non-2xx status. */
+    HTTP: 'E_HTTP',
+    /** Response body was not the expected JSON envelope. */
+    PARSE: 'E_PARSE',
+    /** The plugin was used before `configure()` / `login()`. */
+    NOT_CONFIGURED: 'E_NOT_CONFIGURED',
+    /** Local guard rail rejected the call before hitting the network. */
+    INVALID_ARGUMENT: 'E_INVALID_ARGUMENT',
+    /** OAuth handshake (authverify2 / token / refresh) failed. */
+    OAUTH: 'E_OAUTH',
+    /** Daily per-interface quota exhausted (platform rejects with "限额"). */
+    QUOTA: 'E_QUOTA',
+    /**
+     * The method exists but this appKey is not authorized for it.
+     *
+     * The platform reports unprovisioned methods in two misleading ways:
+     *  - `接口名称(X)无效！`
+     *  - `无效的接口方法参数签名！` — which looks like a signing bug but, verified
+     *    against the live server, is what you get for a method that is not
+     *    enabled for the key. Only treat it as this code when the same key's
+     *    other calls succeed, which the client knows.
+     */
+    NOT_PROVISIONED: 'E_NOT_PROVISIONED',
+    /** The call was aborted by the caller (AbortSignal). */
+    ABORTED: 'E_ABORTED',
+};
+export class ElectricOpenPlatformError extends Error {
+    constructor(code, message, options = {}) {
+        super(message || CODE_MESSAGES[code] || `调用失败 (code=${code})`);
+        this.name = 'ElectricOpenPlatformError';
+        this.code = code;
+        this.method = options.method;
+        this.details = options.details;
+        this.httpStatus = options.httpStatus;
+        if (options.cause !== undefined)
+            this.cause = options.cause;
+    }
+    /** True when the platform says the access token must be renewed. */
+    get isTokenExpired() {
+        return this.code === PlatformCodes.TOKEN_EXPIRED || this.code === PlatformCodes.NOT_LOGGED_IN;
+    }
+    /** True when a retry after a short delay is likely to succeed. */
+    get isRetryable() {
+        return (this.code === TransportCodes.NETWORK ||
+            this.code === PlatformCodes.BOX_OFFLINE ||
+            (this.httpStatus !== undefined && this.httpStatus >= 500));
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            method: this.method,
+            httpStatus: this.httpStatus,
+            details: this.details,
+        };
+    }
+}
+export function isElectricOpenPlatformError(e) {
+    return e instanceof ElectricOpenPlatformError;
+}
+/** Human readable Chinese description for a platform code. */
+export function describeCode(code) {
+    return CODE_MESSAGES[String(code)] || `未知返回码 (${code})`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/core/errors.js.map

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

package/dist/esm/core/http.d.ts

@@ -0,0 +1,24 @@
+import { HttpRequest, HttpResponse, Transport } from './transport.js';
+export type { HttpRequest, HttpResponse, Transport } from './transport.js';
+export { parseBody, assertHttpOk, DEFAULT_TIMEOUT_MS } from './transport.js';
+export { createFetchTransport } from './transport-fetch.js';
+/** 当前实际使用的传输实现名称，供诊断使用。 */
+export declare function currentTransportName(): string;
+/** 当前传输实现的引用。 */
+export declare function currentTransport(): Transport;
+/** 调用方是否显式设置过传输实现。 */
+export declare function hasExplicitTransport(): boolean;
+/** 替换传输实现（插件在 configure 时按 config.transport / 已注入的实现决定）。 */
+export declare function setTransport(transport: Transport): void;
+/** 恢复默认的 fetch 实现（测试用）。 */
+export declare function resetTransport(): void;
+/**
+ * 按优先级挑选传输实现：
+ * `config.transport`（最高）> configure() 之前 setTransport 注入的实现 > 内置 fetch。
+ *
+ * 这里**不做任何宿主探测**：同一个包在 Node、浏览器、Electron 里行为一致，
+ * 差异只来自使用方显式注入的实现。
+ */
+export declare function resolveTransport(explicitTransport?: Transport, preset?: Transport): Transport;
+/** 用当前传输发送一次 form-urlencoded POST。 */
+export declare function postForm(req: HttpRequest): Promise<HttpResponse>;

package/dist/esm/core/http.js

@@ -0,0 +1,56 @@
+/**
+ * 当前传输实现的注册表 + `postForm` 兼容入口。
+ *
+ * 历史上所有调用都走 `postForm`，现在它转发到「当前选定的 Transport」。
+ * 这样：
+ *  - 既有调用点与测试无需改动；
+ *  - 传输实现由使用方通过 `config.transport` / `setTransport()` 注入；
+ *  - 未注入时一律用内置 `fetch`，不按宿主环境猜。
+ */
+import { ElectricOpenPlatformError, TransportCodes } from './errors.js';
+import { createFetchTransport } from './transport-fetch.js';
+export { parseBody, assertHttpOk, DEFAULT_TIMEOUT_MS } from './transport.js';
+export { createFetchTransport } from './transport-fetch.js';
+let current = createFetchTransport();
+/** 是否由调用方显式 setTransport 指定过（区别于默认的 fetch）。 */
+let explicit = false;
+/** 当前实际使用的传输实现名称，供诊断使用。 */
+export function currentTransportName() {
+    return current.name;
+}
+/** 当前传输实现的引用。 */
+export function currentTransport() {
+    return current;
+}
+/** 调用方是否显式设置过传输实现。 */
+export function hasExplicitTransport() {
+    return explicit;
+}
+/** 替换传输实现（插件在 configure 时按 config.transport / 已注入的实现决定）。 */
+export function setTransport(transport) {
+    current = transport;
+    explicit = true;
+}
+/** 恢复默认的 fetch 实现（测试用）。 */
+export function resetTransport() {
+    current = createFetchTransport();
+    explicit = false;
+}
+/**
+ * 按优先级挑选传输实现：
+ * `config.transport`（最高）> configure() 之前 setTransport 注入的实现 > 内置 fetch。
+ *
+ * 这里**不做任何宿主探测**：同一个包在 Node、浏览器、Electron 里行为一致，
+ * 差异只来自使用方显式注入的实现。
+ */
+export function resolveTransport(explicitTransport, preset) {
+    return explicitTransport ?? preset ?? createFetchTransport();
+}
+/** 用当前传输发送一次 form-urlencoded POST。 */
+export function postForm(req) {
+    if (!current) {
+        return Promise.reject(new ElectricOpenPlatformError(TransportCodes.NETWORK, '未配置网络传输实现'));
+    }
+    return current.postForm(req);
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/core/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,IAAI,OAAO,GAAc,oBAAoB,EAAE,CAAC;AAChD,+CAA+C;AAC/C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,2BAA2B;AAC3B,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,SAAoB;IAC/C,OAAO,GAAG,SAAS,CAAC;IACpB,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,cAAc;IAC5B,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACjC,QAAQ,GAAG,KAAK,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,iBAA6B,EAAE,MAAkB;IAChF,OAAO,iBAAiB,IAAI,MAAM,IAAI,oBAAoB,EAAE,CAAC;AAC/D,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,QAAQ,CAAC,GAAgB;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,yBAAyB,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CACnE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/esm/core/models.d.ts

@@ -0,0 +1,441 @@
+/**
+ * Typed models for the open platform's `data` payloads.
+ *
+ * Field names mirror the wire format exactly (including the odd ones such as
+ * `aTUp` or `mxgl`) so that mapping mistakes are caught at compile time rather
+ * than surfacing as `undefined` in the UI.
+ */
+/** 设备类型 */
+export declare enum EquipmentType {
+    MicroBreaker = 1,
+    ElectricalFire = 2,
+    LiquidLevel = 4,
+    Pressure = 5,
+    SmokeForSafe = 6,
+    GasForSafe = 7,
+    SmokeZac = 10,
+    TempHumidity = 11,
+    SmartMeter = 12,
+    GasZac = 13,
+    Lux = 14,
+    SmartWaterMeter = 16,
+    SmokeWanlin = 29,
+    TempWanlin = 39,
+    SmokeHaiman = 42,
+    GasHaiman = 45
+}
+export type ProjectStatus = 'INTERIM' | 'AUDITED' | 'REJECTED' | string;
+export interface ProjectInfo {
+    projectCode: string;
+    projectName: string;
+    status: ProjectStatus;
+    provinceName?: string;
+    cityName?: string;
+    countyName?: string;
+    provinceId?: string;
+    cityId?: string;
+    countyId?: string;
+    street?: string;
+    imgUrl?: string;
+    longitude?: number;
+    latitude?: number;
+    linkMan?: string;
+    linkTel?: string;
+}
+/** -1 未连接；0 离线；1 在线 */
+export type OnlineState = -1 | 0 | 1;
+export interface Box {
+    mac: string;
+    projectCode: string;
+    equipmentType: EquipmentType | number;
+    aliasName: string;
+    build: string;
+    unit: string;
+    room: string;
+    linkman: string;
+    phone: string;
+    online: OnlineState;
+    onlineLastTime?: string;
+    protocol: 'HTTP' | 'UDP' | '' | string;
+    latitude?: number;
+    longitude?: number;
+    provinceName?: string;
+    cityName?: string;
+    countyName?: string;
+    street?: string;
+    extMeta?: string;
+}
+export interface PositionNode {
+    name: string;
+    childs?: PositionNode[];
+    /** Leave nodes may carry a mac. */
+    mac?: string;
+    boxes?: Box[];
+}
+/** lineType 220=单相 380=三相 120=E系列单相 180=E系列三相 IO=808 */
+export type LineType = '220' | '380' | '120' | '180' | 'IO' | string;
+/**
+ * One circuit ("线路/节点") snapshot from GET_BOX_CHANNELS_REALTIME.
+ *
+ * Single-phase devices fill the `a…` fields; three-phase devices fill `g…` plus
+ * per-phase `a…`/`b…`/`c…`; the 808 IO module fills `digitalIns`/`digitalOuts`.
+ */
+export interface ChannelRealtime {
+    mac?: string;
+    addr: number;
+    title: string;
+    /** 线路有效性（与通信模块的连通性） */
+    validity: boolean;
+    /** 开关状态 true 合闸 / false 分闸 */
+    oc: boolean;
+    ocTime: string;
+    /** 是否可以远程分合闸 */
+    enableNetCtrl: boolean;
+    updateTime: string;
+    online: boolean;
+    /** 刻度电量 kWh */
+    power: number;
+    /** 过功门限 */
+    mxgg?: string | number;
+    /** 过流门限 */
+    mxgl?: string | number;
+    lineType: LineType;
+    /** 告警位 — deprecated by the platform, use GET_BOX_ALARM instead. */
+    alarm: number;
+    specification?: string;
+    /** -1 表示进线直连，非 -1 表示汇电目标节点号 */
+    gatherAddr: number;
+    control: boolean;
+    visibility: boolean;
+    mainLine?: string;
+    localLock: boolean;
+    remoteLock: boolean;
+    clearModel?: string;
+    aLd?: number;
+    aA?: number;
+    aT?: number;
+    aTUp?: number;
+    aV?: number;
+    aW?: number;
+    aPF?: number;
+    gLd?: number;
+    gA?: number;
+    gT?: number;
+    gV?: number;
+    gW?: number;
+    gPF?: number;
+    bA?: number;
+    bT?: number;
+    bTUp?: number;
+    bV?: number;
+    bW?: number;
+    bPF?: number;
+    cA?: number;
+    cT?: number;
+    cTUp?: number;
+    cV?: number;
+    cW?: number;
+    cPF?: number;
+    nA?: number;
+    nT?: number;
+    nTUp?: number;
+    digitalIns?: number[];
+    digitalOuts?: number[];
+    analogIns?: string[];
+}
+export interface BoxRealtime {
+    mac: string;
+    channelList: ChannelRealtime[];
+}
+export interface BoxChannel {
+    addr: number;
+    title: string;
+    oc: boolean;
+    ocTime: string;
+    updateTime: string;
+}
+export interface BoxChannels {
+    mac: string;
+    channels: BoxChannel[];
+}
+export type AlarmStatus = 0 | 1;
+export interface AlarmRecord {
+    id: number;
+    autoid: number;
+    mac: string;
+    addr: number;
+    node: string;
+    /** 告警时间 yyyy-MM-dd HH:mm */
+    time: string;
+    info: string;
+    /** JSON string: { his, elecType, unit, threshold, value } */
+    valueDescribe: string;
+    status: AlarmStatus;
+    processStatus: 0 | 1 | 2 | 4;
+    typeNumber: number;
+}
+export interface PagedResult<T> {
+    total: number;
+    page: number;
+    totalPage: number;
+    datas: T[];
+}
+export declare const AlarmType: {
+    readonly ShortCircuit: 1;
+    readonly LeakageMonitor: 2;
+    readonly Overload: 3;
+    readonly Overcurrent: 4;
+    readonly Overvoltage: 5;
+    readonly Undervoltage: 6;
+    readonly Temperature: 7;
+    readonly Surge: 8;
+    readonly LeakageProtectOk: 9;
+    readonly LeakageSelfTestIncomplete: 10;
+    readonly Arc: 11;
+    readonly LeakageWarning: 12;
+    readonly CurrentWarning: 13;
+    readonly OvervoltageWarning: 14;
+    readonly UndervoltageWarning: 15;
+    readonly CommWarning: 16;
+    readonly PhaseLoss: 17;
+    readonly ThreePhaseUnbalance: 18;
+    readonly ThreePhaseSequence: 19;
+    readonly PowerLoss: 53;
+    readonly BoxOpen: 54;
+    readonly TemperatureWarning: 55;
+    readonly Humidity: 56;
+    readonly Input: 57;
+    readonly PowerNormal: 58;
+    readonly MalignantLoad: 62;
+    readonly Config: 1001;
+    readonly Offline: 1002;
+    readonly SwitchOffNotice: 1003;
+    readonly SwitchOnNotice: 1004;
+    readonly AbnormalOpen: 1005;
+    readonly LeakageProtection: 1016;
+    readonly Smoke: 2002;
+    readonly Gas: 2006;
+    readonly Pressure: 2003;
+    readonly LiquidLevel: 2004;
+    readonly DeviceFault: 9000;
+    readonly CommFault: 9001;
+};
+export type AlarmTypeNumber = (typeof AlarmType)[keyof typeof AlarmType];
+export interface ParsedAlarmValue {
+    his?: boolean;
+    elecType?: 1 | 2 | 3 | 4 | 5;
+    unit?: string;
+    threshold?: number;
+    value?: number;
+}
+/** Daily / hourly / monthly statistics row. See GET_BOXES_DAY_STATS. */
+export interface BoxStat {
+    mac?: string;
+    /** addr = 0 表示该设备总量 */
+    addr?: number;
+    /** 天区间用电量 kWh */
+    electricity?: number;
+    totalElectricity?: number;
+    /** 平均电流 A */
+    currentValue?: number;
+    /** 平均电压 V */
+    voltage?: number;
+    tempA?: number;
+    tempB?: number;
+    tempC?: number;
+    tempN?: number;
+    /** 漏电流峰值 mA */
+    leakageValue?: number;
+}
+export type BoxStatsByMac = Record<string, BoxStat[]>;
+export type BoxStatsByMacAndPeriod = Record<string, Record<string, BoxStat[]>>;
+export interface OnlineHistoryRecord {
+    online?: number;
+    time?: string;
+    [key: string]: unknown;
+}
+export interface BoxControlCommand {
+    OCSWITCH: {
+        value1: 'open' | 'close';
+        value2: string;
+        value3?: 'ABNORMAL_LOCK_CHECK';
+    };
+    SWITCHSET: {
+        value1: number;
+        value2: string;
+        value4?: number;
+        value5?: number;
+    };
+    SETAUTOLEAK: {
+        value1: 'true' | 'false';
+        value2: number;
+        value3: number;
+        value4: number;
+    };
+    SETLOGINPWD: {
+        value1: string;
+        value2: string;
+        force?: 'true' | 'false';
+    };
+    SETWIRELESS: {
+        value1: string;
+        value2: string;
+        value3: string;
+        value5: string;
+        force?: 'true' | 'false';
+    };
+    UPDATEDEVICES: Record<string, string | number>;
+    DELDEVICES: {
+        'device.autoid': number;
+    };
+    DELDEVICESES: {
+        autoid: string;
+    };
+    UPDATETIMER: Record<string, string | number>;
+    DELTIMER: {
+        'timer.autoid': number;
+    };
+    DELTIMERES: {
+        autoid: string;
+    };
+    SETWIRING: {
+        value1: number;
+        value2: number;
+    };
+    DELALARM: {
+        'alarm.autoid': number;
+    };
+    DELALARMES: {
+        autoid: string;
+    };
+    SETVISIBILITY: {
+        value1: number;
+        value2: 0 | 1;
+    };
+    SETCONTROL: {
+        value1: number;
+        value2: 0 | 1;
+    };
+    REMOTE_SWITCH_LOCK: {
+        value1: number;
+        value2: 'true' | 'false';
+    };
+    ABNORMAL_SWITCH_UNLOCK: {
+        value1: number;
+    };
+    THIRD_DEVICE_OCSWITCH: {
+        value1: 'open' | 'close';
+        value2: string;
+    };
+}
+export type BoxControlCmd = keyof BoxControlCommand;
+export interface TimerConfig {
+    autoid: number;
+    channel: string;
+    /** 如 "三四"，空表示单次定时 */
+    weekday: string;
+    /** 循环: 时:分:秒；单次: 年-月-日 时:分:秒 */
+    time: string;
+    /** true 合闸 / false 分闸 / closeAndLock / unlockAndOpen */
+    status: 'true' | 'false' | 'closeAndLock' | 'unlockAndOpen' | string;
+}
+export interface LeakageCheckConfig {
+    autoid?: number;
+    enable?: boolean | string;
+    time?: string;
+    [key: string]: unknown;
+}
+export interface BoxProperty {
+    [key: string]: unknown;
+}
+export interface Scene {
+    sceneId: string;
+    sceneName?: string;
+    [key: string]: unknown;
+}
+export interface PushSubscription {
+    url: string;
+    projectCode: string[];
+    typeNumbers: (number | string)[];
+    equipmentTypes?: number[];
+    salt: string;
+    pushEnable: 0 | 1;
+    timeRanges: string[];
+    pushMode?: string;
+    failure?: {
+        peroidStartTime: string;
+        peroidEndTime: string;
+        lastFailReason: string;
+        failTimes: number;
+    };
+}
+/** Push type 1=告警 2=节点状态 3=事件通知 */
+export declare enum PushType {
+    Alarm = 1,
+    ChannelStatus = 2,
+    Event = 3
+}
+/**
+ * 第三方设备类型（GET_THR_DEVICE_STATUS 的 equipmentType）。
+ * 注意：这些是「非微断」设备，微断(1)/电气火灾(2) 不走这个接口。
+ */
+export declare enum ThirdPartyEquipmentType {
+    LiquidLevel = 4,
+    Pressure = 5,
+    SmokeForSafe = 6,
+    GasForSafe = 7,
+    SmokeZac = 10,
+    TempHumidity = 11,
+    SmartMeter = 12,
+    GasZac = 13,
+    Lux = 14,
+    SmartWaterMeter = 16,
+    SmokeWanlin = 29,
+    TempWanlin = 39,
+    SmokeHaiman = 42,
+    GasHaiman = 45
+}
+/**
+ * 第三方设备状态记录 GET_THR_DEVICE_STATUS.
+ *
+ * 平台按 `msgType` 分条返回，`data` 是**JSON 字符串**（需自行解析），
+ * 且不同设备类型的字段完全不同（感烟有 BatVol/DevInfo/NetBeats/Status，
+ * 水表/电表则是抄表读数）。用 {@link parseThirdPartyData} 安全解析。
+ */
+export interface ThirdPartyDeviceStatus {
+    /** 设备型号，如 FS3031 */
+    devType: string;
+    /** 消息类型，如 BatVol / DevInfo / NetBeats / Status */
+    msgType: string;
+    /** JSON 字符串载荷 */
+    data: string;
+    mac: string;
+}
+/** 智能水表(CHaobiamao) 查询模式：0=实时抄表，1=时间范围 */
+export declare enum MeterQueryType {
+    Realtime = 0,
+    Range = 1
+}
+/**
+ * 设备维保工单处理记录 GET_BOX_MAINTENANCE_HISTORY.
+ * 字段为可选，因为不同版本平台返回的集合略有差异。
+ */
+export interface MaintenanceRecord {
+    /** 关联的报警 id */
+    alarmId?: string;
+    /** 维保单 id */
+    id?: string;
+    mac?: string;
+    projectCode?: string;
+    /** 处理人 */
+    handlerUserName?: string;
+    handlerUserPhone?: string;
+    /** 维保内容 */
+    maintenanceContent?: string;
+    /** 故障内容 */
+    malfunctionContent?: string;
+    /** 处理结果 */
+    handledResult?: string;
+    suggest?: string;
+    [key: string]: unknown;
+}