@zhin.js/adapter-kook 2.0.10 → 2.0.12

package/lib/kook-asset-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-asset-upload.d.ts","sourceRoot":"","sources":["../src/kook-asset-upload.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CACF,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAC5C,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAuBD,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,MAAM,GAAG,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/lib/kook-asset-upload.js

@@ -0,0 +1,46 @@
+/**
+ * KOOK /v3/asset/create 上传（formdata-node 要求 Blob，不能直传 Node Buffer）。
+ */
+import { readFile } from "node:fs/promises";
+function guessFilename(data) {
+    if (Buffer.isBuffer(data))
+        return "upload.png";
+    if (/^data:image\/png/i.test(data))
+        return "upload.png";
+    if (/^data:image\/jpe?g/i.test(data))
+        return "upload.jpg";
+    if (/^data:image\/gif/i.test(data))
+        return "upload.gif";
+    if (/^data:image\/webp/i.test(data))
+        return "upload.webp";
+    const base = data.replace(/^file:\/\//, "").split("/").pop();
+    return base?.includes(".") ? base : "upload.png";
+}
+async function toBuffer(data) {
+    if (Buffer.isBuffer(data))
+        return data;
+    if (data.startsWith("base64://")) {
+        return Buffer.from(data.slice(9), "base64");
+    }
+    if (/^data:[^/]+\/[^;]+;base64,/i.test(data)) {
+        return Buffer.from(data.replace(/^data:[^/]+\/[^;]+;base64,/, ""), "base64");
+    }
+    return readFile(data.replace(/^file:\/\//, ""));
+}
+export async function uploadKookAsset(request, data) {
+    if (typeof data === "string" && /^https?:\/\//i.test(data)) {
+        return data;
+    }
+    const buffer = await toBuffer(data);
+    const form = new globalThis.FormData();
+    form.append("file", new globalThis.Blob([new Uint8Array(buffer)]), guessFilename(data));
+    const response = await request.post("/v3/asset/create", form, {
+        headers: { Accept: "application/json" },
+    });
+    const url = response.data?.url;
+    if (!url) {
+        throw new Error(`KOOK asset upload failed: ${response.message ?? "missing url"}`);
+    }
+    return url;
+}
+//# sourceMappingURL=kook-asset-upload.js.map

package/lib/kook-asset-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-asset-upload.js","sourceRoot":"","sources":["../src/kook-asset-upload.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAU5C,SAAS,aAAa,CAAC,IAAqB;IAC1C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IAC/C,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IACxD,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IAC1D,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,CAAC;IACxD,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAC7D,OAAO,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAqB;IAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAyB,EACzB,IAAqB;IAErB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAExF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,EAAE;QAC5D,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;KACxC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/kook-inbound.d.ts

@@ -0,0 +1,6 @@
+export declare class InboundMessageDeduper {
+    private readonly seen;
+    shouldProcess(key: string): boolean;
+    clear(): void;
+}
+//# sourceMappingURL=kook-inbound.d.ts.map

package/lib/kook-inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-inbound.d.ts","sourceRoot":"","sources":["../src/kook-inbound.ts"],"names":[],"mappings":"AAKA,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAElD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUnC,KAAK,IAAI,IAAI;CAGd"}

package/lib/kook-inbound.js

@@ -0,0 +1,22 @@
+/**
+ * KOOK 入站侧事件去重（gateway notice / 系统消息）
+ */
+const DEDUPE_TTL_MS = 120_000;
+export class InboundMessageDeduper {
+    seen = new Map();
+    shouldProcess(key) {
+        const now = Date.now();
+        for (const [id, t] of this.seen) {
+            if (now - t > DEDUPE_TTL_MS)
+                this.seen.delete(id);
+        }
+        if (this.seen.has(key))
+            return false;
+        this.seen.set(key, now);
+        return true;
+    }
+    clear() {
+        this.seen.clear();
+    }
+}
+//# sourceMappingURL=kook-inbound.js.map

package/lib/kook-inbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-inbound.js","sourceRoot":"","sources":["../src/kook-inbound.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,MAAM,OAAO,qBAAqB;IACf,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElD,aAAa,CAAC,GAAW;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,GAAG,GAAG,CAAC,GAAG,aAAa;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF"}

package/lib/kook-msg-route.d.ts

@@ -0,0 +1,34 @@
+/**
+ * KOOK msg_id 路由：频道 / 私聊 API 路径不同，出站编码路由、入站/删除按路由命中。
+ */
+export type KookMsgRoute = 'channel' | 'direct';
+export declare function routeFromSceneType(sceneType?: 'private' | 'group' | 'channel'): KookMsgRoute | undefined;
+export declare function routeFromSendType(type: 'private' | 'group' | 'channel'): KookMsgRoute;
+/** 出站 send 返回值，供 recall / typing 删除时走路由 */
+export declare function encodeKookMsgRef(route: KookMsgRoute, msgId: string): string;
+export declare function parseKookMsgRef(ref: string): {
+    route?: KookMsgRoute;
+    msgId: string;
+};
+export declare function plainKookMsgId(ref: string): string;
+export declare function resolveKookRoutes(action: 'add' | 'delete', routeHint?: KookMsgRoute): KookMsgRoute[];
+export declare function isKookMsgGoneError(err: unknown): boolean;
+/** KOOK 标准成功：code=0；少数接口 HTTP 200 省略 code */
+export declare function isKookApiSuccess(result: unknown): boolean;
+/** 明确的业务失败（可尝试另一路由） */
+export declare function isKookExplicitError(result: unknown): boolean;
+/**
+ * delete 请求已返回且未抛错：是否停止（不再打第二条路由）。
+ * 仅当双路由且响应为明确错误码时，才继续尝试下一路由。
+ */
+export declare function shouldStopDeleteAfterResponse(result: unknown, routeCount: number): boolean;
+/** KOOK 有时用 HTTP 200 + 非 0 code 表示目标已不存在 */
+export declare function isKookApiGoneResult(result: unknown): boolean;
+export declare function kookDeleteApiPath(route: KookMsgRoute): string;
+export declare function kookReactionApiPath(route: KookMsgRoute, action: 'add' | 'delete'): string;
+export declare function encodeKookReactionId(route: KookMsgRoute, msgId: string, emoji: string): string;
+export declare function parseKookReactionId(reactionId: string): {
+    route?: KookMsgRoute;
+    emoji: string;
+};
+//# sourceMappingURL=kook-msg-route.d.ts.map

package/lib/kook-msg-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-msg-route.d.ts","sourceRoot":"","sources":["../src/kook-msg-route.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhD,wBAAgB,kBAAkB,CAChC,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAC1C,YAAY,GAAG,SAAS,CAI1B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAErF;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMpF;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,GAAG,QAAQ,EACxB,SAAS,CAAC,EAAE,YAAY,GACvB,YAAY,EAAE,CAIhB;AASD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAExD;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED,uBAAuB;AACvB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAI5D;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAIT;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAK5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAE7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAIzF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG;IACvD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAYA"}

package/lib/kook-msg-route.js

@@ -0,0 +1,106 @@
+/**
+ * KOOK msg_id 路由：频道 / 私聊 API 路径不同，出站编码路由、入站/删除按路由命中。
+ */
+export function routeFromSceneType(sceneType) {
+    if (sceneType === 'private')
+        return 'direct';
+    if (sceneType === 'group' || sceneType === 'channel')
+        return 'channel';
+    return undefined;
+}
+export function routeFromSendType(type) {
+    return type === 'private' ? 'direct' : 'channel';
+}
+/** 出站 send 返回值，供 recall / typing 删除时走路由 */
+export function encodeKookMsgRef(route, msgId) {
+    return `kook:${route}:${msgId}`;
+}
+export function parseKookMsgRef(ref) {
+    const parts = ref.split(':');
+    if (parts[0] === 'kook' && (parts[1] === 'channel' || parts[1] === 'direct') && parts.length >= 3) {
+        return { route: parts[1], msgId: parts.slice(2).join(':') };
+    }
+    return { msgId: ref };
+}
+export function plainKookMsgId(ref) {
+    return parseKookMsgRef(ref).msgId;
+}
+export function resolveKookRoutes(action, routeHint) {
+    if (action === 'delete' && routeHint)
+        return [routeHint];
+    if (routeHint)
+        return [routeHint, routeHint === 'channel' ? 'direct' : 'channel'];
+    return ['channel', 'direct'];
+}
+function isKookGoneText(text) {
+    return text.includes('404')
+        || text.includes('该数据不存在')
+        || text.includes('没有权限操作')
+        || text.toLowerCase().includes('not found');
+}
+export function isKookMsgGoneError(err) {
+    return isKookGoneText(err instanceof Error ? err.message : String(err));
+}
+/** KOOK 标准成功：code=0；少数接口 HTTP 200 省略 code */
+export function isKookApiSuccess(result) {
+    if (result == null || typeof result !== 'object')
+        return false;
+    const { code } = result;
+    if (code === 0)
+        return true;
+    if (code === undefined)
+        return true;
+    return false;
+}
+/** 明确的业务失败（可尝试另一路由） */
+export function isKookExplicitError(result) {
+    if (result == null || typeof result !== 'object')
+        return false;
+    const { code } = result;
+    return typeof code === 'number' && code !== 0;
+}
+/**
+ * delete 请求已返回且未抛错：是否停止（不再打第二条路由）。
+ * 仅当双路由且响应为明确错误码时，才继续尝试下一路由。
+ */
+export function shouldStopDeleteAfterResponse(result, routeCount) {
+    if (isKookApiSuccess(result) || isKookApiGoneResult(result))
+        return true;
+    if (routeCount === 1)
+        return true;
+    return !isKookExplicitError(result);
+}
+/** KOOK 有时用 HTTP 200 + 非 0 code 表示目标已不存在 */
+export function isKookApiGoneResult(result) {
+    if (!result || typeof result !== 'object')
+        return false;
+    const { code, message } = result;
+    if (code === 404)
+        return true;
+    return isKookGoneText(message ?? '');
+}
+export function kookDeleteApiPath(route) {
+    return route === 'channel' ? '/v3/message/delete' : '/v3/direct-message/delete';
+}
+export function kookReactionApiPath(route, action) {
+    const prefix = route === 'channel' ? '/v3/message' : '/v3/direct-message';
+    const suffix = action === 'add' ? 'add-reaction' : 'delete-reaction';
+    return `${prefix}/${suffix}`;
+}
+export function encodeKookReactionId(route, msgId, emoji) {
+    return `reaction:${route}:${msgId}:${emoji}`;
+}
+export function parseKookReactionId(reactionId) {
+    const parts = reactionId.split(':');
+    if (parts[0] === 'reaction' && (parts[1] === 'channel' || parts[1] === 'direct')) {
+        return {
+            route: parts[1],
+            emoji: parts.slice(3).join(':') || '⏳',
+        };
+    }
+    if (parts[0] === 'reaction' && parts.length >= 3) {
+        return { emoji: parts.slice(2).join(':') || '⏳' };
+    }
+    return { emoji: parts[parts.length - 1] ?? '⏳' };
+}
+//# sourceMappingURL=kook-msg-route.js.map

package/lib/kook-msg-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-msg-route.js","sourceRoot":"","sources":["../src/kook-msg-route.ts"],"names":[],"mappings":"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"}

package/lib/kook-side-events.d.ts

@@ -0,0 +1,43 @@
+/**
+ * KOOK Gateway 非聊天入站：系统消息 (type=255) / BROADCAST → Notice
+ * @see https://developer.kookapp.cn/doc/event/event-introduction
+ */
+import { Notice } from "zhin.js";
+/** KOOK WebSocket s=0 时 d 字段（kook-client Receiver 入参） */
+export interface KookGatewayEvent {
+    channel_type?: string;
+    type?: number;
+    target_id?: string;
+    author_id?: string;
+    content?: string;
+    msg_id?: string;
+    msg_timestamp?: number;
+    nonce?: string;
+    extra?: KookGatewayExtra;
+    [key: string]: unknown;
+}
+export interface KookGatewayExtra {
+    type?: string;
+    body?: Record<string, unknown>;
+    guild_id?: string;
+    channel_id?: string;
+    channel_name?: string;
+    author?: {
+        id?: string;
+        username?: string;
+        nickname?: string;
+    };
+    [key: string]: unknown;
+}
+/** 是否应由适配器作为 notice 处理（kook-client 对 notice 的 transform 为空实现） */
+export declare function isKookNoticeGatewayEvent(data: unknown): data is KookGatewayEvent;
+export declare function resolveKookSideEventDedupeKey(event: KookGatewayEvent, kind: "notice" | "gateway"): string;
+/** 解析 notice 发生的频道 / 群 / 私聊 */
+export declare function resolveKookNoticeChannel(event: KookGatewayEvent): {
+    id: string;
+    type: "group" | "private" | "channel";
+};
+export declare function enrichKookGatewayForPlugins(event: KookGatewayEvent): KookGatewayEvent;
+export declare function formatKookNotice(event: KookGatewayEvent, botName: string): ReturnType<typeof Notice.from<KookGatewayEvent>>;
+export declare function formatKookNoticeLog(notice: ReturnType<typeof formatKookNotice>): string;
+//# sourceMappingURL=kook-side-events.d.ts.map

package/lib/kook-side-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-side-events.d.ts","sourceRoot":"","sources":["../src/kook-side-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAkC,MAAM,SAAS,CAAC;AAEjE,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,iEAAiE;AACjE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAKhF;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,QAAQ,GAAG,SAAS,GACzB,MAAM,CAOR;AA6BD,+BAA+B;AAC/B,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,gBAAgB,GACtB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;CAAE,CA+DvD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAWrF;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACd,UAAU,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CA6BlD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAAG,MAAM,CAOvF"}

package/lib/kook-side-events.js

@@ -0,0 +1,147 @@
+/**
+ * KOOK Gateway 非聊天入站：系统消息 (type=255) / BROADCAST → Notice
+ * @see https://developer.kookapp.cn/doc/event/event-introduction
+ */
+import { Notice, formatCompact } from "zhin.js";
+const SYSTEM_MESSAGE_TYPE = 255;
+/** 是否应由适配器作为 notice 处理（kook-client 对 notice 的 transform 为空实现） */
+export function isKookNoticeGatewayEvent(data) {
+    if (!data || typeof data !== "object")
+        return false;
+    const ev = data;
+    if (ev.type === SYSTEM_MESSAGE_TYPE)
+        return true;
+    return ev.channel_type === "BROADCAST";
+}
+export function resolveKookSideEventDedupeKey(event, kind) {
+    if (event.msg_id)
+        return `${kind}:${event.msg_id}`;
+    const extra = event.extra ?? {};
+    const noticeType = extra.type ?? String(event.type ?? "");
+    const scope = event.target_id ?? "";
+    const ts = event.msg_timestamp ?? 0;
+    return `${kind}:${ts}_${noticeType}_${scope}`;
+}
+const NOTICE_TYPE_MAP = {
+    joined_guild: "group_member_increase",
+    exited_guild: "group_member_decrease",
+    deleted_message: "group_recall",
+    deleted_private_message: "friend_recall",
+    added_reaction: "group_emoji_reaction",
+    deleted_reaction: "group_emoji_reaction",
+    private_added_reaction: "group_emoji_reaction",
+    private_deleted_reaction: "group_emoji_reaction",
+};
+function resolveNoticeZhinType(rawType) {
+    return NOTICE_TYPE_MAP[rawType] ?? rawType;
+}
+function senderFromId(id, name) {
+    if (id == null || id === "")
+        return undefined;
+    const s = String(id);
+    return { id: s, name: name ?? s };
+}
+function readString(obj, key) {
+    const v = obj?.[key];
+    if (v == null || v === "")
+        return undefined;
+    return String(v);
+}
+/** 解析 notice 发生的频道 / 群 / 私聊 */
+export function resolveKookNoticeChannel(event) {
+    const extra = event.extra ?? {};
+    const body = extra.body ?? {};
+    const rawType = String(extra.type ?? "");
+    if (event.channel_type === "BROADCAST") {
+        const guildId = readString(body, "guild_id")
+            ?? extra.guild_id
+            ?? event.target_id
+            ?? "";
+        return { id: guildId, type: "group" };
+    }
+    if (event.type === SYSTEM_MESSAGE_TYPE && event.channel_type === "GROUP") {
+        const guildId = readString(body, "guild_id")
+            ?? extra.guild_id
+            ?? event.target_id
+            ?? "";
+        if (rawType === "joined_guild"
+            || rawType === "exited_guild"
+            || rawType === "updated_guild"
+            || rawType === "deleted_guild"
+            || rawType.startsWith("added_role")
+            || rawType.startsWith("deleted_role")
+            || rawType.startsWith("updated_role")
+            || rawType.startsWith("added_block")
+            || rawType.startsWith("deleted_block")
+            || rawType === "self_joined_guild"
+            || rawType === "self_exited_guild") {
+            return { id: guildId, type: "group" };
+        }
+        const channelId = readString(body, "channel_id")
+            ?? extra.channel_id
+            ?? event.target_id
+            ?? "";
+        return { id: channelId, type: "channel" };
+    }
+    if (rawType.startsWith("private_")
+        || rawType.includes("private_message")
+        || event.channel_type === "PERSON") {
+        const userId = readString(body, "user_id")
+            ?? readString(body, "target_id")
+            ?? event.target_id
+            ?? event.author_id
+            ?? "";
+        return { id: userId, type: "private" };
+    }
+    const channelId = readString(body, "channel_id")
+        ?? extra.channel_id
+        ?? event.target_id
+        ?? "";
+    return { id: channelId, type: "channel" };
+}
+export function enrichKookGatewayForPlugins(event) {
+    const extra = event.extra ?? {};
+    const noticeType = extra.type;
+    if (!isKookNoticeGatewayEvent(event)) {
+        return { ...event, post_type: "message" };
+    }
+    return {
+        ...event,
+        post_type: "notice",
+        notice_type: noticeType ?? "system",
+    };
+}
+export function formatKookNotice(event, botName) {
+    const extra = event.extra ?? {};
+    const body = extra.body ?? {};
+    const rawType = String(extra.type ?? "unknown");
+    const $type = resolveNoticeZhinType(rawType);
+    const channel = resolveKookNoticeChannel(event);
+    const ts = event.msg_timestamp ?? Date.now();
+    const targetId = readString(body, "user_id")
+        ?? readString(body, "msg_id")
+        ?? readString(body, "target_id");
+    const operatorId = readString(body, "operator_id")
+        ?? (event.author_id !== "1" ? event.author_id : undefined);
+    const mapped = NOTICE_TYPE_MAP[rawType] != null;
+    return Notice.from(event, {
+        $id: resolveKookSideEventDedupeKey(event, "notice"),
+        $adapter: "kook",
+        $bot: botName,
+        $type,
+        $subType: mapped ? rawType : undefined,
+        $channel: channel,
+        $operator: senderFromId(operatorId),
+        $target: senderFromId(targetId),
+        $timestamp: ts,
+    });
+}
+export function formatKookNoticeLog(notice) {
+    return formatCompact({
+        notice: notice.$type,
+        kook_type: notice.$subType,
+        channel: `${notice.$channel.type}(${notice.$channel.id})`,
+        bot: notice.$bot,
+    });
+}
+//# sourceMappingURL=kook-side-events.js.map

package/lib/kook-side-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kook-side-events.js","sourceRoot":"","sources":["../src/kook-side-events.ts"],"names":[],"mappings":"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"}

package/lib/outbound-media.d.ts

@@ -0,0 +1,10 @@
+/**
+ * KOOK 出站媒体：base64 / 本地文件须先走 /v3/asset/create 上传，再嵌入 KMarkdown。
+ */
+import type { MessageElement, SendContent } from "zhin.js";
+export interface KookMediaUploader {
+    uploadMedia(data: string | Buffer): Promise<string>;
+}
+/** 将 base64 / 本地媒体上传为 KOOK 可访问 URL */
+export declare function materializeOutboundMedia(uploader: KookMediaUploader, content: SendContent): Promise<MessageElement[]>;
+//# sourceMappingURL=outbound-media.d.ts.map

package/lib/outbound-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-media.d.ts","sourceRoot":"","sources":["../src/outbound-media.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAkB,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3E,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD;AA2FD,sCAAsC;AACtC,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CAM3B"}

package/lib/outbound-media.js

@@ -0,0 +1,86 @@
+const MEDIA_TYPES = new Set(["image", "audio", "video", "file"]);
+function isMessageSegment(seg) {
+    return typeof seg.type === "string";
+}
+function isRemoteUrl(value) {
+    return /^https?:\/\//i.test(value);
+}
+function asSegments(content) {
+    if (typeof content === "string") {
+        return [{ type: "text", data: { text: content } }];
+    }
+    if (!Array.isArray(content)) {
+        return [content];
+    }
+    return content.map((item) => typeof item === "string" ? { type: "text", data: { text: item } } : item);
+}
+function extractBase64Buffer(data) {
+    const url = typeof data.url === "string" ? data.url : undefined;
+    const file = typeof data.file === "string" ? data.file : undefined;
+    const base64 = typeof data.base64 === "string" ? data.base64 : undefined;
+    if (url?.startsWith("base64://")) {
+        return Buffer.from(url.slice(9), "base64");
+    }
+    if (url && /^data:[^/]+\/[^;]+;base64,/i.test(url)) {
+        return Buffer.from(url.replace(/^data:[^/]+\/[^;]+;base64,/, ""), "base64");
+    }
+    if (file?.startsWith("base64://")) {
+        return Buffer.from(file.slice(9), "base64");
+    }
+    if (base64) {
+        const raw = base64.startsWith("base64://") ? base64.slice(9) : base64;
+        return Buffer.from(raw, "base64");
+    }
+    return undefined;
+}
+function resolveLocalFile(data) {
+    const url = typeof data.url === "string" ? data.url : undefined;
+    const file = typeof data.file === "string" ? data.file : undefined;
+    const candidate = file ?? url;
+    if (!candidate || isRemoteUrl(candidate))
+        return undefined;
+    if (candidate.startsWith("base64://") || /^data:/.test(candidate))
+        return undefined;
+    if (candidate.startsWith("file://") || candidate.startsWith("/") || !candidate.includes("://")) {
+        return candidate;
+    }
+    return undefined;
+}
+function withUploadedUrl(seg, uploadedUrl) {
+    const data = { ...seg.data };
+    data.url = uploadedUrl;
+    data.file = uploadedUrl;
+    delete data.base64;
+    return { type: seg.type, data };
+}
+async function resolveMediaSegment(uploader, seg) {
+    if (!MEDIA_TYPES.has(seg.type))
+        return seg;
+    const data = seg.data;
+    const url = typeof data.url === "string" ? data.url : undefined;
+    const file = typeof data.file === "string" ? data.file : undefined;
+    if ((url && isRemoteUrl(url)) || (file && isRemoteUrl(file))) {
+        return seg;
+    }
+    const buffer = extractBase64Buffer(data);
+    if (buffer) {
+        const uploaded = await uploader.uploadMedia(buffer);
+        return withUploadedUrl(seg, uploaded);
+    }
+    const local = resolveLocalFile(data);
+    if (local) {
+        const uploaded = await uploader.uploadMedia(local);
+        return withUploadedUrl(seg, uploaded);
+    }
+    return seg;
+}
+/** 将 base64 / 本地媒体上传为 KOOK 可访问 URL */
+export async function materializeOutboundMedia(uploader, content) {
+    const segments = asSegments(content);
+    return Promise.all(segments.map(async (item) => {
+        if (!isMessageSegment(item))
+            return item;
+        return resolveMediaSegment(uploader, item);
+    }));
+}
+//# sourceMappingURL=outbound-media.js.map

package/lib/outbound-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-media.js","sourceRoot":"","sources":["../src/outbound-media.ts"],"names":[],"mappings":"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"}

package/lib/outbound-sendable.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Zhin 消息段 → kook-client Sendable。
+ * 图片/音视频须用 segment 发送对应 msg_type，不能写成 Markdown ![alt](url)。
+ */
+import { type MessageSegment as KookMessageSegment } from "kook-client";
+import type { MessageElement } from "zhin.js";
+/**
+ * 单张图片（可带 reply）→ kook image 消息段（type=2）
+ */
+export declare function convertToKookSendable(elements: MessageElement[], formatText: (content: MessageElement[]) => string): string | KookMessageSegment[];
+//# sourceMappingURL=outbound-sendable.d.ts.map

package/lib/outbound-sendable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-sendable.d.ts","sourceRoot":"","sources":["../src/outbound-sendable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAW,KAAK,cAAc,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,MAAM,GAChD,MAAM,GAAG,kBAAkB,EAAE,CA2C/B"}

package/lib/outbound-sendable.js

@@ -0,0 +1,55 @@
+/**
+ * Zhin 消息段 → kook-client Sendable。
+ * 图片/音视频须用 segment 发送对应 msg_type，不能写成 Markdown ![alt](url)。
+ */
+import { segment } from "kook-client";
+function mediaUrl(data) {
+    return String(data.url ?? data.file ?? "");
+}
+/**
+ * 单张图片（可带 reply）→ kook image 消息段（type=2）
+ */
+export function convertToKookSendable(elements, formatText) {
+    const replies = [];
+    const images = [];
+    const videos = [];
+    const audios = [];
+    const rest = [];
+    for (const el of elements) {
+        if (el.type === "reply" && el.data.id) {
+            replies.push(String(el.data.id));
+            continue;
+        }
+        if (el.type === "image") {
+            const url = mediaUrl(el.data);
+            if (url)
+                images.push(url);
+            continue;
+        }
+        if (el.type === "video") {
+            const url = mediaUrl(el.data);
+            if (url)
+                videos.push(url);
+            continue;
+        }
+        if (el.type === "audio") {
+            const url = mediaUrl(el.data);
+            if (url)
+                audios.push(url);
+            continue;
+        }
+        rest.push(el);
+    }
+    const replySegs = replies.map((id) => segment.reply(id));
+    if (images.length === 1 && videos.length === 0 && audios.length === 0 && rest.length === 0) {
+        return [...replySegs, segment.image(images[0])];
+    }
+    if (videos.length === 1 && images.length === 0 && audios.length === 0 && rest.length === 0) {
+        return [...replySegs, segment.video(videos[0])];
+    }
+    if (audios.length === 1 && images.length === 0 && videos.length === 0 && rest.length === 0) {
+        return [...replySegs, segment.audio(audios[0])];
+    }
+    return formatText(elements);
+}
+//# sourceMappingURL=outbound-sendable.js.map