pi-courier 0.1.0

package/dist/transports/manager.js

@@ -0,0 +1,98 @@
+/**
+ * Manages multiple transport providers and routes messages
+ */
+export class TransportManager {
+    transports = new Map();
+    messageHandler;
+    errorHandler;
+    /**
+     * Register a transport provider
+     */
+    addTransport(transport) {
+        this.transports.set(transport.type, transport);
+        // Forward messages from this transport
+        transport.onMessage((msg) => {
+            if (this.messageHandler) {
+                this.messageHandler(msg);
+            }
+        });
+        // Forward errors from this transport
+        transport.onError((err) => {
+            if (this.errorHandler) {
+                this.errorHandler(err, transport.type);
+            }
+        });
+    }
+    /**
+     * Get a specific transport by type
+     */
+    getTransport(type) {
+        return this.transports.get(type);
+    }
+    /**
+     * Get all registered transports
+     */
+    getAllTransports() {
+        return Array.from(this.transports.values());
+    }
+    /**
+     * Connect all registered transports
+     */
+    async connectAll() {
+        const connections = Array.from(this.transports.values()).map((t) => t.connect().catch((err) => {
+            throw new Error(`${t.type} connection failed: ${err.message}`);
+        }));
+        await Promise.all(connections);
+    }
+    /**
+     * Disconnect all transports
+     */
+    async disconnectAll() {
+        const disconnections = Array.from(this.transports.values()).map((t) => t.disconnect());
+        await Promise.allSettled(disconnections);
+    }
+    /**
+     * Send a message to a specific chat via a specific transport
+     */
+    async sendMessage(chatId, transportType, text) {
+        const transport = this.transports.get(transportType);
+        if (!transport) {
+            throw new Error(`Transport ${transportType} not found`);
+        }
+        if (!transport.isConnected) {
+            throw new Error(`Transport ${transportType} not connected`);
+        }
+        await transport.sendMessage(chatId, text);
+    }
+    /**
+     * Send typing indicator to a chat via a specific transport
+     */
+    async sendTyping(chatId, transportType) {
+        const transport = this.transports.get(transportType);
+        if (transport?.isConnected) {
+            await transport.sendTyping(chatId);
+        }
+    }
+    /**
+     * Register handler for incoming messages from all transports
+     */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    /**
+     * Register handler for errors from all transports
+     */
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+    /**
+     * Get connection status for all transports
+     */
+    getStatus() {
+        return Array.from(this.transports.values()).map((t) => ({
+            type: t.type,
+            connected: t.isConnected,
+        }));
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/transports/manager.js.map

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

package/dist/transports/matrix-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pure utility functions for Matrix transport.
+ * Extracted for testability — no SDK or network dependencies.
+ */
+/** Escape HTML special characters */
+export declare function escapeHtml(text: string): string;
+/** Convert markdown to Matrix HTML. Returns plain body + optional formatted HTML. */
+export declare function formatForMatrix(text: string): {
+    body: string;
+    formattedBody?: string;
+};
+/**
+ * Determine whether to skip a Matrix room event before processing.
+ * Returns a reason string if the event should be skipped, or null if it should be processed.
+ */
+export declare function shouldSkipEvent(event: {
+    sender?: string;
+    origin_server_ts?: number;
+    content?: any;
+}, botUserId: string, connectedAt: number, joinedRooms: Set<string>, roomId: string): string | null;
+/** Extract Matrix username (localpart) from a full MXID like @user:matrix.org */
+export declare function extractUsername(userId: string): string;
+/**
+ * Check if bot was mentioned, matching either:
+ *  - the full MXID `@user:server`
+ *  - `@localpart` as a leading-@ word (avoids false-positives on bare names)
+ */
+export declare function wasBotMentioned(messageText: string, botUserId: string): boolean;
+/** Strip bot mention from message text — symmetric with wasBotMentioned */
+export declare function stripBotMention(text: string, botUserId: string): string;
+//# sourceMappingURL=matrix-utils.d.ts.map

package/dist/transports/matrix-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-utils.d.ts","sourceRoot":"","sources":["../../src/transports/matrix-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAoCtF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAA;CAAE,EACpE,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAmBf;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAM/E;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOvE"}

package/dist/transports/matrix-utils.js

@@ -0,0 +1,99 @@
+/**
+ * Pure utility functions for Matrix transport.
+ * Extracted for testability — no SDK or network dependencies.
+ */
+/** Escape HTML special characters */
+export function escapeHtml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** Convert markdown to Matrix HTML. Returns plain body + optional formatted HTML. */
+export function formatForMatrix(text) {
+    const hasMarkdown = /[*_`#[]/.test(text);
+    if (!hasMarkdown) {
+        return { body: text };
+    }
+    let html = text;
+    // Protect code blocks
+    const codeBlocks = [];
+    html = html.replace(/```(\w*)\n?([\s\S]*?)```/g, (_, lang, code) => {
+        codeBlocks.push(`<pre><code${lang ? ` class="language-${lang}"` : ""}>${escapeHtml(code.trimEnd())}</code></pre>`);
+        return `__CODEBLOCK_${codeBlocks.length - 1}__`;
+    });
+    // Protect inline code
+    const inlineCodes = [];
+    html = html.replace(/`([^`]+)`/g, (_, code) => {
+        inlineCodes.push(`<code>${escapeHtml(code)}</code>`);
+        return `__INLINECODE_${inlineCodes.length - 1}__`;
+    });
+    // Bold
+    html = html.replace(/\*\*([^*]+?)\*\*/g, "<strong>$1</strong>");
+    // Italic
+    html = html.replace(/(?<!\*)\*(?!\*)([^*]+?)(?<!\*)\*(?!\*)/g, "<em>$1</em>");
+    // Links
+    html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+    // Newlines to <br>
+    html = html.replace(/\n/g, "<br>");
+    // Restore code blocks and inline code
+    html = html.replace(/__CODEBLOCK_(\d+)__/g, (_, idx) => codeBlocks[parseInt(idx, 10)]);
+    html = html.replace(/__INLINECODE_(\d+)__/g, (_, idx) => inlineCodes[parseInt(idx, 10)]);
+    return { body: text, formattedBody: html };
+}
+/**
+ * Determine whether to skip a Matrix room event before processing.
+ * Returns a reason string if the event should be skipped, or null if it should be processed.
+ */
+export function shouldSkipEvent(event, botUserId, connectedAt, joinedRooms, roomId) {
+    // Ignore own messages
+    if (event.sender === botUserId)
+        return "own_message";
+    // Skip events from before this connection (stale replay from initial sync)
+    const eventTs = event.origin_server_ts || 0;
+    if (eventTs < connectedAt)
+        return "stale";
+    // Only process text messages
+    const content = event.content;
+    if (!content || content.msgtype !== "m.text" || !content.body)
+        return "not_text";
+    // Ignore edits (we only process original messages)
+    if (content["m.new_content"])
+        return "edit";
+    // Skip events from rooms we're not in (cached, no API call)
+    if (!joinedRooms.has(roomId))
+        return "not_joined";
+    return null;
+}
+/** Extract Matrix username (localpart) from a full MXID like @user:matrix.org */
+export function extractUsername(userId) {
+    return userId.replace(/^@/, "").replace(/:.*$/, "");
+}
+/**
+ * Check if bot was mentioned, matching either:
+ *  - the full MXID `@user:server`
+ *  - `@localpart` as a leading-@ word (avoids false-positives on bare names)
+ */
+export function wasBotMentioned(messageText, botUserId) {
+    if (messageText.includes(botUserId))
+        return true;
+    const localpart = extractUsername(botUserId);
+    if (!localpart)
+        return false;
+    const re = new RegExp(`@${escapeRegExp(localpart)}\\b`, "i");
+    return re.test(messageText);
+}
+/** Strip bot mention from message text — symmetric with wasBotMentioned */
+export function stripBotMention(text, botUserId) {
+    const localpart = extractUsername(botUserId);
+    let out = text.replace(new RegExp(escapeRegExp(botUserId), "g"), "");
+    if (localpart) {
+        out = out.replace(new RegExp(`@${escapeRegExp(localpart)}\\b`, "gi"), "");
+    }
+    return out.trim();
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=matrix-utils.js.map

package/dist/transports/matrix-utils.js.map

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

package/dist/transports/matrix-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=matrix-utils.test.d.ts.map

package/dist/transports/matrix-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-utils.test.d.ts","sourceRoot":"","sources":["../../src/transports/matrix-utils.test.ts"],"names":[],"mappings":""}

package/dist/transports/matrix-utils.test.js

@@ -0,0 +1,246 @@
+import * as fc from "fast-check";
+import { describe, expect, it } from "vitest";
+import { escapeHtml, extractUsername, formatForMatrix, shouldSkipEvent, stripBotMention, wasBotMentioned, } from "./matrix-utils.js";
+// ─── escapeHtml ───────────────────────────────────────────────
+describe("escapeHtml", () => {
+    it("escapes ampersand", () => {
+        expect(escapeHtml("a & b")).toBe("a & b");
+    });
+    it("escapes angle brackets", () => {
+        expect(escapeHtml("<script>")).toBe("&lt;script&gt;");
+    });
+    it("escapes double quotes", () => {
+        expect(escapeHtml('say "hello"')).toBe("say &quot;hello&quot;");
+    });
+    it("handles all special chars together", () => {
+        expect(escapeHtml('<a href="x">&')).toBe("&lt;a href=&quot;x&quot;&gt;&amp;");
+    });
+    it("returns plain text unchanged", () => {
+        expect(escapeHtml("hello world")).toBe("hello world");
+    });
+    it("handles empty string", () => {
+        expect(escapeHtml("")).toBe("");
+    });
+});
+// ─── formatForMatrix ──────────────────────────────────────────
+describe("formatForMatrix", () => {
+    it("returns plain body only for text without markdown", () => {
+        const result = formatForMatrix("hello world");
+        expect(result).toEqual({ body: "hello world" });
+        expect(result.formattedBody).toBeUndefined();
+    });
+    it("converts **bold** to <strong>", () => {
+        const result = formatForMatrix("this is **bold** text");
+        expect(result.body).toBe("this is **bold** text");
+        expect(result.formattedBody).toContain("<strong>bold</strong>");
+    });
+    it("converts *italic* to <em>", () => {
+        const result = formatForMatrix("this is *italic* text");
+        expect(result.formattedBody).toContain("<em>italic</em>");
+    });
+    it("does not confuse **bold** with *italic*", () => {
+        const result = formatForMatrix("**bold** and *italic*");
+        expect(result.formattedBody).toContain("<strong>bold</strong>");
+        expect(result.formattedBody).toContain("<em>italic</em>");
+    });
+    it("converts [text](url) to <a href>", () => {
+        const result = formatForMatrix("click [here](https://example.com)");
+        expect(result.formattedBody).toContain('<a href="https://example.com">here</a>');
+    });
+    it("converts newlines to <br>", () => {
+        const result = formatForMatrix("line *one*\nline two");
+        expect(result.formattedBody).toContain("<br>");
+    });
+    it("protects inline code from markdown conversion", () => {
+        const result = formatForMatrix("use `**not bold**` here");
+        expect(result.formattedBody).toContain("<code>");
+        expect(result.formattedBody).not.toContain("<strong>not bold</strong>");
+    });
+    it("protects code blocks from markdown conversion", () => {
+        const result = formatForMatrix("```\n**not bold**\n```");
+        expect(result.formattedBody).toContain("<pre><code>");
+        expect(result.formattedBody).not.toContain("<strong>");
+    });
+    it("adds language class to code blocks", () => {
+        const result = formatForMatrix("```typescript\nconst x = 1;\n```");
+        expect(result.formattedBody).toContain('class="language-typescript"');
+    });
+    it("escapes HTML inside code blocks", () => {
+        const result = formatForMatrix("```\n<script>alert('xss')</script>\n```");
+        expect(result.formattedBody).toContain("&lt;script&gt;");
+        expect(result.formattedBody).not.toContain("<script>");
+    });
+    it("escapes HTML inside inline code", () => {
+        const result = formatForMatrix("use `<div>` tag");
+        expect(result.formattedBody).toContain("&lt;div&gt;");
+    });
+    it("preserves original text as body even when formatted", () => {
+        const original = "**bold** and `code`";
+        const result = formatForMatrix(original);
+        expect(result.body).toBe(original);
+    });
+});
+// ─── shouldSkipEvent ──────────────────────────────────────────
+describe("shouldSkipEvent", () => {
+    const botUserId = "@bot:matrix.org";
+    const connectedAt = 1000;
+    const joinedRooms = new Set(["!room1:matrix.org", "!room2:matrix.org"]);
+    function makeEvent(overrides = {}) {
+        return {
+            sender: "@user:matrix.org",
+            origin_server_ts: 2000,
+            content: { msgtype: "m.text", body: "hello" },
+            ...overrides,
+        };
+    }
+    it("returns null for a valid message", () => {
+        expect(shouldSkipEvent(makeEvent(), botUserId, connectedAt, joinedRooms, "!room1:matrix.org")).toBeNull();
+    });
+    it("skips own messages", () => {
+        expect(shouldSkipEvent(makeEvent({ sender: botUserId }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBe("own_message");
+    });
+    it("skips stale events (before connectedAt)", () => {
+        expect(shouldSkipEvent(makeEvent({ origin_server_ts: 500 }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBe("stale");
+    });
+    it("skips events at exactly connectedAt (boundary: < not <=)", () => {
+        // connectedAt=1000, event ts=1000 → NOT stale (< is strict)
+        expect(shouldSkipEvent(makeEvent({ origin_server_ts: 1000 }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBeNull();
+    });
+    it("skips events with ts=999 (one below connectedAt)", () => {
+        expect(shouldSkipEvent(makeEvent({ origin_server_ts: 999 }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBe("stale");
+    });
+    it("skips non-text messages", () => {
+        expect(shouldSkipEvent(makeEvent({ content: { msgtype: "m.image", body: "photo" } }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBe("not_text");
+    });
+    it("skips messages with no content", () => {
+        expect(shouldSkipEvent(makeEvent({ content: undefined }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBe("not_text");
+    });
+    it("skips messages with no body", () => {
+        expect(shouldSkipEvent(makeEvent({ content: { msgtype: "m.text" } }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBe("not_text");
+    });
+    it("skips edits (m.new_content present)", () => {
+        expect(shouldSkipEvent(makeEvent({ content: { msgtype: "m.text", body: "edited", "m.new_content": { body: "new" } } }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org")).toBe("edit");
+    });
+    it("skips events from rooms not in joinedRooms", () => {
+        expect(shouldSkipEvent(makeEvent(), botUserId, connectedAt, joinedRooms, "!unknown:matrix.org"))
+            .toBe("not_joined");
+    });
+    it("handles missing origin_server_ts (defaults to 0, always stale)", () => {
+        expect(shouldSkipEvent(makeEvent({ origin_server_ts: undefined }), botUserId, connectedAt, joinedRooms, "!room1:matrix.org"))
+            .toBe("stale");
+    });
+});
+// ─── extractUsername ──────────────────────────────────────────
+describe("extractUsername", () => {
+    it("extracts localpart from full MXID", () => {
+        expect(extractUsername("@alice:matrix.org")).toBe("alice");
+    });
+    it("handles homeserver with port", () => {
+        expect(extractUsername("@bob:localhost:8448")).toBe("bob");
+    });
+    it("handles already plain username", () => {
+        expect(extractUsername("charlie")).toBe("charlie");
+    });
+    it("handles MXID without @ prefix", () => {
+        expect(extractUsername("dave:matrix.org")).toBe("dave");
+    });
+});
+// ─── wasBotMentioned ─────────────────────────────────────────
+describe("wasBotMentioned", () => {
+    const botUserId = "@pibot:matrix.org";
+    it("detects full MXID mention", () => {
+        expect(wasBotMentioned("hey @pibot:matrix.org do this", botUserId)).toBe(true);
+    });
+    it("detects @localpart mention (case-insensitive)", () => {
+        expect(wasBotMentioned("hey @Pibot do this", botUserId)).toBe(true);
+    });
+    it("detects lowercase @localpart", () => {
+        expect(wasBotMentioned("@pibot help", botUserId)).toBe(true);
+    });
+    it("returns false when not mentioned", () => {
+        expect(wasBotMentioned("hello world", botUserId)).toBe(false);
+    });
+    it("returns false for bare localpart without @ (avoids false positives on names)", () => {
+        // "pibot" appearing in casual chat without @ shouldn't be a mention
+        expect(wasBotMentioned("pibot help", botUserId)).toBe(false);
+    });
+    it("returns false for partial match that isn't the localpart", () => {
+        expect(wasBotMentioned("pi is great", botUserId)).toBe(false);
+    });
+});
+// ─── stripBotMention ─────────────────────────────────────────
+describe("stripBotMention", () => {
+    const botUserId = "@pibot:matrix.org";
+    it("strips full MXID mention", () => {
+        expect(stripBotMention("@pibot:matrix.org help me", botUserId)).toBe("help me");
+    });
+    it("strips multiple mentions", () => {
+        expect(stripBotMention("@pibot:matrix.org hey @pibot:matrix.org", botUserId)).toBe("hey");
+    });
+    it("returns original text when no mention present", () => {
+        expect(stripBotMention("hello world", botUserId)).toBe("hello world");
+    });
+    it("handles mention at end of message", () => {
+        expect(stripBotMention("help @pibot:matrix.org", botUserId)).toBe("help");
+    });
+    it("handles message that is only the mention", () => {
+        expect(stripBotMention("@pibot:matrix.org", botUserId)).toBe("");
+    });
+});
+// ─── Property tests ───────────────────────────────────────────
+describe("formatForMatrix properties", () => {
+    it("body always equals original input (preservation)", () => {
+        fc.assert(fc.property(fc.string(), (text) => {
+            const result = formatForMatrix(text);
+            expect(result.body).toBe(text);
+        }));
+    });
+    it("formattedBody is undefined when no markdown chars present", () => {
+        // Generate strings that don't contain markdown-triggering chars
+        const noMarkdown = fc.string().filter((s) => !/[*_`#[]/.test(s));
+        fc.assert(fc.property(noMarkdown, (text) => {
+            const result = formatForMatrix(text);
+            expect(result.formattedBody).toBeUndefined();
+        }));
+    });
+});
+describe("stripBotMention properties", () => {
+    it("result never contains the bot MXID (verification)", () => {
+        // Generate valid-ish MXIDs: @localpart:server
+        const localpart = fc.string({ minLength: 1, maxLength: 10 }).filter((s) => !/[@: ]/.test(s) && s.length > 0);
+        const server = fc.string({ minLength: 1, maxLength: 10 }).filter((s) => !/[@: ]/.test(s) && s.length > 0);
+        const mxid = fc.tuple(localpart, server).map(([user, host]) => `@${user}:${host}`);
+        fc.assert(fc.property(mxid, fc.string(), (botId, prefix) => {
+            const text = `${prefix} ${botId} some text`;
+            const result = stripBotMention(text, botId);
+            expect(result).not.toContain(botId);
+        }));
+    });
+});
+describe("escapeHtml properties", () => {
+    it("output never contains raw <, >, &, or \" (except as entities)", () => {
+        fc.assert(fc.property(fc.string(), (text) => {
+            const result = escapeHtml(text);
+            // After escaping, the only < > & " should be inside entity sequences
+            const withoutEntities = result
+                .replace(/&amp;/g, "")
+                .replace(/&lt;/g, "")
+                .replace(/&gt;/g, "")
+                .replace(/&quot;/g, "");
+            expect(withoutEntities).not.toMatch(/[<>"&]/);
+        }));
+    });
+});
+// Excluded from testing (design decisions / integration-only, verified by inspection):
+// - connect()/disconnect() lifecycle (requires real MatrixClient)
+// - sendMessage()/sendTyping() (thin SDK wrappers)
+// - index.ts wiring (env var reading, command handler plumbing)
+// - Widget abbreviation (mx)
+//# sourceMappingURL=matrix-utils.test.js.map

package/dist/transports/matrix-utils.test.js.map

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

package/dist/transports/matrix.d.ts

@@ -0,0 +1,34 @@
+import type { ChallengeAuth } from "../auth/challenge-auth.js";
+import type { ExternalMessage } from "../types.js";
+import type { ITransportProvider } from "./interface.js";
+/**
+ * Matrix transport provider using matrix-bot-sdk
+ * Works with any Matrix homeserver — Element X, Element Web, FluffyChat, etc.
+ */
+export declare class MatrixProvider implements ITransportProvider {
+    private config;
+    private auth;
+    readonly type = "matrix";
+    private client?;
+    private _isConnected;
+    private messageHandler?;
+    private errorHandler?;
+    private botUserId?;
+    private joinedRooms;
+    private roomMemberCount;
+    private connectedAt;
+    constructor(config: {
+        homeserverUrl: string;
+        accessToken: string;
+        encryption?: boolean;
+    }, auth: ChallengeAuth);
+    get isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendMessage(chatId: string, text: string): Promise<void>;
+    sendTyping(chatId: string): Promise<void>;
+    onMessage(handler: (message: ExternalMessage) => void): void;
+    onError(handler: (error: Error) => void): void;
+    private handleMessage;
+}
+//# sourceMappingURL=matrix.d.ts.map

package/dist/transports/matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/transports/matrix.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AASzD;;;GAGG;AACH,qBAAa,cAAe,YAAW,kBAAkB;IAYrD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IAZd,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAqC;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,WAAW,CAAK;gBAGd,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,EAC5E,IAAI,EAAE,aAAa;IAG7B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAIK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6HxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI5D,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;YAIhC,aAAa;CAkF5B"}