@hybrd/xmtp 1.0.0 → 1.0.3

package/dist/src/client.d.ts

@@ -0,0 +1,76 @@
+import { type Signer } from "@xmtp/node-sdk";
+import { privateKeyToAccount } from "viem/accounts";
+import { XmtpClient } from "./types";
+interface User {
+    key: `0x${string}`;
+    account: ReturnType<typeof privateKeyToAccount>;
+    wallet: any;
+}
+export declare const createUser: (key: string) => User;
+export declare const createSigner: (key: string) => Signer;
+export declare function createXMTPClient(privateKey: string, opts?: {
+    persist?: boolean;
+    maxRetries?: number;
+    storagePath?: string;
+}): Promise<XmtpClient>;
+/**
+ * Generate a random encryption key
+ * @returns The encryption key as a hex string
+ */
+export declare const generateEncryptionKeyHex: () => string;
+/**
+ * Get the encryption key from a hex string
+ * @param hex - The hex string
+ * @returns The encryption key as Uint8Array
+ */
+export declare const getEncryptionKeyFromHex: (hex: string) => Uint8Array;
+export declare const getDbPath: (description?: string, storagePath?: string) => Promise<string>;
+export declare const backupDbToPersistentStorage: (dbPath: string, description: string) => Promise<void>;
+export declare const logAgentDetails: (clients: XmtpClient | XmtpClient[]) => Promise<void>;
+export declare function validateEnvironment(vars: string[]): Record<string, string>;
+/**
+ * Diagnose XMTP environment and identity issues
+ */
+export declare function diagnoseXMTPIdentityIssue(client: XmtpClient, inboxId: string, environment: string): Promise<{
+    canResolve: boolean;
+    suggestions: string[];
+    details: Record<string, any>;
+}>;
+export interface XMTPConnectionConfig {
+    maxRetries?: number;
+    retryDelayMs?: number;
+    healthCheckIntervalMs?: number;
+    connectionTimeoutMs?: number;
+    reconnectOnFailure?: boolean;
+}
+export interface XMTPConnectionHealth {
+    isConnected: boolean;
+    lastHealthCheck: Date;
+    consecutiveFailures: number;
+    totalReconnects: number;
+    avgResponseTime: number;
+}
+export declare class XMTPConnectionManager {
+    private client;
+    private privateKey;
+    private config;
+    private health;
+    private healthCheckTimer;
+    private isReconnecting;
+    constructor(privateKey: string, config?: XMTPConnectionConfig);
+    connect(persist?: boolean): Promise<XmtpClient>;
+    private startHealthMonitoring;
+    private performHealthCheck;
+    private handleConnectionFailure;
+    private sleep;
+    getHealth(): XMTPConnectionHealth;
+    getClient(): XmtpClient | null;
+    disconnect(): Promise<void>;
+}
+export declare function createXMTPConnectionManager(privateKey: string, config?: XMTPConnectionConfig): Promise<XMTPConnectionManager>;
+/**
+ * Resolve user address from inbox ID with automatic identity refresh on association errors
+ */
+export declare function resolveUserAddress(client: XmtpClient, senderInboxId: string, maxRetries?: number): Promise<string>;
+export declare const startPeriodicBackup: (dbPath: string, description: string, intervalMs?: number) => NodeJS.Timeout;
+export {};