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

package/dist/cjs/core/storage.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenStore = exports.memoryBackend = void 0;
+exports.createMemoryStore = createMemoryStore;
+exports.createLocalStorageStore = createLocalStorageStore;
+exports.setDefaultStore = setDefaultStore;
+exports.getDefaultStore = getDefaultStore;
+exports.clearDefaultStore = clearDefaultStore;
+exports.resolveBackend = resolveBackend;
+exports.resetStorageBackend = resetStorageBackend;
+const memory = new Map();
+/** 内存后端：进程内共享，适合测试与一次性脚本。 */
+function createMemoryStore() {
+    return {
+        name: 'memory',
+        async get(key) {
+            return memory.has(key) ? memory.get(key) : null;
+        },
+        async set(key, value) {
+            memory.set(key, value);
+        },
+        async remove(key) {
+            memory.delete(key);
+        },
+    };
+}
+exports.memoryBackend = createMemoryStore();
+/** 探活 localStorage：隐私模式/服务端渲染下读写都会抛错，此时返回 null。 */
+function createLocalStorageStore() {
+    try {
+        if (typeof globalThis.localStorage === 'undefined')
+            return null;
+        const probe = '__eop_probe__';
+        globalThis.localStorage.setItem(probe, '1');
+        globalThis.localStorage.removeItem(probe);
+    }
+    catch {
+        return null;
+    }
+    return {
+        name: 'localStorage',
+        async get(key) {
+            return globalThis.localStorage.getItem(key);
+        },
+        async set(key, value) {
+            globalThis.localStorage.setItem(key, value);
+        },
+        async remove(key) {
+            globalThis.localStorage.removeItem(key);
+        },
+    };
+}
+let resolved = null;
+let defaultStore;
+/**
+ * 注入全局默认存储后端（如 iOS `UserDefaults` / Android `SharedPreferences`）。
+ *
+ * 与 `setTransport()` 对称：宿主应用在 bootstrap 阶段调用一次，之后所有
+ * `configure()` 都会用它，业务代码（组件、页面、共享模块）**不需要知道宿主是什么**。
+ * 传了 `config.store` 时以 `config.store` 为准。
+ */
+function setDefaultStore(store) {
+    defaultStore = store;
+}
+/** 当前注入的全局默认存储后端（未注入为 undefined）。 */
+function getDefaultStore() {
+    return defaultStore;
+}
+/** 撤销全局默认存储后端（测试用）。 */
+function clearDefaultStore() {
+    defaultStore = undefined;
+}
+/**
+ * 解析存储后端，优先级：
+ * `config.store`（最高）> `setDefaultStore()` 注入的全局后端 > `storage` 模式对应的内置后端。
+ *
+ * @param mode   配置里的 `storage`（默认 `auto`）
+ * @param custom 调用方在 `configure({ store })` 里传入的自定义 store
+ */
+function resolveBackend(mode = 'auto', custom) {
+    if (custom)
+        return custom;
+    if (defaultStore)
+        return defaultStore;
+    if (mode === 'memory')
+        return exports.memoryBackend;
+    if (mode === 'localStorage')
+        return createLocalStorageStore() ?? exports.memoryBackend;
+    // auto：localStorage → 内存（Node/SSR 没有 localStorage）
+    if (resolved)
+        return resolved;
+    resolved = createLocalStorageStore() ?? exports.memoryBackend;
+    return resolved;
+}
+/** Resets the cached backend — used by tests and after a `storage` config change. */
+function resetStorageBackend() {
+    resolved = null;
+}
+class TokenStore {
+    constructor(backend, namespace) {
+        this.backend = backend;
+        this.namespace = namespace;
+    }
+    key(name) {
+        return `eop:${this.namespace}:${name}`;
+    }
+    async readTokens() {
+        let raw = null;
+        try {
+            raw = await this.backend.get(this.key('tokens'));
+        }
+        catch {
+            // 自定义后端读失败不应让 App 启动即崩：当作没有 token，走重新登录。
+            return null;
+        }
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            // Corrupt payload: drop it rather than crashing the app on boot.
+            await this.safeRemove();
+            return null;
+        }
+    }
+    async writeTokens(tokens) {
+        try {
+            await this.backend.set(this.key('tokens'), JSON.stringify(tokens));
+        }
+        catch {
+            // 持久化失败不影响本次会话（内存里仍有 token），下次请求会自然重登。
+        }
+    }
+    async clear() {
+        await this.safeRemove();
+    }
+    /** The backend actually in use, for diagnostics screens. */
+    get backendName() {
+        return this.backend.name;
+    }
+    async safeRemove() {
+        try {
+            await this.backend.remove(this.key('tokens'));
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+exports.TokenStore = TokenStore;
+//# sourceMappingURL=storage.js.map

package/dist/cjs/core/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/core/storage.ts"],"names":[],"mappings":";;;AAuCA,8CAaC;AAKD,0DAqBC;AAYD,0CAEC;AAGD,0CAEC;AAGD,8CAEC;AASD,wCAaC;AAGD,kDAEC;AA7FD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEzC,6BAA6B;AAC7B,SAAgB,iBAAiB;IAC/B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9D,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK;YAClB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAEY,QAAA,aAAa,GAAkB,iBAAiB,EAAE,CAAC;AAEhE,mDAAmD;AACnD,SAAgB,uBAAuB;IACrC,IAAI,CAAC;QACH,IAAI,OAAO,UAAU,CAAC,YAAY,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAChE,MAAM,KAAK,GAAG,eAAe,CAAC;QAC9B,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5C,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,OAAO,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK;YAClB,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAC1C,IAAI,YAAuC,CAAC;AAE5C;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,KAAoB;IAClD,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,qCAAqC;AACrC,SAAgB,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,uBAAuB;AACvB,SAAgB,iBAAiB;IAC/B,YAAY,GAAG,SAAS,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,OAAoB,MAAM,EAC1B,MAAsB;IAEtB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,qBAAa,CAAC;IAC5C,IAAI,IAAI,KAAK,cAAc;QAAE,OAAO,uBAAuB,EAAE,IAAI,qBAAa,CAAC;IAE/E,mDAAmD;IACnD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,GAAG,uBAAuB,EAAE,IAAI,qBAAa,CAAC;IACtD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,SAAgB,mBAAmB;IACjC,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,MAAa,UAAU;IACrB,YACmB,OAAsB,EACtB,SAAiB;QADjB,YAAO,GAAP,OAAO,CAAe;QACtB,cAAS,GAAT,SAAS,CAAQ;IACjC,CAAC;IAEI,GAAG,CAAC,IAAY;QACtB,OAAO,OAAO,IAAI,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,GAAG,GAAkB,IAAI,CAAC;QAC9B,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,iEAAiE;YACjE,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAe;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IAED,4DAA4D;IAC5D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;CACF;AApDD,gCAoDC"}

package/dist/cjs/core/transport-fetch.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFetchTransport = createFetchTransport;
+/**
+ * 基于标准 `fetch` 的传输实现 —— 包内唯一的默认实现。
+ *
+ * 适用：Node ≥ 18、Electron 主进程、Deno/Bun、以及**同源或已配反向代理**的浏览器。
+ *
+ * ⚠️ 浏览器里直接请求 `open.snd02.com` 会被同源策略拦截：平台不返回 CORS 头。
+ * 浏览器场景请把 `baseUrl` 指向自己的代理/后端中转，或注入一个走原生网络的
+ * {@link Transport} 实现（见 README「在任何环境里使用」）。
+ */
+const errors_js_1 = require("./errors.js");
+const transport_js_1 = require("./transport.js");
+function createFetchTransport() {
+    return {
+        name: 'fetch',
+        async postForm(req) {
+            if (req.signal?.aborted) {
+                throw new errors_js_1.ElectricOpenPlatformError(errors_js_1.TransportCodes.ABORTED, '请求已取消');
+            }
+            const headers = {
+                'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8',
+                Accept: 'application/json, text/plain, */*',
+                ...req.headers,
+            };
+            const timeoutMs = req.timeoutMs ?? transport_js_1.DEFAULT_TIMEOUT_MS;
+            // AbortController 让超时行为不依赖运行时的具体实现
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            const onAbort = () => controller.abort();
+            req.signal?.addEventListener('abort', onAbort);
+            try {
+                const res = await fetch(req.url, {
+                    method: 'POST',
+                    headers,
+                    body: req.body,
+                    signal: controller.signal,
+                });
+                const raw = await res.text();
+                (0, transport_js_1.assertHttpOk)(res.status, raw);
+                return { status: res.status, data: (0, transport_js_1.parseBody)(raw), raw };
+            }
+            catch (err) {
+                if (err instanceof errors_js_1.ElectricOpenPlatformError)
+                    throw err;
+                const aborted = err?.name === 'AbortError';
+                throw new errors_js_1.ElectricOpenPlatformError(aborted ? errors_js_1.TransportCodes.ABORTED : errors_js_1.TransportCodes.NETWORK, aborted ? '请求超时或已取消' : `网络请求失败：${err?.message ?? err}`, { cause: err });
+            }
+            finally {
+                clearTimeout(timer);
+                req.signal?.removeEventListener('abort', onAbort);
+            }
+        },
+    };
+}
+//# sourceMappingURL=transport-fetch.js.map

package/dist/cjs/core/transport-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-fetch.js","sourceRoot":"","sources":["../../../src/core/transport-fetch.ts"],"names":[],"mappings":";;AAmBA,oDA6CC;AAhED;;;;;;;;GAQG;AACH,2CAAwE;AACxE,iDAOwB;AAExB,SAAgB,oBAAoB;IAClC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,CAAC,QAAQ,CAAC,GAAgB;YAC7B,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACxB,MAAM,IAAI,qCAAyB,CAAC,0BAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvE,CAAC;YAED,MAAM,OAAO,GAAG;gBACd,cAAc,EAAE,kDAAkD;gBAClE,MAAM,EAAE,mCAAmC;gBAC3C,GAAG,GAAG,CAAC,OAAO;aACf,CAAC;YACF,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,iCAAkB,CAAC;YAEtD,mCAAmC;YACnC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACzC,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE/C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;oBAC/B,MAAM,EAAE,MAAM;oBACd,OAAO;oBACP,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAA,2BAAY,EAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAA,wBAAS,EAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;YAC3D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,qCAAyB;oBAAE,MAAM,GAAG,CAAC;gBACxD,MAAM,OAAO,GAAI,GAAa,EAAE,IAAI,KAAK,YAAY,CAAC;gBACtD,MAAM,IAAI,qCAAyB,CACjC,OAAO,CAAC,CAAC,CAAC,0BAAc,CAAC,OAAO,CAAC,CAAC,CAAC,0BAAc,CAAC,OAAO,EACzD,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAW,GAAa,EAAE,OAAO,IAAI,GAAG,EAAE,EACjE,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cjs/core/transport.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TIMEOUT_MS = void 0;
+exports.parseBody = parseBody;
+exports.assertHttpOk = assertHttpOk;
+/**
+ * Pluggable HTTP transport.
+ *
+ * 包内只提供一种实现（{@link createFetchTransport}，基于标准 `fetch`），
+ * 需要走原生网络栈、代理或自建网关时，实现 {@link Transport} 注入即可：
+ *
+ * ```ts
+ * await ElectricOpenPlatform.configure({ ...cfg, transport: myTransport });
+ * ```
+ *
+ * 所有实现只负责「发出去、拿回来、把 HTTP 状态映射成异常」，
+ * 解析 JSON 与业务错误码由上层统一处理，保证不同传输实现的行为一致。
+ */
+const errors_js_1 = require("./errors.js");
+exports.DEFAULT_TIMEOUT_MS = 20000;
+function parseBody(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return raw;
+    }
+}
+/** 非 2xx 统一转成可识别的异常。 */
+function assertHttpOk(status, raw) {
+    if (status < 200 || status >= 300) {
+        throw new errors_js_1.ElectricOpenPlatformError(errors_js_1.TransportCodes.HTTP, `服务器返回 HTTP ${status}`, {
+            httpStatus: status,
+            details: raw,
+        });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/cjs/core/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/core/transport.ts"],"names":[],"mappings":";;;AAuCA,8BAQC;AAGD,oCAOC;AAzDD;;;;;;;;;;;;GAYG;AACH,2CAAwE;AAwB3D,QAAA,kBAAkB,GAAG,KAAM,CAAC;AAEzC,SAAgB,SAAS,CAAC,GAAW;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,SAAgB,YAAY,CAAC,MAAc,EAAE,GAAW;IACtD,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,qCAAyB,CAAC,0BAAc,CAAC,IAAI,EAAE,cAAc,MAAM,EAAE,EAAE;YAC/E,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,GAAG;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/cjs/core/types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_BASE_URL = void 0;
+exports.DEFAULT_BASE_URL = 'https://open.snd02.com';
+//# sourceMappingURL=types.js.map

package/dist/cjs/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":";;;AAmFa,QAAA,gBAAgB,GAAG,wBAAwB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushApi = exports.parseThirdPartyData = exports.ThirdPartyDeviceApi = exports.SceneApi = exports.StatsApi = exports.AlarmApi = exports.ControlApi = exports.ChannelApi = exports.BoxApi = exports.ProjectApi = exports.verifyPushKey = exports.RouterClient = exports.AuthManager = exports.clearDefaultStore = exports.getDefaultStore = exports.setDefaultStore = exports.memoryBackend = exports.createLocalStorageStore = exports.createMemoryStore = exports.resetStorageBackend = exports.resolveBackend = exports.TokenStore = exports.DEFAULT_BASE_URL = exports.isElectricOpenPlatformError = exports.describeCode = exports.TransportCodes = exports.PlatformCodes = exports.ElectricOpenPlatformError = exports.hasGlobalFetch = exports.detectRuntime = exports.hasExplicitTransport = exports.currentTransportName = exports.currentTransport = exports.resetTransport = exports.setTransport = exports.resolveTransport = exports.createFetchTransport = exports.parseBody = exports.postForm = exports.signRefreshSecret = exports.signAuthCodeSecret = exports.encodeForm = exports.buildSignedRequest = exports.signParams = exports.formatAlarmTime = exports.formatTimestamp = exports.md5 = exports.ElectricOpenPlatformClient = exports.ElectricOpenPlatform = void 0;
+/**
+ * @packageDocumentation
+ * 智慧式用电数据开放平台（Mtsci Open Platform，open.snd02.com）的纯 TypeScript SDK。
+ *
+ * 零运行时依赖，Node ≥ 18 / 浏览器 / Electron / 任意前端框架通用；
+ * 需要走原生网络或自建网关时，注入一个 {@link Transport} 即可。
+ *
+ * ```ts
+ * import { ElectricOpenPlatform } from '@wdywdy/electric-open-platform';
+ *
+ * await ElectricOpenPlatform.configure({
+ *   appKey: 'O000093290',
+ *   appSecret: process.env.EOP_APP_SECRET!,   // keep out of source control
+ *   redirectUri: 'http://yourserverurl/receive',
+ *   projectCode: 'P00000104893',
+ * });
+ *
+ * await ElectricOpenPlatform.login('yfdq01', '…');
+ * const boxes = await ElectricOpenPlatform.box.listOnline();
+ * const [live] = await ElectricOpenPlatform.channel.realtime({ mac: boxes[0].mac });
+ * await ElectricOpenPlatform.control.switchCircuit({ mac: boxes[0].mac, action: 'close', addr: 1 });
+ * ```
+ */
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "ElectricOpenPlatform", { enumerable: true, get: function () { return client_js_1.ElectricOpenPlatform; } });
+Object.defineProperty(exports, "ElectricOpenPlatformClient", { enumerable: true, get: function () { return client_js_1.ElectricOpenPlatformClient; } });
+// Core building blocks — exported so host apps can sign their own calls or
+// reuse the primitives in a backend.
+var crypto_js_1 = require("./core/crypto.js");
+Object.defineProperty(exports, "md5", { enumerable: true, get: function () { return crypto_js_1.md5; } });
+Object.defineProperty(exports, "formatTimestamp", { enumerable: true, get: function () { return crypto_js_1.formatTimestamp; } });
+Object.defineProperty(exports, "formatAlarmTime", { enumerable: true, get: function () { return crypto_js_1.formatAlarmTime; } });
+var sign_js_1 = require("./core/sign.js");
+Object.defineProperty(exports, "signParams", { enumerable: true, get: function () { return sign_js_1.signParams; } });
+Object.defineProperty(exports, "buildSignedRequest", { enumerable: true, get: function () { return sign_js_1.buildSignedRequest; } });
+Object.defineProperty(exports, "encodeForm", { enumerable: true, get: function () { return sign_js_1.encodeForm; } });
+Object.defineProperty(exports, "signAuthCodeSecret", { enumerable: true, get: function () { return sign_js_1.signAuthCodeSecret; } });
+Object.defineProperty(exports, "signRefreshSecret", { enumerable: true, get: function () { return sign_js_1.signRefreshSecret; } });
+var http_js_1 = require("./core/http.js");
+Object.defineProperty(exports, "postForm", { enumerable: true, get: function () { return http_js_1.postForm; } });
+Object.defineProperty(exports, "parseBody", { enumerable: true, get: function () { return http_js_1.parseBody; } });
+// 传输层：使用方可以显式指定实现（config.transport / setTransport），
+// 未指定时一律用内置 fetch —— 不做宿主探测。
+Object.defineProperty(exports, "createFetchTransport", { enumerable: true, get: function () { return http_js_1.createFetchTransport; } });
+Object.defineProperty(exports, "resolveTransport", { enumerable: true, get: function () { return http_js_1.resolveTransport; } });
+Object.defineProperty(exports, "setTransport", { enumerable: true, get: function () { return http_js_1.setTransport; } });
+Object.defineProperty(exports, "resetTransport", { enumerable: true, get: function () { return http_js_1.resetTransport; } });
+Object.defineProperty(exports, "currentTransport", { enumerable: true, get: function () { return http_js_1.currentTransport; } });
+Object.defineProperty(exports, "currentTransportName", { enumerable: true, get: function () { return http_js_1.currentTransportName; } });
+Object.defineProperty(exports, "hasExplicitTransport", { enumerable: true, get: function () { return http_js_1.hasExplicitTransport; } });
+var runtime_js_1 = require("./core/runtime.js");
+Object.defineProperty(exports, "detectRuntime", { enumerable: true, get: function () { return runtime_js_1.detectRuntime; } });
+Object.defineProperty(exports, "hasGlobalFetch", { enumerable: true, get: function () { return runtime_js_1.hasGlobalFetch; } });
+var errors_js_1 = require("./core/errors.js");
+Object.defineProperty(exports, "ElectricOpenPlatformError", { enumerable: true, get: function () { return errors_js_1.ElectricOpenPlatformError; } });
+Object.defineProperty(exports, "PlatformCodes", { enumerable: true, get: function () { return errors_js_1.PlatformCodes; } });
+Object.defineProperty(exports, "TransportCodes", { enumerable: true, get: function () { return errors_js_1.TransportCodes; } });
+Object.defineProperty(exports, "describeCode", { enumerable: true, get: function () { return errors_js_1.describeCode; } });
+Object.defineProperty(exports, "isElectricOpenPlatformError", { enumerable: true, get: function () { return errors_js_1.isElectricOpenPlatformError; } });
+var types_js_1 = require("./core/types.js");
+Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return types_js_1.DEFAULT_BASE_URL; } });
+var storage_js_1 = require("./core/storage.js");
+Object.defineProperty(exports, "TokenStore", { enumerable: true, get: function () { return storage_js_1.TokenStore; } });
+Object.defineProperty(exports, "resolveBackend", { enumerable: true, get: function () { return storage_js_1.resolveBackend; } });
+Object.defineProperty(exports, "resetStorageBackend", { enumerable: true, get: function () { return storage_js_1.resetStorageBackend; } });
+Object.defineProperty(exports, "createMemoryStore", { enumerable: true, get: function () { return storage_js_1.createMemoryStore; } });
+Object.defineProperty(exports, "createLocalStorageStore", { enumerable: true, get: function () { return storage_js_1.createLocalStorageStore; } });
+Object.defineProperty(exports, "memoryBackend", { enumerable: true, get: function () { return storage_js_1.memoryBackend; } });
+// 宿主应用在 bootstrap 阶段注入全局默认存储（与 setTransport 对称），
+// 这样共享页面/组件无需引用任何平台 SDK。
+Object.defineProperty(exports, "setDefaultStore", { enumerable: true, get: function () { return storage_js_1.setDefaultStore; } });
+Object.defineProperty(exports, "getDefaultStore", { enumerable: true, get: function () { return storage_js_1.getDefaultStore; } });
+Object.defineProperty(exports, "clearDefaultStore", { enumerable: true, get: function () { return storage_js_1.clearDefaultStore; } });
+var auth_js_1 = require("./core/auth.js");
+Object.defineProperty(exports, "AuthManager", { enumerable: true, get: function () { return auth_js_1.AuthManager; } });
+var router_js_1 = require("./core/router.js");
+Object.defineProperty(exports, "RouterClient", { enumerable: true, get: function () { return router_js_1.RouterClient; } });
+var push_js_1 = require("./core/push.js");
+Object.defineProperty(exports, "verifyPushKey", { enumerable: true, get: function () { return push_js_1.verifyPushKey; } });
+// Domain APIs (for typing custom wrappers) and every wire model / enum.
+var api_js_1 = require("./core/api.js");
+Object.defineProperty(exports, "ProjectApi", { enumerable: true, get: function () { return api_js_1.ProjectApi; } });
+Object.defineProperty(exports, "BoxApi", { enumerable: true, get: function () { return api_js_1.BoxApi; } });
+Object.defineProperty(exports, "ChannelApi", { enumerable: true, get: function () { return api_js_1.ChannelApi; } });
+Object.defineProperty(exports, "ControlApi", { enumerable: true, get: function () { return api_js_1.ControlApi; } });
+Object.defineProperty(exports, "AlarmApi", { enumerable: true, get: function () { return api_js_1.AlarmApi; } });
+Object.defineProperty(exports, "StatsApi", { enumerable: true, get: function () { return api_js_1.StatsApi; } });
+Object.defineProperty(exports, "SceneApi", { enumerable: true, get: function () { return api_js_1.SceneApi; } });
+Object.defineProperty(exports, "ThirdPartyDeviceApi", { enumerable: true, get: function () { return api_js_1.ThirdPartyDeviceApi; } });
+Object.defineProperty(exports, "parseThirdPartyData", { enumerable: true, get: function () { return api_js_1.parseThirdPartyData; } });
+var push_js_2 = require("./core/push.js");
+Object.defineProperty(exports, "PushApi", { enumerable: true, get: function () { return push_js_2.PushApi; } });
+__exportStar(require("./core/models.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,yCAA+E;AAAtE,iHAAA,oBAAoB,OAAA;AAAE,uHAAA,0BAA0B,OAAA;AAEzD,2EAA2E;AAC3E,qCAAqC;AACrC,8CAAyE;AAAhE,gGAAA,GAAG,OAAA;AAAE,4GAAA,eAAe,OAAA;AAAE,4GAAA,eAAe,OAAA;AAC9C,0CAOwB;AANtB,qGAAA,UAAU,OAAA;AACV,6GAAA,kBAAkB,OAAA;AAClB,qGAAA,UAAU,OAAA;AACV,6GAAA,kBAAkB,OAAA;AAClB,4GAAA,iBAAiB,OAAA;AAGnB,0CAewB;AAdtB,mGAAA,QAAQ,OAAA;AACR,oGAAA,SAAS,OAAA;AACT,oDAAoD;AACpD,6BAA6B;AAC7B,+GAAA,oBAAoB,OAAA;AACpB,2GAAA,gBAAgB,OAAA;AAChB,uGAAA,YAAY,OAAA;AACZ,yGAAA,cAAc,OAAA;AACd,2GAAA,gBAAgB,OAAA;AAChB,+GAAA,oBAAoB,OAAA;AACpB,+GAAA,oBAAoB,OAAA;AAKtB,gDAAgF;AAAvE,2GAAA,aAAa,OAAA;AAAE,4GAAA,cAAc,OAAA;AACtC,8CAQ0B;AAPxB,sHAAA,yBAAyB,OAAA;AACzB,0GAAA,aAAa,OAAA;AACb,2GAAA,cAAc,OAAA;AACd,yGAAA,YAAY,OAAA;AACZ,wHAAA,2BAA2B,OAAA;AAI7B,4CASyB;AARvB,4GAAA,gBAAgB,OAAA;AASlB,gDAa2B;AAZzB,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AACd,iHAAA,mBAAmB,OAAA;AACnB,+GAAA,iBAAiB,OAAA;AACjB,qHAAA,uBAAuB,OAAA;AACvB,2GAAA,aAAa,OAAA;AACb,iDAAiD;AACjD,yBAAyB;AACzB,6GAAA,eAAe,OAAA;AACf,6GAAA,eAAe,OAAA;AACf,+GAAA,iBAAiB,OAAA;AAGnB,0CAA6C;AAApC,sGAAA,WAAW,OAAA;AACpB,8CAAkE;AAAzD,yGAAA,YAAY,OAAA;AACrB,0CAA6D;AAApD,wGAAA,aAAa,OAAA;AAEtB,wEAAwE;AACxE,wCAUuB;AATrB,oGAAA,UAAU,OAAA;AACV,gGAAA,MAAM,OAAA;AACN,oGAAA,UAAU,OAAA;AACV,oGAAA,UAAU,OAAA;AACV,kGAAA,QAAQ,OAAA;AACR,kGAAA,QAAQ,OAAA;AACR,kGAAA,QAAQ,OAAA;AACR,6GAAA,mBAAmB,OAAA;AACnB,6GAAA,mBAAmB,OAAA;AAErB,0CAAyC;AAAhC,kGAAA,OAAO,OAAA;AAChB,mDAAiC"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * The SDK facade.
+ *
+ * Everything is composed here so the public surface stays a single object:
+ *
+ * ```ts
+ * import { ElectricOpenPlatform } from '@wdywdy/electric-open-platform';
+ *
+ * await ElectricOpenPlatform.configure({ appKey, appSecret, redirectUri, projectCode });
+ * await ElectricOpenPlatform.login('yfdq01', '******');
+ * const boxes = await ElectricOpenPlatform.box.list();
+ * ```
+ */
+import { AlarmApi, BoxApi, ChannelApi, ControlApi, ProjectApi, SceneApi, StatsApi, ThirdPartyDeviceApi } from './core/api.js';
+import { PushApi } from './core/push.js';
+import { ElectricConfig, LoginResult, TokenSet } from './core/types.js';
+export declare class ElectricOpenPlatformClient {
+    private auth?;
+    private router?;
+    private config?;
+    private backend?;
+    /** Domain API groups — populated by {@link configure}. */
+    project: ProjectApi;
+    box: BoxApi;
+    channel: ChannelApi;
+    control: ControlApi;
+    alarm: AlarmApi;
+    stats: StatsApi;
+    scene: SceneApi;
+    push: PushApi;
+    /** 第三方设备（烟感/燃气/水表/温湿度…），即 equipmentType ≠ 1/2 */
+    thirdparty: ThirdPartyDeviceApi;
+    private credentials;
+    /**
+     * Configures the SDK. Safe to call again (e.g. after the user switches
+     * project) — previous timers are released and tokens for the old `appKey` are
+     * left untouched on disk.
+     */
+    configure(config: ElectricConfig): Promise<void>;
+    /** True once `configure()` succeeded. */
+    get isConfigured(): boolean;
+    /** Where tokens are persisted — useful on a diagnostics screen. */
+    storageBackend(): Promise<string>;
+    /** Headless login with the platform account (POST /oauth/authverify2.as). */
+    login(username: string, password: string): Promise<LoginResult>;
+    /** Redirect-flow: the URL to open in a browser for the platform's login page. */
+    getAuthorizeUrl(options?: {
+        state?: string;
+    }): string;
+    /**
+     * Redirect-flow step 2: pass the full redirect URL (or the bare code) received
+     * by your `redirectUri` endpoint.
+     */
+    handleRedirect(urlOrCode: string): Promise<TokenSet>;
+    /** Renews the token now instead of waiting for the timer. */
+    refreshToken(): Promise<TokenSet>;
+    get currentToken(): TokenSet | null;
+    logout(): Promise<void>;
+    /**
+     * Escape hatch for platform methods that are not (yet) wrapped, e.g. new
+     * `GET_*` endpoints added after this release. Signs, retries and unwraps for
+     * you, so prefer it over hand-rolling `fetch`.
+     */
+    invoke<T = unknown>(method: string, params?: Record<string, string | number | boolean | null | undefined>): Promise<T>;
+    /** Current configuration with the secret masked. */
+    describe(): Record<string, unknown>;
+    /** Releases timers; call from `ngOnDestroy` / `useEffect` cleanup. */
+    dispose(): void;
+    private requireAuth;
+    private requireRouter;
+}
+/** Default singleton instance. Also exported as the named `ElectricOpenPlatform`. */
+export declare const ElectricOpenPlatform: ElectricOpenPlatformClient;

package/dist/esm/client.js

@@ -0,0 +1,169 @@
+/**
+ * The SDK facade.
+ *
+ * Everything is composed here so the public surface stays a single object:
+ *
+ * ```ts
+ * import { ElectricOpenPlatform } from '@wdywdy/electric-open-platform';
+ *
+ * await ElectricOpenPlatform.configure({ appKey, appSecret, redirectUri, projectCode });
+ * await ElectricOpenPlatform.login('yfdq01', '******');
+ * const boxes = await ElectricOpenPlatform.box.list();
+ * ```
+ */
+import { AlarmApi, BoxApi, ChannelApi, ControlApi, ProjectApi, SceneApi, StatsApi, ThirdPartyDeviceApi, } from './core/api.js';
+import { AuthManager } from './core/auth.js';
+import { currentTransport, currentTransportName, hasExplicitTransport, resolveTransport, setTransport, } from './core/http.js';
+import { PushApi } from './core/push.js';
+import { detectRuntime } from './core/runtime.js';
+import { RouterClient } from './core/router.js';
+import { resolveBackend, TokenStore } from './core/storage.js';
+export class ElectricOpenPlatformClient {
+    constructor() {
+        this.credentials = {};
+    }
+    /**
+     * Configures the SDK. Safe to call again (e.g. after the user switches
+     * project) — previous timers are released and tokens for the old `appKey` are
+     * left untouched on disk.
+     */
+    async configure(config) {
+        assertConfig(config);
+        this.dispose();
+        this.config = config;
+        this.credentials = { username: config.username, password: config.password };
+        // 存储：config.store（自定义后端，最高）> config.storage 指定的内置后端
+        const backend = await resolveBackend(config.storage ?? 'auto', config.store);
+        this.backend = backend;
+        const store = new TokenStore(backend, config.appKey);
+        const auth = new AuthManager(store, config);
+        const router = new RouterClient(config, auth, () => this.credentials);
+        // 传输：config.transport（最高）> 调用方 setTransport 注入的实现 > 内置 fetch
+        setTransport(resolveTransport(config.transport, hasExplicitTransport() ? currentTransport() : undefined));
+        this.auth = auth;
+        this.router = router;
+        this.project = new ProjectApi(router);
+        this.box = new BoxApi(router);
+        this.channel = new ChannelApi(router);
+        this.control = new ControlApi(router);
+        this.alarm = new AlarmApi(router);
+        this.stats = new StatsApi(router);
+        this.scene = new SceneApi(router);
+        this.push = new PushApi(router);
+        this.thirdparty = new ThirdPartyDeviceApi(router);
+        await auth.restore();
+    }
+    /** True once `configure()` succeeded. */
+    get isConfigured() {
+        return !!this.router;
+    }
+    /** Where tokens are persisted — useful on a diagnostics screen. */
+    async storageBackend() {
+        return this.backend?.name ?? 'none';
+    }
+    // --------------------------------------------------------------------- auth
+    /** Headless login with the platform account (POST /oauth/authverify2.as). */
+    async login(username, password) {
+        const auth = this.requireAuth();
+        this.credentials = { username, password };
+        const code = await auth.fetchCode({ username, password });
+        const tokens = await auth.exchangeCode(code);
+        return { success: true, code, expiresIn: secondsUntil(tokens.expiresAt), expiresAt: tokens.expiresAt };
+    }
+    /** Redirect-flow: the URL to open in a browser for the platform's login page. */
+    getAuthorizeUrl(options = {}) {
+        return this.requireAuth().getAuthorizeUrl(options);
+    }
+    /**
+     * Redirect-flow step 2: pass the full redirect URL (or the bare code) received
+     * by your `redirectUri` endpoint.
+     */
+    async handleRedirect(urlOrCode) {
+        const auth = this.requireAuth();
+        const code = AuthManager.extractCode(urlOrCode) ?? urlOrCode;
+        return auth.exchangeCode(code);
+    }
+    /** Renews the token now instead of waiting for the timer. */
+    async refreshToken() {
+        return this.requireAuth().refresh();
+    }
+    get currentToken() {
+        return this.auth?.current ?? null;
+    }
+    async logout() {
+        this.credentials = {};
+        this.config = this.config ? { ...this.config, username: undefined, password: undefined } : this.config;
+        await this.auth?.logout();
+    }
+    /**
+     * Escape hatch for platform methods that are not (yet) wrapped, e.g. new
+     * `GET_*` endpoints added after this release. Signs, retries and unwraps for
+     * you, so prefer it over hand-rolling `fetch`.
+     */
+    async invoke(method, params = {}) {
+        return this.requireRouter().call(method, { params });
+    }
+    /** Current configuration with the secret masked. */
+    describe() {
+        const c = this.config;
+        if (!c)
+            return { configured: false };
+        return {
+            configured: true,
+            appKey: c.appKey,
+            appSecret: c.appSecret ? `****${c.appSecret.slice(-4)}` : '',
+            redirectUri: c.redirectUri,
+            baseUrl: c.baseUrl ?? 'https://open.snd02.com',
+            projectCode: c.projectCode,
+            storage: c.storage ?? 'auto',
+            /** 实际生效的存储后端名（内置 memory/localStorage，或自定义 store 的 name） */
+            storageBackend: this.backend?.name ?? 'none',
+            /** 运行宿主：node / browser / unknown（仅诊断用，不参与能力选择） */
+            runtime: detectRuntime(),
+            /** 实际生效的网络传输实现 */
+            transport: currentTransportName(),
+            token: this.auth?.current
+                ? { ...this.auth.current, accessToken: mask(this.auth.current.accessToken) }
+                : null,
+        };
+    }
+    /** Releases timers; call from `ngOnDestroy` / `useEffect` cleanup. */
+    dispose() {
+        this.auth?.dispose();
+        this.auth = undefined;
+        this.router = undefined;
+    }
+    requireAuth() {
+        if (!this.auth)
+            throw new Error('SDK 尚未初始化，请先调用 configure({ appKey, appSecret, redirectUri })');
+        return this.auth;
+    }
+    requireRouter() {
+        if (!this.router)
+            throw new Error('SDK 尚未初始化，请先调用 configure()');
+        return this.router;
+    }
+}
+function assertConfig(config) {
+    const missing = [];
+    if (!config.appKey)
+        missing.push('appKey');
+    if (!config.appSecret)
+        missing.push('appSecret');
+    if (!config.redirectUri)
+        missing.push('redirectUri');
+    if (missing.length)
+        throw new Error(`缺少必填配置：${missing.join(', ')}`);
+    if (config.redirectUri && !/^https?:\/\//i.test(config.redirectUri)) {
+        throw new Error('redirectUri 必须是 http(s) 绝对地址（会参与签名，需与平台登记一致）');
+    }
+}
+function secondsUntil(epochMs) {
+    return Math.max(0, Math.round((epochMs - Date.now()) / 1000));
+}
+function mask(token) {
+    return token.length <= 8 ? '****' : `${token.slice(0, 6)}…${token.slice(-4)}`;
+}
+/** Default singleton instance. Also exported as the named `ElectricOpenPlatform`. */
+export const ElectricOpenPlatform = new ElectricOpenPlatformClient();
+//# sourceMappingURL=client.js.map