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

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

@@ -0,0 +1,73 @@
+/**
+ * Token / config persistence.
+ *
+ * The platform's own guidance is to keep one "central controller" that owns the
+ * access token, so tokens are persisted across restarts and renewed with the
+ * refresh token.
+ *
+ * 本包**不依赖任何平台 SDK**。存储后端由 {@link KeyValueStore} 抽象：
+ *
+ * | 模式 | 实现 | 说明 |
+ * | --- | --- | --- |
+ * | `auto`（默认） | `localStorage` → 内存 | 浏览器/Electron 渲染进程可用；Node 里退到内存 |
+ * | `localStorage` | `localStorage` | 拿不到时退到内存 |
+ * | `memory` | 内存 | 进程结束即丢，适合测试或一次性脚本 |
+ * | 自定义 | `config.store` | 想写入文件、Redis、数据库、iOS `UserDefaults`／Android
+ *   `SharedPreferences` 时，自己实现 4 个方法传给 `configure({ store })` 即可 |
+ *
+ * 之前版本内置的宿主原生存储（Cordova SharedPreferences、Capacitor Preferences）已移除：
+ * 它们需要宿主桥接或额外依赖，与「纯 npm 包、任何项目都能用」的目标冲突。
+ * 同样的能力可以用自定义 store 在 10 行内实现，见 README。
+ */
+import type { StorageMode } from './types.js';
+/**
+ * 最小键值存储契约。
+ *
+ * 实现只需保证 4 个方法；写入失败请抛出异常，调用方会降级处理而不是崩溃。
+ */
+export interface KeyValueStore {
+    /** 便于诊断：`client.storageBackend()` 与 `describe()` 会返回该名字。 */
+    readonly name: string;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/** 内存后端：进程内共享，适合测试与一次性脚本。 */
+export declare function createMemoryStore(): KeyValueStore;
+export declare const memoryBackend: KeyValueStore;
+/** 探活 localStorage：隐私模式/服务端渲染下读写都会抛错，此时返回 null。 */
+export declare function createLocalStorageStore(): KeyValueStore | null;
+/**
+ * 注入全局默认存储后端（如 iOS `UserDefaults` / Android `SharedPreferences`）。
+ *
+ * 与 `setTransport()` 对称：宿主应用在 bootstrap 阶段调用一次，之后所有
+ * `configure()` 都会用它，业务代码（组件、页面、共享模块）**不需要知道宿主是什么**。
+ * 传了 `config.store` 时以 `config.store` 为准。
+ */
+export declare function setDefaultStore(store: KeyValueStore): void;
+/** 当前注入的全局默认存储后端（未注入为 undefined）。 */
+export declare function getDefaultStore(): KeyValueStore | undefined;
+/** 撤销全局默认存储后端（测试用）。 */
+export declare function clearDefaultStore(): void;
+/**
+ * 解析存储后端，优先级：
+ * `config.store`（最高）> `setDefaultStore()` 注入的全局后端 > `storage` 模式对应的内置后端。
+ *
+ * @param mode   配置里的 `storage`（默认 `auto`）
+ * @param custom 调用方在 `configure({ store })` 里传入的自定义 store
+ */
+export declare function resolveBackend(mode?: StorageMode, custom?: KeyValueStore): KeyValueStore | Promise<KeyValueStore>;
+/** Resets the cached backend — used by tests and after a `storage` config change. */
+export declare function resetStorageBackend(): void;
+export declare class TokenStore {
+    private readonly backend;
+    private readonly namespace;
+    constructor(backend: KeyValueStore, namespace: string);
+    private key;
+    readTokens<T>(): Promise<T | null>;
+    writeTokens(tokens: unknown): Promise<void>;
+    clear(): Promise<void>;
+    /** The backend actually in use, for diagnostics screens. */
+    get backendName(): string;
+    private safeRemove;
+}

package/dist/esm/core/storage.js

@@ -0,0 +1,141 @@
+const memory = new Map();
+/** 内存后端：进程内共享，适合测试与一次性脚本。 */
+export 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);
+        },
+    };
+}
+export const memoryBackend = createMemoryStore();
+/** 探活 localStorage：隐私模式/服务端渲染下读写都会抛错，此时返回 null。 */
+export 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` 为准。
+ */
+export function setDefaultStore(store) {
+    defaultStore = store;
+}
+/** 当前注入的全局默认存储后端（未注入为 undefined）。 */
+export function getDefaultStore() {
+    return defaultStore;
+}
+/** 撤销全局默认存储后端（测试用）。 */
+export function clearDefaultStore() {
+    defaultStore = undefined;
+}
+/**
+ * 解析存储后端，优先级：
+ * `config.store`（最高）> `setDefaultStore()` 注入的全局后端 > `storage` 模式对应的内置后端。
+ *
+ * @param mode   配置里的 `storage`（默认 `auto`）
+ * @param custom 调用方在 `configure({ store })` 里传入的自定义 store
+ */
+export function resolveBackend(mode = 'auto', custom) {
+    if (custom)
+        return custom;
+    if (defaultStore)
+        return defaultStore;
+    if (mode === 'memory')
+        return memoryBackend;
+    if (mode === 'localStorage')
+        return createLocalStorageStore() ?? memoryBackend;
+    // auto：localStorage → 内存（Node/SSR 没有 localStorage）
+    if (resolved)
+        return resolved;
+    resolved = createLocalStorageStore() ?? memoryBackend;
+    return resolved;
+}
+/** Resets the cached backend — used by tests and after a `storage` config change. */
+export function resetStorageBackend() {
+    resolved = null;
+}
+export 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 */
+        }
+    }
+}
+//# sourceMappingURL=storage.js.map

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

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

package/dist/esm/core/transport-fetch.d.ts

@@ -0,0 +1,2 @@
+import { Transport } from './transport.js';
+export declare function createFetchTransport(): Transport;

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

@@ -0,0 +1,54 @@
+/**
+ * 基于标准 `fetch` 的传输实现 —— 包内唯一的默认实现。
+ *
+ * 适用：Node ≥ 18、Electron 主进程、Deno/Bun、以及**同源或已配反向代理**的浏览器。
+ *
+ * ⚠️ 浏览器里直接请求 `open.snd02.com` 会被同源策略拦截：平台不返回 CORS 头。
+ * 浏览器场景请把 `baseUrl` 指向自己的代理/后端中转，或注入一个走原生网络的
+ * {@link Transport} 实现（见 README「在任何环境里使用」）。
+ */
+import { ElectricOpenPlatformError, TransportCodes } from './errors.js';
+import { assertHttpOk, DEFAULT_TIMEOUT_MS, parseBody, } from './transport.js';
+export function createFetchTransport() {
+    return {
+        name: 'fetch',
+        async postForm(req) {
+            if (req.signal?.aborted) {
+                throw new ElectricOpenPlatformError(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 ?? 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();
+                assertHttpOk(res.status, raw);
+                return { status: res.status, data: parseBody(raw), raw };
+            }
+            catch (err) {
+                if (err instanceof ElectricOpenPlatformError)
+                    throw err;
+                const aborted = err?.name === 'AbortError';
+                throw new ElectricOpenPlatformError(aborted ? TransportCodes.ABORTED : TransportCodes.NETWORK, aborted ? '请求超时或已取消' : `网络请求失败：${err?.message ?? err}`, { cause: err });
+            }
+            finally {
+                clearTimeout(timer);
+                req.signal?.removeEventListener('abort', onAbort);
+            }
+        },
+    };
+}
+//# sourceMappingURL=transport-fetch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport-fetch.js","sourceRoot":"","sources":["../../../src/core/transport-fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAGlB,SAAS,GAEV,MAAM,gBAAgB,CAAC;AAExB,MAAM,UAAU,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,yBAAyB,CAAC,cAAc,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,kBAAkB,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,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC;YAC3D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,yBAAyB;oBAAE,MAAM,GAAG,CAAC;gBACxD,MAAM,OAAO,GAAI,GAAa,EAAE,IAAI,KAAK,YAAY,CAAC;gBACtD,MAAM,IAAI,yBAAyB,CACjC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,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/esm/core/transport.d.ts

@@ -0,0 +1,23 @@
+export interface HttpRequest {
+    url: string;
+    /** form-urlencoded body. */
+    body: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface HttpResponse {
+    status: number;
+    /** Response body already parsed when it was JSON, otherwise the raw string. */
+    data: unknown;
+    raw: string;
+}
+export interface Transport {
+    /** 便于诊断：当前实际使用的传输实现名称。 */
+    readonly name: string;
+    postForm(req: HttpRequest): Promise<HttpResponse>;
+}
+export declare const DEFAULT_TIMEOUT_MS = 20000;
+export declare function parseBody(raw: string): unknown;
+/** 非 2xx 统一转成可识别的异常。 */
+export declare function assertHttpOk(status: number, raw: string): void;

package/dist/esm/core/transport.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/core/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAwBxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAM,CAAC;AAEzC,MAAM,UAAU,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,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,GAAW;IACtD,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClC,MAAM,IAAI,yBAAyB,CAAC,cAAc,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/esm/core/types.d.ts

@@ -0,0 +1,76 @@
+/** Shared configuration and token types. */
+import type { KeyValueStore } from './storage.js';
+import type { Transport } from './transport.js';
+export interface ElectricConfig {
+    /** `appKey` from the open-platform console — sent as `client_id`. */
+    appKey: string;
+    /** `appSecret` — never leaves the device except as an MD5 digest. */
+    appSecret: string;
+    /** Registered callback URL; must match the console exactly (it is signed). */
+    redirectUri: string;
+    /** Defaults to `https://open.snd02.com`. */
+    baseUrl?: string;
+    /** Default `projectCode`, so most calls do not need to repeat it. */
+    projectCode?: string;
+    /** Request timeout in ms (default 20000). */
+    timeoutMs?: number;
+    /** Renew the access token this many ms before it expires (default 60000). */
+    tokenRefreshSkewMs?: number;
+    /** `uname` used for the headless (authverify2) login flow. */
+    username?: string;
+    /** `passwd` used for the headless login flow. */
+    password?: string;
+    /** Where tokens are persisted. Default `auto`. */
+    storage?: StorageMode;
+    /**
+     * 自定义存储后端（优先级高于 `storage`）。
+     *
+     * 想把 token 写进文件、Redis、数据库，或 iOS `UserDefaults`／Android
+     * `SharedPreferences`，实现 {@link KeyValueStore} 的 4 个方法传进来即可，
+     * 包本身不会引入任何平台 SDK。
+     */
+    store?: KeyValueStore;
+    /**
+     * 自定义网络传输实现。留空则用内置 `fetch`。
+     *
+     * 浏览器里平台不返回 CORS 头，直接调用会被同源策略拦截 —— 这种情况下要么
+     * 让 `baseUrl` 指向你自己的反向代理/后端中转，要么注入一个走原生网络的实现。
+     */
+    transport?: Transport;
+    /** Called for every request/response when set. Console-friendly. */
+    logger?: ElectricLogger;
+}
+/** `auto` = localStorage → 内存；Node 里没有 localStorage 时自动退到内存。 */
+export type StorageMode = 'auto' | 'localStorage' | 'memory';
+export type ElectricLogger = (event: ElectricLogEvent) => void;
+export interface ElectricLogEvent {
+    type: 'request' | 'response' | 'token' | 'error';
+    method?: string;
+    /** Never contains the access token or the secret; bodies are redacted. */
+    detail?: Record<string, unknown>;
+    message: string;
+    at: string;
+}
+export interface TokenSet {
+    accessToken: string;
+    refreshToken: string;
+    /** `tokenType` as returned — the platform sends `"BEARER"`. */
+    tokenType: string;
+    /** Unix epoch ms at which the access token expires. */
+    expiresAt: number;
+}
+export interface LoginResult {
+    success: true;
+    /** The OAuth temporary code that was exchanged. */
+    code: string;
+    expiresIn: number;
+    expiresAt: number;
+}
+/** Envelope every `router.as` response shares. */
+export interface ApiEnvelope<T> {
+    code: string;
+    message?: string;
+    success?: boolean;
+    data: T;
+}
+export declare const DEFAULT_BASE_URL = "https://open.snd02.com";

package/dist/esm/core/types.js

@@ -0,0 +1,2 @@
+export const DEFAULT_BASE_URL = 'https://open.snd02.com';
+//# sourceMappingURL=types.js.map

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

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

package/dist/esm/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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 });
+ * ```
+ */
+export { ElectricOpenPlatform, ElectricOpenPlatformClient } from './client.js';
+export { md5, formatTimestamp, formatAlarmTime } from './core/crypto.js';
+export { signParams, buildSignedRequest, encodeForm, signAuthCodeSecret, signRefreshSecret, type ParamValue, } from './core/sign.js';
+export { postForm, parseBody, createFetchTransport, resolveTransport, setTransport, resetTransport, currentTransport, currentTransportName, hasExplicitTransport, type HttpRequest, type HttpResponse, type Transport, } from './core/http.js';
+export { detectRuntime, hasGlobalFetch, type Runtime } from './core/runtime.js';
+export { ElectricOpenPlatformError, PlatformCodes, TransportCodes, describeCode, isElectricOpenPlatformError, type PlatformCode, type TransportCode, } from './core/errors.js';
+export { DEFAULT_BASE_URL, type ElectricConfig, type ElectricLogger, type ElectricLogEvent, type StorageMode, type TokenSet, type LoginResult, type ApiEnvelope, } from './core/types.js';
+export { TokenStore, resolveBackend, resetStorageBackend, createMemoryStore, createLocalStorageStore, memoryBackend, setDefaultStore, getDefaultStore, clearDefaultStore, type KeyValueStore, } from './core/storage.js';
+export { AuthManager } from './core/auth.js';
+export { RouterClient, type CallOptions } from './core/router.js';
+export { verifyPushKey, type PushCmd } from './core/push.js';
+export { ProjectApi, BoxApi, ChannelApi, ControlApi, AlarmApi, StatsApi, SceneApi, ThirdPartyDeviceApi, parseThirdPartyData, } from './core/api.js';
+export { PushApi } from './core/push.js';
+export * from './core/models.js';

package/dist/esm/index.js

@@ -0,0 +1,47 @@
+/**
+ * @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 });
+ * ```
+ */
+export { ElectricOpenPlatform, ElectricOpenPlatformClient } from './client.js';
+// Core building blocks — exported so host apps can sign their own calls or
+// reuse the primitives in a backend.
+export { md5, formatTimestamp, formatAlarmTime } from './core/crypto.js';
+export { signParams, buildSignedRequest, encodeForm, signAuthCodeSecret, signRefreshSecret, } from './core/sign.js';
+export { postForm, parseBody, 
+// 传输层：使用方可以显式指定实现（config.transport / setTransport），
+// 未指定时一律用内置 fetch —— 不做宿主探测。
+createFetchTransport, resolveTransport, setTransport, resetTransport, currentTransport, currentTransportName, hasExplicitTransport, } from './core/http.js';
+export { detectRuntime, hasGlobalFetch } from './core/runtime.js';
+export { ElectricOpenPlatformError, PlatformCodes, TransportCodes, describeCode, isElectricOpenPlatformError, } from './core/errors.js';
+export { DEFAULT_BASE_URL, } from './core/types.js';
+export { TokenStore, resolveBackend, resetStorageBackend, createMemoryStore, createLocalStorageStore, memoryBackend, 
+// 宿主应用在 bootstrap 阶段注入全局默认存储（与 setTransport 对称），
+// 这样共享页面/组件无需引用任何平台 SDK。
+setDefaultStore, getDefaultStore, clearDefaultStore, } from './core/storage.js';
+export { AuthManager } from './core/auth.js';
+export { RouterClient } from './core/router.js';
+export { verifyPushKey } from './core/push.js';
+// Domain APIs (for typing custom wrappers) and every wire model / enum.
+export { ProjectApi, BoxApi, ChannelApi, ControlApi, AlarmApi, StatsApi, SceneApi, ThirdPartyDeviceApi, parseThirdPartyData, } from './core/api.js';
+export { PushApi } from './core/push.js';
+export * from './core/models.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE/E,2EAA2E;AAC3E,qCAAqC;AACrC,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,SAAS;AACT,oDAAoD;AACpD,6BAA6B;AAC7B,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,GAIrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAgB,MAAM,mBAAmB,CAAC;AAChF,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,2BAA2B,GAG5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,GAQjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,aAAa;AACb,iDAAiD;AACjD,yBAAyB;AACzB,eAAe,EACf,eAAe,EACf,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAoB,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAE7D,wEAAwE;AACxE,OAAO,EACL,UAAU,EACV,MAAM,EACN,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@wdywdy/electric-open-platform",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "智慧式用电数据开放平台（open.snd02.com）的纯 TypeScript SDK：OAuth2 token 生命周期、MD5 参数签名，以及全部 router.as 接口的类型化封装。零运行时依赖，Node / 浏览器 / Electron / 任意前端框架通用。",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "npm run clean && npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node scripts/finalize-cjs.mjs",
+    "clean": "node -e \"import('node:fs').then(fs=>fs.rmSync('dist',{recursive:true,force:true}))\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit -p tsconfig.json",
+    "demo": "vite --config vite.demo.config.ts",
+    "verify:live": "node scripts/verify-live.mjs",
+    "check:versions": "node scripts/check-versions.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mantunsci",
+    "electric",
+    "snd02",
+    "iot",
+    "smart-power",
+    "open-platform",
+    "sdk",
+    "api-client",
+    "oauth2",
+    "typescript"
+  ],
+  "author": "ACME 毅丰电器",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lanyangayang/cordova-mantunsci-electric.git"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "vite": "^5.4.10",
+    "vitest": "^2.1.4"
+  }
+}