@ai-devkit/channel-connector 0.2.0

package/dist/ChannelManager.d.ts

@@ -0,0 +1,26 @@
+import type { ChannelAdapter } from './adapters/ChannelAdapter';
+/**
+ * Central registry for channel adapters.
+ * Manages adapter lifecycle (start/stop).
+ */
+export declare class ChannelManager {
+    private adapters;
+    /**
+     * Register a channel adapter.
+     * @throws If an adapter for the same type is already registered.
+     */
+    registerAdapter(adapter: ChannelAdapter): void;
+    /**
+     * Get a registered adapter by type.
+     */
+    getAdapter(type: string): ChannelAdapter | undefined;
+    /**
+     * Start all registered adapters.
+     */
+    startAll(): Promise<void>;
+    /**
+     * Stop all registered adapters.
+     */
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=ChannelManager.d.ts.map

package/dist/ChannelManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelManager.d.ts","sourceRoot":"","sources":["../src/ChannelManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAA0C;IAE1D;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAO9C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIpD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}

package/dist/ChannelManager.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChannelManager = void 0;
+/**
+ * Central registry for channel adapters.
+ * Manages adapter lifecycle (start/stop).
+ */
+class ChannelManager {
+    constructor() {
+        this.adapters = new Map();
+    }
+    /**
+     * Register a channel adapter.
+     * @throws If an adapter for the same type is already registered.
+     */
+    registerAdapter(adapter) {
+        if (this.adapters.has(adapter.type)) {
+            throw new Error(`Adapter for type "${adapter.type}" is already registered`);
+        }
+        this.adapters.set(adapter.type, adapter);
+    }
+    /**
+     * Get a registered adapter by type.
+     */
+    getAdapter(type) {
+        return this.adapters.get(type);
+    }
+    /**
+     * Start all registered adapters.
+     */
+    async startAll() {
+        const startPromises = Array.from(this.adapters.values()).map(a => a.start());
+        await Promise.all(startPromises);
+    }
+    /**
+     * Stop all registered adapters.
+     */
+    async stopAll() {
+        const stopPromises = Array.from(this.adapters.values()).map(a => a.stop());
+        await Promise.all(stopPromises);
+    }
+}
+exports.ChannelManager = ChannelManager;
+//# sourceMappingURL=ChannelManager.js.map

package/dist/ChannelManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelManager.js","sourceRoot":"","sources":["../src/ChannelManager.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,cAAc;IAA3B;QACY,aAAQ,GAAgC,IAAI,GAAG,EAAE,CAAC;IAmC9D,CAAC;IAjCG;;;OAGG;IACH,eAAe,CAAC,OAAuB;QACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,CAAC,IAAI,yBAAyB,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACV,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7E,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;CACJ;AApCD,wCAoCC"}

package/dist/ConfigStore.d.ts

@@ -0,0 +1,28 @@
+import type { ChannelConfig, ChannelEntry } from './types';
+/**
+ * Persists channel configurations to disk.
+ * Default location: ~/.ai-devkit/channels.json
+ * File permissions are set to 0600 to protect tokens.
+ */
+export declare class ConfigStore {
+    private configPath;
+    constructor(configPath?: string);
+    /**
+     * Read the full config. Returns default empty config if file is missing or corrupt.
+     */
+    getConfig(): Promise<ChannelConfig>;
+    /**
+     * Save a channel entry. Creates the file and parent directory if needed.
+     */
+    saveChannel(name: string, entry: ChannelEntry): Promise<void>;
+    /**
+     * Remove a channel entry by name.
+     */
+    removeChannel(name: string): Promise<void>;
+    /**
+     * Get a single channel entry by name.
+     */
+    getChannel(name: string): Promise<ChannelEntry | undefined>;
+    private writeConfig;
+}
+//# sourceMappingURL=ConfigStore.d.ts.map

package/dist/ConfigStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigStore.d.ts","sourceRoot":"","sources":["../src/ConfigStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK3D;;;;GAIG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAI/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IASzC;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;YAKnD,WAAW;CAK5B"}

package/dist/ConfigStore.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigStore = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.ai-devkit', 'channels.json');
+const DEFAULT_CONFIG = { channels: {} };
+/**
+ * Persists channel configurations to disk.
+ * Default location: ~/.ai-devkit/channels.json
+ * File permissions are set to 0600 to protect tokens.
+ */
+class ConfigStore {
+    constructor(configPath) {
+        this.configPath = configPath ?? DEFAULT_CONFIG_PATH;
+    }
+    /**
+     * Read the full config. Returns default empty config if file is missing or corrupt.
+     */
+    async getConfig() {
+        try {
+            const raw = fs.readFileSync(this.configPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return { ...DEFAULT_CONFIG, channels: {} };
+        }
+    }
+    /**
+     * Save a channel entry. Creates the file and parent directory if needed.
+     */
+    async saveChannel(name, entry) {
+        const config = await this.getConfig();
+        config.channels[name] = entry;
+        await this.writeConfig(config);
+    }
+    /**
+     * Remove a channel entry by name.
+     */
+    async removeChannel(name) {
+        const config = await this.getConfig();
+        delete config.channels[name];
+        await this.writeConfig(config);
+    }
+    /**
+     * Get a single channel entry by name.
+     */
+    async getChannel(name) {
+        const config = await this.getConfig();
+        return config.channels[name];
+    }
+    async writeConfig(config) {
+        const dir = path.dirname(this.configPath);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2), { mode: 0o600 });
+    }
+}
+exports.ConfigStore = ConfigStore;
+//# sourceMappingURL=ConfigStore.js.map

package/dist/ConfigStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigStore.js","sourceRoot":"","sources":["../src/ConfigStore.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AAGzB,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;AACnF,MAAM,cAAc,GAAkB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAEvD;;;;GAIG;AACH,MAAa,WAAW;IAGpB,YAAY,UAAmB;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,mBAAmB,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACX,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,GAAG,cAAc,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC/C,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,KAAmB;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC9B,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY;QAC5B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,MAAqB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;CACJ;AAlDD,kCAkDC"}

package/dist/adapters/ChannelAdapter.d.ts

@@ -0,0 +1,30 @@
+import type { IncomingMessage } from '../types';
+/**
+ * Interface for messaging platform adapters.
+ *
+ * Implementations connect to a specific platform (Telegram, Slack, etc.)
+ * and provide a generic send/receive abstraction.
+ */
+export interface ChannelAdapter {
+    /** Identifier for this channel type (e.g., 'telegram') */
+    readonly type: string;
+    /** Start listening for incoming messages */
+    start(): Promise<void>;
+    /** Stop listening and clean up resources */
+    stop(): Promise<void>;
+    /**
+     * Send a message to a specific chat.
+     * Implementations should handle platform-specific limits
+     * (e.g., chunking at 4096 chars for Telegram).
+     */
+    sendMessage(chatId: string, text: string): Promise<void>;
+    /**
+     * Register a handler for incoming text messages.
+     * Fire-and-forget — handler returns void.
+     * Responses are sent separately via sendMessage().
+     */
+    onMessage(handler: (msg: IncomingMessage) => Promise<void>): void;
+    /** Check if the adapter is connected and healthy */
+    isHealthy(): Promise<boolean>;
+}
+//# sourceMappingURL=ChannelAdapter.d.ts.map

package/dist/adapters/ChannelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/ChannelAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAElE,oDAAoD;IACpD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC"}

package/dist/adapters/ChannelAdapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ChannelAdapter.js.map

package/dist/adapters/ChannelAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelAdapter.js","sourceRoot":"","sources":["../../src/adapters/ChannelAdapter.ts"],"names":[],"mappings":""}

package/dist/adapters/TelegramAdapter.d.ts

@@ -0,0 +1,27 @@
+import type { ChannelAdapter } from './ChannelAdapter';
+import type { IncomingMessage } from '../types';
+export declare const TELEGRAM_CHANNEL_TYPE = "telegram";
+export declare const TELEGRAM_MAX_MESSAGE_LENGTH = 4096;
+export interface TelegramAdapterOptions {
+    botToken: string;
+}
+/**
+ * Telegram Bot API adapter using telegraf with long polling.
+ */
+export declare class TelegramAdapter implements ChannelAdapter {
+    readonly type = "telegram";
+    private bot;
+    private messageHandler;
+    private running;
+    constructor(options: TelegramAdapterOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Send a message to a chat. Automatically chunks messages exceeding
+     * Telegram's 4096-char limit, preferring newline boundaries.
+     */
+    sendMessage(chatId: string, text: string): Promise<void>;
+    onMessage(handler: (msg: IncomingMessage) => Promise<void>): void;
+    isHealthy(): Promise<boolean>;
+}
+//# sourceMappingURL=TelegramAdapter.d.ts.map

package/dist/adapters/TelegramAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/TelegramAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAChD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,cAAc;IAClD,QAAQ,CAAC,IAAI,cAAyB;IAEtC,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,sBAAsB;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;OAGG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI3D,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/adapters/TelegramAdapter.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelegramAdapter = exports.TELEGRAM_MAX_MESSAGE_LENGTH = exports.TELEGRAM_CHANNEL_TYPE = void 0;
+const telegraf_1 = require("telegraf");
+exports.TELEGRAM_CHANNEL_TYPE = 'telegram';
+exports.TELEGRAM_MAX_MESSAGE_LENGTH = 4096;
+/**
+ * Telegram Bot API adapter using telegraf with long polling.
+ */
+class TelegramAdapter {
+    constructor(options) {
+        this.type = exports.TELEGRAM_CHANNEL_TYPE;
+        this.messageHandler = null;
+        this.running = false;
+        this.bot = new telegraf_1.Telegraf(options.botToken);
+    }
+    async start() {
+        this.bot.on('text', async (ctx) => {
+            if (!this.messageHandler)
+                return;
+            const msg = {
+                channelType: exports.TELEGRAM_CHANNEL_TYPE,
+                chatId: String(ctx.message.chat.id),
+                userId: String(ctx.message.from.id),
+                text: ctx.message.text,
+                timestamp: new Date(ctx.message.date * 1000),
+            };
+            try {
+                await this.messageHandler(msg);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                await ctx.reply(`Error processing message: ${errorMessage}`);
+            }
+        });
+        await this.bot.launch();
+        this.running = true;
+    }
+    async stop() {
+        this.running = false;
+        await this.bot.stop();
+    }
+    /**
+     * Send a message to a chat. Automatically chunks messages exceeding
+     * Telegram's 4096-char limit, preferring newline boundaries.
+     */
+    async sendMessage(chatId, text) {
+        const chunks = chunkMessage(text, exports.TELEGRAM_MAX_MESSAGE_LENGTH);
+        for (const chunk of chunks) {
+            await this.bot.telegram.sendMessage(chatId, chunk);
+        }
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    async isHealthy() {
+        return this.running;
+    }
+}
+exports.TelegramAdapter = TelegramAdapter;
+/**
+ * Split text into chunks of maxLen or fewer characters,
+ * preferring to split at newline boundaries.
+ */
+function chunkMessage(text, maxLen) {
+    if (text.length <= maxLen) {
+        return [text];
+    }
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLen) {
+            chunks.push(remaining);
+            break;
+        }
+        // Find the last newline within the limit
+        const searchArea = remaining.slice(0, maxLen);
+        const lastNewline = searchArea.lastIndexOf('\n');
+        let splitAt;
+        if (lastNewline > 0) {
+            splitAt = lastNewline + 1; // include the newline in the current chunk
+        }
+        else {
+            // No newline found — hard split at maxLen
+            splitAt = maxLen;
+        }
+        chunks.push(remaining.slice(0, splitAt));
+        remaining = remaining.slice(splitAt);
+    }
+    return chunks;
+}
+//# sourceMappingURL=TelegramAdapter.js.map

package/dist/adapters/TelegramAdapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { ChannelManager } from './ChannelManager';
+export { ConfigStore } from './ConfigStore';
+export { TelegramAdapter, TELEGRAM_CHANNEL_TYPE, TELEGRAM_MAX_MESSAGE_LENGTH } from './adapters/TelegramAdapter';
+export type { TelegramAdapterOptions } from './adapters/TelegramAdapter';
+export type { ChannelAdapter } from './adapters/ChannelAdapter';
+export type { IncomingMessage, MessageHandler, ChannelConfig, ChannelEntry, ChannelType, TelegramConfig, } from './types';
+//# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACjH,YAAY,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,YAAY,EACR,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,GACjB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELEGRAM_MAX_MESSAGE_LENGTH = exports.TELEGRAM_CHANNEL_TYPE = exports.TelegramAdapter = exports.ConfigStore = exports.ChannelManager = void 0;
+var ChannelManager_1 = require("./ChannelManager");
+Object.defineProperty(exports, "ChannelManager", { enumerable: true, get: function () { return ChannelManager_1.ChannelManager; } });
+var ConfigStore_1 = require("./ConfigStore");
+Object.defineProperty(exports, "ConfigStore", { enumerable: true, get: function () { return ConfigStore_1.ConfigStore; } });
+var TelegramAdapter_1 = require("./adapters/TelegramAdapter");
+Object.defineProperty(exports, "TelegramAdapter", { enumerable: true, get: function () { return TelegramAdapter_1.TelegramAdapter; } });
+Object.defineProperty(exports, "TELEGRAM_CHANNEL_TYPE", { enumerable: true, get: function () { return TelegramAdapter_1.TELEGRAM_CHANNEL_TYPE; } });
+Object.defineProperty(exports, "TELEGRAM_MAX_MESSAGE_LENGTH", { enumerable: true, get: function () { return TelegramAdapter_1.TELEGRAM_MAX_MESSAGE_LENGTH; } });
+//# 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,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,8DAAiH;AAAxG,kHAAA,eAAe,OAAA;AAAE,wHAAA,qBAAqB,OAAA;AAAE,8HAAA,2BAA2B,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * An incoming message from a messaging platform.
+ * Generic — no agent-specific concepts.
+ */
+export interface IncomingMessage {
+    channelType: string;
+    chatId: string;
+    userId: string;
+    text: string;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Handler function provided by the consumer (e.g., CLI).
+ * Fire-and-forget — returns void. Responses are sent separately via sendMessage().
+ */
+export type MessageHandler = (message: IncomingMessage) => Promise<void>;
+/**
+ * Root configuration for all channels.
+ */
+export interface ChannelConfig {
+    channels: Record<string, ChannelEntry>;
+}
+/**
+ * Configuration entry for a single channel.
+ */
+export interface ChannelEntry {
+    type: ChannelType;
+    enabled: boolean;
+    createdAt: string;
+    config: TelegramConfig;
+}
+/**
+ * Supported channel types.
+ */
+export type ChannelType = 'telegram' | 'slack' | 'whatsapp';
+/**
+ * Telegram-specific configuration.
+ */
+export interface TelegramConfig {
+    botToken: string;
+    botUsername: string;
+    authorizedChatId?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@ai-devkit/channel-connector",
+  "version": "0.2.0",
+  "description": "Generic messaging bridge for connecting to external communication platforms",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "ai",
+    "channel",
+    "connector",
+    "telegram",
+    "messaging"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "telegraf": "^4.16.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.11.5",
+    "@typescript-eslint/eslint-plugin": "^6.19.1",
+    "@typescript-eslint/parser": "^6.19.1",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=20.20.0"
+  }
+}