@michengai/dsh-im-connect 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/README.md +39 -0
- package/client.js +1479 -0
- package/cordis.patch.yml +4 -0
- package/lib/channels/dingtalk-card.d.ts +24 -0
- package/lib/channels/dingtalk-card.d.ts.map +1 -0
- package/lib/channels/dingtalk-card.js +182 -0
- package/lib/channels/dingtalk-card.js.map +1 -0
- package/lib/channels/dingtalk.d.ts +7 -0
- package/lib/channels/dingtalk.d.ts.map +1 -0
- package/lib/channels/dingtalk.js +107 -0
- package/lib/channels/dingtalk.js.map +1 -0
- package/lib/channels/factory.d.ts +4 -0
- package/lib/channels/factory.d.ts.map +1 -0
- package/lib/channels/factory.js +24 -0
- package/lib/channels/factory.js.map +1 -0
- package/lib/channels/feishu.d.ts +8 -0
- package/lib/channels/feishu.d.ts.map +1 -0
- package/lib/channels/feishu.js +73 -0
- package/lib/channels/feishu.js.map +1 -0
- package/lib/channels/meta.d.ts +20 -0
- package/lib/channels/meta.d.ts.map +1 -0
- package/lib/channels/meta.js +69 -0
- package/lib/channels/meta.js.map +1 -0
- package/lib/channels/qr/dingtalk.d.ts +12 -0
- package/lib/channels/qr/dingtalk.d.ts.map +1 -0
- package/lib/channels/qr/dingtalk.js +69 -0
- package/lib/channels/qr/dingtalk.js.map +1 -0
- package/lib/channels/qr/feishu.d.ts +14 -0
- package/lib/channels/qr/feishu.d.ts.map +1 -0
- package/lib/channels/qr/feishu.js +87 -0
- package/lib/channels/qr/feishu.js.map +1 -0
- package/lib/channels/qr/hub.d.ts +22 -0
- package/lib/channels/qr/hub.d.ts.map +1 -0
- package/lib/channels/qr/hub.js +193 -0
- package/lib/channels/qr/hub.js.map +1 -0
- package/lib/channels/qr/render.d.ts +3 -0
- package/lib/channels/qr/render.d.ts.map +1 -0
- package/lib/channels/qr/render.js +9 -0
- package/lib/channels/qr/render.js.map +1 -0
- package/lib/channels/qr/shared.d.ts +39 -0
- package/lib/channels/qr/shared.d.ts.map +1 -0
- package/lib/channels/qr/shared.js +51 -0
- package/lib/channels/qr/shared.js.map +1 -0
- package/lib/channels/qr/wecom.d.ts +10 -0
- package/lib/channels/qr/wecom.d.ts.map +1 -0
- package/lib/channels/qr/wecom.js +81 -0
- package/lib/channels/qr/wecom.js.map +1 -0
- package/lib/channels/qr/weixin.d.ts +10 -0
- package/lib/channels/qr/weixin.d.ts.map +1 -0
- package/lib/channels/qr/weixin.js +77 -0
- package/lib/channels/qr/weixin.js.map +1 -0
- package/lib/channels/telegram.d.ts +7 -0
- package/lib/channels/telegram.d.ts.map +1 -0
- package/lib/channels/telegram.js +133 -0
- package/lib/channels/telegram.js.map +1 -0
- package/lib/channels/wecom.d.ts +28 -0
- package/lib/channels/wecom.d.ts.map +1 -0
- package/lib/channels/wecom.js +168 -0
- package/lib/channels/wecom.js.map +1 -0
- package/lib/channels/weixin.d.ts +41 -0
- package/lib/channels/weixin.d.ts.map +1 -0
- package/lib/channels/weixin.js +678 -0
- package/lib/channels/weixin.js.map +1 -0
- package/lib/client.js +1479 -0
- package/lib/engine/access.d.ts +11 -0
- package/lib/engine/access.d.ts.map +1 -0
- package/lib/engine/access.js +11 -0
- package/lib/engine/access.js.map +1 -0
- package/lib/engine/agent-options.d.ts +25 -0
- package/lib/engine/agent-options.d.ts.map +1 -0
- package/lib/engine/agent-options.js +19 -0
- package/lib/engine/agent-options.js.map +1 -0
- package/lib/engine/approval.d.ts +9 -0
- package/lib/engine/approval.d.ts.map +1 -0
- package/lib/engine/approval.js +38 -0
- package/lib/engine/approval.js.map +1 -0
- package/lib/engine/assistant-settings.d.ts +17 -0
- package/lib/engine/assistant-settings.d.ts.map +1 -0
- package/lib/engine/assistant-settings.js +35 -0
- package/lib/engine/assistant-settings.js.map +1 -0
- package/lib/engine/credentials.d.ts +17 -0
- package/lib/engine/credentials.d.ts.map +1 -0
- package/lib/engine/credentials.js +51 -0
- package/lib/engine/credentials.js.map +1 -0
- package/lib/engine/gateway.d.ts +46 -0
- package/lib/engine/gateway.d.ts.map +1 -0
- package/lib/engine/gateway.js +333 -0
- package/lib/engine/gateway.js.map +1 -0
- package/lib/engine/json-state.d.ts +8 -0
- package/lib/engine/json-state.d.ts.map +1 -0
- package/lib/engine/json-state.js +24 -0
- package/lib/engine/json-state.js.map +1 -0
- package/lib/engine/merge.d.ts +21 -0
- package/lib/engine/merge.d.ts.map +1 -0
- package/lib/engine/merge.js +55 -0
- package/lib/engine/merge.js.map +1 -0
- package/lib/engine/router.d.ts +88 -0
- package/lib/engine/router.d.ts.map +1 -0
- package/lib/engine/router.js +309 -0
- package/lib/engine/router.js.map +1 -0
- package/lib/engine/seen-store.d.ts +12 -0
- package/lib/engine/seen-store.d.ts.map +1 -0
- package/lib/engine/seen-store.js +38 -0
- package/lib/engine/seen-store.js.map +1 -0
- package/lib/engine/session-id.d.ts +30 -0
- package/lib/engine/session-id.d.ts.map +1 -0
- package/lib/engine/session-id.js +53 -0
- package/lib/engine/session-id.js.map +1 -0
- package/lib/engine/session-store.d.ts +13 -0
- package/lib/engine/session-store.d.ts.map +1 -0
- package/lib/engine/session-store.js +38 -0
- package/lib/engine/session-store.js.map +1 -0
- package/lib/engine/split.d.ts +2 -0
- package/lib/engine/split.d.ts.map +1 -0
- package/lib/engine/split.js +41 -0
- package/lib/engine/split.js.map +1 -0
- package/lib/engine/types.d.ts +52 -0
- package/lib/engine/types.d.ts.map +1 -0
- package/lib/engine/types.js +2 -0
- package/lib/engine/types.js.map +1 -0
- package/lib/index.d.ts +22 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +53 -0
- package/lib/index.js.map +1 -0
- package/lib/manager.d.ts +103 -0
- package/lib/manager.d.ts.map +1 -0
- package/lib/manager.js +543 -0
- package/lib/manager.js.map +1 -0
- package/package.json +63 -0
- package/src/channels/dingtalk-card.ts +191 -0
- package/src/channels/dingtalk.ts +113 -0
- package/src/channels/factory.ts +32 -0
- package/src/channels/feishu.ts +77 -0
- package/src/channels/meta.ts +89 -0
- package/src/channels/qr/dingtalk.ts +71 -0
- package/src/channels/qr/feishu.ts +90 -0
- package/src/channels/qr/hub.ts +206 -0
- package/src/channels/qr/render.ts +7 -0
- package/src/channels/qr/shared.ts +80 -0
- package/src/channels/qr/wecom.ts +78 -0
- package/src/channels/qr/weixin.ts +78 -0
- package/src/channels/telegram.ts +145 -0
- package/src/channels/wecom.ts +182 -0
- package/src/channels/weixin.ts +712 -0
- package/src/engine/access.ts +17 -0
- package/src/engine/agent-options.ts +24 -0
- package/src/engine/approval.ts +45 -0
- package/src/engine/assistant-settings.ts +41 -0
- package/src/engine/credentials.ts +64 -0
- package/src/engine/gateway.ts +330 -0
- package/src/engine/json-state.ts +20 -0
- package/src/engine/merge.ts +60 -0
- package/src/engine/router.ts +333 -0
- package/src/engine/seen-store.ts +36 -0
- package/src/engine/session-id.ts +65 -0
- package/src/engine/session-store.ts +45 -0
- package/src/engine/split.ts +29 -0
- package/src/engine/types.ts +55 -0
- package/src/index.ts +81 -0
- package/src/manager.ts +571 -0
- package/src/optional-modules.d.ts +13 -0
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
/** 渠道扫码会话:同一渠道同时只保留一次尝试。 */
|
|
2
|
+
import type { ChannelId } from '../../engine/session-id.js'
|
|
3
|
+
import { CHANNEL_META } from '../meta.js'
|
|
4
|
+
import { qrPayloadOf, remainingSeconds, sleep, type PairingBegin, type PairingPhase, type PairingView } from './shared.js'
|
|
5
|
+
import { renderQrDataUrl } from './render.js'
|
|
6
|
+
import { beginDingtalkQr } from './dingtalk.js'
|
|
7
|
+
import { beginFeishuQr } from './feishu.js'
|
|
8
|
+
import { beginWecomQr } from './wecom.js'
|
|
9
|
+
import { beginWeixinQr } from './weixin.js'
|
|
10
|
+
|
|
11
|
+
export interface PairingHubOptions {
|
|
12
|
+
onSuccess?: (channelId: ChannelId, credentials: Record<string, string>) => Promise<void>
|
|
13
|
+
log?: (line: string) => void
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
interface Session {
|
|
17
|
+
channelId: ChannelId
|
|
18
|
+
status: PairingPhase
|
|
19
|
+
qrUrl?: string
|
|
20
|
+
qrImage?: string
|
|
21
|
+
expiresAt?: number
|
|
22
|
+
pollIntervalMs: number
|
|
23
|
+
hint?: string
|
|
24
|
+
error?: string
|
|
25
|
+
extra?: Record<string, string>
|
|
26
|
+
controller: AbortController
|
|
27
|
+
begin?: PairingBegin
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export class PairingHub {
|
|
31
|
+
private readonly sessions = new Map<string, Session>()
|
|
32
|
+
private readonly onSuccess?: PairingHubOptions['onSuccess']
|
|
33
|
+
private readonly log: (line: string) => void
|
|
34
|
+
|
|
35
|
+
constructor(options: PairingHubOptions = {}) {
|
|
36
|
+
this.onSuccess = options.onSuccess
|
|
37
|
+
this.log = options.log ?? (() => undefined)
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
supports(id: ChannelId): boolean {
|
|
41
|
+
const kind = CHANNEL_META[id]?.kind
|
|
42
|
+
return kind === 'qr' || kind === 'qr-or-credentials'
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
view(id: ChannelId): PairingView {
|
|
46
|
+
const session = this.sessions.get(id)
|
|
47
|
+
if (!session) return { channelId: id, status: 'idle' }
|
|
48
|
+
return {
|
|
49
|
+
channelId: id,
|
|
50
|
+
status: session.status,
|
|
51
|
+
qrUrl: session.qrUrl,
|
|
52
|
+
qrImage: session.qrImage,
|
|
53
|
+
expiresAt: session.expiresAt,
|
|
54
|
+
remainingSeconds: remainingSeconds(session.expiresAt),
|
|
55
|
+
hint: session.hint,
|
|
56
|
+
error: session.error,
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
async start(id: ChannelId, extra: Record<string, string> = {}): Promise<PairingView> {
|
|
61
|
+
if (!this.supports(id)) throw new Error(`${id} 不支持扫码绑定`)
|
|
62
|
+
this.cancel(id)
|
|
63
|
+
const session: Session = {
|
|
64
|
+
channelId: id,
|
|
65
|
+
status: 'starting',
|
|
66
|
+
pollIntervalMs: 3000,
|
|
67
|
+
extra,
|
|
68
|
+
controller: new AbortController(),
|
|
69
|
+
}
|
|
70
|
+
this.sessions.set(id, session)
|
|
71
|
+
try {
|
|
72
|
+
const begun = await this.begin(id, session.controller.signal)
|
|
73
|
+
if (this.sessions.get(id) !== session) return this.view(id)
|
|
74
|
+
session.begin = begun
|
|
75
|
+
const payload = qrPayloadOf(begun)
|
|
76
|
+
session.qrUrl = payload.qrUrl
|
|
77
|
+
session.qrImage = payload.qrImage
|
|
78
|
+
if (!session.qrImage && session.qrUrl) {
|
|
79
|
+
try { session.qrImage = await renderQrDataUrl(session.qrUrl) } catch { /* 前端再兜底 */ }
|
|
80
|
+
}
|
|
81
|
+
session.expiresAt = begun.expiresAt
|
|
82
|
+
session.pollIntervalMs = begun.pollIntervalMs
|
|
83
|
+
session.status = 'waiting'
|
|
84
|
+
session.hint = hintOf(id)
|
|
85
|
+
void this.loop(session)
|
|
86
|
+
return this.view(id)
|
|
87
|
+
} catch (error) {
|
|
88
|
+
if (this.sessions.get(id) !== session) return this.view(id)
|
|
89
|
+
session.status = 'failed'
|
|
90
|
+
session.error = error instanceof Error ? error.message : String(error)
|
|
91
|
+
this.log(`[pairing] ${id} 生成二维码失败:${session.error}`)
|
|
92
|
+
return this.view(id)
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
async refresh(id: ChannelId): Promise<PairingView> {
|
|
97
|
+
const extra = this.sessions.get(id)?.extra ?? {}
|
|
98
|
+
return this.start(id, extra)
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
cancel(id: ChannelId): PairingView {
|
|
102
|
+
const session = this.sessions.get(id)
|
|
103
|
+
if (!session) return this.view(id)
|
|
104
|
+
session.controller.abort()
|
|
105
|
+
if (session.status !== 'success') {
|
|
106
|
+
session.status = 'cancelled'
|
|
107
|
+
session.qrUrl = undefined
|
|
108
|
+
session.qrImage = undefined
|
|
109
|
+
}
|
|
110
|
+
return this.view(id)
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
dispose(): void {
|
|
114
|
+
for (const id of [...this.sessions.keys()]) this.cancel(id as ChannelId)
|
|
115
|
+
this.sessions.clear()
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
private async begin(id: ChannelId, signal: AbortSignal): Promise<PairingBegin> {
|
|
119
|
+
switch (id) {
|
|
120
|
+
case 'wecom':
|
|
121
|
+
return beginWecomQr(signal)
|
|
122
|
+
case 'dingtalk':
|
|
123
|
+
return beginDingtalkQr(signal)
|
|
124
|
+
case 'feishu':
|
|
125
|
+
return beginFeishuQr('feishu', signal)
|
|
126
|
+
case 'lark':
|
|
127
|
+
return beginFeishuQr('lark', signal)
|
|
128
|
+
case 'weixin':
|
|
129
|
+
return beginWeixinQr(signal)
|
|
130
|
+
default:
|
|
131
|
+
throw new Error(`${id} 不支持扫码绑定`)
|
|
132
|
+
}
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
private async loop(session: Session): Promise<void> {
|
|
136
|
+
const begun = session.begin
|
|
137
|
+
if (!begun) return
|
|
138
|
+
while (!session.controller.signal.aborted && this.sessions.get(session.channelId) === session) {
|
|
139
|
+
if (session.expiresAt && Date.now() >= session.expiresAt) {
|
|
140
|
+
session.status = 'expired'
|
|
141
|
+
session.error = '二维码已过期'
|
|
142
|
+
session.qrUrl = undefined
|
|
143
|
+
session.qrImage = undefined
|
|
144
|
+
return
|
|
145
|
+
}
|
|
146
|
+
try {
|
|
147
|
+
const polled = await begun.poll(session.controller.signal)
|
|
148
|
+
if (this.sessions.get(session.channelId) !== session) return
|
|
149
|
+
if (polled.pollIntervalMs) session.pollIntervalMs = polled.pollIntervalMs
|
|
150
|
+
if (polled.status === 'success' && polled.credentials) {
|
|
151
|
+
session.status = 'success'
|
|
152
|
+
session.qrUrl = undefined
|
|
153
|
+
session.qrImage = undefined
|
|
154
|
+
session.hint = '绑定成功'
|
|
155
|
+
const credentials = { ...session.extra, ...polled.credentials }
|
|
156
|
+
try {
|
|
157
|
+
await this.onSuccess?.(session.channelId, credentials)
|
|
158
|
+
} catch (error) {
|
|
159
|
+
session.status = 'failed'
|
|
160
|
+
session.error = error instanceof Error ? error.message : String(error)
|
|
161
|
+
this.log(`[pairing] ${session.channelId} 保存凭据失败:${session.error}`)
|
|
162
|
+
}
|
|
163
|
+
return
|
|
164
|
+
}
|
|
165
|
+
if (polled.status === 'scanned') {
|
|
166
|
+
session.status = 'scanned'
|
|
167
|
+
session.hint = '已扫码,请在手机上确认'
|
|
168
|
+
} else if (polled.status === 'expired' || polled.status === 'failed') {
|
|
169
|
+
session.status = polled.status
|
|
170
|
+
session.error = polled.error
|
|
171
|
+
session.qrUrl = undefined
|
|
172
|
+
session.qrImage = undefined
|
|
173
|
+
return
|
|
174
|
+
} else if (session.status !== 'scanned') {
|
|
175
|
+
session.status = 'waiting'
|
|
176
|
+
}
|
|
177
|
+
} catch (error) {
|
|
178
|
+
if (session.controller.signal.aborted) return
|
|
179
|
+
this.log(`[pairing] ${session.channelId} 轮询失败:${error instanceof Error ? error.message : String(error)}`)
|
|
180
|
+
}
|
|
181
|
+
try {
|
|
182
|
+
await sleep(session.pollIntervalMs, session.controller.signal)
|
|
183
|
+
} catch {
|
|
184
|
+
return
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
function hintOf(id: ChannelId): string {
|
|
191
|
+
switch (id) {
|
|
192
|
+
case 'weixin':
|
|
193
|
+
return '请使用微信扫描二维码完成绑定'
|
|
194
|
+
case 'feishu':
|
|
195
|
+
return '请使用飞书扫描二维码,将自动创建机器人'
|
|
196
|
+
case 'lark':
|
|
197
|
+
return '请使用 Lark 扫描二维码完成配对'
|
|
198
|
+
case 'wecom':
|
|
199
|
+
return '请使用企业微信扫描二维码,快捷绑定机器人'
|
|
200
|
+
case 'dingtalk':
|
|
201
|
+
return '请使用钉钉扫描二维码,自动创建机器人'
|
|
202
|
+
default:
|
|
203
|
+
return '请使用对应 App 扫描二维码'
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/** 把扫码内容画成本地 data URL,避免前端把链接当成图片。 */
|
|
2
|
+
export async function renderQrDataUrl(payload: string): Promise<string> {
|
|
3
|
+
const QRCode = await import('qrcode') as { default?: { toDataURL(text: string, opts?: object): Promise<string> }; toDataURL?(text: string, opts?: object): Promise<string> }
|
|
4
|
+
const toDataURL = QRCode.toDataURL ?? QRCode.default?.toDataURL
|
|
5
|
+
if (!toDataURL) throw new Error('缺少二维码生成库 qrcode')
|
|
6
|
+
return toDataURL(payload, { width: 240, margin: 1, errorCorrectionLevel: 'M' })
|
|
7
|
+
}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
/** 扫码绑定公共工具。 */
|
|
2
|
+
|
|
3
|
+
export function cleanString(value: unknown): string | undefined {
|
|
4
|
+
return typeof value === 'string' && value.trim() ? value.trim() : undefined
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
export function asRecord(value: unknown): Record<string, unknown> {
|
|
8
|
+
return value && typeof value === 'object' && !Array.isArray(value)
|
|
9
|
+
? value as Record<string, unknown>
|
|
10
|
+
: {}
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export async function readJson(response: Response, label: string): Promise<Record<string, unknown>> {
|
|
14
|
+
let body: unknown
|
|
15
|
+
try {
|
|
16
|
+
body = await response.json()
|
|
17
|
+
} catch (error) {
|
|
18
|
+
throw new Error(`${label} 返回了非 JSON`, { cause: error })
|
|
19
|
+
}
|
|
20
|
+
if (!response.ok) throw new Error(`${label} HTTP ${response.status}`)
|
|
21
|
+
return asRecord(body)
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export function sleep(ms: number, signal?: AbortSignal): Promise<void> {
|
|
25
|
+
return new Promise((resolve, reject) => {
|
|
26
|
+
if (signal?.aborted) {
|
|
27
|
+
reject(signal.reason ?? new Error('aborted'))
|
|
28
|
+
return
|
|
29
|
+
}
|
|
30
|
+
const timer = setTimeout(resolve, ms)
|
|
31
|
+
signal?.addEventListener('abort', () => {
|
|
32
|
+
clearTimeout(timer)
|
|
33
|
+
reject(signal.reason ?? new Error('aborted'))
|
|
34
|
+
}, { once: true })
|
|
35
|
+
})
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
export function remainingSeconds(expiresAt?: number, now = Date.now()): number | undefined {
|
|
39
|
+
if (!expiresAt) return undefined
|
|
40
|
+
return Math.max(0, Math.ceil((expiresAt - now) / 1000))
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
export type PairingPhase = 'idle' | 'starting' | 'waiting' | 'scanned' | 'success' | 'expired' | 'failed' | 'cancelled'
|
|
44
|
+
|
|
45
|
+
export interface PairingView {
|
|
46
|
+
channelId: string
|
|
47
|
+
status: PairingPhase
|
|
48
|
+
qrUrl?: string
|
|
49
|
+
qrImage?: string
|
|
50
|
+
expiresAt?: number
|
|
51
|
+
remainingSeconds?: number
|
|
52
|
+
hint?: string
|
|
53
|
+
error?: string
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export interface PairingBegin {
|
|
57
|
+
qrUrl?: string
|
|
58
|
+
qrImage?: string
|
|
59
|
+
expiresAt?: number
|
|
60
|
+
pollIntervalMs: number
|
|
61
|
+
poll: (signal?: AbortSignal) => Promise<PairingPoll>
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export interface PairingPoll {
|
|
65
|
+
status: 'waiting' | 'scanned' | 'success' | 'expired' | 'failed'
|
|
66
|
+
credentials?: Record<string, string>
|
|
67
|
+
error?: string
|
|
68
|
+
pollIntervalMs?: number
|
|
69
|
+
}
|
|
70
|
+
export function isRasterQr(value?: string): boolean {
|
|
71
|
+
if (!value) return false
|
|
72
|
+
return /^data:image\//i.test(value) || /\.(png|jpe?g|gif|webp)(\?|$)/i.test(value)
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export function qrPayloadOf(begun: { qrUrl?: string; qrImage?: string }): { qrUrl?: string; qrImage?: string } {
|
|
76
|
+
if (isRasterQr(begun.qrImage)) return { qrUrl: begun.qrUrl, qrImage: begun.qrImage }
|
|
77
|
+
const qrUrl = begun.qrUrl || begun.qrImage
|
|
78
|
+
return { qrUrl, qrImage: undefined }
|
|
79
|
+
}
|
|
80
|
+
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/** 企业微信扫码:快捷绑定拿 Bot ID + Secret。 */
|
|
2
|
+
import { asRecord, cleanString, readJson, type PairingBegin, type PairingPoll } from './shared.js'
|
|
3
|
+
|
|
4
|
+
const GENERATE_URL = 'https://work.weixin.qq.com/ai/qc/generate'
|
|
5
|
+
const POLL_URL = 'https://work.weixin.qq.com/ai/qc/query_result'
|
|
6
|
+
const QR_TTL_MS = 5 * 60_000
|
|
7
|
+
const POLL_INTERVAL_MS = 3_000
|
|
8
|
+
|
|
9
|
+
function defaultPlatform(): number {
|
|
10
|
+
if (process.platform === 'win32') return 2
|
|
11
|
+
if (process.platform === 'linux') return 3
|
|
12
|
+
return 1
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
function safeVerificationUrl(value: unknown): string | undefined {
|
|
16
|
+
const raw = cleanString(value)
|
|
17
|
+
if (!raw) return undefined
|
|
18
|
+
try {
|
|
19
|
+
const url = new URL(raw)
|
|
20
|
+
return url.protocol === 'https:' && url.hostname === 'work.weixin.qq.com' && (!url.port || url.port === '443')
|
|
21
|
+
? url.href
|
|
22
|
+
: undefined
|
|
23
|
+
} catch {
|
|
24
|
+
return undefined
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export function parseWecomGenerate(body: unknown, now = Date.now()): { scode: string; verificationUrl: string; expiresAt: number } {
|
|
29
|
+
const data = asRecord(asRecord(body).data)
|
|
30
|
+
const scode = cleanString(data.scode)
|
|
31
|
+
const verificationUrl = safeVerificationUrl(data.auth_url)
|
|
32
|
+
if (!scode || !verificationUrl) throw new Error('企业微信二维码服务返回数据不完整')
|
|
33
|
+
return { scode, verificationUrl, expiresAt: now + QR_TTL_MS }
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
export function parseWecomPoll(body: unknown): PairingPoll {
|
|
37
|
+
const data = asRecord(asRecord(body).data)
|
|
38
|
+
const state = cleanString(data.status)?.toLowerCase()
|
|
39
|
+
if (state === 'success') {
|
|
40
|
+
const bot = asRecord(data.bot_info)
|
|
41
|
+
const botId = cleanString(bot.botid) ?? cleanString(bot.botId)
|
|
42
|
+
const secret = cleanString(bot.secret)
|
|
43
|
+
if (!botId || !secret) throw new Error('企业微信扫码结果缺少 Bot 凭据')
|
|
44
|
+
return { status: 'success', credentials: { botId, secret } }
|
|
45
|
+
}
|
|
46
|
+
if (state === 'expired' || state === 'timeout') return { status: 'expired', error: '二维码已过期' }
|
|
47
|
+
if (state === 'fail' || state === 'failed' || state === 'error') return { status: 'failed', error: '扫码未完成' }
|
|
48
|
+
return { status: 'waiting' }
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export async function beginWecomQr(signal?: AbortSignal): Promise<PairingBegin> {
|
|
52
|
+
const url = new URL(GENERATE_URL)
|
|
53
|
+
url.searchParams.set('source', 'dsh-im-connect')
|
|
54
|
+
url.searchParams.set('plat', String(defaultPlatform()))
|
|
55
|
+
const body = await readJson(await fetch(url, {
|
|
56
|
+
method: 'GET',
|
|
57
|
+
redirect: 'error',
|
|
58
|
+
signal: signal ?? AbortSignal.timeout(10_000),
|
|
59
|
+
headers: { accept: 'application/json' },
|
|
60
|
+
}), '企业微信生成二维码')
|
|
61
|
+
const begun = parseWecomGenerate(body)
|
|
62
|
+
return {
|
|
63
|
+
qrUrl: begun.verificationUrl,
|
|
64
|
+
expiresAt: begun.expiresAt,
|
|
65
|
+
pollIntervalMs: POLL_INTERVAL_MS,
|
|
66
|
+
poll: async (pollSignal) => {
|
|
67
|
+
const pollUrl = new URL(POLL_URL)
|
|
68
|
+
pollUrl.searchParams.set('scode', begun.scode)
|
|
69
|
+
const polled = await readJson(await fetch(pollUrl, {
|
|
70
|
+
method: 'GET',
|
|
71
|
+
redirect: 'error',
|
|
72
|
+
signal: pollSignal ?? AbortSignal.timeout(10_000),
|
|
73
|
+
headers: { accept: 'application/json' },
|
|
74
|
+
}), '企业微信查询扫码')
|
|
75
|
+
return parseWecomPoll(polled)
|
|
76
|
+
},
|
|
77
|
+
}
|
|
78
|
+
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/** 微信 iLink 扫码登录。 */
|
|
2
|
+
import { asRecord, cleanString, type PairingBegin, type PairingPoll } from './shared.js'
|
|
3
|
+
|
|
4
|
+
const BASE_URL = 'https://ilinkai.weixin.qq.com'
|
|
5
|
+
|
|
6
|
+
function pickStr(obj: Record<string, unknown>, ...keys: string[]): string | undefined {
|
|
7
|
+
for (const key of keys) {
|
|
8
|
+
const value = cleanString(obj[key])
|
|
9
|
+
if (value) return value
|
|
10
|
+
}
|
|
11
|
+
return undefined
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export function weixinHeaders(uin = Buffer.from(String(Math.floor(Math.random() * 0xffffffff)), 'utf8').toString('base64')): Record<string, string> {
|
|
15
|
+
return {
|
|
16
|
+
'content-type': 'application/json',
|
|
17
|
+
'iLink-App-ClientVersion': '1',
|
|
18
|
+
'X-WECHAT-UIN': uin,
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export function parseWeixinQr(body: unknown): { qrcodeId: string; qrUrl: string } {
|
|
23
|
+
const record = asRecord(body)
|
|
24
|
+
const qrcodeId = pickStr(record, 'qrcode', 'qrcode_id')
|
|
25
|
+
const qrUrl = pickStr(record, 'qrcode_img_content', 'qrcode_url', 'url')
|
|
26
|
+
if (!qrcodeId || !qrUrl) throw new Error('微信二维码字段缺失')
|
|
27
|
+
return { qrcodeId, qrUrl }
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export function parseWeixinStatus(body: unknown): PairingPoll {
|
|
31
|
+
const record = asRecord(body)
|
|
32
|
+
const status = String(record.status ?? '')
|
|
33
|
+
if (Number(record.ret ?? 0) === 0 && status === 'confirmed') {
|
|
34
|
+
const botToken = pickStr(record, 'bot_token')
|
|
35
|
+
const allowedUserId = pickStr(record, 'ilink_user_id')
|
|
36
|
+
const baseUrl = pickStr(record, 'baseurl', 'base_url')
|
|
37
|
+
if (!botToken) throw new Error('微信确认登录但缺少 token')
|
|
38
|
+
const credentials: Record<string, string> = { botToken, bound: '1' }
|
|
39
|
+
if (allowedUserId) credentials.allowedUserId = allowedUserId
|
|
40
|
+
if (baseUrl) credentials.baseUrl = baseUrl
|
|
41
|
+
return { status: 'success', credentials }
|
|
42
|
+
}
|
|
43
|
+
if (status === 'expired') return { status: 'expired', error: '二维码已过期' }
|
|
44
|
+
if (status === 'scaned' || status === 'scanned') return { status: 'scanned' }
|
|
45
|
+
return { status: 'waiting' }
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
async function post(path: string, headers: Record<string, string>, signal?: AbortSignal): Promise<Record<string, unknown>> {
|
|
49
|
+
const response = await fetch(`${BASE_URL}${path}`, {
|
|
50
|
+
method: 'POST',
|
|
51
|
+
headers,
|
|
52
|
+
body: '{}',
|
|
53
|
+
signal: signal ?? AbortSignal.timeout(40_000),
|
|
54
|
+
})
|
|
55
|
+
if (!response.ok) throw new Error(`微信 ${path} HTTP ${response.status}`)
|
|
56
|
+
const data = asRecord(await response.json())
|
|
57
|
+
const ret = Number(data.ret ?? 0)
|
|
58
|
+
const errcode = Number(data.errcode ?? 0)
|
|
59
|
+
if (path.includes('get_qrcode_status') && ret === 1 && errcode === 0) return data
|
|
60
|
+
if (ret !== 0 || errcode !== 0) throw new Error(`微信 ${path} ret=${ret} errcode=${errcode}`)
|
|
61
|
+
return data
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export async function beginWeixinQr(signal?: AbortSignal): Promise<PairingBegin> {
|
|
65
|
+
const headers = weixinHeaders()
|
|
66
|
+
const begun = parseWeixinQr(await post('/ilink/bot/get_bot_qrcode?bot_type=3', headers, signal ?? AbortSignal.timeout(15_000)))
|
|
67
|
+
return {
|
|
68
|
+
qrUrl: begun.qrUrl,
|
|
69
|
+
expiresAt: Date.now() + 5 * 60_000,
|
|
70
|
+
pollIntervalMs: 2000,
|
|
71
|
+
poll: async (pollSignal) => parseWeixinStatus(await post(
|
|
72
|
+
`/ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(begun.qrcodeId)}`,
|
|
73
|
+
headers,
|
|
74
|
+
pollSignal,
|
|
75
|
+
)),
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
|
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
import type { ChannelAdapter, ImMessage, ReplyStream } from '../engine/types.js'
|
|
2
|
+
import { JsonStateFile } from '../engine/json-state.js'
|
|
3
|
+
|
|
4
|
+
export interface TelegramConfig {
|
|
5
|
+
token?: string
|
|
6
|
+
stateDir?: string
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
interface TgUpdate {
|
|
10
|
+
update_id: number
|
|
11
|
+
message?: {
|
|
12
|
+
message_id: number
|
|
13
|
+
chat: { id: number; type: string }
|
|
14
|
+
from?: { id: number; username?: string; first_name?: string; is_bot?: boolean }
|
|
15
|
+
text?: string
|
|
16
|
+
caption?: string
|
|
17
|
+
entities?: Array<{ type: string; offset: number; length: number }>
|
|
18
|
+
reply_to_message?: { from?: { id: number } }
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
const API = 'https://api.telegram.org'
|
|
23
|
+
|
|
24
|
+
export function createTelegramChannel(config: TelegramConfig, log: (line: string) => void): ChannelAdapter | undefined {
|
|
25
|
+
const token = config.token?.trim()
|
|
26
|
+
if (!token) return undefined
|
|
27
|
+
const cursorFile = new JsonStateFile(config.stateDir ? `${config.stateDir.replace(/[\\/]$/, '')}/cursor.json` : '', { offset: 0 })
|
|
28
|
+
const persist = Boolean(config.stateDir)
|
|
29
|
+
|
|
30
|
+
let handler: ((msg: ImMessage) => void | Promise<void>) | undefined
|
|
31
|
+
let offset = persist ? cursorFile.read().offset : 0
|
|
32
|
+
let stopped = false
|
|
33
|
+
let lastError = ''
|
|
34
|
+
let botId = ''
|
|
35
|
+
let username = ''
|
|
36
|
+
|
|
37
|
+
async function api<T>(method: string, body: Record<string, unknown>): Promise<T> {
|
|
38
|
+
const res = await fetch(`${API}/bot${token}/${method}`, {
|
|
39
|
+
method: 'POST',
|
|
40
|
+
headers: { 'content-type': 'application/json' },
|
|
41
|
+
body: JSON.stringify(body),
|
|
42
|
+
})
|
|
43
|
+
const data = (await res.json()) as { ok: boolean; description?: string; error_code?: number; result: T }
|
|
44
|
+
if (!data.ok) {
|
|
45
|
+
const error = new Error(`telegram ${method}: ${data.description ?? 'unknown'}`)
|
|
46
|
+
if (data.error_code === 401) (error as Error & { code?: string }).code = 'telegram-401'
|
|
47
|
+
throw error
|
|
48
|
+
}
|
|
49
|
+
return data.result
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function mentioned(message: NonNullable<TgUpdate['message']>): boolean {
|
|
53
|
+
if (!username || !message.text || !Array.isArray(message.entities)) return false
|
|
54
|
+
return message.entities.some((entity) => {
|
|
55
|
+
if (entity.type !== 'mention') return false
|
|
56
|
+
return message.text!.slice(entity.offset, entity.offset + entity.length).toLowerCase() === `@${username.toLowerCase()}`
|
|
57
|
+
})
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
async function pollLoop(): Promise<void> {
|
|
61
|
+
while (!stopped) {
|
|
62
|
+
try {
|
|
63
|
+
const updates = await api<TgUpdate[]>('getUpdates', {
|
|
64
|
+
offset,
|
|
65
|
+
timeout: 25,
|
|
66
|
+
allowed_updates: ['message'],
|
|
67
|
+
})
|
|
68
|
+
lastError = ''
|
|
69
|
+
for (const update of updates) {
|
|
70
|
+
offset = update.update_id + 1
|
|
71
|
+
if (persist) cursorFile.write({ offset })
|
|
72
|
+
const message = update.message
|
|
73
|
+
if (!message || message.from?.is_bot) continue
|
|
74
|
+
if (!['private', 'group', 'supergroup'].includes(message.chat.type)) continue
|
|
75
|
+
const direct = message.chat.type === 'private'
|
|
76
|
+
const addressed = direct
|
|
77
|
+
|| String(message.reply_to_message?.from?.id ?? '') === botId
|
|
78
|
+
|| mentioned(message)
|
|
79
|
+
let text = message.text ?? message.caption ?? ''
|
|
80
|
+
if (username) text = text.replace(new RegExp(`@${username}\\b`, 'ig'), '').trim()
|
|
81
|
+
void handler?.({
|
|
82
|
+
chatId: String(message.chat.id),
|
|
83
|
+
userId: message.from ? String(message.from.id) : undefined,
|
|
84
|
+
username: message.from?.username ?? message.from?.first_name,
|
|
85
|
+
text,
|
|
86
|
+
kind: direct ? 'dm' : 'group',
|
|
87
|
+
addressed,
|
|
88
|
+
messageId: String(update.update_id),
|
|
89
|
+
})
|
|
90
|
+
}
|
|
91
|
+
} catch (error) {
|
|
92
|
+
lastError = error instanceof Error ? error.message : String(error)
|
|
93
|
+
log(`[telegram] 轮询错误: ${lastError}`)
|
|
94
|
+
if (stopped) break
|
|
95
|
+
await new Promise((resolve) => setTimeout(resolve, 3000))
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
return {
|
|
101
|
+
id: 'telegram',
|
|
102
|
+
label: 'Telegram',
|
|
103
|
+
maxMessageLength: 4000,
|
|
104
|
+
async start() {
|
|
105
|
+
stopped = false
|
|
106
|
+
const me = await api<{ id: number; username?: string; is_bot: boolean }>('getMe', {})
|
|
107
|
+
botId = String(me.id)
|
|
108
|
+
username = me.username ?? ''
|
|
109
|
+
const hook = await api<{ url?: string }>('getWebhookInfo', {})
|
|
110
|
+
if (hook.url) throw Object.assign(new Error('该 Telegram 机器人已配置 Webhook,请先在原服务中移除。'), { code: 'webhook-configured' })
|
|
111
|
+
log('[telegram] 开始长轮询')
|
|
112
|
+
void pollLoop()
|
|
113
|
+
},
|
|
114
|
+
async stop() {
|
|
115
|
+
stopped = true
|
|
116
|
+
if (persist) cursorFile.write({ offset })
|
|
117
|
+
},
|
|
118
|
+
async send(chatId, text) {
|
|
119
|
+
await api('sendMessage', { chat_id: Number(chatId), text })
|
|
120
|
+
},
|
|
121
|
+
async sendAction(chatId) {
|
|
122
|
+
await api('sendChatAction', { chat_id: Number(chatId), action: 'typing' }).catch(() => undefined)
|
|
123
|
+
},
|
|
124
|
+
async beginReply(chatId): Promise<ReplyStream> {
|
|
125
|
+
const first = await api<{ message_id: number }>('sendMessage', { chat_id: Number(chatId), text: '…' })
|
|
126
|
+
let last = '…'
|
|
127
|
+
return {
|
|
128
|
+
async update(text) {
|
|
129
|
+
const next = text.slice(0, 4000) || '…'
|
|
130
|
+
if (next === last) return
|
|
131
|
+
last = next
|
|
132
|
+
await api('editMessageText', { chat_id: Number(chatId), message_id: first.message_id, text: next }).catch(() => undefined)
|
|
133
|
+
},
|
|
134
|
+
async finish(text) {
|
|
135
|
+
const next = text.slice(0, 4000) || last
|
|
136
|
+
await api('editMessageText', { chat_id: Number(chatId), message_id: first.message_id, text: next }).catch(async () => {
|
|
137
|
+
await api('sendMessage', { chat_id: Number(chatId), text: next })
|
|
138
|
+
})
|
|
139
|
+
},
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
setMessageHandler(h) { handler = h },
|
|
143
|
+
status() { return stopped ? '已停止' : lastError ? `轮询中(${lastError})` : '轮询中' },
|
|
144
|
+
}
|
|
145
|
+
}
|