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

package/dist/esm/core/auth.js

@@ -0,0 +1,289 @@
+/**
+ * OAuth2 lifecycle for the open platform.
+ *
+ * Two ways to obtain a token, both documented:
+ *  1. Redirect flow (`/oauth/authorize.as?client_id=…&response_type=code`) for a
+ *     full web-login experience — the host app receives `?code=` and calls
+ *     {@link AuthManager.exchangeCode}.
+ *  2. Headless flow (`POST /oauth/authverify2.as` with `uname`/`passwd`) — used
+ *     by the plugin's `login()` convenience method.
+ *
+ * Once a token exists it is kept warm with the refresh endpoint, so a background
+ * poller never has to handle expiry itself.
+ */
+import { ElectricOpenPlatformError, PlatformCodes, TransportCodes } from './errors.js';
+import { postForm } from './http.js';
+import { encodeForm, signAuthCodeSecret, signRefreshSecret } from './sign.js';
+import { DEFAULT_BASE_URL } from './types.js';
+const MIN_EXPIRES_IN_SECONDS = 60;
+export class AuthManager {
+    constructor(store, config) {
+        this.tokens = null;
+        this.inflight = null;
+        this.timer = null;
+        this.store = store;
+        this.logger = config.logger;
+        this.config = {
+            appKey: config.appKey,
+            appSecret: config.appSecret,
+            redirectUri: config.redirectUri,
+            baseUrl: (config.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, ''),
+            timeoutMs: config.timeoutMs ?? 20000,
+            tokenRefreshSkewMs: config.tokenRefreshSkewMs ?? 60000,
+        };
+    }
+    /** Hydrates tokens persisted by a previous app session. */
+    async restore() {
+        const saved = await this.store.readTokens();
+        if (saved && saved.accessToken) {
+            this.tokens = saved;
+            if (!this.isExpired(saved))
+                this.scheduleRefresh();
+            else
+                this.tokens = null;
+            return this.tokens;
+        }
+        return null;
+    }
+    get current() {
+        return this.tokens;
+    }
+    /** The redirect-flow login URL, for opening in a browser / InAppBrowser. */
+    getAuthorizeUrl(options = {}) {
+        const qs = encodeForm({
+            client_id: this.config.appKey,
+            response_type: 'code',
+            redirect_uri: this.config.redirectUri,
+            ...(options.state ? { state: options.state } : {}),
+        });
+        return `${this.config.baseUrl}/oauth/authorize.as?${qs}`;
+    }
+    /** Extracts `code` from a redirect URL such as `http://host/receive?code=abc`. */
+    static extractCode(url) {
+        const match = /[?&#]code=([^&#]+)/.exec(url);
+        return match ? decodeURIComponent(match[1]) : null;
+    }
+    /** Step 1 of the headless flow: POST `/oauth/authverify2.as` for a temporary code. */
+    async fetchCode(credentials) {
+        const body = encodeForm({
+            response_type: 'code',
+            client_id: this.config.appKey,
+            redirect_uri: this.config.redirectUri,
+            uname: credentials.username,
+            passwd: credentials.password,
+        });
+        const res = await postForm({
+            url: `${this.config.baseUrl}/oauth/authverify2.as`,
+            body,
+            timeoutMs: this.config.timeoutMs,
+        });
+        const payload = res.data;
+        if (!payload || typeof payload !== 'object' || !payload.code || String(payload.success) !== 'true') {
+            throw new ElectricOpenPlatformError(TransportCodes.OAUTH, `获取授权码失败：${(payload && payload.message) || '账号或密码不正确'}`, { details: res.data });
+        }
+        this.logger?.({ type: 'token', message: '已获取临时授权码 code', at: new Date().toISOString() });
+        return payload.code;
+    }
+    /**
+     * Steps 1+2 in one call: headless login with username/password, then store the token.
+     * Concurrent calls share the same in-flight handshake.
+     */
+    async loginWithPassword(username, password) {
+        const code = await this.fetchCode({ username, password });
+        return this.exchangeCode(code);
+    }
+    /** Step 2: exchange a code for an access token (`POST /oauth/token.as`). */
+    async exchangeCode(code) {
+        if (this.inflight)
+            return this.inflight;
+        this.inflight = this.doExchangeCode(code).finally(() => {
+            this.inflight = null;
+        });
+        return this.inflight;
+    }
+    async doExchangeCode(code) {
+        const clientSecret = signAuthCodeSecret({
+            appKey: this.config.appKey,
+            appSecret: this.config.appSecret,
+            redirectUri: this.config.redirectUri,
+            code,
+        });
+        const body = encodeForm({
+            client_id: this.config.appKey,
+            client_secret: clientSecret,
+            grant_type: 'authorization_code',
+            redirect_uri: this.config.redirectUri,
+            code,
+        });
+        const res = await postForm({
+            url: `${this.config.baseUrl}/oauth/token.as`,
+            body,
+            timeoutMs: this.config.timeoutMs,
+        });
+        return this.absorb(res.data, 'accessToken');
+    }
+    /**
+     * Returns a usable access token, renewing it first when it is within the skew
+     * window. Falls back to a full re-login when the refresh token is gone.
+     */
+    async getAccessToken(credentials) {
+        if (this.tokens && !this.isExpired(this.tokens))
+            return this.tokens.accessToken;
+        if (this.inflight)
+            return (await this.inflight).accessToken;
+        if (this.tokens?.refreshToken) {
+            try {
+                return (await this.refresh()).accessToken;
+            }
+            catch (err) {
+                // A dead refresh token is indistinguishable from an expired session;
+                // drop it and fall through to a full login when credentials exist.
+                this.emit('error', `刷新 accessToken 失败：${err.message}`);
+                this.tokens = null;
+            }
+        }
+        if (credentials?.username && credentials.password) {
+            return (await this.loginWithPassword(credentials.username, credentials.password)).accessToken;
+        }
+        throw new ElectricOpenPlatformError(TransportCodes.NOT_CONFIGURED, 'accessToken 已过期，请重新登录');
+    }
+    /** `POST /oauth/refresh.as` */
+    async refresh() {
+        if (this.inflight)
+            return this.inflight;
+        this.inflight = this.doRefresh().finally(() => {
+            this.inflight = null;
+        });
+        return this.inflight;
+    }
+    async doRefresh() {
+        const refreshToken = this.tokens?.refreshToken;
+        if (!refreshToken) {
+            throw new ElectricOpenPlatformError(TransportCodes.OAUTH, '缺少 refreshToken，无法刷新');
+        }
+        const clientSecret = signRefreshSecret({
+            appKey: this.config.appKey,
+            appSecret: this.config.appSecret,
+            redirectUri: this.config.redirectUri,
+            refreshToken,
+        });
+        const body = encodeForm({
+            client_id: this.config.appKey,
+            client_secret: clientSecret,
+            grant_type: 'refresh_token',
+            redirect_uri: this.config.redirectUri,
+            refresh_token: refreshToken,
+        });
+        const res = await postForm({
+            url: `${this.config.baseUrl}/oauth/refresh.as`,
+            body,
+            timeoutMs: this.config.timeoutMs,
+        });
+        return this.absorb(res.data, 'refresh');
+    }
+    /** Invalidates the platform-side session? No such endpoint exists — clear locally. */
+    async logout() {
+        this.tokens = null;
+        this.clearTimer();
+        await this.store.clear();
+        this.emit('token', '已清除本地授权');
+    }
+    /**
+     * Converts a platform "token invalid" answer into a fresh access token.
+     *
+     * Prefers the refresh token (no credential round-trip); falls back to a full
+     * headless login when credentials were configured.
+     */
+    async recover(credentials) {
+        if (this.tokens?.refreshToken) {
+            try {
+                return (await this.refresh()).accessToken;
+            }
+            catch (err) {
+                this.emit('error', `refresh 失败，改用账号密码重新登录：${err.message}`);
+            }
+        }
+        if (credentials?.username && credentials.password) {
+            return (await this.loginWithPassword(credentials.username, credentials.password)).accessToken;
+        }
+        await this.invalidate();
+        throw new ElectricOpenPlatformError(TransportCodes.NOT_CONFIGURED, '会话已失效，请重新登录');
+    }
+    /** Called by the client after the platform answers with code `"2"`. */
+    async invalidate() {
+        this.tokens = null;
+        this.clearTimer();
+        await this.store.clear();
+    }
+    dispose() {
+        this.clearTimer();
+    }
+    absorb(payload, origin) {
+        const envelope = payload;
+        if (!envelope || typeof envelope !== 'object' || !envelope.data) {
+            throw new ElectricOpenPlatformError(TransportCodes.OAUTH, '授权响应格式异常', { details: payload });
+        }
+        if (envelope.code !== undefined && envelope.code !== PlatformCodes.OK) {
+            throw new ElectricOpenPlatformError(envelope.code, envelope.message || '授权失败', {
+                details: payload,
+            });
+        }
+        const d = envelope.data;
+        const accessToken = d.accessToken ?? d.access_token;
+        const refreshToken = d.refreshToken ?? d.refresh_token ?? '';
+        const rawExpires = d.expiresIn ?? d.expires_in;
+        const expiresIn = Number(rawExpires ?? 3600);
+        if (!accessToken) {
+            throw new ElectricOpenPlatformError(TransportCodes.OAUTH, '授权响应中缺少 accessToken', {
+                details: payload,
+            });
+        }
+        const ttlSeconds = Number.isFinite(expiresIn) && expiresIn > 0 ? expiresIn : 3600;
+        const tokens = {
+            accessToken,
+            refreshToken,
+            tokenType: (d.tokenType ?? 'BEARER').toUpperCase(),
+            expiresAt: Date.now() + Math.max(ttlSeconds, MIN_EXPIRES_IN_SECONDS) * 1000,
+        };
+        this.tokens = tokens;
+        this.scheduleRefresh();
+        void this.store.writeTokens(tokens);
+        this.emit('token', origin === 'refresh' ? 'accessToken 已刷新' : 'accessToken 已获取', {
+            expiresIn: ttlSeconds,
+        });
+        return tokens;
+    }
+    isExpired(tokens) {
+        return tokens.expiresAt - this.config.tokenRefreshSkewMs <= Date.now();
+    }
+    /**
+     * Proactively refreshes shortly before expiry so that a 60 s poller never
+     * hits code `"2"`. Browsers throttle long timers, so the client *also* checks
+     * lazily on every request — belt and braces.
+     */
+    scheduleRefresh() {
+        this.clearTimer();
+        if (!this.tokens?.refreshToken)
+            return;
+        const delay = this.tokens.expiresAt - this.config.tokenRefreshSkewMs - Date.now();
+        if (delay <= 0 || delay > 2 ** 31 - 1)
+            return;
+        this.timer = setTimeout(() => {
+            this.refresh().catch((err) => {
+                this.emit('error', `定时刷新失败：${err.message}`);
+            });
+        }, delay);
+        // Node/SSR safety: an unref'd timer must not keep the test process alive.
+        this.timer.unref?.();
+    }
+    clearTimer() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    emit(type, message, detail) {
+        this.logger?.({ type, message, detail, at: new Date().toISOString() });
+    }
+}
+//# sourceMappingURL=auth.js.map

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

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

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

@@ -0,0 +1,24 @@
+/**
+ * Small, dependency-free crypto/time helpers.
+ *
+ * The plugin must stay framework free (no node:crypto, no js-sha1) because the
+ * exact same code runs inside a WebView, in the Vite demo page and in Node
+ * based unit tests.
+ */
+/**
+ * MD5 of the UTF-8 encoding of `input`, lowercase hex (32 chars).
+ *
+ * The platform specifies MD5 over the UTF-8 byte stream (see the Java reference
+ * implementation in the docs: `md.update(param.getBytes("utf-8"))`), so the
+ * conversion below must be done on UTF-8 bytes, not on code units.
+ */
+export declare function md5(input: string): string;
+/**
+ * The platform's `timestamp` parameter: `yyyyMMddHHmmss` in **local time**
+ * (the docs say "当前时间截"), padded to two digits.
+ */
+export declare function formatTimestamp(date?: Date): string;
+/** Local `yyyy-MM-dd HH:mm` — the format GET_BOX_ALARM expects for start/end. */
+export declare function formatAlarmTime(date: Date): string;
+/** A stable, deterministic non-cryptographic id used for request correlation. */
+export declare function randomId(length?: number): string;

package/dist/esm/core/crypto.js

@@ -0,0 +1,154 @@
+/**
+ * Small, dependency-free crypto/time helpers.
+ *
+ * The plugin must stay framework free (no node:crypto, no js-sha1) because the
+ * exact same code runs inside a WebView, in the Vite demo page and in Node
+ * based unit tests.
+ */
+const HEX = '0123456789abcdef';
+/**
+ * MD5 of the UTF-8 encoding of `input`, lowercase hex (32 chars).
+ *
+ * The platform specifies MD5 over the UTF-8 byte stream (see the Java reference
+ * implementation in the docs: `md.update(param.getBytes("utf-8"))`), so the
+ * conversion below must be done on UTF-8 bytes, not on code units.
+ */
+export function md5(input) {
+    const bytes = utf8Bytes(input);
+    const words = toWords(bytes);
+    const digest = md5Words(words, bytes.length);
+    let out = '';
+    for (let i = 0; i < 4; i++) {
+        const word = digest[i];
+        for (let j = 0; j < 4; j++) {
+            out += HEX.charAt((word >>> (j * 8 + 4)) & 0x0f);
+            out += HEX.charAt((word >>> (j * 8)) & 0x0f);
+        }
+    }
+    return out;
+}
+function utf8Bytes(input) {
+    const out = [];
+    for (let i = 0; i < input.length; i++) {
+        let cp = input.charCodeAt(i);
+        if (cp >= 0xd800 && cp <= 0xdbff && i + 1 < input.length) {
+            const next = input.charCodeAt(i + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                cp = ((cp - 0xd800) << 10) + (next - 0xdc00) + 0x10000;
+                i++;
+            }
+        }
+        if (cp < 0x80) {
+            out.push(cp);
+        }
+        else if (cp < 0x800) {
+            out.push(0xc0 | (cp >> 6), 0x80 | (cp & 0x3f));
+        }
+        else if (cp < 0x10000) {
+            out.push(0xe0 | (cp >> 12), 0x80 | ((cp >> 6) & 0x3f), 0x80 | (cp & 0x3f));
+        }
+        else {
+            out.push(0xf0 | (cp >> 18), 0x80 | ((cp >> 12) & 0x3f), 0x80 | ((cp >> 6) & 0x3f), 0x80 | (cp & 0x3f));
+        }
+    }
+    return out;
+}
+function toWords(bytes) {
+    const bitLen = bytes.length * 8;
+    const withPadding = bytes.slice();
+    withPadding.push(0x80);
+    while (withPadding.length % 64 !== 56)
+        withPadding.push(0);
+    // 64-bit little-endian length; JS numbers stop being exact above 2^53, which
+    // is far beyond any string we would ever sign.
+    withPadding.push(bitLen & 0xff, (bitLen >>> 8) & 0xff, (bitLen >>> 16) & 0xff, (bitLen >>> 24) & 0xff);
+    withPadding.push(0, 0, 0, 0);
+    const words = [];
+    for (let i = 0; i < withPadding.length; i += 4) {
+        words.push(withPadding[i] | (withPadding[i + 1] << 8) | (withPadding[i + 2] << 16) | (withPadding[i + 3] << 24));
+    }
+    return words;
+}
+const S = [
+    7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22, 7, 12, 17, 22, 5, 9, 14, 20, 5, 9, 14, 20, 5, 9, 14, 20, 5, 9,
+    14, 20, 4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23, 4, 11, 16, 23, 6, 10, 15, 21, 6, 10, 15, 21, 6, 10, 15,
+    21, 6, 10, 15, 21,
+];
+const K = (() => {
+    const k = [];
+    for (let i = 0; i < 64; i++)
+        k.push(Math.floor(Math.abs(Math.sin(i + 1)) * 0x100000000) | 0);
+    return k;
+})();
+function md5Words(words, byteLen) {
+    let a0 = 0x67452301;
+    let b0 = 0xefcdab89;
+    let c0 = 0x98badcfe;
+    let d0 = 0x10325476;
+    for (let chunk = 0; chunk < words.length; chunk += 16) {
+        const M = words.slice(chunk, chunk + 16);
+        let A = a0;
+        let B = b0;
+        let C = c0;
+        let D = d0;
+        for (let i = 0; i < 64; i++) {
+            let F;
+            let g;
+            if (i < 16) {
+                F = (B & C) | (~B & D);
+                g = i;
+            }
+            else if (i < 32) {
+                F = (D & B) | (~D & C);
+                g = (5 * i + 1) % 16;
+            }
+            else if (i < 48) {
+                F = B ^ C ^ D;
+                g = (3 * i + 5) % 16;
+            }
+            else {
+                F = C ^ (B | ~D);
+                g = (7 * i) % 16;
+            }
+            F = (F + A + K[i] + M[g]) | 0;
+            A = D;
+            D = C;
+            C = B;
+            B = (B + ((F << S[i]) | (F >>> (32 - S[i])))) | 0;
+        }
+        a0 = (a0 + A) | 0;
+        b0 = (b0 + B) | 0;
+        c0 = (c0 + C) | 0;
+        d0 = (d0 + D) | 0;
+    }
+    void byteLen;
+    return [a0, b0, c0, d0];
+}
+/**
+ * The platform's `timestamp` parameter: `yyyyMMddHHmmss` in **local time**
+ * (the docs say "当前时间截"), padded to two digits.
+ */
+export function formatTimestamp(date = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return (String(date.getFullYear()) +
+        pad(date.getMonth() + 1) +
+        pad(date.getDate()) +
+        pad(date.getHours()) +
+        pad(date.getMinutes()) +
+        pad(date.getSeconds()));
+}
+/** Local `yyyy-MM-dd HH:mm` — the format GET_BOX_ALARM expects for start/end. */
+export function formatAlarmTime(date) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return (`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` +
+        ` ${pad(date.getHours())}:${pad(date.getMinutes())}`);
+}
+/** A stable, deterministic non-cryptographic id used for request correlation. */
+export function randomId(length = 12) {
+    let out = '';
+    const alphabet = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    for (let i = 0; i < length; i++)
+        out += alphabet.charAt(Math.floor(Math.random() * alphabet.length));
+    return out;
+}
+//# sourceMappingURL=crypto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../../src/core/crypto.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,KAAa;IAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACjD,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,MAAM,IAAI,EAAE,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACzD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACrC,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;gBACrC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC;gBACvD,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;QACD,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;aAAM,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CACN,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,EACjB,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAC1B,IAAI,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EACzB,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,KAAe;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAClC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,WAAW,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE;QAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,6EAA6E;IAC7E,+CAA+C;IAC/C,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACvG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CACR,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,GAAG;IACR,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1G,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE;IAC3G,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;CAClB,CAAC;AAEF,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;IACd,MAAM,CAAC,GAAa,EAAE,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE;QAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7F,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,EAAE,CAAC;AAEL,SAAS,QAAQ,CAAC,KAAe,EAAE,OAAe;IAChD,IAAI,EAAE,GAAG,UAAU,CAAC;IACpB,IAAI,EAAE,GAAG,UAAU,CAAC;IACpB,IAAI,EAAE,GAAG,UAAU,CAAC;IACpB,IAAI,EAAE,GAAG,UAAU,CAAC;IAEpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,GAAG,EAAE,CAAC;QAEX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAS,CAAC;YACd,IAAI,CAAS,CAAC;YACd,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACX,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACvB,CAAC,GAAG,CAAC,CAAC;YACR,CAAC;iBAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAClB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACvB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACvB,CAAC;iBAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAClB,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACnB,CAAC;YACD,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAC9B,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,CAAC;YACN,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;QAED,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAa,IAAI,IAAI,EAAE;IACrD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CACvB,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,CACL,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE;QAC1E,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CACrD,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,MAAM,GAAG,EAAE;IAClC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,MAAM,QAAQ,GAAG,sCAAsC,CAAC;IACxD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACrG,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * 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 declare const PlatformCodes: {
+    readonly OK: "0";
+    readonly NOT_LOGGED_IN: "-1";
+    readonly FAILED: "1";
+    readonly TOKEN_EXPIRED: "2";
+    readonly BOX_OFFLINE: "1001";
+    readonly ILLEGAL_PARAM: "1002";
+    readonly ILLEGAL_OWNERSHIP: "1003";
+    readonly REMOTE_CONTROL_FORBIDDEN: "1004";
+    readonly INCOMPLETE_PROPERTY: "1005";
+    readonly VERIFY_FAILED: "1006";
+    readonly ALREADY_EXISTS: "1007";
+    readonly NOT_FOUND: "1008";
+    readonly OVER_LIMIT: "1009";
+    readonly DUPLICATE_OPERATION: "1010";
+};
+export type PlatformCode = (typeof PlatformCodes)[keyof typeof PlatformCodes] | string;
+/** Failure classes that never come from the platform itself. */
+export declare const TransportCodes: {
+    /** The device could not reach the server at all. */
+    readonly NETWORK: "E_NETWORK";
+    /** The server answered with a non-2xx status. */
+    readonly HTTP: "E_HTTP";
+    /** Response body was not the expected JSON envelope. */
+    readonly PARSE: "E_PARSE";
+    /** The plugin was used before `configure()` / `login()`. */
+    readonly NOT_CONFIGURED: "E_NOT_CONFIGURED";
+    /** Local guard rail rejected the call before hitting the network. */
+    readonly INVALID_ARGUMENT: "E_INVALID_ARGUMENT";
+    /** OAuth handshake (authverify2 / token / refresh) failed. */
+    readonly OAUTH: "E_OAUTH";
+    /** Daily per-interface quota exhausted (platform rejects with "限额"). */
+    readonly 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.
+     */
+    readonly NOT_PROVISIONED: "E_NOT_PROVISIONED";
+    /** The call was aborted by the caller (AbortSignal). */
+    readonly ABORTED: "E_ABORTED";
+};
+export type TransportCode = (typeof TransportCodes)[keyof typeof TransportCodes];
+export declare class ElectricOpenPlatformError extends Error {
+    /** Platform business code (`"0"`, `"1"`, `"2"`, `"1001"`…) or a `TransportCodes` value. */
+    readonly code: PlatformCode;
+    /** The `method` that failed, when the failure happened during a router call. */
+    readonly method?: string;
+    /** Raw server payload, kept for logging / bug reports. */
+    readonly details?: unknown;
+    /** HTTP status, when the failure happened at the transport layer. */
+    readonly httpStatus?: number;
+    constructor(code: PlatformCode, message?: string, options?: {
+        method?: string;
+        details?: unknown;
+        httpStatus?: number;
+        cause?: unknown;
+    });
+    /** True when the platform says the access token must be renewed. */
+    get isTokenExpired(): boolean;
+    /** True when a retry after a short delay is likely to succeed. */
+    get isRetryable(): boolean;
+    toJSON(): {
+        name: string;
+        code: string;
+        message: string;
+        method: string | undefined;
+        httpStatus: number | undefined;
+        details: unknown;
+    };
+}
+export declare function isElectricOpenPlatformError(e: unknown): e is ElectricOpenPlatformError;
+/** Human readable Chinese description for a platform code. */
+export declare function describeCode(code: PlatformCode): string;