@zhin.js/adapter-satori 1.0.1 → 1.1.0

package/src/protocol.ts

@@ -0,0 +1,370 @@
+/**
+ * Satori protocol helpers (no legacy Adapter/Endpoint / segment-mapper).
+ * Canonicalization is owned by gateway/core before endpoint.send.
+ * Spec: https://satori.chat/zh-CN/protocol/overview.html
+ */
+
+import { pickCredential } from 'zhin.js/adapter';
+import { isMediaRef } from '@zhin.js/core';
+import type { ConversationKind, ConversationRef } from '@zhin.js/im-contract';
+import { formatCompact, getLogger } from '@zhin.js/logger';
+
+const logger = getLogger('satori');
+
+/** Opcode：EVENT=0, PING=1, PONG=2, IDENTIFY=3, READY=4, META=5 */
+export const SatoriOpcode = {
+  EVENT: 0,
+  PING: 1,
+  PONG: 2,
+  IDENTIFY: 3,
+  READY: 4,
+  META: 5,
+} as const;
+
+export interface SatoriSignal {
+  readonly op: number;
+  readonly body?: Record<string, unknown>;
+}
+
+export interface SatoriUser {
+  readonly id: string;
+  readonly name?: string;
+  readonly avatar?: string;
+}
+
+export interface SatoriChannel {
+  readonly id: string;
+  /** 0=TEXT, 1=DIRECT, 2=CATEGORY, 3=VOICE */
+  readonly type?: number;
+  readonly name?: string;
+  readonly parent_id?: string;
+}
+
+export interface SatoriMessage {
+  readonly id: string;
+  readonly content?: string;
+  readonly channel?: SatoriChannel;
+  readonly user?: SatoriUser;
+  readonly member?: { readonly user?: SatoriUser; readonly nick?: string };
+  readonly created_at?: number;
+  readonly updated_at?: number;
+}
+
+export interface SatoriLogin {
+  readonly platform?: string;
+  readonly user?: SatoriUser;
+  readonly status?: number;
+  readonly sn?: number;
+}
+
+export interface SatoriEventBody {
+  readonly type?: string;
+  readonly sn?: number;
+  readonly timestamp?: number;
+  readonly login?: SatoriLogin;
+  readonly message?: SatoriMessage;
+  readonly channel?: SatoriChannel;
+  readonly user?: SatoriUser;
+  readonly guild?: { readonly id: string; readonly name?: string };
+  readonly member?: { readonly user?: SatoriUser; readonly nick?: string; readonly roles?: string[] };
+  readonly [key: string]: unknown;
+}
+
+export interface SatoriApiOptions {
+  readonly baseUrl: string;
+  readonly platform: string;
+  readonly userId: string;
+  readonly token?: string;
+}
+
+export interface SatoriWireSegment {
+  readonly type: string;
+  readonly data?: Record<string, unknown>;
+}
+
+/** Plugin Runtime owner config (`plugins.<instanceKey>` / schema.json). */
+export interface SatoriAdapterConfig {
+  readonly id?: string;
+  readonly connection?: 'ws' | 'webhook';
+  readonly baseUrl?: string;
+  readonly token?: string;
+  readonly heartbeat_interval?: number;
+  /** Webhook POST path (connection: webhook). */
+  readonly path?: string;
+  /** Transitional: legacy root `endpoints[]` with `context: satori`. */
+  readonly endpoints?: ReadonlyArray<Partial<ResolvedSatoriWsConfig> & {
+    readonly context?: string;
+    readonly connection?: 'ws' | 'webhook';
+    readonly path?: string;
+  }>;
+}
+
+export interface ResolvedSatoriWsConfig {
+  readonly context: 'satori';
+  readonly connection: 'ws';
+  readonly id: string;
+  readonly baseUrl: string;
+  readonly token?: string;
+  readonly heartbeat_interval: number;
+}
+
+export interface ResolvedSatoriWebhookConfig {
+  readonly context: 'satori';
+  readonly connection: 'webhook';
+  readonly id: string;
+  readonly baseUrl: string;
+  readonly token?: string;
+  readonly path: string;
+}
+
+export type ResolvedSatoriConfig = ResolvedSatoriWsConfig | ResolvedSatoriWebhookConfig;
+
+export function resolveSatoriConfig(config: SatoriAdapterConfig = {}): ResolvedSatoriConfig {
+  const entry = config.endpoints?.find((item) => item.context === 'satori');
+  const connection = config.connection ?? entry?.connection ?? 'ws';
+  const baseUrl = pickCredential(config.baseUrl, entry?.baseUrl, process.env.SATORI_BASE_URL);
+  if (!baseUrl) {
+    throw new TypeError(
+      'Satori adapter requires baseUrl (plugins.<key>.baseUrl or endpoints with context: satori)',
+    );
+  }
+  const id = (typeof config.id === 'string' && config.id)
+    || (typeof entry?.id === 'string' && entry.id)
+    || process.env.SATORI_BOT_NAME
+    || 'satori-bot';
+  const token = (typeof config.token === 'string' && config.token)
+    || (typeof entry?.token === 'string' && entry.token)
+    || process.env.SATORI_TOKEN
+    || undefined;
+
+  if (connection === 'webhook') {
+    const path = config.path ?? entry?.path;
+    if (!path) {
+      throw new TypeError('Satori connection:webhook requires path');
+    }
+    return {
+      context: 'satori',
+      connection: 'webhook',
+      id,
+      baseUrl,
+      token,
+      path,
+    };
+  }
+
+  const heartbeat = config.heartbeat_interval
+    ?? entry?.heartbeat_interval
+    ?? 10_000;
+  return {
+    context: 'satori',
+    connection: 'ws',
+    id,
+    baseUrl,
+    token,
+    heartbeat_interval: heartbeat,
+  };
+}
+
+/** Channel.type 1 = DIRECT (private). */
+export function isPrivateChannel(channel?: SatoriChannel): boolean {
+  return channel?.type === 1;
+}
+
+export function isMessageEvent(
+  body: SatoriEventBody,
+): body is SatoriEventBody & { message: SatoriMessage } {
+  return (body.type === 'message-created' || body.type === 'message-updated')
+    && !!body.message?.id;
+}
+
+export function buildWsUrl(baseUrl: string, token?: string): string {
+  const url = new URL(baseUrl.replace(/\/$/, ''));
+  if (token) url.searchParams.set('access_token', token);
+  return url.toString();
+}
+
+/**
+ * Call Satori HTTP API: POST {baseUrl}/v1/{resource}.{method}
+ * @see https://satori.chat/en-US/protocol/api.html
+ */
+export async function callSatoriApi<T = unknown>(
+  options: SatoriApiOptions,
+  resource: string,
+  method: string,
+  params: Record<string, unknown> = {},
+): Promise<T> {
+  const { baseUrl, platform, userId, token } = options;
+  const url = `${baseUrl.replace(/\/$/, '')}/v1/${resource}.${method}`;
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+    'Satori-Platform': platform,
+    'Satori-User-ID': userId,
+  };
+  if (token) headers.Authorization = `Bearer ${token}`;
+
+  const res = await fetch(url, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(params),
+  });
+
+  const text = await res.text();
+  if (res.status === 401) throw new Error(`Satori API 认证失败: ${text}`);
+  if (res.status === 403) throw new Error(`Satori API 权限不足: ${text}`);
+  if (res.status === 404) throw new Error(`Satori API 不存在: ${resource}.${method}`);
+  if (res.status >= 400) throw new Error(`Satori API 错误 ${res.status}: ${text}`);
+
+  if (!text || text.trim() === '') return undefined as T;
+  try {
+    return JSON.parse(text) as T;
+  } catch {
+    throw new Error(`Satori API 无效 JSON: ${text.slice(0, 200)}`);
+  }
+}
+
+/** Build inbound text for OutboundMessageService.receive. */
+export function formatInboundContent(body: SatoriEventBody & { message: SatoriMessage }): string {
+  const content = body.message.content ?? '';
+  return typeof content === 'string' ? content : String(content);
+}
+
+
+/**
+ * 入站归一化 → ConversationRef：Channel.type 1 (DIRECT) → kind 'private'；
+ * 其余频道消息 → kind 'group'，所属 guild 容器进 `parent`（kind 'channel'）。
+ */
+export function satoriInboundConversation(
+  endpointKey: string,
+  body: SatoriEventBody & { message: SatoriMessage },
+): ConversationRef {
+  const channel = body.channel ?? body.message.channel;
+  const kind: ConversationKind = isPrivateChannel(channel) ? 'private' : 'group';
+  return {
+    endpoint: { id: endpointKey, adapter: endpointKey.split('\0')[0] ?? endpointKey },
+    kind,
+    id: channel?.id ?? '',
+    ...(kind === 'group' && body.guild?.id
+      ? { parent: { kind: 'channel' as const, id: body.guild.id } }
+      : {}),
+  };
+}
+
+export function resolveInboundSender(
+  body: SatoriEventBody & { message: SatoriMessage },
+): { id: string; name?: string } {
+  const user = body.user ?? body.message.user ?? body.message.member?.user;
+  const name = user?.name ?? body.message.member?.nick;
+  const id = user?.id ?? name ?? '';
+  return name && name !== id ? { id, name } : { id };
+}
+
+/**
+ * Detect `<at id="…"/>` elements in message content targeting the bot selfId.
+ * selfId 来源：READY/事件携带的 `login.user.id`。
+ */
+export function isSelfMentioned(
+  body: SatoriEventBody & { message: SatoriMessage },
+  selfId?: string,
+): boolean {
+  if (!selfId) return false;
+  const content = body.message.content;
+  if (typeof content !== 'string' || !content.includes('<at')) return false;
+  const tags = content.match(/<at\b[^>]*>/gi) ?? [];
+  return tags.some((tag) => /\bid\s*=\s*["']([^"']+)["']/i.exec(tag)?.[1] === selfId);
+}
+
+export function formatMessageId(channelId: string, messageId: string): string {
+  return `${channelId}:${messageId}`;
+}
+
+export function parseMessageRef(id: string): { channelId: string; messageId: string } {
+  if (id.includes(':')) {
+    const [channelId, messageId] = id.split(':');
+    return { channelId: channelId ?? '', messageId: messageId ?? '' };
+  }
+  return { channelId: '', messageId: id };
+}
+
+/**
+ * 解析媒体段（image/audio/video/file）的投递源，canonical MediaRef 为唯一来源：
+ * - kind=url → 直发 URL；
+ * - kind=base64 → 规范为 `base64://` 前缀内联（Satori img/file 元素消费内联数据）。
+ * 无 canonical 媒体引用或来源不可投递（path / file 本端点不物化）时 warn + 丢弃。
+ */
+function resolveMediaSrc(type: string, data: Record<string, unknown>): string | undefined {
+  const media = data.media;
+  if (!isMediaRef(media)) {
+    logger.warn(formatCompact({
+      op: 'satori_outbound_media_dropped',
+      type,
+      reason: 'missing_media_ref',
+    }));
+    return undefined;
+  }
+  if (media.kind === 'url') return media.value;
+  if (media.kind === 'base64') {
+    return media.value.startsWith('base64://') ? media.value : `base64://${media.value}`;
+  }
+  logger.warn(formatCompact({
+    op: 'satori_outbound_media_dropped',
+    type,
+    reason: `unsupported_media_kind:${media.kind}`,
+  }));
+  return undefined;
+}
+
+/**
+ * Wire-encode an already-rendered outbound payload into Satori message content.
+ * Segment canonicalization is intentionally not done here.
+ */
+export function formatSatoriOutbound(payload: unknown): string {
+  if (typeof payload === 'string') return payload;
+  if (payload == null) return '';
+
+  const segments: Array<string | SatoriWireSegment> = Array.isArray(payload)
+    ? payload as Array<string | SatoriWireSegment>
+    : payload && typeof payload === 'object' && 'type' in (payload as object)
+      ? [payload as SatoriWireSegment]
+      : [];
+
+  if (segments.length === 0) {
+    return typeof payload === 'object' ? JSON.stringify(payload) : String(payload);
+  }
+
+  const parts: string[] = [];
+  for (const item of segments) {
+    if (typeof item === 'string') {
+      parts.push(item);
+      continue;
+    }
+    const data = item.data ?? {};
+    switch (item.type) {
+      case 'text':
+        parts.push(String(data.text ?? data.content ?? ''));
+        break;
+      case 'at':
+      case 'mention':
+        parts.push(`@${String(data.name ?? data.id ?? data.target ?? '')}`);
+        break;
+      case 'image':
+      case 'audio':
+      case 'video':
+      case 'file': {
+        const src = resolveMediaSrc(item.type, data);
+        if (src) parts.push(`[${item.type}:${src}]`);
+        break;
+      }
+      default:
+        break;
+    }
+  }
+  return parts.join('');
+}
+
+export function extractCreatedMessageId(result: unknown): string {
+  const list = Array.isArray(result)
+    ? result
+    : (result as { data?: unknown[] } | null)?.data;
+  const msg = list?.[0] as { id?: string } | undefined;
+  return msg?.id ?? '';
+}

package/src/satori-endpoint-commands.ts

@@ -0,0 +1,19 @@
+/**
+ * `satori.endpoint` 命令族：由 @zhin.js/adapter 的 createEndpointCommands 套件生成。
+ * commands/endpoint/ 下的 list / add / remove 直接默认导出这三项。
+ */
+import { createEndpointCommands } from 'zhin.js/adapter';
+import { defineCommand } from 'zhin.js/command';
+import { satoriRuntimeStateToken } from './satori-runtime-state.js';
+
+export const satoriEndpointCommands = createEndpointCommands({
+  adapterKey: 'satori',
+  adapterDisplayName: 'Satori',
+  fields: [
+    { key: 'baseUrl', required: true, description: 'Satori 服务 base URL' },
+    { key: 'path', description: 'webhook 路径（connection: webhook）' },
+    { key: 'token', env: true, description: 'Satori access token' },
+  ],
+  running: (use) => use(satoriRuntimeStateToken).endpoints.values(),
+  describeEntry: (entry) => `baseUrl: ${String(entry.baseUrl)}`,
+}, defineCommand);

package/src/satori-runtime-state.ts

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

package/src/webhook.ts

@@ -0,0 +1,79 @@
+/**
+ * Satori webhook HTTP: token → opcode → parse → admit.
+ */
+import { timingSafeEqual } from 'node:crypto';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { HttpHost, HttpRouteRegistration } from '@zhin.js/host-http';
+import { getLogger } from '@zhin.js/logger';
+import {
+  SatoriOpcode,
+  type ResolvedSatoriWebhookConfig,
+} from './protocol.js';
+
+const logger = getLogger('satori');
+
+export interface SatoriWebhookHandler {
+  readonly config: ResolvedSatoriWebhookConfig;
+  readonly isOpen: boolean;
+  acceptHttp(request: IncomingMessage, response: ServerResponse): Promise<void>;
+}
+
+export function registerSatoriWebhookRoutes(
+  http: HttpHost,
+  handler: SatoriWebhookHandler,
+): HttpRouteRegistration[] {
+  const path = handler.config.path;
+  return [
+    http.route('POST', path, async (request, response) => {
+      await handleSatoriWebhookRequest(request, response, handler);
+    }, { summary: 'Satori webhook callback', tags: ['satori'] }),
+  ];
+}
+
+export async function handleSatoriWebhookRequest(
+  request: IncomingMessage,
+  response: ServerResponse,
+  handler: SatoriWebhookHandler,
+): Promise<void> {
+  try {
+    if (!verifySatoriToken(handler.config.token, request)) {
+      response.writeHead(403, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ message: 'Unauthorized' }));
+      return;
+    }
+    const opcode = resolveSatoriOpcode(request);
+    if (opcode !== SatoriOpcode.EVENT && opcode !== SatoriOpcode.META) {
+      response.writeHead(200, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ message: 'OK' }));
+      return;
+    }
+    if (handler.isOpen) {
+      await handler.acceptHttp(request, response);
+    } else {
+      response.writeHead(200, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ status: 'ok' }));
+    }
+  } catch (error) {
+    logger.error('Satori webhook error:', error);
+    if (!response.headersSent) {
+      response.writeHead(500, { 'Content-Type': 'application/json' });
+      response.end(JSON.stringify({ message: 'Internal Server Error' }));
+    }
+  }
+}
+
+export function resolveSatoriOpcode(request: IncomingMessage): number | undefined {
+  const raw = request.headers['satori-opcode'] ?? request.headers['Satori-Opcode'];
+  const value = Array.isArray(raw) ? raw[0] : raw;
+  if (value == null || value === '') return undefined;
+  const parsed = Number.parseInt(String(value), 10);
+  return Number.isNaN(parsed) ? undefined : parsed;
+}
+
+export function verifySatoriToken(token: string | undefined, request: IncomingMessage): boolean {
+  if (!token) return true;
+  const auth = request.headers.authorization ?? '';
+  const expected = Buffer.from(`Bearer ${token}`, 'utf8');
+  const actual = Buffer.from(auth, 'utf8');
+  return actual.length === expected.length && timingSafeEqual(actual, expected);
+}

package/src/ws.ts

@@ -0,0 +1,22 @@
+import WebSocket from 'ws';
+
+export const WS_OPEN = 1;
+
+export interface SatoriWsSocket {
+  readonly readyState: number;
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+  on(event: 'open' | 'message' | 'close' | 'error', listener: (...args: unknown[]) => void): void;
+}
+
+export type CreateSatoriWebSocket = (
+  url: string,
+  options?: { readonly headers?: Record<string, string> },
+) => SatoriWsSocket;
+
+export function defaultCreateWebSocket(
+  url: string,
+  options?: { readonly headers?: Record<string, string> },
+): SatoriWsSocket {
+  return new WebSocket(url, { headers: options?.headers }) as unknown as SatoriWsSocket;
+}

package/lib/adapter.d.ts

@@ -1,17 +0,0 @@
-/**
- * Satori 适配器：单一适配器支持 WS 正向 / Webhook，由 config.connection 区分
- * 协议文档：https://satori.chat/zh-CN/introduction.html
- */
-import { Adapter, Plugin } from 'zhin.js';
-import { SatoriWsClient } from './endpoint-ws.js';
-import { SatoriWebhookEndpoint } from './endpoint-webhook.js';
-import type { SatoriEndpointConfig } from './types.js';
-export type SatoriBot = SatoriWsClient | SatoriWebhookEndpoint;
-export declare class SatoriAdapter extends Adapter<SatoriBot> {
-    #private;
-    static readonly capabilities: readonly ["inbound", "outbound"];
-    constructor(plugin: Plugin);
-    createEndpoint(config: SatoriEndpointConfig): SatoriBot;
-    start(): Promise<void>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAiB,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EACV,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAE/D,qBAAa,aAAc,SAAQ,OAAO,CAAC,SAAS,CAAC;;IACnD,gBAAyB,YAAY,mCAAoC;gBAI7D,MAAM,EAAE,MAAM;IAI1B,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS;IAcjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/lib/adapter.js

@@ -1,35 +0,0 @@
-/**
- * Satori 适配器：单一适配器支持 WS 正向 / Webhook，由 config.connection 区分
- * 协议文档：https://satori.chat/zh-CN/introduction.html
- */
-import { Adapter } from 'zhin.js';
-import { SatoriWsClient } from './endpoint-ws.js';
-import { SatoriWebhookEndpoint } from './endpoint-webhook.js';
-export class SatoriAdapter extends Adapter {
-    static capabilities = ['inbound', 'outbound'];
-    #router;
-    constructor(plugin) {
-        super(plugin, 'satori', []);
-    }
-    createEndpoint(config) {
-        switch (config.connection) {
-            case 'ws':
-                return new SatoriWsClient(this, config);
-            case 'webhook':
-                if (!this.#router) {
-                    throw new Error('Satori connection: webhook 需要 router，请安装并在配置中启用 @zhin.js/host-router');
-                }
-                return new SatoriWebhookEndpoint(this, this.#router, config);
-            default:
-                throw new Error(`Unknown Satori connection: ${config.connection}`);
-        }
-    }
-    async start() {
-        this.#router = this.plugin.inject('router');
-        this.plugin.useContext('router', (router) => {
-            this.#router = router;
-        });
-        await super.start();
-    }
-}
-//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAiB,OAAO,EAAU,MAAM,SAAS,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAU9D,MAAM,OAAO,aAAc,SAAQ,OAAkB;IACnD,MAAM,CAAmB,YAAY,GAAG,CAAC,SAAS,EAAE,UAAU,CAAU,CAAC;IAEzE,OAAO,CAAU;IAEjB,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,MAA4B;QACzC,QAAQ,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1B,KAAK,IAAI;gBACP,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,MAAwB,CAAC,CAAC;YAC5D,KAAK,SAAS;gBACZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;gBAC1F,CAAC;gBACD,OAAO,IAAI,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAA6B,CAAC,CAAC;YACtF;gBACE,MAAM,IAAI,KAAK,CAAC,8BAA+B,MAA+B,CAAC,UAAU,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAI,IAAI,CAAC,MAAM,CAAC,MAA8C,CAAC,QAAQ,CAAC,CAAC;QACpF,IAAI,CAAC,MAAM,CAAC,UAAkE,CAAC,QAAQ,EAAE,CAAC,MAAc,EAAE,EAAE;YAC3G,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC"}

package/lib/api.d.ts

@@ -1,15 +0,0 @@
-/**
- * Satori HTTP API 封装：POST /v1/{resource}.{method}，头 Satori-Platform、Satori-User-ID、Authorization
- * 参考 https://satori.chat/en-US/protocol/api.html
- */
-export interface SatoriApiOptions {
-    baseUrl: string;
-    platform: string;
-    userId: string;
-    token?: string;
-}
-/**
- * 调用 Satori API：POST {baseUrl}/v1/{resource}.{method}，JSON body
- */
-export declare function callSatoriApi<T = unknown>(options: SatoriApiOptions, resource: string, method: string, params?: Record<string, unknown>): Promise<T>;
-//# sourceMappingURL=api.d.ts.map

package/lib/api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,OAAO,EAC7C,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC,CA4BZ"}

package/lib/api.js

@@ -1,37 +0,0 @@
-/**
- * 调用 Satori API：POST {baseUrl}/v1/{resource}.{method}，JSON body
- */
-export async function callSatoriApi(options, resource, method, params = {}) {
-    const { baseUrl, platform, userId, token } = options;
-    const url = `${baseUrl.replace(/\/$/, '')}/v1/${resource}.${method}`;
-    const headers = {
-        'Content-Type': 'application/json',
-        'Satori-Platform': platform,
-        'Satori-User-ID': userId,
-    };
-    if (token)
-        headers['Authorization'] = `Bearer ${token}`;
-    const res = await fetch(url, {
-        method: 'POST',
-        headers,
-        body: JSON.stringify(params),
-    });
-    const text = await res.text();
-    if (res.status === 401)
-        throw new Error(`Satori API 认证失败: ${text}`);
-    if (res.status === 403)
-        throw new Error(`Satori API 权限不足: ${text}`);
-    if (res.status === 404)
-        throw new Error(`Satori API 不存在: ${resource}.${method}`);
-    if (res.status >= 400)
-        throw new Error(`Satori API 错误 ${res.status}: ${text}`);
-    if (!text || text.trim() === '')
-        return undefined;
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        throw new Error(`Satori API 无效 JSON: ${text.slice(0, 200)}`);
-    }
-}
-//# sourceMappingURL=api.js.map

package/lib/api.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAyB,EACzB,QAAgB,EAChB,MAAc,EACd,SAAkC,EAAE;IAEpC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,QAAQ,IAAI,MAAM,EAAE,CAAC;IACrE,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,iBAAiB,EAAE,QAAQ;QAC3B,gBAAgB,EAAE,MAAM;KACzB,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;IAExD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;KAC7B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IACpE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IACpE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;IACjF,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAE/E,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAc,CAAC;IACvD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/lib/endpoint-webhook.d.ts

@@ -1,27 +0,0 @@
-/**
- * Satori WebHook Bot：应用提供 POST path，SDK 推送 EVENT（Satori-Opcode: 0）
- */
-import { EventEmitter } from 'events';
-import { Endpoint, Message, SendOptions } from 'zhin.js';
-import { type Router } from '@zhin.js/host-router/router';
-import type { SatoriWebhookConfig, SatoriEventBody } from './types.js';
-import type { SatoriAdapter } from './adapter.js';
-export declare class SatoriWebhookEndpoint extends EventEmitter implements Endpoint<SatoriWebhookConfig, SatoriEventBody> {
-    adapter: SatoriAdapter;
-    router: Router;
-    $config: SatoriWebhookConfig;
-    $connected: boolean;
-    /** 从首个事件的 login 得到，用于 API 的 platform / userId */
-    private login?;
-    get logger(): import("zhin.js").Logger;
-    constructor(adapter: SatoriAdapter, router: Router, $config: SatoriWebhookConfig);
-    get $id(): string;
-    private apiOptions;
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    private handleEvent;
-    $formatMessage(body: SatoriEventBody): Message<SatoriEventBody>;
-    $sendMessage(options: SendOptions): Promise<string>;
-    $recallMessage(id: string): Promise<void>;
-}
-//# sourceMappingURL=endpoint-webhook.d.ts.map

package/lib/endpoint-webhook.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"endpoint-webhook.d.ts","sourceRoot":"","sources":["../src/endpoint-webhook.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAiB,QAAQ,EAAE,OAAO,EAAW,WAAW,EAAE,MAAM,SAAS,CAAC;AACjF,OAAO,EAAsB,KAAK,MAAM,EAAsB,MAAM,6BAA6B,CAAC;AAElG,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAEpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,qBAAa,qBAAsB,SAAQ,YAAa,YAAW,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC;IAUtG,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,mBAAmB;IAXrC,UAAU,EAAE,OAAO,CAAQ;IAC3B,iDAAiD;IACjD,OAAO,CAAC,KAAK,CAAC,CAAc;IAE5B,IAAI,MAAM,6BAET;gBAGQ,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB;IAKrC,IAAI,GAAG,WAEN;IAED,OAAO,CAAC,UAAU;IAMZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAezB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,CAAC,WAAW;IAUnB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IA+BzD,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAanD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIhD"}