@kyan-du/agent-wechat-wechaty-puppet 0.12.0-next.0

package/dist/poll-guard.d.ts

@@ -0,0 +1,14 @@
+export type PollLifecycle = {
+    generation: number;
+    inFlight?: Promise<boolean>;
+};
+export type PollContext = {
+    isCurrent: () => boolean;
+};
+export declare function startPollLifecycle(lifecycle: PollLifecycle): number;
+/** Run one poll at a time; interval ticks arriving while busy are dropped. */
+export declare function runPollIfIdle(lifecycle: PollLifecycle, generation: number, poll: (context: PollContext) => Promise<void>): Promise<boolean>;
+export declare function invalidatePollLifecycle(lifecycle: PollLifecycle): void;
+/** Invalidate the current generation and wait for its active poll to settle. */
+export declare function stopPollLifecycle(lifecycle: PollLifecycle): Promise<void>;
+//# sourceMappingURL=poll-guard.d.ts.map

package/dist/puppet-agent-wechat.d.ts

@@ -0,0 +1,111 @@
+import * as PUPPET from 'wechaty-puppet';
+import { FileBox } from 'file-box';
+export interface PuppetAgentWeChatOptions extends PUPPET.PuppetOptions {
+    serverUrl?: string;
+    token?: string;
+    pollIntervalMs?: number;
+}
+export declare class PuppetAgentWeChat extends PUPPET.Puppet {
+    static readonly VERSION: any;
+    private client;
+    private pollTimer?;
+    private pollLifecycle;
+    private loginHandle?;
+    private loginTerminalSeen;
+    private loginFailureEmitted;
+    private lastSeenId;
+    private contactStore;
+    private roomStore;
+    private messageStore;
+    private rawMessageStore;
+    private get serverUrl();
+    private get token();
+    private get pollIntervalMs();
+    constructor(options?: PuppetAgentWeChatOptions);
+    name(): string;
+    version(): any;
+    onStart(): Promise<void>;
+    onStop(): Promise<void>;
+    private startLoginSubscription;
+    private emitLoginFailure;
+    private handleLoginEvent;
+    private onLoginSuccess;
+    private snapshotBaseline;
+    private startPolling;
+    private stopPolling;
+    private pollMessages;
+    private processUnreadChat;
+    private loadContacts;
+    ding(data?: string): void;
+    contactList(): Promise<string[]>;
+    contactRawPayload(contactId: string): Promise<PUPPET.payloads.Contact>;
+    contactRawPayloadParser(rawPayload: PUPPET.payloads.Contact): Promise<PUPPET.payloads.Contact>;
+    contactAlias(contactId: string): Promise<string>;
+    contactAlias(contactId: string, alias: string | null): Promise<void>;
+    contactAvatar(contactId: string): Promise<FileBox>;
+    contactAvatar(contactId: string, file: FileBox): Promise<void>;
+    contactPhone(contactId: string, phoneList: string[]): Promise<void>;
+    contactCorporationRemark(contactId: string, corporationRemark: string | null): Promise<void>;
+    contactDescription(contactId: string, description: string | null): Promise<void>;
+    contactSelfQRCode(): Promise<string>;
+    contactSelfName(name: string): Promise<void>;
+    contactSelfSignature(signature: string): Promise<void>;
+    messageRawPayload(messageId: string): Promise<PUPPET.payloads.Message>;
+    messageRawPayloadParser(rawPayload: PUPPET.payloads.Message): Promise<PUPPET.payloads.Message>;
+    /** Explicit operator path for retrying one reviewed similar-content send. */
+    messageSendTextConfirmed(conversationId: string, text: string, confirmed: true): Promise<void | string>;
+    messageSendText(conversationId: string, text: string, _mentionIdList?: string[]): Promise<void | string>;
+    messageSendFile(conversationId: string, file: FileBox): Promise<void | string>;
+    messageImage(messageId: string, imageType: PUPPET.types.Image): Promise<FileBox>;
+    messageFile(messageId: string): Promise<FileBox>;
+    private messageMediaToFileBox;
+    messageContact(messageId: string): Promise<string>;
+    messageMiniProgram(messageId: string): Promise<PUPPET.payloads.MiniProgram>;
+    messageUrl(messageId: string): Promise<PUPPET.payloads.UrlLink>;
+    messageLocation(messageId: string): Promise<PUPPET.payloads.Location>;
+    messageForward(conversationId: string, messageId: string): Promise<void | string>;
+    messageRecall(messageId: string): Promise<boolean>;
+    messageSendContact(conversationId: string, contactId: string): Promise<void | string>;
+    messageSendUrl(conversationId: string, urlLinkPayload: PUPPET.payloads.UrlLink): Promise<void | string>;
+    messageSendMiniProgram(conversationId: string, miniProgramPayload: PUPPET.payloads.MiniProgram): Promise<void | string>;
+    messageSendLocation(conversationId: string, locationPayload: PUPPET.payloads.Location): Promise<void | string>;
+    messageSendPost(conversationId: string, postPayload: PUPPET.payloads.Post): Promise<void | string>;
+    conversationReadMark(conversationId: string, hasRead?: boolean): Promise<void | boolean>;
+    roomList(): Promise<string[]>;
+    roomRawPayload(roomId: string): Promise<PUPPET.payloads.Room>;
+    roomRawPayloadParser(rawPayload: PUPPET.payloads.Room): Promise<PUPPET.payloads.Room>;
+    roomAdd(roomId: string, contactId: string): Promise<void>;
+    roomDel(roomId: string, contactId: string): Promise<void>;
+    roomCreate(contactIdList: string[], topic?: string): Promise<string>;
+    roomQuit(roomId: string): Promise<void>;
+    roomQRCode(roomId: string): Promise<string>;
+    roomTopic(roomId: string): Promise<string>;
+    roomTopic(roomId: string, topic: string): Promise<void>;
+    roomAnnounce(roomId: string): Promise<string>;
+    roomAnnounce(roomId: string, text: string): Promise<void>;
+    roomAvatar(roomId: string): Promise<FileBox>;
+    roomMemberList(roomId: string): Promise<string[]>;
+    roomMemberRawPayload(roomId: string, contactId: string): Promise<PUPPET.payloads.RoomMember>;
+    roomMemberRawPayloadParser(rawPayload: PUPPET.payloads.RoomMember): Promise<PUPPET.payloads.RoomMember>;
+    roomInvitationAccept(roomInvitationId: string): Promise<void>;
+    roomInvitationRawPayload(roomInvitationId: string): Promise<PUPPET.payloads.RoomInvitation>;
+    roomInvitationRawPayloadParser(rawPayload: PUPPET.payloads.RoomInvitation): Promise<PUPPET.payloads.RoomInvitation>;
+    friendshipAccept(friendshipId: string): Promise<void>;
+    friendshipAdd(contactId: string, option?: PUPPET.types.FriendshipAddOptions): Promise<void>;
+    friendshipSearchPhone(phone: string): Promise<null | string>;
+    friendshipSearchHandle(handle: string): Promise<null | string>;
+    friendshipRawPayload(friendshipId: string): Promise<PUPPET.payloads.Friendship>;
+    friendshipRawPayloadParser(rawPayload: PUPPET.payloads.Friendship): Promise<PUPPET.payloads.Friendship>;
+    tagContactAdd(tagId: string, contactId: string): Promise<void>;
+    tagContactRemove(tagId: string, contactId: string): Promise<void>;
+    tagContactDelete(tagId: string): Promise<void>;
+    tagContactList(contactId: string): Promise<string[]>;
+    tagContactList(): Promise<string[]>;
+    postPublish(payload: PUPPET.payloads.Post): Promise<void | string>;
+    postSearch(filter: PUPPET.filters.Post, pagination?: PUPPET.filters.PaginationRequest): Promise<PUPPET.filters.PaginationResponse<string[]>>;
+    postRawPayload(postId: string): Promise<PUPPET.payloads.Post>;
+    postRawPayloadParser(rawPayload: PUPPET.payloads.Post): Promise<PUPPET.payloads.Post>;
+    tap(postId: string, type?: PUPPET.types.Tap, tap?: boolean): Promise<void | boolean>;
+    tapSearch(postId: string, query?: PUPPET.filters.Tap, pagination?: PUPPET.filters.PaginationRequest): Promise<PUPPET.filters.PaginationResponse<PUPPET.payloads.Tap>>;
+}
+//# sourceMappingURL=puppet-agent-wechat.d.ts.map

package/dist/send-confirmation.d.ts

@@ -0,0 +1,3 @@
+import type { SendParams } from '@kyan-du/agent-wechat-shared';
+export declare function buildWechatyTextSend(chatId: string, text: string, explicitlyConfirmed?: boolean): SendParams;
+//# sourceMappingURL=send-confirmation.d.ts.map

package/dist/type-map.d.ts

@@ -0,0 +1,26 @@
+import * as PUPPET from 'wechaty-puppet';
+import type { Chat, Contact, Message } from '@kyan-du/agent-wechat-shared';
+/**
+ * Map WeChat message type numbers to Wechaty MessageType.
+ *
+ * WeChat types: 1=Text, 3=Image, 34=Voice, 42=ShareCard, 43=Video,
+ *   47=Emoticon, 48=Location, 49=App(varies), 62=MicroVideo, 10000=Sys
+ */
+export declare function wechatTypeToMessageType(wechatType: number): PUPPET.types.Message;
+/**
+ * Convert an agent-wechat Chat (non-group) to a Wechaty ContactPayload.
+ */
+export declare function chatToContactPayload(chat: Chat): PUPPET.payloads.Contact;
+/**
+ * Convert a server Contact to a Wechaty ContactPayload.
+ */
+export declare function contactToContactPayload(contact: Contact): PUPPET.payloads.Contact;
+/**
+ * Convert an agent-wechat Chat (group) to a Wechaty RoomPayload.
+ */
+export declare function chatToRoomPayload(chat: Chat): PUPPET.payloads.Room;
+/**
+ * Convert an agent-wechat Message to a Wechaty MessagePayload.
+ */
+export declare function messageToPayload(msg: Message, selfId: string): PUPPET.payloads.Message;
+//# sourceMappingURL=type-map.d.ts.map

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@kyan-du/agent-wechat-wechaty-puppet",
+  "version": "0.12.0-next.0",
+  "description": "Wechaty Puppet for agent-wechat — bridges Wechaty bots to WeChat via the agent-wechat REST/WebSocket server",
+  "type": "module",
+  "main": "./dist/mod.js",
+  "types": "./dist/mod.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/mod.js",
+      "types": "./dist/mod.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "!dist/.release-metafile.json"
+  ],
+  "scripts": {
+    "build": "esbuild src/mod.ts --bundle --format=esm --platform=node --outfile=dist/mod.js --metafile=dist/.release-metafile.json --external:wechaty-puppet --external:file-box && tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit",
+    "test": "node --import tsx --test src/*.test.ts",
+    "test:puppet": "node --import tsx scripts/test-puppet.ts",
+    "test:contacts": "node --import tsx scripts/test-contacts.ts",
+    "test:ding-dong": "node --import tsx scripts/test-ding-dong.ts"
+  },
+  "peerDependencies": {
+    "wechaty-puppet": "^1.10.2"
+  },
+  "dependencies": {
+    "file-box": "^1.4.15"
+  },
+  "devDependencies": {
+    "@kyan-du/agent-wechat-shared": "workspace:*",
+    "@types/node": "^22",
+    "esbuild": "^0.25.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.4.5",
+    "wechaty-puppet": "^1.20.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kyan-du/agent-wechat.git",
+    "directory": "packages/wechaty-puppet"
+  }
+}