@zhin.js/adapter-icqq 1.1.18 → 1.1.20

package/src/group-moderation.ts

@@ -1,17 +1,17 @@
 import type { Client } from '@icqqjs/icqq';
-import type { GroupModerationAction, GroupModerationMember } from 'zhin.js/adapter';
+import { createEndpointOperation, type EndpointMemberInspectionRequest, type EndpointModerationRequest, type GroupModerationMember } from 'zhin.js/adapter';
 
 /** Native role/join facts stay in the adapter; the moderation plugin owns policy. */
 export async function inspectGroupMember(
-  client: Client, groupId: string, userId: string, signal: AbortSignal,
+  client: Client, { groupId, userId, signal }: EndpointMemberInspectionRequest,
 ): Promise<GroupModerationMember> {
-  signal.throwIfAborted();
+  const operation = createEndpointOperation({ signal });
   const group = numericId(groupId);
   const user = numericId(userId);
-  const selfLookup = client.getGroupMemberInfo(group, client.uin, true);
+  const selfLookup = operation.run(() => client.getGroupMemberInfo(group, client.uin, true));
   const [self, member] = await Promise.all([
     selfLookup,
-    user === client.uin ? selfLookup : client.getGroupMemberInfo(group, user, true),
+    user === client.uin ? selfLookup : operation.run(() => client.getGroupMemberInfo(group, user, true)),
   ]);
   signal.throwIfAborted();
   const joinedAt = member.join_time * 1000;
@@ -29,10 +29,10 @@ export async function inspectGroupMember(
 }
 
 export async function moderateGroupMember(
-  client: Client, groupId: string, userId: string, action: GroupModerationAction,
-  signal: AbortSignal, isActive: () => boolean,
+  { client, isActive }: { readonly client: Client; readonly isActive: () => boolean },
+  { groupId, userId, action, signal }: EndpointModerationRequest,
 ): Promise<void> {
-  const member = await inspectGroupMember(client, groupId, userId, signal);
+  const member = await inspectGroupMember(client, { groupId: groupId, userId: userId, signal: signal });
   signal.throwIfAborted();
   if (!isActive() || !member.canModerate) throw new Error('Group moderation permission is unavailable');
   if (action.type === 'kick') {
@@ -45,8 +45,8 @@ export async function moderateGroupMember(
     throw new Error('Invalid group mute duration');
   }
   const ok = action.type === 'kick'
-    ? await client.setGroupKick(numericId(groupId), numericId(userId))
-    : await client.setGroupBan(numericId(groupId), numericId(userId), action.durationSeconds);
+    ? await createEndpointOperation({ signal }).run(() => client.setGroupKick(numericId(groupId), numericId(userId)))
+    : await createEndpointOperation({ signal }).run(() => client.setGroupBan(numericId(groupId), numericId(userId), action.durationSeconds));
   if (!ok) throw new Error('Platform did not confirm the moderation action');
 }
 

package/src/group-scene.ts

@@ -1,5 +1,5 @@
 import type { Client } from '@icqqjs/icqq';
-import type { GroupMemberProfile, GroupSceneFacts } from 'zhin.js/adapter';
+import { createEndpointOperation, type EndpointGroupInspectionRequest, type EndpointMemberInspectionRequest, type GroupMemberProfile, type GroupSceneFacts } from 'zhin.js/adapter';
 
 /** Listing a very large roster only to find admins is not worth the packet; adminIds stay unknown. */
 export const ADMIN_SCAN_MAX_MEMBERS = 1000;
@@ -19,10 +19,10 @@ function numericId(value: string): number {
  * ADR 0041 scene facts: one uncached group-info read, plus (small groups only) one roster read for
  * admins. A roster failure leaves adminIds unknown instead of failing the other facts.
  */
-export async function inspectGroupScene(client: Client, groupId: string, signal: AbortSignal): Promise<GroupSceneFacts> {
-  signal.throwIfAborted();
+export async function inspectGroupScene(client: Client, { groupId, signal }: EndpointGroupInspectionRequest): Promise<GroupSceneFacts> {
+  const operation = createEndpointOperation({ signal });
   const group = numericId(groupId);
-  const info = await client.getGroupInfo(group, true);
+  const info = await operation.run(() => client.getGroupInfo(group, true));
   signal.throwIfAborted();
   if (info.group_id !== group) return {};
   const memberCount = Number.isSafeInteger(info.member_count) && info.member_count > 0 ? info.member_count : undefined;
@@ -30,7 +30,7 @@ export async function inspectGroupScene(client: Client, groupId: string, signal:
   let adminIds: string[] | undefined;
   if (memberCount === undefined || memberCount <= ADMIN_SCAN_MAX_MEMBERS) {
     try {
-      const roster = await client.getGroupMemberList(group);
+      const roster = await operation.run(() => client.getGroupMemberList(group));
       signal.throwIfAborted();
       adminIds = [...roster.values()]
         .filter(member => member.role === 'admin' && member.group_id === group)
@@ -55,12 +55,12 @@ export async function inspectGroupScene(client: Client, groupId: string, signal:
 
 /** ADR 0041 member facts from one uncached lookup (same rationale as the agent `freshMember` helper). */
 export async function inspectGroupMemberProfile(
-  client: Client, groupId: string, userId: string, signal: AbortSignal,
+  client: Client, { groupId, userId, signal }: EndpointMemberInspectionRequest,
 ): Promise<GroupMemberProfile> {
-  signal.throwIfAborted();
+  const operation = createEndpointOperation({ signal });
   const group = numericId(groupId);
   const user = numericId(userId);
-  const member = await client.getGroupMemberInfo(group, user, true);
+  const member = await operation.run(() => client.getGroupMemberInfo(group, user, true));
   signal.throwIfAborted();
   if (member.user_id !== user || member.group_id !== group) return {};
   const card = typeof member.card === 'string' && member.card.trim() ? member.card.trim() : undefined;

package/src/icqq-login-assist.ts

@@ -1,6 +1,6 @@
 import type { Locale } from 'zhin.js/i18n';
 import { messages as t } from './i18n.js';
-import type { LoginAssist, LoginAssistType, PendingLoginTaskPayload } from '@zhin.js/core';
+import type { LoginAssist, LoginAssistEndpointIdentity, LoginAssistType, PendingLoginTaskPayload } from '@zhin.js/core';
 import { formatCompact } from '@zhin.js/logger';
 
 type IcqqLoginClient = {
@@ -26,6 +26,8 @@ export async function runIcqqLoginAssistStep(input: {
   adapter: string;
   endpointKey: string;
   owner: object;
+  signal?: AbortSignal;
+  endpointIdentity?: LoginAssistEndpointIdentity;
   logger: Logger;
   step: LoginAssistType;
   event: unknown;
@@ -44,6 +46,7 @@ export async function runIcqqLoginAssistStep(input: {
   }));
 
   try {
+    input.signal?.throwIfAborted();
     if (step === 'device') {
       try {
         await client.sendSmsCode();
@@ -56,7 +59,8 @@ export async function runIcqqLoginAssistStep(input: {
       }
     }
 
-    const value = await assist.waitForInput(adapter, endpointKey, step, payload, { owner });
+    const value = await assist.waitForInput(adapter, endpointKey, step, payload, { owner, signal: input.signal, endpointIdentity: input.endpointIdentity });
+    input.signal?.throwIfAborted();
     const text = normalizeSubmitValue(value);
 
     switch (step) {

package/src/icqq-login-control.ts

@@ -1,9 +1,11 @@
 /**
  * ICQQ login control surface exposed to the Plugin Runtime, Console and the
- * recovery command. One control per endpoint instance (UIN), provided by the
- * ICQQ plugin setup and filled by `adapters/icqq/create()`.
+ * recovery command. Controls are projected from actual current incarnations in
+ * the owning IcqqAdapter; no plugin resource keeps a second Endpoint directory.
  */
-import { createToken } from 'zhin.js';
+import { adapterFeatureId, isAdapterIndex } from 'zhin.js/adapter';
+import type { FeatureId, PluginId } from 'zhin.js';
+import { IcqqAdapter } from './adapter.js';
 import type { PendingLoginTask } from '@zhin.js/core';
 
 export interface IcqqLoginControlState {
@@ -23,8 +25,18 @@ export interface IcqqLoginControl {
   cancel(taskId: string, reason?: string): boolean;
 }
 
-/** `endpoint id (QQ uin)` → control for the current generation. */
-export const icqqLoginControlToken = createToken<Map<string, IcqqLoginControl>>(
-  'zhin.icqq.login-control',
-  'ICQQ login control surface for recovery commands',
-);
+/** Read the owning Adapter's actual incarnations; this projection retains no independent directory. */
+export function icqqLoginControls(context: Readonly<{ owner: PluginId | Readonly<{ id: PluginId }>; project<T>(id: FeatureId): T }>): ReadonlyMap<string, IcqqLoginControl> {
+  const index = context.project<unknown>(adapterFeatureId);
+  if (!isAdapterIndex(index)) throw new Error('ICQQ Adapter projection is unavailable');
+  const owner = typeof context.owner === 'string' ? context.owner : context.owner.id;
+  const controls = new Map<string, IcqqLoginControl>();
+  for (const adapter of index.forOwner(owner).adapters()) {
+    if (!(adapter instanceof IcqqAdapter)) continue;
+    for (const row of adapter.list()) {
+      const endpoint = adapter.getEndpoint(row.instanceId);
+      if (endpoint) controls.set(row.endpointId, endpoint.loginControl);
+    }
+  }
+  return controls;
+}

package/src/index.ts

@@ -23,7 +23,6 @@ export {
 export * from './types.js';
 
 export {
-  icqqClient,
   type IcqqClient,
   type IcqqClientEventMap,
 } from './client.js';
@@ -31,3 +30,5 @@ export {
 export {
   resolveIcqqInboundMessageId,
 } from './icqq-inbound.js';
+
+export { IcqqAdapter } from './adapter.js';

package/src/protocol.ts

@@ -277,6 +277,9 @@ export interface IcqqWireSegment {
 }
 
 export interface IcqqInboundMessage {
+  /** Exact SDK callback object, operation-local and never a persisted projection. */
+  readonly event?: unknown;
+  readonly platformSentAt?: number;
   readonly id: string;
   readonly conversation: ConversationRef;
   readonly content: string;

package/lib/icqq-runtime-state.d.ts

@@ -1 +0,0 @@
-export declare const icqqRuntimeStateToken: import("zhin.js").Token<import("@zhin.js/adapter").EndpointRuntimeState>;

package/lib/icqq-runtime-state.js

@@ -1,6 +0,0 @@
-/**
- * ICQQ 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `icqq endpoint` 命令共享（同一 owner generation）。
- */
-import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
-export const icqqRuntimeStateToken = defineEndpointRuntimeStateToken('icqq');

package/src/icqq-runtime-state.ts

@@ -1,7 +0,0 @@
-/**
- * ICQQ 插件实例的运行时状态：adapter create() 注册的 endpoint 列表。
- * 由 plugin.ts setup() provide，adapter create 与 `icqq endpoint` 命令共享（同一 owner generation）。
- */
-import { defineEndpointRuntimeStateToken } from 'zhin.js/adapter';
-
-export const icqqRuntimeStateToken = defineEndpointRuntimeStateToken('icqq');