toledgram-bot-sdk 0.1.0

package/dist/bot.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ToledgramBot — main entry point for bot developers
+ *
+ * Usage:
+ *   const bot = new ToledgramBot({ mnemonic, backendUrl, dataDir })
+ *   bot.on('message', async (msg) => { await msg.reply('Hello!') })
+ *   await bot.start()
+ */
+import { type LocalMessage } from "./storage/messages.js";
+import type { BotConfig, MessageHandler, FileHandler, ErrorHandler, ContentType, Conversation } from "./types.js";
+export declare class ToledgramBot {
+    private config;
+    private connection;
+    private db;
+    private messageStore;
+    private conversationStore;
+    private fileStore;
+    private syncService;
+    private sender;
+    private privateKey;
+    private publicKeyBase64;
+    private messageHandler;
+    private fileHandler;
+    private errorHandler;
+    private activeConversations;
+    private conversationPollInterval;
+    private startedAt;
+    constructor(config: BotConfig);
+    /** Register an event handler */
+    on(event: "message", handler: MessageHandler): void;
+    on(event: "file", handler: FileHandler): void;
+    on(event: "error", handler: ErrorHandler): void;
+    /** Start the bot — authenticate and begin syncing */
+    start(): Promise<void>;
+    /** Stop the bot */
+    stop(): Promise<void>;
+    /** The bot's persona ID (available after start) */
+    get personaId(): string;
+    /** The bot's username (available after start) */
+    get username(): string;
+    /** Get messages from local DB (already decrypted) */
+    getMessages(conversationId: string, opts?: {
+        limit?: number;
+    }): LocalMessage[];
+    /** Send a text message */
+    sendText(conversationId: string, text: string): Promise<void>;
+    /** Send a file from disk */
+    sendFile(conversationId: string, filePath: string, opts?: {
+        type?: ContentType;
+        filename?: string;
+    }): Promise<void>;
+    /** Send in-memory data as a file (no disk write needed) */
+    sendBuffer(conversationId: string, data: Uint8Array, opts: {
+        type?: ContentType;
+        filename: string;
+        mimeType?: string;
+    }): Promise<void>;
+    /** Get the list of conversations */
+    getConversations(): Promise<Conversation[]>;
+    private discoverAndSync;
+    private handleNewMessage;
+    private localToMessage;
+    private downloadMessageFile;
+    private getRecipientPublicKey;
+}
+//# sourceMappingURL=bot.d.ts.map

package/dist/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAOxE,OAAO,KAAK,EACV,SAAS,EAET,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAC;AAGpB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAS;IAGhC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA6B;IAGjD,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,wBAAwB,CACzB;IACP,OAAO,CAAC,SAAS,CAAa;gBAElB,MAAM,EAAE,SAAS;IAc7B,gCAAgC;IAChC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IACnD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAC7C,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAe/C,qDAAqD;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD5B,mBAAmB;IACb,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,mDAAmD;IACnD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,iDAAiD;IACjD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,qDAAqD;IACrD,WAAW,CACT,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxB,YAAY,EAAE;IAIjB,0BAA0B;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE,4BAA4B;IACtB,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,OAAO,CAAC,IAAI,CAAC;IAShB,2DAA2D;IACrD,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAChE,OAAO,CAAC,IAAI,CAAC;IAShB,oCAAoC;IAC9B,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YA6BnC,eAAe;IAsB7B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,cAAc;YAkCR,mBAAmB;YAiDnB,qBAAqB;CA4BpC"}

package/dist/bot.js

@@ -0,0 +1,282 @@
+/**
+ * ToledgramBot — main entry point for bot developers
+ *
+ * Usage:
+ *   const bot = new ToledgramBot({ mnemonic, backendUrl, dataDir })
+ *   bot.on('message', async (msg) => { await msg.reply('Hello!') })
+ *   await bot.start()
+ */
+import { ConvexConnection } from "./client/convex.js";
+import { SyncService } from "./client/sync.js";
+import { MessageSender } from "./client/sender.js";
+import { LocalDatabase } from "./storage/database.js";
+import { MessageStore } from "./storage/messages.js";
+import { ConversationStore } from "./storage/conversations.js";
+import { FileStore } from "./storage/files.js";
+import { mnemonicToPrivateKey } from "./crypto/bip39.js";
+import { derivePublicKey } from "./crypto/p256.js";
+export class ToledgramBot {
+    config;
+    connection;
+    db;
+    messageStore;
+    conversationStore;
+    fileStore;
+    syncService = null;
+    sender = null;
+    privateKey;
+    publicKeyBase64;
+    // Event handlers
+    messageHandler = null;
+    fileHandler = null;
+    errorHandler = null;
+    // Active conversation tracking
+    activeConversations = new Set();
+    conversationPollInterval = null;
+    startedAt = 0;
+    constructor(config) {
+        this.config = config;
+        this.connection = new ConvexConnection(config.backendUrl);
+        this.db = new LocalDatabase(config.dataDir);
+        this.messageStore = new MessageStore(this.db.raw);
+        this.conversationStore = new ConversationStore(this.db.raw);
+        this.fileStore = new FileStore(this.db.raw, config.dataDir);
+        // Derive keys from mnemonic
+        this.privateKey = mnemonicToPrivateKey(config.mnemonic);
+        const publicKey = derivePublicKey(this.privateKey);
+        this.publicKeyBase64 = Buffer.from(publicKey).toString("base64");
+    }
+    on(event, handler) {
+        switch (event) {
+            case "message":
+                this.messageHandler = handler;
+                break;
+            case "file":
+                this.fileHandler = handler;
+                break;
+            case "error":
+                this.errorHandler = handler;
+                break;
+        }
+    }
+    /** Start the bot — authenticate and begin syncing */
+    async start() {
+        console.log("[Bot] Starting...");
+        this.startedAt = Date.now();
+        // 1. Authenticate
+        const auth = await this.connection.authenticate(this.config.mnemonic, this.config.username);
+        console.log(`[Bot] Authenticated as @${auth.username} (${auth.personaId})`);
+        // 2. Initialize sender
+        this.sender = new MessageSender(this.connection.httpClient, this.privateKey, auth.personaId, this.publicKeyBase64, auth.token, auth.username);
+        // 3. Initialize sync service
+        this.syncService = new SyncService(this.connection.httpClient, this.privateKey, auth.personaId, auth.token, this.messageStore, this.conversationStore);
+        // Wire up new message callback
+        this.syncService.onMessage((localMsg) => {
+            this.handleNewMessage(localMsg);
+        });
+        // 4. Discover conversations and start syncing
+        await this.discoverAndSync();
+        // 5. Poll for new conversations periodically
+        this.conversationPollInterval = setInterval(async () => {
+            try {
+                await this.discoverAndSync();
+            }
+            catch (e) {
+                this.errorHandler?.(e instanceof Error ? e : new Error(String(e)));
+            }
+        }, 10000);
+        console.log("[Bot] Ready and listening for messages");
+    }
+    /** Stop the bot */
+    async stop() {
+        console.log("[Bot] Stopping...");
+        if (this.conversationPollInterval) {
+            clearInterval(this.conversationPollInterval);
+        }
+        this.syncService?.stopAll();
+        this.connection.close();
+        this.db.close();
+        console.log("[Bot] Stopped");
+    }
+    // ==================== Public API ====================
+    /** The bot's persona ID (available after start) */
+    get personaId() {
+        return this.connection.personaId;
+    }
+    /** The bot's username (available after start) */
+    get username() {
+        return this.connection.username;
+    }
+    /** Get messages from local DB (already decrypted) */
+    getMessages(conversationId, opts) {
+        return this.messageStore.list(conversationId, opts?.limit ?? 50);
+    }
+    /** Send a text message */
+    async sendText(conversationId, text) {
+        if (!this.sender)
+            throw new Error("Bot not started");
+        // Get recipient public key
+        const recipientPubKey = await this.getRecipientPublicKey(conversationId);
+        await this.sender.sendText(conversationId, text, recipientPubKey);
+    }
+    /** Send a file from disk */
+    async sendFile(conversationId, filePath, opts) {
+        if (!this.sender)
+            throw new Error("Bot not started");
+        const recipientPubKey = await this.getRecipientPublicKey(conversationId);
+        await this.sender.sendFile(conversationId, filePath, recipientPubKey, opts);
+    }
+    /** Send in-memory data as a file (no disk write needed) */
+    async sendBuffer(conversationId, data, opts) {
+        if (!this.sender)
+            throw new Error("Bot not started");
+        const recipientPubKey = await this.getRecipientPublicKey(conversationId);
+        await this.sender.sendBuffer(conversationId, data, recipientPubKey, opts);
+    }
+    /** Get the list of conversations */
+    async getConversations() {
+        const convos = (await this.connection.httpClient.query("conversations:list", {
+            token: this.connection.token,
+            personaId: this.connection.personaId,
+        }));
+        return convos.map((c) => ({
+            id: c.id,
+            type: c.type,
+            name: c.name,
+            members: (c.members ?? []).map((m) => ({
+                personaId: m.personaId,
+                username: m.username,
+                displayName: m.displayName,
+                publicKey: m.publicKey,
+                role: m.role,
+                isOnline: m.isOnline,
+                isBot: m.isBot ?? false,
+            })),
+            lastMessageAt: c.lastMessageAt,
+            reactionSalt: c.reactionSalt,
+        }));
+    }
+    // ==================== Internal ====================
+    async discoverAndSync() {
+        const conversations = await this.getConversations();
+        for (const convo of conversations) {
+            // Skip saved messages conversations — bots don't need them
+            if (convo.type === "saved")
+                continue;
+            if (!this.activeConversations.has(convo.id)) {
+                this.activeConversations.add(convo.id);
+                this.conversationStore.upsert({
+                    id: convo.id,
+                    type: convo.type,
+                    name: convo.name ?? null,
+                    lastMessageAt: convo.lastMessageAt ?? null,
+                    reactionSalt: convo.reactionSalt ?? null,
+                    metadata: JSON.stringify({ members: convo.members }),
+                });
+                this.syncService.startSync(convo.id);
+            }
+        }
+    }
+    handleNewMessage(localMsg) {
+        // Skip messages from before the bot started (avoids replaying old history)
+        if (localMsg.createdAt < this.startedAt)
+            return;
+        const msg = this.localToMessage(localMsg);
+        if (localMsg.contentType !== "text" && this.fileHandler) {
+            try {
+                this.fileHandler(msg);
+            }
+            catch (e) {
+                this.errorHandler?.(e instanceof Error ? e : new Error(String(e)));
+            }
+        }
+        if (this.messageHandler) {
+            try {
+                this.messageHandler(msg);
+            }
+            catch (e) {
+                this.errorHandler?.(e instanceof Error ? e : new Error(String(e)));
+            }
+        }
+    }
+    localToMessage(local) {
+        return {
+            id: local.id,
+            conversationId: local.conversationId,
+            senderPersonaId: local.senderPersonaId,
+            senderName: local.senderName ?? "Unknown",
+            senderDisplayName: local.senderDisplayName ?? undefined,
+            content: local.content ?? "",
+            contentType: local.contentType,
+            createdAt: local.createdAt,
+            replyToMessageId: local.replyToMessageId ?? undefined,
+            replyToPreview: local.replyToPreview ?? undefined,
+            keyMaterial: local.keyMaterial ? JSON.parse(local.keyMaterial) : undefined,
+            hasFile: !!local.encryptedFileStorageId,
+            encryptedFileStorageId: local.encryptedFileStorageId ?? undefined,
+            reply: async (text) => {
+                await this.sendText(local.conversationId, text);
+            },
+            replyWithFile: async (filePath, opts) => {
+                await this.sendFile(local.conversationId, filePath, opts);
+            },
+            replyWithBuffer: async (data, opts) => {
+                await this.sendBuffer(local.conversationId, data, opts);
+            },
+            downloadFile: async () => {
+                return this.downloadMessageFile(local);
+            },
+        };
+    }
+    async downloadMessageFile(local) {
+        // Check cache first
+        const cached = this.fileStore.getCachedPath(local.id);
+        if (cached)
+            return cached;
+        if (!local.encryptedFileStorageId || !local.keyMaterial) {
+            throw new Error("Message has no file attachment");
+        }
+        // Parse key material (SDK uses "fileKey", iOS uses "key")
+        const km = JSON.parse(local.keyMaterial);
+        const fileKeyBase64 = (km.fileKey ?? km.key);
+        if (!fileKeyBase64) {
+            throw new Error("No file key in key material");
+        }
+        // iOS stores keyMaterial as key(32) + nonce(12) = 44 bytes
+        // The nonce is also embedded in the encrypted file (combined format)
+        // so we only need the first 32 bytes as the AES key
+        let fileKeyBytes = new Uint8Array(Buffer.from(fileKeyBase64, "base64"));
+        if (fileKeyBytes.length === 44) {
+            fileKeyBytes = fileKeyBytes.slice(0, 32);
+        }
+        // Download encrypted file from Convex storage
+        const url = await this.connection.httpClient.mutation("storage:getFileUrl", {
+            token: this.connection.token,
+            storageId: local.encryptedFileStorageId,
+        });
+        if (!url) {
+            throw new Error("File not found in storage");
+        }
+        const response = await fetch(url);
+        const encryptedData = new Uint8Array(await response.arrayBuffer());
+        return this.fileStore.saveDecryptedFile(local.id, encryptedData, fileKeyBytes, km.filename, km.mimeType);
+    }
+    async getRecipientPublicKey(conversationId) {
+        // Get conversation details with member public keys
+        const convo = (await this.connection.httpClient.query("conversations:get", {
+            token: this.connection.token,
+            personaId: this.connection.personaId,
+            conversationId,
+        }));
+        if (!convo) {
+            throw new Error("Conversation not found");
+        }
+        // Find the other member's public key (for direct messages)
+        const otherMember = convo.members.find((m) => m.personaId !== this.connection.personaId);
+        if (!otherMember?.publicKey) {
+            throw new Error("Recipient public key not found");
+        }
+        return otherMember.publicKey;
+    }
+}
+//# sourceMappingURL=bot.js.map

package/dist/bot.js.map

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

package/dist/client/convex.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Convex client connection and authentication
+ * Handles login with mnemonic-derived public key
+ */
+import { ConvexHttpClient } from "convex/browser";
+export interface AuthResult {
+    token: string;
+    personaId: string;
+    userId: string;
+    username: string;
+    displayName?: string;
+}
+export declare class ConvexConnection {
+    readonly httpClient: ConvexHttpClient;
+    private _token;
+    private _personaId;
+    private _userId;
+    private _username;
+    private _publicKeyBase64;
+    constructor(backendUrl: string);
+    get token(): string;
+    get personaId(): string;
+    get userId(): string;
+    get username(): string;
+    get publicKeyBase64(): string;
+    get isAuthenticated(): boolean;
+    /**
+     * Authenticate with the backend using a mnemonic
+     * Derives public key from mnemonic, then logs in
+     */
+    authenticate(mnemonic: string, preferredUsername?: string): Promise<AuthResult>;
+    /** Close the connection */
+    close(): void;
+}
+//# sourceMappingURL=convex.d.ts.map

package/dist/client/convex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.d.ts","sourceRoot":"","sources":["../../src/client/convex.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIlD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,UAAU,EAAE,MAAM;IAI9B,IAAI,KAAK,IAAI,MAAM,CAGlB;IAED,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,IAAI,eAAe,IAAI,MAAM,CAG5B;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;OAGG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,UAAU,CAAC;IA4DtB,2BAA2B;IAC3B,KAAK,IAAI,IAAI;CAGd"}

package/dist/client/convex.js

@@ -0,0 +1,96 @@
+/**
+ * Convex client connection and authentication
+ * Handles login with mnemonic-derived public key
+ */
+import { ConvexHttpClient } from "convex/browser";
+import { mnemonicToPrivateKey } from "../crypto/bip39.js";
+import { derivePublicKey } from "../crypto/p256.js";
+export class ConvexConnection {
+    httpClient;
+    _token = null;
+    _personaId = null;
+    _userId = null;
+    _username = null;
+    _publicKeyBase64 = null;
+    constructor(backendUrl) {
+        this.httpClient = new ConvexHttpClient(backendUrl);
+    }
+    get token() {
+        if (!this._token)
+            throw new Error("Not authenticated");
+        return this._token;
+    }
+    get personaId() {
+        if (!this._personaId)
+            throw new Error("Not authenticated");
+        return this._personaId;
+    }
+    get userId() {
+        if (!this._userId)
+            throw new Error("Not authenticated");
+        return this._userId;
+    }
+    get username() {
+        if (!this._username)
+            throw new Error("Not authenticated");
+        return this._username;
+    }
+    get publicKeyBase64() {
+        if (!this._publicKeyBase64)
+            throw new Error("Not authenticated");
+        return this._publicKeyBase64;
+    }
+    get isAuthenticated() {
+        return this._token !== null;
+    }
+    /**
+     * Authenticate with the backend using a mnemonic
+     * Derives public key from mnemonic, then logs in
+     */
+    async authenticate(mnemonic, preferredUsername) {
+        // Derive keys from mnemonic
+        const privateKey = mnemonicToPrivateKey(mnemonic);
+        const publicKey = derivePublicKey(privateKey);
+        const publicKeyBase64 = Buffer.from(publicKey).toString("base64");
+        this._publicKeyBase64 = publicKeyBase64;
+        // Try login first
+        const loginResult = await this.httpClient.mutation("auth:loginWithPublicKey", {
+            publicKey: publicKeyBase64,
+            deviceId: `bot-${Date.now()}`,
+        });
+        if (loginResult) {
+            const result = loginResult;
+            this._token = result.token;
+            this._userId = result.userId;
+            // Find matching persona
+            const personas = result.personas;
+            let persona = preferredUsername
+                ? personas.find((p) => p.username === preferredUsername.toLowerCase())
+                : personas[0];
+            if (!persona) {
+                persona = personas[0];
+            }
+            this._personaId = persona._id;
+            this._username = persona.username;
+            // Always switch to ensure session has correct active persona
+            await this.httpClient.mutation("auth:switchPersona", {
+                token: this._token,
+                personaId: persona._id,
+            });
+            return {
+                token: this._token,
+                personaId: this._personaId,
+                userId: this._userId,
+                username: this._username,
+                displayName: persona.displayName,
+            };
+        }
+        throw new Error("Login failed — no account found for this mnemonic. " +
+            "Create the bot persona in the iOS app first, then use the same mnemonic here.");
+    }
+    /** Close the connection */
+    close() {
+        // ConvexHttpClient doesn't need explicit cleanup
+    }
+}
+//# sourceMappingURL=convex.js.map

package/dist/client/convex.js.map

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

package/dist/client/sender.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Message sender — encrypt and send to Convex
+ * Port of iOS MessageService.swift send flow
+ */
+import type { ConvexHttpClient } from "convex/browser";
+import type { ContentType } from "../types.js";
+export declare class MessageSender {
+    private httpClient;
+    private privateKey;
+    private myPersonaId;
+    private myPublicKeyBase64;
+    private token;
+    private username;
+    constructor(httpClient: ConvexHttpClient, privateKey: Uint8Array, myPersonaId: string, myPublicKeyBase64: string, token: string, username: string);
+    /**
+     * Send a text message to a direct conversation
+     */
+    sendText(conversationId: string, text: string, recipientPublicKeyBase64: string, opts?: {
+        replyToMessageId?: string;
+    }): Promise<{
+        messageId: string;
+        createdAt: number;
+    }>;
+    /**
+     * Send a file/media message to a direct conversation
+     */
+    sendFile(conversationId: string, filePath: string, recipientPublicKeyBase64: string, opts?: {
+        type?: ContentType;
+        filename?: string;
+        replyToMessageId?: string;
+    }): Promise<{
+        messageId: string;
+        createdAt: number;
+    }>;
+    /**
+     * Send in-memory data as a file (no disk I/O needed)
+     */
+    sendBuffer(conversationId: string, data: Uint8Array, recipientPublicKeyBase64: string, opts: {
+        type?: ContentType;
+        filename: string;
+        mimeType?: string;
+        replyToMessageId?: string;
+    }): Promise<{
+        messageId: string;
+        createdAt: number;
+    }>;
+    /** Upload raw bytes to Convex storage, returns storage ID */
+    private uploadToStorage;
+}
+//# sourceMappingURL=sender.d.ts.map

package/dist/client/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../src/client/sender.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,aAAa,CAAC;AAI7D,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAGvB,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM;IAUlB;;OAEG;IACG,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,wBAAwB,EAAE,MAAM,EAChC,IAAI,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAiCpD;;OAEG;IACG,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,wBAAwB,EAAE,MAAM,EAChC,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GACA,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAuDpD;;OAEG;IACG,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,UAAU,EAChB,wBAAwB,EAAE,MAAM,EAChC,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GACA,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAqDpD,6DAA6D;YAC/C,eAAe;CAqB9B"}