@zhin.js/adapter-icqq 1.1.17 → 1.1.19

package/src/adapter.ts

@@ -0,0 +1,29 @@
+import { Adapter, createAdapterOutageNotifier, type AdapterContext, type EndpointCreationContext } from 'zhin.js/adapter';
+import { projectLocaleToken } from 'zhin.js/i18n';
+import { loginAssistToken } from '@zhin.js/core/runtime';
+import { outboundHostToken } from 'zhin.js';
+import { IcqqEndpoint } from './endpoint.js';
+import { resolveIcqqConfig, type IcqqEndpointConfig } from './protocol.js';
+import type { IcqqClientEventMap } from './client.js';
+
+/** ICQQ account construction and actual SDK ownership belong to this Adapter. */
+export class IcqqAdapter extends Adapter<IcqqEndpoint, IcqqEndpointConfig, IcqqClientEventMap> {
+  override get configurationIdentityFields(): readonly string[] { return ['id']; }
+  override get configurationUpdateFields(): readonly string[] {
+    return ['password', 'platform', 'ver', 'dataDir', 'signApiAddr', 'autoReconnect', 'autoServer', 'qqnt', 'ntLogin'];
+  }
+  readonly #context: AdapterContext<IcqqEndpointConfig>;
+  constructor(context: AdapterContext<IcqqEndpointConfig>) { super(); this.#context = context; }
+  protected override validateConfiguration(config: IcqqEndpointConfig): void { resolveIcqqConfig(config); }
+  protected createEndpoint(input: IcqqEndpointConfig, execution: EndpointCreationContext): IcqqEndpoint {
+    const context = this.#context;
+    const config = resolveIcqqConfig(input);
+    const outbound = context.has?.(outboundHostToken) ? context.use(outboundHostToken) : undefined;
+    const endpoint = new IcqqEndpoint({ id: execution.canonicalId, config,
+      signal: execution.signal, endpointIdentity: { canonicalId: execution.canonicalId, instanceId: execution.instanceId, epoch: execution.epoch, incarnationId: execution.incarnationId },
+      loginAssist: context.use(loginAssistToken), locale: context.use(projectLocaleToken),
+      notifier: createAdapterOutageNotifier(outbound, config.notify),
+    });
+    return endpoint;
+  }
+}

package/src/client.ts

@@ -1,5 +1,6 @@
-import type { Client, EventMap } from '@icqqjs/icqq';
-import { defineEndpointClient } from 'zhin.js/adapter';
+import type { IcqqAdapter } from './adapter.js';
+import type { IcqqEndpoint } from './endpoint.js';
+import type { EventMap } from '@icqqjs/icqq';
 
 type EventPayload<TListener> = TListener extends (
   event: infer TEvent,
@@ -9,7 +10,7 @@ type EventPayload<TListener> = TListener extends (
   : never;
 
 /** The actual ICQQ SDK instance exposed by every ICQQ Endpoint event. */
-export type IcqqClient = Client;
+export type IcqqClient = IcqqEndpoint;
 
 /** Native ICQQ event-name → first public event payload, derived from the SDK SSOT. */
 export type IcqqClientEventMap = {
@@ -17,13 +18,7 @@ export type IcqqClientEventMap = {
 };
 
 declare module '@zhin.js/feature-kit' {
-  interface AdapterClientRegistry {
-    readonly icqq: {
-      readonly client: IcqqClient;
-      readonly events: IcqqClientEventMap;
-    };
+  interface AdapterRegistry {
+    readonly icqq: IcqqAdapter;
   }
 }
-
-/** Typed, generation-checked identity used by handlers, commands, tools and schedules. */
-export const icqqClient = defineEndpointClient<IcqqClient, IcqqClientEventMap>('icqq');

package/src/console-spec.ts

@@ -0,0 +1,26 @@
+/**
+ * ICQQ Console 页面元数据（浏览器与服务端共享；不要在这里 import 服务端代码）。
+ */
+import type { AdapterConsoleField } from 'zhin.js/adapter';
+
+export const icqqConsoleSpec = {
+  adapterKey: 'icqq',
+  adapterDisplayName: 'ICQQ',
+  fields: [
+    { key: 'password', env: true, description: 'QQ password; leave blank to retain the saved credential' },
+    { key: 'platform', type: 'number', description: 'ICQQ platform number' },
+    { key: 'ver', description: 'ICQQ protocol version' },
+    { key: 'dataDir', description: 'ICQQ device and session directory' },
+    { key: 'signApiAddr', description: 'ICQQ signing service URL' },
+    { key: 'autoReconnect', type: 'boolean', description: 'ICQQ reconnect setting' },
+    { key: 'autoServer', type: 'boolean', description: 'ICQQ automatic server selection' },
+    { key: 'qqnt', type: 'boolean', description: 'QQNT protocol' },
+    { key: 'ntLogin', type: 'boolean', description: 'QQNT login' },
+  ] as readonly AdapterConsoleField[],
+  docsUrl: 'https://zhin.js.org/adapters/icqq',
+  readPermission: 'icqq:read',
+  writePermission: 'icqq:write',
+  idPattern: /^\d+$/,
+  idHint: 'ICQQ endpoint id 是 QQ 号（纯数字）',
+  idHintI18n: { en: 'ICQQ endpoint ID is the QQ number (digits only)' },
+} as const;

package/src/console.ts

@@ -0,0 +1,17 @@
+/**
+ * ICQQ Console RPC：运行状态 + endpoint 增删（原 `icqq endpoint` 聊天命令）。
+ *
+ * 页面绑定 `pages/index`，读取 / 写入分别要求 `<adapter>:read` / `<adapter>:write`。
+ */
+import { createAdapterConsoleRpc } from 'zhin.js/adapter';
+import type { PluginConsoleRpc } from 'zhin.js';
+import { icqqConsoleSpec } from './console-spec.js';
+
+export function createIcqqConsoleRpc(
+  getConfig: () => unknown,
+): PluginConsoleRpc {
+  return createAdapterConsoleRpc({
+    ...icqqConsoleSpec,
+    getConfig,
+  });
+}