@hybrd/xmtp 1.0.0 → 1.0.3

package/dist/src/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_OPTIONS: string[];
+export declare const DEFAULT_AMOUNT = "0.1";
+export declare const MAX_USDC_AMOUNT = 10;

package/dist/src/constants.js

@@ -0,0 +1,6 @@
+// ===================================================================
+// Betting Configuration
+// ===================================================================
+export const DEFAULT_OPTIONS = ["yes", "no"];
+export const DEFAULT_AMOUNT = "0.1";
+export const MAX_USDC_AMOUNT = 10; // Maximum allowed USDC transaction amount

package/dist/src/index.d.ts

@@ -0,0 +1,22 @@
+export * from "./client";
+export * from "./constants";
+export * from "./lib/message-listener";
+export * from "./lib/subjects";
+export * from "./resolver";
+export * from "./resolver/basename-resolver";
+export * from "./resolver/ens-resolver";
+export * from "./resolver/xmtp-resolver";
+export * from "./service-client";
+export * from "./types";
+export { createXMTPConnectionManager, XMTPConnectionManager, type XMTPConnectionConfig, type XMTPConnectionHealth } from "./client";
+export { createXmtpServiceClient, XmtpServiceClient } from "./service-client";
+export type { GetMessageParams, GetRootMessageParams, SendMessageParams, SendMessageResponse, SendReactionParams, SendReactionResponse, SendReplyParams, SendReplyResponse, SendTransactionParams, SendTransactionResponse, TransactionCall, TransactionRequest, XmtpRootMessageResponse, XmtpServiceClientConfig, XmtpServiceMessage, XmtpServiceResponse } from "./types";
+export { Client, IdentifierKind, type DecodedMessage, type Dm, type LogLevel, type Signer, type XmtpEnv } from "@xmtp/node-sdk";
+export { ContentTypeTransactionReference, type TransactionReference } from "@xmtp/content-type-transaction-reference";
+export { ContentTypeText, type TextParameters } from "@xmtp/content-type-text";
+export { ContentTypeReaction, type Reaction } from "@xmtp/content-type-reaction";
+export { ContentTypeReply, ReplyCodec, type Reply } from "@xmtp/content-type-reply";
+export { ContentTypeGroupUpdated, GroupUpdatedCodec, type GroupUpdated } from "@xmtp/content-type-group-updated";
+export { ContentTypeWalletSendCalls, type WalletSendCallsParams } from "@xmtp/content-type-wallet-send-calls";
+export { backupDbToPersistentStorage, createSigner, createUser, createXMTPClient, diagnoseXMTPIdentityIssue, generateEncryptionKeyHex, getEncryptionKeyFromHex, logAgentDetails, startPeriodicBackup, validateEnvironment } from "./client";
+export { DEFAULT_AMOUNT, DEFAULT_OPTIONS, MAX_USDC_AMOUNT } from "./constants";

package/dist/src/index.js

@@ -0,0 +1,46 @@
+// ===================================================================
+// XMTP Package - Main Entry Point
+// ===================================================================
+// This package provides a clean interface to XMTP functionality
+// Re-exports core XMTP SDK types and utilities
+export * from "./client";
+export * from "./constants";
+export * from "./lib/message-listener";
+export * from "./lib/subjects";
+export * from "./resolver";
+export * from "./resolver/basename-resolver";
+export * from "./resolver/ens-resolver";
+export * from "./resolver/xmtp-resolver";
+export * from "./service-client";
+export * from "./types";
+// ===================================================================
+// Enhanced XMTP Client & Connection Management
+// ===================================================================
+export { createXMTPConnectionManager, 
+// Enhanced connection management
+XMTPConnectionManager } from "./client";
+// ===================================================================
+// XMTP Service Client (for external service communication)
+// ===================================================================
+export { createXmtpServiceClient, XmtpServiceClient } from "./service-client";
+// ===================================================================
+// XMTP Core SDK Exports
+// ===================================================================
+export { Client } from "@xmtp/node-sdk";
+// ===================================================================
+// XMTP Content Types
+// ===================================================================
+export { ContentTypeTransactionReference } from "@xmtp/content-type-transaction-reference";
+export { ContentTypeText } from "@xmtp/content-type-text";
+export { ContentTypeReaction } from "@xmtp/content-type-reaction";
+export { ContentTypeReply, ReplyCodec } from "@xmtp/content-type-reply";
+export { ContentTypeGroupUpdated, GroupUpdatedCodec } from "@xmtp/content-type-group-updated";
+export { ContentTypeWalletSendCalls } from "@xmtp/content-type-wallet-send-calls";
+// ===================================================================
+// Local Client Utilities
+// ===================================================================
+export { backupDbToPersistentStorage, createSigner, createUser, createXMTPClient, diagnoseXMTPIdentityIssue, generateEncryptionKeyHex, getEncryptionKeyFromHex, logAgentDetails, startPeriodicBackup, validateEnvironment } from "./client";
+// ===================================================================
+// Application Constants
+// ===================================================================
+export { DEFAULT_AMOUNT, DEFAULT_OPTIONS, MAX_USDC_AMOUNT } from "./constants";

package/dist/src/lib/message-listener.d.ts

@@ -0,0 +1,69 @@
+import { EventEmitter } from "node:events";
+import { PublicClient } from "viem";
+import type { MessageEvent, XmtpClient } from "../types";
+export interface MessageListenerConfig {
+    publicClient: PublicClient;
+    xmtpClient: XmtpClient;
+    /**
+     * Filter function to determine which messages to process
+     * Return true to process the message, false to skip
+     */
+    filter?: (event: Pick<MessageEvent, "conversation" | "message" | "rootMessage">) => Promise<boolean> | boolean;
+    /**
+     * Heartbeat interval in milliseconds (default: 5 minutes)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Conversation check interval in milliseconds (default: 30 seconds)
+     */
+    conversationCheckInterval?: number;
+    /**
+     * Environment variable key for XMTP environment (default: "XMTP_ENV")
+     */
+    envKey?: string;
+}
+export interface MessageListenerEvents {
+    message: [data: MessageEvent];
+    error: [error: Error];
+    started: [];
+    stopped: [];
+    heartbeat: [stats: {
+        messageCount: number;
+        conversationCount: number;
+    }];
+}
+/**
+ * A flexible XMTP message listener that can be configured for different applications
+ */
+export declare class MessageListener extends EventEmitter {
+    private xmtpClient;
+    private resolver;
+    private filter?;
+    private heartbeatInterval?;
+    private fallbackCheckInterval?;
+    private messageCount;
+    private conversations;
+    private readonly config;
+    constructor(config: MessageListenerConfig);
+    on<U extends keyof MessageListenerEvents>(event: U, listener: (...args: MessageListenerEvents[U]) => void): this;
+    emit<U extends keyof MessageListenerEvents>(event: U, ...args: MessageListenerEvents[U]): boolean;
+    start(): Promise<void>;
+    private cleanup;
+    stop(): void;
+    /**
+     * Get current statistics
+     */
+    getStats(): {
+        messageCount: number;
+        conversationCount: number;
+        isActive: boolean;
+    };
+}
+/**
+ * Helper function to start a message listener
+ */
+export declare function startMessageListener(config: MessageListenerConfig): Promise<MessageListener>;
+/**
+ * Factory function to create a message listener with common filters
+ */
+export declare function createMessageListener(config: MessageListenerConfig): MessageListener;

package/dist/src/lib/message-listener.js

@@ -0,0 +1,235 @@
+import { EventEmitter } from "node:events";
+import { http, createPublicClient } from "viem";
+import { mainnet } from "viem/chains";
+import { Resolver } from "../resolver/resolver";
+/**
+ * A flexible XMTP message listener that can be configured for different applications
+ */
+export class MessageListener extends EventEmitter {
+    constructor(config) {
+        super();
+        this.messageCount = 0;
+        this.conversations = [];
+        this.xmtpClient = config.xmtpClient;
+        // Create mainnet client for ENS resolution
+        const mainnetClient = createPublicClient({
+            chain: mainnet,
+            transport: http()
+        });
+        // Create unified resolver with all capabilities
+        this.resolver = new Resolver({
+            xmtpClient: this.xmtpClient,
+            mainnetClient,
+            baseClient: config.publicClient,
+            maxCacheSize: 1000,
+            cacheTtl: 86400000 // 24 hours
+        });
+        this.filter = config.filter;
+        this.config = {
+            heartbeatInterval: config.heartbeatInterval ?? 300000, // 5 minutes
+            conversationCheckInterval: config.conversationCheckInterval ?? 30000, // 30 seconds
+            envKey: config.envKey ?? "XMTP_ENV"
+        };
+    }
+    // Type-safe event emitter methods
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    async start() {
+        const XMTP_ENV = process.env[this.config.envKey];
+        // Pre-populate address cache from existing conversations
+        await this.resolver?.prePopulateAllCaches();
+        console.log("📡 Syncing conversations...");
+        await this.xmtpClient.conversations.sync();
+        const address = this.xmtpClient.accountIdentifier?.identifier;
+        // List existing conversations for debugging
+        this.conversations = await this.xmtpClient.conversations.list();
+        console.log(`🤖 XMTP[${XMTP_ENV}] Listening on ${address} ...`);
+        // Emit started event
+        this.emit("started");
+        // Stream all messages and emit events for processing
+        try {
+            const stream = await this.xmtpClient.conversations.streamAllMessages();
+            // Add a heartbeat to show the listener is active
+            this.heartbeatInterval = setInterval(() => {
+                this.emit("heartbeat", {
+                    messageCount: this.messageCount,
+                    conversationCount: this.conversations.length
+                });
+                if (this.messageCount > 0) {
+                    console.log(`💓 Active - processed ${this.messageCount} messages`);
+                }
+            }, this.config.heartbeatInterval);
+            // Check for new conversations
+            this.fallbackCheckInterval = setInterval(async () => {
+                try {
+                    const latestConversations = await this.xmtpClient.conversations.list();
+                    if (latestConversations.length > this.conversations.length) {
+                        console.log(`🆕 Detected ${latestConversations.length - this.conversations.length} new conversations`);
+                        this.conversations.push(...latestConversations.slice(this.conversations.length));
+                    }
+                }
+                catch (error) {
+                    console.error("❌ Error checking for new conversations:", error);
+                    this.emit("error", error);
+                }
+            }, this.config.conversationCheckInterval);
+            try {
+                for await (const message of stream) {
+                    this.messageCount++;
+                    try {
+                        // Skip messages from self or null messages
+                        if (!message ||
+                            message.senderInboxId.toLowerCase() ===
+                                this.xmtpClient.inboxId.toLowerCase()) {
+                            continue;
+                        }
+                        console.log(`📨 Received message "${JSON.stringify(message)}" in ${message.conversationId}`);
+                        // Get conversation details
+                        const conversation = await this.xmtpClient.conversations.getConversationById(message.conversationId);
+                        if (!conversation) {
+                            console.log("❌ Could not find conversation for message");
+                            continue;
+                        }
+                        const contentTypeId = message.contentType?.typeId;
+                        // Extract message content for processing
+                        let messageContent;
+                        if (contentTypeId === "reply") {
+                            const replyContent = message.content;
+                            messageContent = (replyContent?.content || "").toString();
+                        }
+                        else if (contentTypeId === "remoteStaticAttachment" ||
+                            contentTypeId === "attachment") {
+                            // For attachments, use the fallback message or filename
+                            messageContent =
+                                message.fallback ||
+                                    message.content?.filename ||
+                                    "[Attachment]";
+                        }
+                        else if (contentTypeId === "reaction") {
+                            // For reactions, use a simple representation
+                            const reactionContent = message.content;
+                            messageContent = `[Reaction: ${reactionContent.content || ""}]`;
+                        }
+                        else {
+                            // For text and other content types, safely convert to string
+                            messageContent = message.content ? String(message.content) : "";
+                        }
+                        // Find root message for replies and reactions
+                        let rootMessage = message;
+                        let parentMessage = null;
+                        if (contentTypeId === "reply") {
+                            const { reference } = message.content;
+                            rootMessage = await this.resolver.findRootMessage(reference);
+                            parentMessage = await this.resolver.findMessage(reference);
+                        }
+                        else if (contentTypeId === "reaction") {
+                            const { reference } = message.content;
+                            rootMessage = await this.resolver.findRootMessage(reference);
+                            parentMessage = await this.resolver.findMessage(reference);
+                        }
+                        else {
+                            // For text messages and attachments, they are root messages
+                            rootMessage = message;
+                            parentMessage = null;
+                        }
+                        // Skip if we couldn't find the root message
+                        if (!rootMessage) {
+                            console.warn(`⚠️ [MessageListener] Could not find root message for: ${message.id}`);
+                            continue;
+                        }
+                        // Apply custom message filter if provided
+                        if (this.filter) {
+                            const shouldProcess = await this.filter({
+                                conversation,
+                                message,
+                                rootMessage
+                            });
+                            if (!shouldProcess) {
+                                console.log("🔄 Skipping message:", message.id);
+                                continue;
+                            }
+                        }
+                        // Create sender using unified resolver
+                        const sender = await this.resolver.createXmtpSender(message.senderInboxId, message.conversationId);
+                        // Extract and resolve subjects (basenames and ENS names mentioned in message)
+                        // TODO: Update extractSubjects to work with unified resolver
+                        const subjects = {};
+                        // Create enriched message with resolved address, name, subjects, root message, and parent message
+                        const messageEvent = {
+                            conversation,
+                            message,
+                            rootMessage: rootMessage, // We already checked it's not null above
+                            parentMessage: parentMessage || undefined,
+                            sender,
+                            subjects
+                        };
+                        // Emit the enriched message
+                        this.emit("message", messageEvent);
+                    }
+                    catch (messageError) {
+                        console.error("❌ Error processing message:", messageError);
+                        this.emit("error", messageError);
+                        // Continue processing other messages instead of crashing
+                    }
+                }
+            }
+            catch (streamError) {
+                console.error("❌ Error in message stream:", streamError);
+                this.cleanup();
+                this.emit("error", streamError);
+                console.log("🔄 Attempting to restart stream...");
+                // Wait a bit before restarting to avoid tight restart loops
+                await new Promise((resolve) => setTimeout(resolve, 5000));
+                // Recursively restart the message listener
+                return this.start();
+            }
+        }
+        catch (streamSetupError) {
+            console.error("❌ Error setting up message stream:", streamSetupError);
+            this.emit("error", streamSetupError);
+            throw streamSetupError;
+        }
+    }
+    cleanup() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+        }
+        if (this.fallbackCheckInterval) {
+            clearInterval(this.fallbackCheckInterval);
+        }
+    }
+    stop() {
+        this.cleanup();
+        this.emit("stopped");
+        console.log("🛑 Message listener stopped");
+        this.removeAllListeners();
+    }
+    /**
+     * Get current statistics
+     */
+    getStats() {
+        return {
+            messageCount: this.messageCount,
+            conversationCount: this.conversations.length,
+            isActive: !!this.heartbeatInterval
+        };
+    }
+}
+/**
+ * Helper function to start a message listener
+ */
+export async function startMessageListener(config) {
+    const listener = new MessageListener(config);
+    await listener.start();
+    return listener;
+}
+/**
+ * Factory function to create a message listener with common filters
+ */
+export function createMessageListener(config) {
+    return new MessageListener(config);
+}

package/dist/src/lib/message-listener.test.d.ts

@@ -0,0 +1 @@
+export {};