@tier0/sdk-v2 0.0.0-stage → 0.1.0

package/dist/esm/mq/broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.js","sourceRoot":"","sources":["../../../src/mq/broker.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * MQTT broker 地址归一化工具。\r\n *\r\n * 平台 `/openapi/v1/info` 返回的 `mqttBroker` 格式随环境变化，不保证统一：\r\n * - enterprise：env 为空时后端兜底返回 `tcp://<host>:1883`（面向边缘/服务端客户端的连接串）；\r\n * - SaaS（Tier0 Cloud）：env 原样透传，常见为 `host:port` 或裸 `host`。\r\n *\r\n * 浏览器 wss 客户端不应直接把它当 hostname 拼 URL（会得到 `wss://tcp://...`\r\n * 这类非法地址），先经本模块解析/推导，再交给 `Tier0MQClient`。\r\n */\r\n\r\n/** 解析后的 broker 端点。hostname 保证为裸主机（无 scheme、无端口、无路径）。 */\r\nexport interface MqttBrokerEndpoint {\r\n  /** 裸主机名（已剥离 scheme/path/query，不含端口）。 */\r\n  hostname: string;\r\n  /**\r\n   * 原始端口。注意：对 `tcp://host:1883` 这是 **tcp 端口**，浏览器 wss 场景\r\n   * 不能直接沿用（wss 通常是 8084），由 `toWebSocketUrl` 的 `wssPort` 决定。\r\n   */\r\n  port?: number;\r\n  /** 原始 scheme（tcp/mqtt/mqtts/ws/wss/...），裸 host 输入时为 undefined。 */\r\n  scheme?: string;\r\n}\r\n\r\nconst SCHEME_RE = /^([a-zA-Z][a-zA-Z0-9+.-]*):\\/\\//;\r\n\r\n/**\r\n * 解析各种形态的 broker 字符串为结构化端点。\r\n *\r\n * 兼容输入：`tcp://host:1883`、`mqtts://host:8883`、`wss://host:8084/mqtt`、\r\n * `host:1883`、裸 `host`。无法解析（空串、非法 URL）返回 undefined。\r\n */\r\nexport function parseMqttBroker(broker?: string | null): MqttBrokerEndpoint | undefined {\r\n  const raw = broker?.trim();\r\n  if (!raw) return undefined;\r\n\r\n  if (SCHEME_RE.test(raw)) {\r\n    try {\r\n      const u = new URL(raw);\r\n      if (!u.hostname) return undefined;\r\n      const scheme = SCHEME_RE.exec(raw)?.[1]?.toLowerCase();\r\n      return {\r\n        hostname: u.hostname,\r\n        port: u.port ? Number.parseInt(u.port, 10) : undefined,\r\n        scheme,\r\n      };\r\n    } catch {\r\n      return undefined;\r\n    }\r\n  }\r\n\r\n  // 无 scheme：`host:port` 或裸 `host`；含路径/空白的是垃圾输入，拒绝\r\n  if (/[\\s/]/.test(raw)) return undefined;\r\n  const i = raw.lastIndexOf(':');\r\n  if (i > 0 && /^\\d+$/.test(raw.slice(i + 1))) {\r\n    const hostname = raw.slice(0, i);\r\n    if (!hostname) return undefined;\r\n    return { hostname, port: Number.parseInt(raw.slice(i + 1), 10) };\r\n  }\r\n  return { hostname: raw };\r\n}\r\n\r\n/** 浏览器 wss 默认端口（与平台 OS_MQTT_WEBSOCKET_TSL_PORT 默认值一致）。 */\r\nexport const DEFAULT_WSS_PORT = 8084;\r\n/** MQTT over WebSocket 路径。 */\r\nexport const DEFAULT_WS_PATH = '/mqtt';\r\n\r\nexport interface ToWebSocketUrlOptions {\r\n  /** wss 端口，默认 {@link DEFAULT_WSS_PORT}（8084）。 */\r\n  wssPort?: number;\r\n  /**\r\n   * 显式指定 ws(false)/wss(true)。缺省自适应：浏览器 https 页面用 wss，\r\n   * 或 WebSocket 端口为 8084 时用 wss，其余用 ws。\r\n   */\r\n  secure?: boolean;\r\n}\r\n\r\n/**\r\n * 当前运行环境是否处于 https 安全上下文。\r\n *\r\n * 用 `globalThis.location` 而不是 `window.location`：Web Worker\r\n * （dedicated/shared）里 `window` 不存在，但 `location.protocol` 同样是 `https:`，\r\n * 应同等视为安全上下文（否则会被降级为 ws 而被浏览器按 mixed content 拦截）。\r\n */\r\nexport function isBrowserHttps(): boolean {\r\n  const loc = (globalThis as { location?: { protocol?: string } }).location;\r\n  return typeof loc?.protocol === 'string' && loc.protocol === 'https:';\r\n}\r\n\r\n/**\r\n * 把 `mqttBroker`（或 {@link MqttBrokerEndpoint}）推导为可直接传给\r\n * `Tier0MQClient` 的 WebSocket URL。\r\n *\r\n * 规则：\r\n * - 输入已是 `ws(s)://` URL：原样归一（补 `/mqtt` 路径，端口、path、query 均保留）；\r\n * - 输入 `tcp://host:1883` / `host:port` / 裸 `host`：按 `secure` 推导 scheme，\r\n *   端口一律用 `wssPort`（8084），**不沿用** tcp 端口；\r\n * - 输入为空/无法解析：返回 undefined（调用方应回退或报错，勿硬拼 URL）。\r\n *\r\n * @example\r\n * toWebSocketUrl('tcp://example.tier0.dev:1883', { secure: true });\r\n * // → 'wss://example.tier0.dev:8084/mqtt'\r\n */\r\nexport function toWebSocketUrl(\r\n  broker: string | MqttBrokerEndpoint | undefined | null,\r\n  opts: ToWebSocketUrlOptions = {},\r\n): string | undefined {\r\n  if (broker == null || broker === '') return undefined;\r\n\r\n  // 已是 ws(s) URL：解析后归一直通（保留其 scheme/端口/path/query，仅补 /mqtt 路径）\r\n  if (typeof broker === 'string' && /^wss?:\\/\\//i.test(broker.trim())) {\r\n    try {\r\n      const u = new URL(broker.trim());\r\n      if (!u.hostname) return undefined;\r\n      if (!u.pathname || u.pathname === '/') {\r\n        u.pathname = DEFAULT_WS_PATH;\r\n      }\r\n      return u.toString();\r\n    } catch {\r\n      return undefined;\r\n    }\r\n  }\r\n\r\n  const endpoint = typeof broker === 'string' ? parseMqttBroker(broker) : broker;\r\n  if (!endpoint?.hostname) return undefined;\r\n\r\n  // ws(s) 端点：保留其 scheme 与端口（\"已是 WebSocket 地址\"的直通语义）\r\n  if (endpoint.scheme === 'ws' || endpoint.scheme === 'wss') {\r\n    const port = endpoint.port ? `:${endpoint.port}` : '';\r\n    return `${endpoint.scheme}://${endpoint.hostname}${port}${DEFAULT_WS_PATH}`;\r\n  }\r\n\r\n  const port = opts.wssPort ?? DEFAULT_WSS_PORT;\r\n  const secure = opts.secure ?? (isBrowserHttps() || port === DEFAULT_WSS_PORT);\r\n  return `${secure ? 'wss' : 'ws'}://${endpoint.hostname}:${port}${DEFAULT_WS_PATH}`;\r\n}\r\n"]}

package/dist/esm/mq/client.d.ts

@@ -0,0 +1,37 @@
+import type { MQTTConfig, MQTTEventMap } from './types.js';
+/**
+ * 消息回调。公开类型保持 `void` 返回，以兼容 async handler、`push()` 简写等
+ * 既有写法；运行时额外识别返回值：handler 返回严格的 `false` 视为下游停滞
+ * （背压），SDK 会统计连续背压次数，配合 MQTTConfig.maxBackpressuredDeliveries
+ * 可在阈值内自动移除订阅。
+ */
+export type TopicHandler = (topic: string, payload: string) => void;
+export declare class Tier0MQClient {
+    private client;
+    private config;
+    private explicitClientId;
+    private explicitUsername;
+    private listeners;
+    private subscriptions;
+    private connectingPromise;
+    private _connected;
+    constructor(config?: MQTTConfig);
+    private get mqttUrl();
+    private ensureConnected;
+    private doConnect;
+    connect(config?: MQTTConfig): Promise<void>;
+    subscribe(topic: string, handler: TopicHandler): void;
+    unsubscribe(topic: string, handler?: TopicHandler): void;
+    publish(topic: string, payload: string | object, options?: {
+        qos?: number;
+        retain?: boolean;
+    }): Promise<void>;
+    disconnect(): void;
+    on<K extends keyof MQTTEventMap>(event: K, handler: MQTTEventMap[K]): void;
+    off<K extends keyof MQTTEventMap>(event: K, handler: MQTTEventMap[K]): void;
+    private emit;
+    private resubscribeAll;
+    private topicMatch;
+    get isConnected(): boolean;
+    get subscribedTopics(): string[];
+}

package/dist/esm/mq/client.js

@@ -0,0 +1,314 @@
+import mqtt from 'mqtt';
+import { getEnvVar } from '../runtime-env.js';
+import { DEFAULT_WSS_PORT, isBrowserHttps, parseMqttBroker, toWebSocketUrl } from './broker.js';
+function parseWorkspaceIDFromApiKey(apiKey) {
+    // Match the backend's sk-<type>-ws<base36>_<secret> contract, not only
+    // service keys. Other workspace-encoded keys use the same MQTT identity.
+    const match = /^sk-[^-]+-ws([0-9a-zA-Z]+)_.+$/.exec(apiKey.trim());
+    if (!match)
+        return undefined;
+    // Keep the int64 workspace ID exact; parseInt can round IDs above 2^53.
+    let workspaceID = 0n;
+    for (const digit of match[1]) {
+        workspaceID = workspaceID * 36n + BigInt(parseInt(digit, 36));
+        if (workspaceID > 9223372036854775807n)
+            return undefined;
+    }
+    return workspaceID > 0n ? workspaceID.toString() : undefined;
+}
+function generateRandomString(length = 8) {
+    const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}
+export class Tier0MQClient {
+    client = null;
+    config;
+    explicitClientId;
+    explicitUsername;
+    listeners = {};
+    subscriptions = [];
+    connectingPromise = null;
+    _connected = false;
+    constructor(config) {
+        this.explicitClientId = config?.clientId !== undefined;
+        this.explicitUsername = config?.username !== undefined;
+        const envHost = getEnvVar('TIER0_MQTT_HOST');
+        const envPort = getEnvVar('TIER0_MQTT_PORT');
+        const host = config?.host || envHost || '';
+        const port = config?.port || parseInt(envPort || '8084') || 8084;
+        const password = config?.password || getEnvVar('TIER0_API_KEY') || '';
+        // 从 apiKey 解析 workspaceID，自动生成 clientId 和 username
+        const workspaceID = config?.clientId && config?.username
+            ? undefined
+            : parseWorkspaceIDFromApiKey(password);
+        const autoClientId = workspaceID
+            ? `${workspaceID}&${generateRandomString(8)}`
+            : undefined;
+        const autoUsername = workspaceID
+            ? `${workspaceID}&open`
+            : undefined;
+        this.config = {
+            host,
+            port,
+            clientId: config?.clientId || autoClientId,
+            username: config?.username || autoUsername,
+            password,
+            keepAlive: config?.keepAlive ?? 60,
+            reconnectPeriod: config?.reconnectPeriod ?? 5000,
+            connectTimeout: config?.connectTimeout ?? 30000,
+            clean: config?.clean ?? true,
+            ...config,
+        };
+    }
+    get mqttUrl() {
+        const { host, port, secure } = this.config;
+        if (!host) {
+            throw new Error('MQTT host is required. Provide it via MQTTConfig or TIER0_MQTT_HOST environment variable.');
+        }
+        const normalizedHost = host.trim().replace(/\/+$/, '');
+        if (/^wss?:\/\//i.test(normalizedHost)) {
+            const url = toWebSocketUrl(normalizedHost);
+            if (!url)
+                throw new TypeError('Invalid MQTT WebSocket URL');
+            return url;
+        }
+        // 裸 host（可含端口）：按运行环境自适应 ws/wss
+        const endpoint = parseMqttBroker(normalizedHost);
+        const hostname = endpoint?.hostname ?? normalizedHost;
+        // 裸 host:port 和 ws(s) URL 的端口按 WebSocket 端口处理；
+        // tcp/mqtt/mqtts 的端口是 TCP 端口（如 1883），wss 下不能沿用，回退到配置的 port
+        const effectivePort = !endpoint?.scheme || endpoint.scheme === 'ws' || endpoint.scheme === 'wss'
+            ? endpoint?.port ?? port
+            : port;
+        const useSecure = secure ?? (isBrowserHttps() || effectivePort === DEFAULT_WSS_PORT);
+        return `${useSecure ? 'wss' : 'ws'}://${hostname}:${effectivePort}/mqtt`;
+    }
+    // 内部确保已连接（懒连接）
+    async ensureConnected() {
+        if (this._connected)
+            return;
+        if (this.connectingPromise)
+            return this.connectingPromise;
+        void this.mqttUrl;
+        if (!this.config.password || !this.config.username || !this.config.clientId) {
+            throw new Error('Tier0 SDK v2: provide a workspace-encoded API key or explicit MQTT username, clientId and password.');
+        }
+        this.connectingPromise = this.doConnect();
+        return this.connectingPromise;
+    }
+    doConnect() {
+        return new Promise((resolve, reject) => {
+            const options = {
+                clientId: this.config.clientId,
+                username: this.config.username,
+                password: this.config.password,
+                keepalive: this.config.keepAlive,
+                reconnectPeriod: this.config.reconnectPeriod,
+                connectTimeout: this.config.connectTimeout,
+                clean: this.config.clean,
+            };
+            this.client = mqtt.connect(this.mqttUrl, options);
+            this.client.on('connect', () => {
+                this._connected = true;
+                this.connectingPromise = null;
+                this.emit('connect');
+                // 断连重连后自动恢复所有订阅
+                this.resubscribeAll();
+                resolve();
+            });
+            this.client.on('error', (err) => {
+                this.emit('error', err);
+                this.connectingPromise = null;
+                reject(err);
+            });
+            this.client.on('disconnect', () => {
+                this._connected = false;
+                this.emit('disconnect');
+            });
+            this.client.on('close', () => {
+                this._connected = false;
+            });
+            this.client.on('message', (topic, payload, _packet) => {
+                const payloadStr = payload.toString();
+                // 复制一份快照：handler 触发背压自动退订时会重建 this.subscriptions
+                this.subscriptions.slice().forEach((sub) => {
+                    if (this.topicMatch(sub.topic, topic)) {
+                        try {
+                            // 公开类型为 void 返回（兼容 async/简写 handler），运行时仅识别严格的 false
+                            const accepted = sub.handler(topic, payloadStr);
+                            if (accepted === false) {
+                                sub.backpressuredCount = (sub.backpressuredCount ?? 0) + 1;
+                                const limit = this.config.maxBackpressuredDeliveries ?? 0;
+                                if (limit > 0 && sub.backpressuredCount >= limit) {
+                                    this.unsubscribe(sub.topic, sub.handler);
+                                    this.emit('subscriptionDropped', {
+                                        topic: sub.topic,
+                                        reason: `handler 连续 ${sub.backpressuredCount} 次返回背压（false），已按 maxBackpressuredDeliveries=${limit} 自动退订`,
+                                    });
+                                }
+                            }
+                            else {
+                                sub.backpressuredCount = 0;
+                            }
+                        }
+                        catch (e) {
+                            this.emit('error', e);
+                        }
+                    }
+                });
+            });
+        });
+    }
+    // 显式连接（需要等待连接完成时使用）
+    async connect(config) {
+        if (config) {
+            const previousPassword = this.config.password;
+            this.config = { ...this.config, ...config };
+            if (config.clientId !== undefined)
+                this.explicitClientId = true;
+            if (config.username !== undefined)
+                this.explicitUsername = true;
+            // A connect-time key may belong to a different workspace. Preserve only
+            // caller-supplied identity fields, not values derived from the previous key.
+            if (config.password !== undefined && config.password !== previousPassword) {
+                const workspaceID = parseWorkspaceIDFromApiKey(config.password);
+                if (!this.explicitClientId) {
+                    this.config.clientId = workspaceID ? workspaceID + '&' + generateRandomString(8) : undefined;
+                }
+                if (!this.explicitUsername)
+                    this.config.username = workspaceID ? workspaceID + '&open' : undefined;
+            }
+        }
+        return this.ensureConnected();
+    }
+    // 订阅 topic，内部 qos 固定为 1，handler 接收 (topic, payload)
+    // 无需先调用 connect()，自动处理连接
+    subscribe(topic, handler) {
+        // 避免重复注册同一 topic 的同一 handler
+        const exists = this.subscriptions.some((s) => s.topic === topic && s.handler === handler);
+        if (exists) {
+            return;
+        }
+        this.subscriptions.push({ topic, handler });
+        if (this._connected && this.client) {
+            this.client.subscribe(topic, { qos: 1 }, (err) => {
+                if (err) {
+                    this.emit('error', err);
+                    // 订阅失败时回滚
+                    this.subscriptions = this.subscriptions.filter((s) => !(s.topic === topic && s.handler === handler));
+                }
+            });
+        }
+        else {
+            // 未连接时触发懒连接，连接成功后 resubscribeAll 会自动 subscribe
+            this.ensureConnected().catch((err) => this.emit('error', err));
+        }
+    }
+    // 取消订阅：如果提供了 handler 则仅移除该 handler，否则移除该 topic 下所有 handler
+    unsubscribe(topic, handler) {
+        if (handler) {
+            this.subscriptions = this.subscriptions.filter((s) => !(s.topic === topic && s.handler === handler));
+        }
+        else {
+            this.subscriptions = this.subscriptions.filter((s) => s.topic !== topic);
+        }
+        if (!this.client)
+            return;
+        // 如果该 topic 下已无任何 handler，则向 broker 发送 unsubscribe
+        const stillHasHandler = this.subscriptions.some((s) => s.topic === topic);
+        if (!stillHasHandler) {
+            this.client.unsubscribe(topic, (err) => {
+                if (err) {
+                    this.emit('error', err);
+                }
+            });
+        }
+    }
+    // 发布消息，无需先调用 connect()，内部自动处理连接
+    async publish(topic, payload, options) {
+        await this.ensureConnected();
+        const message = typeof payload === 'string' ? payload : JSON.stringify(payload);
+        this.client.publish(topic, message, {
+            qos: (options?.qos ?? 0),
+            retain: options?.retain ?? false,
+        });
+    }
+    disconnect() {
+        if (!this.client)
+            return;
+        this.client.end(true, () => {
+            this.emit('disconnect');
+        });
+        this.client = null;
+        this._connected = false;
+        this.connectingPromise = null;
+        this.subscriptions = [];
+    }
+    on(event, handler) {
+        if (!this.listeners[event]) {
+            this.listeners[event] = [];
+        }
+        this.listeners[event].push(handler);
+    }
+    off(event, handler) {
+        const handlers = this.listeners[event];
+        if (!handlers)
+            return;
+        const idx = handlers.indexOf(handler);
+        if (idx !== -1) {
+            handlers.splice(idx, 1);
+        }
+    }
+    emit(event, ...args) {
+        const handlers = this.listeners[event];
+        if (!handlers)
+            return;
+        handlers.forEach((h) => h(...args));
+    }
+    // 断连后自动重新订阅所有已注册的 topic
+    resubscribeAll() {
+        if (!this.client)
+            return;
+        // 按 topic 去重，每个 topic 只订阅一次
+        const uniqueTopics = Array.from(new Set(this.subscriptions.map((s) => s.topic)));
+        uniqueTopics.forEach((topic) => {
+            this.client.subscribe(topic, { qos: 1 }, (err) => {
+                if (err) {
+                    this.emit('error', err);
+                }
+            });
+        });
+    }
+    // 判断接收到的 topic 是否匹配订阅的 topic（支持通配符 # 和 +）
+    topicMatch(subscribed, received) {
+        const subParts = subscribed.split('/');
+        const recParts = received.split('/');
+        for (let i = 0; i < subParts.length; i++) {
+            const sp = subParts[i];
+            const rp = recParts[i];
+            if (sp === '#') {
+                // # 必须是最后一个层级，匹配后面所有
+                return true;
+            }
+            if (sp === '+') {
+                // + 匹配单个层级
+                continue;
+            }
+            if (sp !== rp) {
+                return false;
+            }
+        }
+        return subParts.length === recParts.length;
+    }
+    get isConnected() {
+        return this._connected;
+    }
+    get subscribedTopics() {
+        return Array.from(new Set(this.subscriptions.map((s) => s.topic)));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/mq/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/mq/client.ts"],"names":[],"mappings":"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","sourcesContent":["import mqtt from 'mqtt';\r\nimport type { MqttClient, IClientOptions } from 'mqtt';\r\nimport { getEnvVar } from '../runtime-env.js';\r\nimport { DEFAULT_WSS_PORT, isBrowserHttps, parseMqttBroker, toWebSocketUrl } from './broker.js';\r\nimport type { MQTTConfig, MQTTEventMap } from './types.js';\r\n\r\n/**\r\n * 消息回调。公开类型保持 `void` 返回，以兼容 async handler、`push()` 简写等\r\n * 既有写法；运行时额外识别返回值：handler 返回严格的 `false` 视为下游停滞\r\n * （背压），SDK 会统计连续背压次数，配合 MQTTConfig.maxBackpressuredDeliveries\r\n * 可在阈值内自动移除订阅。\r\n */\r\nexport type TopicHandler = (topic: string, payload: string) => void;\r\n\r\nfunction parseWorkspaceIDFromApiKey(apiKey: string): string | undefined {\r\n  // Match the backend's sk-<type>-ws<base36>_<secret> contract, not only\r\n  // service keys. Other workspace-encoded keys use the same MQTT identity.\r\n  const match = /^sk-[^-]+-ws([0-9a-zA-Z]+)_.+$/.exec(apiKey.trim());\r\n  if (!match) return undefined;\r\n\r\n  // Keep the int64 workspace ID exact; parseInt can round IDs above 2^53.\r\n  let workspaceID = 0n;\r\n  for (const digit of match[1]) {\r\n    workspaceID = workspaceID * 36n + BigInt(parseInt(digit, 36));\r\n    if (workspaceID > 9223372036854775807n) return undefined;\r\n  }\r\n  return workspaceID > 0n ? workspaceID.toString() : undefined;\r\n}\r\n\r\nfunction generateRandomString(length = 8): string {\r\n  const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';\r\n  let result = '';\r\n  for (let i = 0; i < length; i++) {\r\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\r\n  }\r\n  return result;\r\n}\r\n\r\ninterface Subscription {\r\n  topic: string;\r\n  handler: TopicHandler;\r\n  /** handler 连续返回 false（背压）的次数，正常返回时清零。 */\r\n  backpressuredCount?: number;\r\n}\r\n\r\nexport class Tier0MQClient {\r\n  private client: MqttClient | null = null;\r\n  private config: MQTTConfig;\r\n  private explicitClientId: boolean;\r\n  private explicitUsername: boolean;\r\n  private listeners: { [K in keyof MQTTEventMap]?: Array<MQTTEventMap[K]> } = {};\r\n  private subscriptions: Subscription[] = [];\r\n  private connectingPromise: Promise<void> | null = null;\r\n  private _connected = false;\r\n\r\n  constructor(config?: MQTTConfig) {\r\n    this.explicitClientId = config?.clientId !== undefined;\r\n    this.explicitUsername = config?.username !== undefined;\r\n    const envHost = getEnvVar('TIER0_MQTT_HOST');\r\n    const envPort = getEnvVar('TIER0_MQTT_PORT');\r\n\r\n    const host = config?.host || envHost || '';\r\n    const port = config?.port || parseInt(envPort || '8084') || 8084;\r\n    const password = config?.password || getEnvVar('TIER0_API_KEY') || '';\r\n\r\n    // 从 apiKey 解析 workspaceID，自动生成 clientId 和 username\r\n    const workspaceID = config?.clientId && config?.username\r\n      ? undefined\r\n      : parseWorkspaceIDFromApiKey(password);\r\n\r\n    const autoClientId = workspaceID\r\n      ? `${workspaceID}&${generateRandomString(8)}`\r\n      : undefined;\r\n    const autoUsername = workspaceID\r\n      ? `${workspaceID}&open`\r\n      : undefined;\r\n\r\n    this.config = {\r\n      host,\r\n      port,\r\n      clientId: config?.clientId || autoClientId,\r\n      username: config?.username || autoUsername,\r\n      password,\r\n      keepAlive: config?.keepAlive ?? 60,\r\n      reconnectPeriod: config?.reconnectPeriod ?? 5000,\r\n      connectTimeout: config?.connectTimeout ?? 30000,\r\n      clean: config?.clean ?? true,\r\n      ...config,\r\n    };\r\n  }\r\n\r\n  private get mqttUrl(): string {\r\n    const { host, port, secure } = this.config;\r\n    if (!host) {\r\n      throw new Error(\r\n        'MQTT host is required. Provide it via MQTTConfig or TIER0_MQTT_HOST environment variable.'\r\n      );\r\n    }\r\n    const normalizedHost = host.trim().replace(/\\/+$/, '');\r\n    if (/^wss?:\\/\\//i.test(normalizedHost)) {\r\n      const url = toWebSocketUrl(normalizedHost);\r\n      if (!url) throw new TypeError('Invalid MQTT WebSocket URL');\r\n      return url;\r\n    }\r\n    // 裸 host（可含端口）：按运行环境自适应 ws/wss\r\n    const endpoint = parseMqttBroker(normalizedHost);\r\n    const hostname = endpoint?.hostname ?? normalizedHost;\r\n    // 裸 host:port 和 ws(s) URL 的端口按 WebSocket 端口处理；\r\n    // tcp/mqtt/mqtts 的端口是 TCP 端口（如 1883），wss 下不能沿用，回退到配置的 port\r\n    const effectivePort =\r\n      !endpoint?.scheme || endpoint.scheme === 'ws' || endpoint.scheme === 'wss'\r\n        ? endpoint?.port ?? port\r\n        : port;\r\n    const useSecure = secure ?? (isBrowserHttps() || effectivePort === DEFAULT_WSS_PORT);\r\n    return `${useSecure ? 'wss' : 'ws'}://${hostname}:${effectivePort}/mqtt`;\r\n  }\r\n\r\n  // 内部确保已连接（懒连接）\r\n  private async ensureConnected(): Promise<void> {\r\n    if (this._connected) return;\r\n    if (this.connectingPromise) return this.connectingPromise;\r\n\r\n    void this.mqttUrl;\r\n    if (!this.config.password || !this.config.username || !this.config.clientId) {\r\n      throw new Error('Tier0 SDK v2: provide a workspace-encoded API key or explicit MQTT username, clientId and password.');\r\n    }\r\n\r\n    this.connectingPromise = this.doConnect();\r\n    return this.connectingPromise;\r\n  }\r\n\r\n  private doConnect(): Promise<void> {\r\n    return new Promise((resolve, reject) => {\r\n      const options: IClientOptions = {\r\n        clientId: this.config.clientId,\r\n        username: this.config.username,\r\n        password: this.config.password,\r\n        keepalive: this.config.keepAlive,\r\n        reconnectPeriod: this.config.reconnectPeriod,\r\n        connectTimeout: this.config.connectTimeout,\r\n        clean: this.config.clean,\r\n      };\r\n\r\n      this.client = mqtt.connect(this.mqttUrl, options);\r\n\r\n      this.client.on('connect', () => {\r\n        this._connected = true;\r\n        this.connectingPromise = null;\r\n        this.emit('connect');\r\n        // 断连重连后自动恢复所有订阅\r\n        this.resubscribeAll();\r\n        resolve();\r\n      });\r\n\r\n      this.client.on('error', (err) => {\r\n        this.emit('error', err);\r\n        this.connectingPromise = null;\r\n        reject(err);\r\n      });\r\n\r\n      this.client.on('disconnect', () => {\r\n        this._connected = false;\r\n        this.emit('disconnect');\r\n      });\r\n\r\n      this.client.on('close', () => {\r\n        this._connected = false;\r\n      });\r\n\r\n      this.client.on(\r\n        'message',\r\n        (topic: string, payload: Buffer, _packet: mqtt.IPublishPacket) => {\r\n          const payloadStr = payload.toString();\r\n          // 复制一份快照：handler 触发背压自动退订时会重建 this.subscriptions\r\n          this.subscriptions.slice().forEach((sub) => {\r\n            if (this.topicMatch(sub.topic, topic)) {\r\n              try {\r\n                // 公开类型为 void 返回（兼容 async/简写 handler），运行时仅识别严格的 false\r\n                const accepted = (\r\n                  sub.handler as (t: string, p: string) => unknown\r\n                )(topic, payloadStr);\r\n                if (accepted === false) {\r\n                  sub.backpressuredCount = (sub.backpressuredCount ?? 0) + 1;\r\n                  const limit = this.config.maxBackpressuredDeliveries ?? 0;\r\n                  if (limit > 0 && sub.backpressuredCount >= limit) {\r\n                    this.unsubscribe(sub.topic, sub.handler);\r\n                    this.emit('subscriptionDropped', {\r\n                      topic: sub.topic,\r\n                      reason: `handler 连续 ${sub.backpressuredCount} 次返回背压（false），已按 maxBackpressuredDeliveries=${limit} 自动退订`,\r\n                    });\r\n                  }\r\n                } else {\r\n                  sub.backpressuredCount = 0;\r\n                }\r\n              } catch (e) {\r\n                this.emit('error', e as Error);\r\n              }\r\n            }\r\n          });\r\n        }\r\n      );\r\n    });\r\n  }\r\n\r\n  // 显式连接（需要等待连接完成时使用）\r\n  async connect(config?: MQTTConfig): Promise<void> {\r\n    if (config) {\r\n      const previousPassword = this.config.password;\r\n      this.config = { ...this.config, ...config };\r\n      if (config.clientId !== undefined) this.explicitClientId = true;\r\n      if (config.username !== undefined) this.explicitUsername = true;\r\n      // A connect-time key may belong to a different workspace. Preserve only\r\n      // caller-supplied identity fields, not values derived from the previous key.\r\n      if (config.password !== undefined && config.password !== previousPassword) {\r\n        const workspaceID = parseWorkspaceIDFromApiKey(config.password);\r\n        if (!this.explicitClientId) {\r\n          this.config.clientId = workspaceID ? workspaceID + '&' + generateRandomString(8) : undefined;\r\n        }\r\n        if (!this.explicitUsername) this.config.username = workspaceID ? workspaceID + '&open' : undefined;\r\n      }\r\n    }\r\n    return this.ensureConnected();\r\n  }\r\n\r\n  // 订阅 topic，内部 qos 固定为 1，handler 接收 (topic, payload)\r\n  // 无需先调用 connect()，自动处理连接\r\n  subscribe(topic: string, handler: TopicHandler): void {\r\n    // 避免重复注册同一 topic 的同一 handler\r\n    const exists = this.subscriptions.some(\r\n      (s) => s.topic === topic && s.handler === handler\r\n    );\r\n    if (exists) {\r\n      return;\r\n    }\r\n\r\n    this.subscriptions.push({ topic, handler });\r\n\r\n    if (this._connected && this.client) {\r\n      this.client.subscribe(topic, { qos: 1 as 0 | 1 | 2 }, (err) => {\r\n        if (err) {\r\n          this.emit('error', err);\r\n          // 订阅失败时回滚\r\n          this.subscriptions = this.subscriptions.filter(\r\n            (s) => !(s.topic === topic && s.handler === handler)\r\n          );\r\n        }\r\n      });\r\n    } else {\r\n      // 未连接时触发懒连接，连接成功后 resubscribeAll 会自动 subscribe\r\n      this.ensureConnected().catch((err) => this.emit('error', err));\r\n    }\r\n  }\r\n\r\n  // 取消订阅：如果提供了 handler 则仅移除该 handler，否则移除该 topic 下所有 handler\r\n  unsubscribe(topic: string, handler?: TopicHandler): void {\r\n    if (handler) {\r\n      this.subscriptions = this.subscriptions.filter(\r\n        (s) => !(s.topic === topic && s.handler === handler)\r\n      );\r\n    } else {\r\n      this.subscriptions = this.subscriptions.filter((s) => s.topic !== topic);\r\n    }\r\n\r\n    if (!this.client) return;\r\n\r\n    // 如果该 topic 下已无任何 handler，则向 broker 发送 unsubscribe\r\n    const stillHasHandler = this.subscriptions.some((s) => s.topic === topic);\r\n    if (!stillHasHandler) {\r\n      this.client.unsubscribe(topic, (err) => {\r\n        if (err) {\r\n          this.emit('error', err);\r\n        }\r\n      });\r\n    }\r\n  }\r\n\r\n  // 发布消息，无需先调用 connect()，内部自动处理连接\r\n  async publish(\r\n    topic: string,\r\n    payload: string | object,\r\n    options?: { qos?: number; retain?: boolean }\r\n  ): Promise<void> {\r\n    await this.ensureConnected();\r\n\r\n    const message =\r\n      typeof payload === 'string' ? payload : JSON.stringify(payload);\r\n    this.client!.publish(topic, message, {\r\n      qos: (options?.qos ?? 0) as 0 | 1 | 2,\r\n      retain: options?.retain ?? false,\r\n    });\r\n  }\r\n\r\n  disconnect(): void {\r\n    if (!this.client) return;\r\n\r\n    this.client.end(true, () => {\r\n      this.emit('disconnect');\r\n    });\r\n    this.client = null;\r\n    this._connected = false;\r\n    this.connectingPromise = null;\r\n    this.subscriptions = [];\r\n  }\r\n\r\n  on<K extends keyof MQTTEventMap>(event: K, handler: MQTTEventMap[K]): void {\r\n    if (!this.listeners[event]) {\r\n      this.listeners[event] = [];\r\n    }\r\n    this.listeners[event]!.push(handler);\r\n  }\r\n\r\n  off<K extends keyof MQTTEventMap>(event: K, handler: MQTTEventMap[K]): void {\r\n    const handlers = this.listeners[event];\r\n    if (!handlers) return;\r\n    const idx = handlers.indexOf(handler);\r\n    if (idx !== -1) {\r\n      handlers.splice(idx, 1);\r\n    }\r\n  }\r\n\r\n  private emit<K extends keyof MQTTEventMap>(\r\n    event: K,\r\n    ...args: Parameters<MQTTEventMap[K]>\r\n  ): void {\r\n    const handlers = this.listeners[event];\r\n    if (!handlers) return;\r\n    handlers.forEach((h) => (h as any)(...args));\r\n  }\r\n\r\n  // 断连后自动重新订阅所有已注册的 topic\r\n  private resubscribeAll(): void {\r\n    if (!this.client) return;\r\n\r\n    // 按 topic 去重，每个 topic 只订阅一次\r\n    const uniqueTopics = Array.from(\r\n      new Set(this.subscriptions.map((s) => s.topic))\r\n    );\r\n    uniqueTopics.forEach((topic) => {\r\n      this.client!.subscribe(topic, { qos: 1 as 0 | 1 | 2 }, (err) => {\r\n        if (err) {\r\n          this.emit('error', err);\r\n        }\r\n      });\r\n    });\r\n  }\r\n\r\n  // 判断接收到的 topic 是否匹配订阅的 topic（支持通配符 # 和 +）\r\n  private topicMatch(subscribed: string, received: string): boolean {\r\n    const subParts = subscribed.split('/');\r\n    const recParts = received.split('/');\r\n\r\n    for (let i = 0; i < subParts.length; i++) {\r\n      const sp = subParts[i];\r\n      const rp = recParts[i];\r\n\r\n      if (sp === '#') {\r\n        // # 必须是最后一个层级，匹配后面所有\r\n        return true;\r\n      }\r\n      if (sp === '+') {\r\n        // + 匹配单个层级\r\n        continue;\r\n      }\r\n      if (sp !== rp) {\r\n        return false;\r\n      }\r\n    }\r\n\r\n    return subParts.length === recParts.length;\r\n  }\r\n\r\n  get isConnected(): boolean {\r\n    return this._connected;\r\n  }\r\n\r\n  get subscribedTopics(): string[] {\r\n    return Array.from(new Set(this.subscriptions.map((s) => s.topic)));\r\n  }\r\n}\r\n"]}

package/dist/esm/mq/index.d.ts

@@ -0,0 +1,5 @@
+export { Tier0MQClient } from './client.js';
+export type { TopicHandler } from './client.js';
+export { parseMqttBroker, toWebSocketUrl, DEFAULT_WSS_PORT, DEFAULT_WS_PATH, } from './broker.js';
+export type { MqttBrokerEndpoint, ToWebSocketUrlOptions } from './broker.js';
+export type { MQTTConfig, MQTTMessage, MQTTEventMap } from './types.js';

package/dist/esm/mq/index.js

@@ -0,0 +1,3 @@
+export { Tier0MQClient } from './client.js';
+export { parseMqttBroker, toWebSocketUrl, DEFAULT_WSS_PORT, DEFAULT_WS_PATH, } from './broker.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/mq/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mq/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC","sourcesContent":["export { Tier0MQClient } from './client.js';\r\nexport type { TopicHandler } from './client.js';\r\nexport {\r\n  parseMqttBroker,\r\n  toWebSocketUrl,\r\n  DEFAULT_WSS_PORT,\r\n  DEFAULT_WS_PATH,\r\n} from './broker.js';\r\nexport type { MqttBrokerEndpoint, ToWebSocketUrlOptions } from './broker.js';\r\nexport type { MQTTConfig, MQTTMessage, MQTTEventMap } from './types.js';\r\n"]}

package/dist/esm/mq/types.d.ts

@@ -0,0 +1,48 @@
+export interface MQTTConfig {
+    /**
+     * broker 地址。支持三种形态：
+     * - 完整 WebSocket URL，如 `wss://host:8084/mqtt`（推荐浏览器场景显式使用）；
+     * - 裸 `host`（可含端口，如 `host:8084`）；
+     * - 平台 `/openapi/v1/info` 返回的原始 `mqttBroker`（如 `tcp://host:1883`，
+     *   建议先用 {@link toWebSocketUrl} 归一后再传入，见 `@tier0/sdk-v2/mq` 的 broker 工具）。
+     */
+    host?: string;
+    /** WebSocket port fallback when host has no embedded WebSocket port. */
+    port?: number;
+    /**
+     * 当 host 不带 ws(s) scheme 时，显式指定用 wss(true) 还是 ws(false)。
+     * 缺省自适应：浏览器 https 页面或端口 8084 用 wss，其余用 ws。
+     */
+    secure?: boolean;
+    clientId?: string;
+    username?: string;
+    /** Original API key; connect-time changes refresh automatically derived identity fields. */
+    password?: string;
+    keepAlive?: number;
+    reconnectPeriod?: number;
+    connectTimeout?: number;
+    clean?: boolean;
+    /**
+     * 背压保护阈值：handler 连续返回 false（表示下游停滞/消费者已断开）达到
+     * 该次数后，SDK 自动移除该订阅并向 broker 退订，避免消息在无消费者的
+     * 应用内队列中持续堆积。0 或不设置表示关闭该保护（保持原有行为）。
+     */
+    maxBackpressuredDeliveries?: number;
+}
+export type MQTTMessage = {
+    topic: string;
+    payload: string | Buffer;
+    qos: number;
+    retain: boolean;
+};
+export type MQTTEventMap = {
+    connect: () => void;
+    disconnect: () => void;
+    error: (error: Error) => void;
+    message: (message: MQTTMessage) => void;
+    /** 订阅因持续背压被 SDK 自动移除时触发。 */
+    subscriptionDropped: (info: {
+        topic: string;
+        reason: string;
+    }) => void;
+};

package/dist/esm/mq/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mq/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface MQTTConfig {\r\n  /**\r\n   * broker 地址。支持三种形态：\r\n   * - 完整 WebSocket URL，如 `wss://host:8084/mqtt`（推荐浏览器场景显式使用）；\r\n   * - 裸 `host`（可含端口，如 `host:8084`）；\r\n   * - 平台 `/openapi/v1/info` 返回的原始 `mqttBroker`（如 `tcp://host:1883`，\r\n   *   建议先用 {@link toWebSocketUrl} 归一后再传入，见 `@tier0/sdk-v2/mq` 的 broker 工具）。\r\n   */\r\n  host?: string;\r\n  /** WebSocket port fallback when host has no embedded WebSocket port. */\r\n  port?: number;\r\n  /**\r\n   * 当 host 不带 ws(s) scheme 时，显式指定用 wss(true) 还是 ws(false)。\r\n   * 缺省自适应：浏览器 https 页面或端口 8084 用 wss，其余用 ws。\r\n   */\r\n  secure?: boolean;\r\n  clientId?: string;\r\n  username?: string;\r\n  /** Original API key; connect-time changes refresh automatically derived identity fields. */\r\n  password?: string;\r\n  keepAlive?: number;\r\n  reconnectPeriod?: number;\r\n  connectTimeout?: number;\r\n  clean?: boolean;\r\n  /**\r\n   * 背压保护阈值：handler 连续返回 false（表示下游停滞/消费者已断开）达到\r\n   * 该次数后，SDK 自动移除该订阅并向 broker 退订，避免消息在无消费者的\r\n   * 应用内队列中持续堆积。0 或不设置表示关闭该保护（保持原有行为）。\r\n   */\r\n  maxBackpressuredDeliveries?: number;\r\n}\r\n\r\nexport type MQTTMessage = {\r\n  topic: string;\r\n  payload: string | Buffer;\r\n  qos: number;\r\n  retain: boolean;\r\n};\r\n\r\nexport type MQTTEventMap = {\r\n  connect: () => void;\r\n  disconnect: () => void;\r\n  error: (error: Error) => void;\r\n  message: (message: MQTTMessage) => void;\r\n  /** 订阅因持续背压被 SDK 自动移除时触发。 */\r\n  subscriptionDropped: (info: { topic: string; reason: string }) => void;\r\n};\r\n"]}