openclaw-imclaw-ext 0.3.0

package/dist/imclaw-bridge.js

@@ -0,0 +1,126 @@
+import { TinodeClient } from './tinode-client.js';
+import { MessageStore } from './message-store.js';
+import { ContactCache } from './contact-cache.js';
+export class ImclawBridge {
+    client;
+    store;
+    cache;
+    config;
+    messageHandler = null;
+    constructor(config) {
+        this.config = config;
+        const clientOptions = {
+            serverUrl: config.tinodeServerUrl,
+            username: config.tinodeUsername,
+            password: config.tinodePassword,
+            apiKey: config.tinodeApiKey,
+        };
+        this.client = new TinodeClient(clientOptions);
+        this.store = new MessageStore(config.dbPath);
+        this.cache = new ContactCache();
+        this.client.on('message', (msg) => {
+            // 1. Skip own messages (agent's own replies echoed back)
+            if (msg.from === this.client.getSelfUid())
+                return;
+            // 2. Check last known seq for dedup
+            const lastSeq = this.store.getLastSeq(msg.topic);
+            // 3. Persist locally (INSERT OR IGNORE — idempotent)
+            this.store.saveMessage(msg.topic, msg.from, msg.seqId, msg.content, msg.timestamp, config.clawId);
+            // 4. Only dispatch genuinely new messages
+            if (msg.seqId <= lastSeq)
+                return;
+            // 5. Skip stale messages (history replay older than 2 minutes)
+            const ageMs = Date.now() - msg.timestamp.getTime();
+            if (ageMs > 2 * 60 * 1000)
+                return;
+            // Dispatch to handler
+            if (this.messageHandler) {
+                const inbound = {
+                    topic: msg.topic,
+                    from: msg.from,
+                    content: msg.content,
+                    seqId: msg.seqId,
+                    timestamp: msg.timestamp,
+                };
+                Promise.resolve(this.messageHandler(inbound)).catch((err) => {
+                    console.error('Message handler error:', err);
+                });
+            }
+        });
+        this.client.on('disconnected', () => {
+            console.log('IMClaw: disconnected from Tinode');
+        });
+        this.client.on('error', (err) => {
+            console.error('IMClaw: Tinode error:', err.message);
+        });
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async start() {
+        await this.client.connect();
+        console.log('IMClaw: connected to Tinode');
+    }
+    async sendMessage(topicName, content) {
+        return this.client.sendMessage(topicName, content);
+    }
+    async uploadFile(fileBuffer, filename, mime) {
+        if (!this.config.httpBaseUrl) {
+            throw new Error('httpBaseUrl is required for file uploads. Set it in ChannelConfig.');
+        }
+        const boundary = '----IMClawBoundary' + Date.now().toString(36);
+        const detectedMime = mime || 'application/octet-stream';
+        // Build multipart body manually to avoid extra dependencies
+        const header = Buffer.from(`--${boundary}\r\n` +
+            `Content-Disposition: form-data; name="file"; filename="${filename}"\r\n` +
+            `Content-Type: ${detectedMime}\r\n\r\n`);
+        const footer = Buffer.from(`\r\n--${boundary}--\r\n`);
+        const body = Buffer.concat([header, fileBuffer, footer]);
+        const basicAuth = Buffer.from(`${this.config.tinodeUsername}:${this.config.tinodePassword}`).toString('base64');
+        const url = `${this.config.httpBaseUrl}/api/files/upload`;
+        const resp = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Basic ${basicAuth}`,
+                'Content-Type': `multipart/form-data; boundary=${boundary}`,
+            },
+            body,
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`Upload failed (${resp.status}): ${text}`);
+        }
+        return resp.json();
+    }
+    async sendImage(topic, imageBuffer, filename, mime) {
+        const uploaded = await this.uploadFile(imageBuffer, filename, mime || 'image/png');
+        return this.sendMessage(topic, {
+            tp: 'image',
+            url: uploaded.url,
+            name: uploaded.name,
+            size: uploaded.size,
+            mime: uploaded.mime,
+        });
+    }
+    async sendFile(topic, fileBuffer, filename, mime) {
+        const uploaded = await this.uploadFile(fileBuffer, filename, mime);
+        return this.sendMessage(topic, {
+            tp: 'file',
+            url: uploaded.url,
+            name: uploaded.name,
+            size: uploaded.size,
+            mime: uploaded.mime,
+        });
+    }
+    getStore() {
+        return this.store;
+    }
+    getContactCache() {
+        return this.cache;
+    }
+    async stop() {
+        this.client.disconnect();
+        this.store.close();
+    }
+}
+//# sourceMappingURL=imclaw-bridge.js.map

package/dist/imclaw-bridge.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { TinodeClient } from './tinode-client.js';
+export type { TinodeMessage, TinodeClientOptions } from './tinode-client.js';
+export { ImclawBridge } from './imclaw-bridge.js';
+export type { ChannelConfig, InboundMessage, MessageHandler, UploadResult } from './imclaw-bridge.js';
+export { MessageStore } from './message-store.js';
+export type { StoredMessage } from './message-store.js';
+export { ContactCache } from './contact-cache.js';
+export { imclawPlugin } from './channel.js';
+export { ImclawDaemon } from './daemon/daemon.js';
+export type { DaemonConfig, ClawCredential } from './daemon/config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// Library exports (for programmatic use)
+export { TinodeClient } from './tinode-client.js';
+export { ImclawBridge } from './imclaw-bridge.js';
+export { MessageStore } from './message-store.js';
+export { ContactCache } from './contact-cache.js';
+// OpenClaw channel plugin
+export { imclawPlugin } from './channel.js';
+// Daemon exports (for programmatic daemon control)
+export { ImclawDaemon } from './daemon/daemon.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/media-store.d.ts

@@ -0,0 +1,4 @@
+export declare function getMediaDir(customDir?: string): string;
+export declare function downloadMedia(url: string, originalName: string, seqId: number, customDir?: string): Promise<string | null>;
+export declare function getMediaPath(filename: string, customDir?: string): string;
+//# sourceMappingURL=media-store.d.ts.map

package/dist/media-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-store.d.ts","sourceRoot":"","sources":["../src/media-store.ts"],"names":[],"mappings":"AAMA,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/media-store.js

@@ -0,0 +1,33 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const DEFAULT_MEDIA_DIR = path.join(os.homedir(), '.openclaw', 'imclaw', 'media');
+export function getMediaDir(customDir) {
+    const dir = customDir || DEFAULT_MEDIA_DIR;
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    return dir;
+}
+export async function downloadMedia(url, originalName, seqId, customDir) {
+    try {
+        const dir = getMediaDir(customDir);
+        const safeName = originalName.replace(/[^a-zA-Z0-9._-]/g, '_');
+        const filename = `${seqId}_${safeName}`;
+        const filePath = path.join(dir, filename);
+        // Skip if already downloaded
+        if (fs.existsSync(filePath))
+            return filename;
+        const resp = await fetch(url);
+        if (!resp.ok)
+            return null;
+        const buffer = Buffer.from(await resp.arrayBuffer());
+        fs.writeFileSync(filePath, buffer);
+        return filename;
+    }
+    catch {
+        return null;
+    }
+}
+export function getMediaPath(filename, customDir) {
+    return path.join(getMediaDir(customDir), filename);
+}
+//# sourceMappingURL=media-store.js.map

package/dist/media-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-store.js","sourceRoot":"","sources":["../src/media-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAElF,MAAM,UAAU,WAAW,CAAC,SAAkB;IAC5C,MAAM,GAAG,GAAG,SAAS,IAAI,iBAAiB,CAAC;IAC3C,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,YAAoB,EACpB,KAAa,EACb,SAAkB;IAElB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAE1C,6BAA6B;QAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAE7C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACrD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,SAAkB;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC"}

package/dist/message-store.d.ts

@@ -0,0 +1,32 @@
+export interface StoredMessage {
+    id: number;
+    topic: string;
+    from_user: string;
+    seq_id: number;
+    content: string;
+    timestamp: string;
+    synced: number;
+    owner_claw_id: string | null;
+}
+export declare class MessageStore {
+    private db;
+    constructor(dbPath?: string);
+    private migrate;
+    saveMessage(topic: string, fromUser: string, seqId: number, content: any, timestamp: Date, ownerClawId?: string): void;
+    getLastSeq(topic: string): number;
+    getMessages(topic: string, limit?: number, beforeSeq?: number): StoredMessage[];
+    getConversations(): {
+        topic: string;
+        last_seq: number;
+        last_message?: StoredMessage;
+    }[];
+    getMessageCount(topic: string): number;
+    getMessagesByOwner(ownerClawId: string, topic: string, limit?: number, beforeSeq?: number): StoredMessage[];
+    getConversationsByOwner(ownerClawId: string): {
+        topic: string;
+        last_seq: number;
+        last_message?: StoredMessage;
+    }[];
+    close(): void;
+}
+//# sourceMappingURL=message-store.d.ts.map

package/dist/message-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-store.d.ts","sourceRoot":"","sources":["../src/message-store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,CAAC,EAAE,MAAM;IAe3B,OAAO,CAAC,OAAO;IA+Bf,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IActH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOjC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAa3E,gBAAgB,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,aAAa,CAAA;KAAE,EAAE;IAavF,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAStC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAavG,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,aAAa,CAAA;KAAE,EAAE;IAcjH,KAAK,IAAI,IAAI;CAGd"}

package/dist/message-store.js

@@ -0,0 +1,103 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+export class MessageStore {
+    db;
+    constructor(dbPath) {
+        const defaultPath = path.join(os.homedir(), '.openclaw', 'imclaw');
+        const resolvedPath = dbPath || path.join(defaultPath, 'messages.db');
+        // Ensure directory exists with restrictive permissions
+        fs.mkdirSync(path.dirname(resolvedPath), { recursive: true, mode: 0o700 });
+        this.db = new Database(resolvedPath);
+        // Restrict database file permissions
+        try {
+            fs.chmodSync(resolvedPath, 0o600);
+        }
+        catch { /* new file, will be set on next open */ }
+        this.db.pragma('journal_mode = WAL');
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS messages (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        topic TEXT NOT NULL,
+        from_user TEXT NOT NULL,
+        seq_id INTEGER NOT NULL,
+        content TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        synced INTEGER DEFAULT 1,
+        UNIQUE(topic, seq_id)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_messages_topic_seq
+        ON messages(topic, seq_id);
+
+      CREATE TABLE IF NOT EXISTS sync_state (
+        topic TEXT PRIMARY KEY,
+        last_seq INTEGER NOT NULL DEFAULT 0
+      );
+    `);
+        // V2: Add owner_claw_id for per-claw message isolation
+        try {
+            this.db.exec(`ALTER TABLE messages ADD COLUMN owner_claw_id TEXT`);
+        }
+        catch {
+            // Column already exists — safe to ignore
+        }
+        this.db.exec(`CREATE INDEX IF NOT EXISTS idx_messages_owner ON messages(owner_claw_id, topic)`);
+    }
+    saveMessage(topic, fromUser, seqId, content, timestamp, ownerClawId) {
+        const contentStr = typeof content === 'string' ? content : JSON.stringify(content);
+        this.db.prepare(`INSERT OR IGNORE INTO messages (topic, from_user, seq_id, content, timestamp, owner_claw_id)
+       VALUES (?, ?, ?, ?, ?, ?)`).run(topic, fromUser, seqId, contentStr, timestamp.toISOString(), ownerClawId || null);
+        // Update sync state
+        this.db.prepare(`INSERT INTO sync_state (topic, last_seq) VALUES (?, ?)
+       ON CONFLICT(topic) DO UPDATE SET last_seq = MAX(last_seq, excluded.last_seq)`).run(topic, seqId);
+    }
+    getLastSeq(topic) {
+        const row = this.db.prepare('SELECT last_seq FROM sync_state WHERE topic = ?').get(topic);
+        return row?.last_seq || 0;
+    }
+    getMessages(topic, limit = 50, beforeSeq) {
+        if (beforeSeq) {
+            return this.db.prepare(`SELECT * FROM messages WHERE topic = ? AND seq_id < ?
+         ORDER BY seq_id DESC LIMIT ?`).all(topic, beforeSeq, limit);
+        }
+        return this.db.prepare(`SELECT * FROM messages WHERE topic = ?
+       ORDER BY seq_id DESC LIMIT ?`).all(topic, limit);
+    }
+    getConversations() {
+        const topics = this.db.prepare('SELECT topic, last_seq FROM sync_state ORDER BY last_seq DESC').all();
+        return topics.map((t) => {
+            const lastMsg = this.db.prepare('SELECT * FROM messages WHERE topic = ? ORDER BY seq_id DESC LIMIT 1').get(t.topic);
+            return { ...t, last_message: lastMsg };
+        });
+    }
+    getMessageCount(topic) {
+        const row = this.db.prepare('SELECT COUNT(*) as cnt FROM messages WHERE topic = ?').get(topic);
+        return row.cnt;
+    }
+    // ── Owner-scoped queries (agent sees only its own messages) ──
+    getMessagesByOwner(ownerClawId, topic, limit = 50, beforeSeq) {
+        if (beforeSeq) {
+            return this.db.prepare(`SELECT * FROM messages WHERE owner_claw_id = ? AND topic = ? AND seq_id < ?
+         ORDER BY seq_id DESC LIMIT ?`).all(ownerClawId, topic, beforeSeq, limit);
+        }
+        return this.db.prepare(`SELECT * FROM messages WHERE owner_claw_id = ? AND topic = ?
+       ORDER BY seq_id DESC LIMIT ?`).all(ownerClawId, topic, limit);
+    }
+    getConversationsByOwner(ownerClawId) {
+        const topics = this.db.prepare(`SELECT topic, MAX(seq_id) as last_seq FROM messages
+       WHERE owner_claw_id = ? GROUP BY topic ORDER BY last_seq DESC`).all(ownerClawId);
+        return topics.map((t) => {
+            const lastMsg = this.db.prepare('SELECT * FROM messages WHERE owner_claw_id = ? AND topic = ? ORDER BY seq_id DESC LIMIT 1').get(ownerClawId, t.topic);
+            return { ...t, last_message: lastMsg };
+        });
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=message-store.js.map

package/dist/message-store.js.map

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

package/dist/plugin-entry.d.ts

@@ -0,0 +1,2 @@
+export declare function register(api: any): void;
+//# sourceMappingURL=plugin-entry.d.ts.map

package/dist/plugin-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-entry.d.ts","sourceRoot":"","sources":["../src/plugin-entry.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAWvC"}

package/dist/plugin-entry.js

@@ -0,0 +1,12 @@
+import { imclawPlugin, setPluginConfig, setPluginRuntime } from './channel.js';
+export function register(api) {
+    // Store plugin-level config so channel.ts can access serverUrl, apiKey, accounts, etc.
+    setPluginConfig(api.pluginConfig ?? {});
+    // Store the PluginRuntime — this is the correct runtime for dispatching messages to agents.
+    // It is NOT the same as the `runtime` param in startAccount().
+    if (api.runtime) {
+        setPluginRuntime(api.runtime);
+    }
+    api.registerChannel({ plugin: imclawPlugin });
+}
+//# sourceMappingURL=plugin-entry.js.map

package/dist/plugin-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-entry.js","sourceRoot":"","sources":["../src/plugin-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/E,MAAM,UAAU,QAAQ,CAAC,GAAQ;IAC/B,uFAAuF;IACvF,eAAe,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAExC,4FAA4F;IAC5F,+DAA+D;IAC/D,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/tinode-client.d.ts

@@ -0,0 +1,43 @@
+import { EventEmitter } from 'events';
+export interface TinodeMessage {
+    topic: string;
+    from: string;
+    seqId: number;
+    content: any;
+    timestamp: Date;
+}
+export interface TinodeClientOptions {
+    serverUrl: string;
+    username: string;
+    password: string;
+    apiKey?: string;
+    userAgent?: string;
+}
+export declare class TinodeClient extends EventEmitter {
+    private ws;
+    private options;
+    private msgId;
+    private reconnectDelay;
+    private maxReconnectDelay;
+    private token;
+    private shouldReconnect;
+    private heartbeatInterval;
+    private subscribedTopics;
+    private _selfUid;
+    constructor(options: TinodeClientOptions);
+    getSelfUid(): string | null;
+    connect(): Promise<void>;
+    disconnect(): void;
+    sendMessage(topicName: string, content: any): Promise<number>;
+    private subscribeTopic;
+    /** Subscribe to "me" topic to discover existing conversations and receive presence notifications. */
+    private subscribeMe;
+    private handleMessage;
+    private sendHi;
+    private loginBasic;
+    private send;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=tinode-client.d.ts.map

package/dist/tinode-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tinode-client.d.ts","sourceRoot":"","sources":["../src/tinode-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,GAAG,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,OAAO,EAAE,mBAAmB;IAKxC,UAAU,IAAI,MAAM,GAAG,IAAI;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA8C9B,UAAU,IAAI,IAAI;IAOZ,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;YAyCrD,cAAc;IAgC5B,qGAAqG;IACrG,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,aAAa;IAoDrB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;CAkB1B"}