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

package/dist/cjs/client.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElectricOpenPlatform = exports.ElectricOpenPlatformClient = void 0;
+/**
+ * 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();
+ * ```
+ */
+const api_js_1 = require("./core/api.js");
+const auth_js_1 = require("./core/auth.js");
+const http_js_1 = require("./core/http.js");
+const push_js_1 = require("./core/push.js");
+const runtime_js_1 = require("./core/runtime.js");
+const router_js_1 = require("./core/router.js");
+const storage_js_1 = require("./core/storage.js");
+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 (0, storage_js_1.resolveBackend)(config.storage ?? 'auto', config.store);
+        this.backend = backend;
+        const store = new storage_js_1.TokenStore(backend, config.appKey);
+        const auth = new auth_js_1.AuthManager(store, config);
+        const router = new router_js_1.RouterClient(config, auth, () => this.credentials);
+        // 传输：config.transport（最高）> 调用方 setTransport 注入的实现 > 内置 fetch
+        (0, http_js_1.setTransport)((0, http_js_1.resolveTransport)(config.transport, (0, http_js_1.hasExplicitTransport)() ? (0, http_js_1.currentTransport)() : undefined));
+        this.auth = auth;
+        this.router = router;
+        this.project = new api_js_1.ProjectApi(router);
+        this.box = new api_js_1.BoxApi(router);
+        this.channel = new api_js_1.ChannelApi(router);
+        this.control = new api_js_1.ControlApi(router);
+        this.alarm = new api_js_1.AlarmApi(router);
+        this.stats = new api_js_1.StatsApi(router);
+        this.scene = new api_js_1.SceneApi(router);
+        this.push = new push_js_1.PushApi(router);
+        this.thirdparty = new api_js_1.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 = auth_js_1.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: (0, runtime_js_1.detectRuntime)(),
+            /** 实际生效的网络传输实现 */
+            transport: (0, http_js_1.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;
+    }
+}
+exports.ElectricOpenPlatformClient = ElectricOpenPlatformClient;
+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`. */
+exports.ElectricOpenPlatform = new ElectricOpenPlatformClient();
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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