This package provides official storage adapters for Telegraf v4.12+ sessions [see motivation].
Warning
You're not meant to import the default path! Read one of the following sections before using this module.
An in-memory session module is bundled with Telegraf. The following modules are available here:
Install the official Redis driver alongside this module.
npm i @telegraf/session redis
Usage is pretty straightforward:
import { Redis } from "@telegraf/session/redis";
const store = Redis({
url: "redis://127.0.0.1:6379",
});
const bot = new Telegraf(token, opts);
bot.use(session({ store }));
// the rest of your bot
To reuse an existing Redis client, use Redis({ client })
instead.
Install the official MongoDB driver alongside this module.
npm i @telegraf/session mongodb
Usage is pretty straightforward:
import { Mongo } from "@telegraf/session/mongodb";
const store = Mongo({
url: "mongodb://127.0.0.1:27017",
database: "telegraf-bot",
});
const bot = new Telegraf(token, opts);
bot.use(session({ store }));
// the rest of your bot
To reuse an existing MongoDB client, use Mongo({ client })
instead.
Install the Better-SQLite3 driver and types alongside this module.
npm i @telegraf/session kysely better-sqlite3
npm i --save-dev @types/better-sqlite3
Usage is pretty straightforward:
import { SQLite } from "@telegraf/session/sqlite";
const store = SQLite({
filename: "./telegraf-sessions.sqlite",
});
const bot = new Telegraf(token, opts);
bot.use(session({ store }));
// the rest of your bot
To reuse an existing Better-SQLite3 database instance, use SQLite({ database })
instead.
Install the 'pg' PostgreSQL driver and types alongside this module.
npm i @telegraf/session kysely pg
npm i --save-dev @types/pg
Usage is pretty straightforward:
import { Postgres } from "@telegraf/session/pg";
const store = Postgres({
host: "127.0.0.1",
database: "telegraf-test",
user: "database-user",
password: "hunter2",
});
const bot = new Telegraf(token, opts);
bot.use(session({ store }));
// the rest of your bot
To reuse an existing pg pool, use Postgres({ pool })
instead.
Install the 'mysql2' MySQL driver alongside this module.
npm i @telegraf/session kysely mysql2
Usage is pretty straightforward:
import { MySQL } from "@telegraf/session/mysql";
const store = MySQL({
host: "127.0.0.1",
database: "telegraf-test",
user: "database-user",
password: "hunter2",
});
const bot = new Telegraf(token, opts);
bot.use(session({ store }));
// the rest of your bot
To reuse an existing MySQL2 pool, use MySQL({ pool })
instead.
Install the official Ydb driver alongside this module.
npm i @telegraf/session ydb-sdk
Usage is pretty straightforward:
import { YDB } from "@telegraf/session/Ydb";
const store = YDB({
// Anonymous authentication will be performed without specifying authentication options
/* Static сredentials
authOptions: {
authType: AuthTypes.Static,
user: "username",
password: "password"
},
*/
/* Сredentials from environment vars
authOptions: {
authType: AuthTypes.Environment,
},
*/
/* Сredentials from JSON file
authOptions: {
authType: AuthTypes.Json,
jsonFileName: "full path filename"
},
*/
endpointUrl: "grpc://localhost:2136",
databaseName: "local",
tokenExpirationTimeout: 20000,
connectionTimeout: 10000,
})
const bot = new Telegraf(token, opts);
bot.use(session({ store }));
// the rest of your bot
To reuse an existing YDB client, use YDB({ client })
instead.
Since telegraf#1372, it has been known that all asynchronous session middleware have been prone to race-conditions. This was addressed in telegraf#1713, but third-party session middleware continue to be affected. Since Telegraf 1.12.0, it's recommended that third-party plugins only provide the store parameter for session, instead of implementing session themselves. This way, they can take advantage of the safety provided by Telegraf's builtin session. Of course, if your plugin has an exceptional usecase, it may need to implement its own middleware.
To begin to solve this problem, we officially maintain the 5 most common storage backends. This package is considered beta, and may have minor breaking changes and bugfixes before a semver stable release. Feedback is welcome via issues and in the group: TelegrafJSChat