@zhin.js/adapter-wecom 0.0.1 → 1.1.2

package/commands/wecom/endpoint/definition.ts

@@ -0,0 +1,20 @@
+/**
+ * `wecom endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/wecom/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ */
+import { createEndpointCommands } from 'zhin.js/adapter';
+import { defineCommand } from 'zhin.js/command';
+import { wecomRuntimeStateToken } from '../../../src/wecom-runtime-state.js';
+
+export const wecomEndpointCommands = createEndpointCommands({
+  adapterKey: 'wecom',
+  adapterDisplayName: 'WeCom',
+  fields: [
+    { key: 'corpId', required: true, env: true, description: '企业 corpId' },
+    { key: 'agentSecret', required: true, env: true, description: '应用 secret' },
+    { key: 'token', required: true, env: true, description: '回调 token' },
+    { key: 'encodingAESKey', required: true, env: true, description: '回调加解密 key' },
+  ],
+  running: (use) => use(wecomRuntimeStateToken).endpoints.values(),
+  describeEntry: (entry) => `corpId: ${String(entry.corpId)}`,
+}, defineCommand);

package/commands/wecom/endpoint/list/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { wecomEndpointCommands } from '../definition.js';
+export default wecomEndpointCommands.list;

package/commands/wecom/endpoint/list/index.ts

@@ -0,0 +1,3 @@
+import { wecomEndpointCommands } from '../definition.js';
+
+export default wecomEndpointCommands.list;

package/commands/wecom/endpoint/remove/[id]/index.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { wecomEndpointCommands } from '../../definition.js';
+export default wecomEndpointCommands.remove;

package/commands/wecom/endpoint/remove/[id]/index.ts

@@ -0,0 +1,3 @@
+import { wecomEndpointCommands } from '../../definition.js';
+
+export default wecomEndpointCommands.remove;

package/lib/client.d.ts

@@ -0,0 +1,12 @@
+import type { WecomClient } from './endpoint.js';
+import type { WecomMessage } from './protocol.js';
+export type WecomClientEventMap = Record<string, WecomMessage>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly wecom: {
+            readonly client: WecomClient;
+            readonly events: WecomClientEventMap;
+        };
+    }
+}
+export declare const wecomClient: import("@zhin.js/adapter").EndpointClientToken<WecomClient, WecomClientEventMap>;

package/lib/client.js

@@ -0,0 +1,2 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+export const wecomClient = defineEndpointClient('wecom');

package/lib/endpoint.d.ts

@@ -1,43 +1,61 @@
+import { Endpoint } from 'zhin.js/adapter';
 /**
- * 企业微信 Endpoint 实现
+ * WecomEndpoint — lifecycle, outbound send, inbound admit, OpenAPI helpers for agent tools.
  */
-import { Endpoint, Message, type SendOptions } from 'zhin.js';
-import { type Router } from '@zhin.js/host-router/router';
-import type { WecomEndpointConfig, WecomMessage, WecomApiResponse } from './types.js';
-import type { WecomAdapter } from './adapter.js';
-export declare class WecomEndpoint implements Endpoint<WecomEndpointConfig, WecomMessage> {
-    #private;
-    adapter: WecomAdapter;
-    $config: WecomEndpointConfig;
-    $connected: boolean;
-    private router;
-    private accessToken;
-    private baseURL;
-    private aesKey;
-    private corpId;
-    get $id(): string;
-    get logger(): import("zhin.js").Logger;
-    constructor(adapter: WecomAdapter, router: Router, $config: WecomEndpointConfig);
-    private request;
-    private setupWebhookRoute;
-    private handleVerification;
-    private handleWebhook;
-    private verifySignature;
-    private decryptMessage;
-    private parseXmlMessage;
-    private handleMessage;
-    private ensureAccessToken;
-    private refreshAccessToken;
-    $formatMessage(msg: WecomMessage): Message<WecomMessage>;
-    private parseMessageContent;
-    $sendMessage(options: SendOptions): Promise<string>;
-    $recallMessage(_id: string): Promise<void>;
-    private formatSendContent;
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    getUserInfo(userId: string): Promise<WecomApiResponse | null>;
+import { type EndpointControl, type EndpointSendRequest } from 'zhin.js/adapter';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from 'zhin.js';
+import { type ResolvedWecomConfig, type WecomMessage } from './protocol.js';
+export type WecomFetch = (url: string, init?: {
+    readonly method?: string;
+    readonly headers?: Record<string, string>;
+    readonly body?: string | FormData;
+}) => Promise<{
+    readonly ok: boolean;
+    readonly status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}>;
+export interface WecomEndpointOptions {
+    readonly id: CapabilityId;
+    readonly http: HttpHost;
+    readonly config: ResolvedWecomConfig;
+    readonly fetch?: WecomFetch;
+}
+export interface WecomClientApi {
+    getUserInfo(userId: string): Promise<unknown>;
     getDepartmentUsers(deptId: number): Promise<unknown[]>;
     getDepartmentList(deptId?: number): Promise<unknown[]>;
     sendTextMessage(userId: string, content: string): Promise<boolean>;
 }
-//# sourceMappingURL=endpoint.d.ts.map
+/** WeCom API surface exposed to plugin events without Endpoint lifecycle methods. */
+export declare class WecomClient implements WecomClientApi {
+    readonly api: WecomClientApi;
+    constructor(api: WecomClientApi);
+    getUserInfo: (userId: string) => Promise<unknown>;
+    getDepartmentUsers: (deptId: number) => Promise<unknown[]>;
+    getDepartmentList: (deptId?: number) => Promise<unknown[]>;
+    sendTextMessage: (userId: string, content: string) => Promise<boolean>;
+}
+/**
+ * 企业微信服务端 API 无 bot 群列表/群成员列表接口（客户群接口属「客户联系」
+ * 独立授权域，非 bot 社交面），好友/频道概念亦不存在；
+ * 因此本 endpoint 不暴露 EndpointManagement（Console 社交面 RPC 对该平台保持未接线）。
+ */
+export declare class WecomEndpoint extends Endpoint<WecomClient> {
+    #private;
+    readonly client: WecomClient;
+    readonly control: EndpointControl;
+    constructor(options: WecomEndpointOptions);
+    /** Used by webhook handler. */
+    get isOpen(): boolean;
+    get config(): ResolvedWecomConfig;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    recallMessage(messageId: string): Promise<void>;
+    /** Test / internal: admit a parsed message when open (non-webhook path). */
+    admit(msg: WecomMessage): void;
+}