@adriangalilea/utils 0.5.0 → 0.7.0

package/dist/bot/access-control.js

@@ -0,0 +1,516 @@
+/**
+ * Access control for personal GramIO bots — a one-stop guard +
+ * approve/deny + revocable allow-list with an inline admin menu.
+ *
+ *                stranger DMs your bot
+ *                       │
+ *                       ▼
+ *      ┌──── plugin gate (this file) ────────────────────┐
+ *      │  ctx.from.id  ∈  admin / defaults / approved?   │
+ *      │     yes → next()                                │
+ *      │     no  → drop + notify admin (rate-limited)    │
+ *      └─────────────────────────────────────────────────┘
+ *                       │
+ *           admin gets DM with [✅ Aprobar] [❌ Denegar]
+ *                       │
+ *                  admin taps
+ *                       │
+ *      stranger's session updated  ·  stranger gets DM
+ *
+ * **Storage layout.** Per-user state lives in its own key, written
+ * through `@gramio/session` so the gate read on the hot path costs
+ * nothing extra (session is loaded for the user already). A single
+ * tiny index key keeps track of who's pending / approved / denied so
+ * the `/access` admin menu can list without scanning the whole DB.
+ *
+ *     storage:
+ *       access:<userId>        → AccessRecord  (the user's session)
+ *       ac:index               → { pending, approved, denied }
+ *
+ * **Cross-user mutations.** When you tap `[✅ Aprobar]` on Pepe's
+ * notification, ctx is *yours* (the admin), so `ctx.access` is your
+ * own record. To mutate Pepe's record we hit the storage at the same
+ * key format we registered the session with (`access:<id>`) and
+ * update the index. This isn't a hack — it's our own module
+ * coordinating with itself.
+ *
+ * **Composes with `adminContext`** (kit.ts) — that plugin must be
+ * extended first or `bot.start()` throws. Inside this plugin,
+ * `ctx.adminId` and `ctx.isAdmin` are typed.
+ *
+ * Peer deps: `gramio`, `@gramio/storage`, `@gramio/session`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { redisStorage } from '@gramio/storage-redis'
+ * import { adminContext, gracefulStart } from '@adriangalilea/utils/bot/kit'
+ * import { accessControl } from '@adriangalilea/utils/bot/access-control'
+ *
+ * const storage = redisStorage()
+ *
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(adminContext({ adminId: 190202471 }))
+ *   .extend(accessControl({ storage, defaults: [1158734055] }))
+ *   .command('start', (ctx) => ctx.send(`hola, source=${ctx.access.source}`))
+ *
+ * await gracefulStart(bot)
+ */
+import { CallbackData, InlineKeyboard, Plugin, } from 'gramio';
+import { session } from '@gramio/session';
+import { inMemoryStorage } from '@gramio/storage';
+const SESSION_KEY_PREFIX = 'access:';
+const INDEX_KEY = 'ac:index';
+const FIRST_MSG_LIMIT = 200;
+const DEFAULT_DENY_MSG = 'Este bot es privado. Tu solicitud se ha enviado al admin.';
+const DEFAULT_THROTTLE_MS = 6 * 60 * 60 * 1000;
+const userSessionKey = (userId) => `${SESSION_KEY_PREFIX}${userId}`;
+// ─── callback schemas ──────────────────────────────────────────────
+//
+// Short `nameId`s keep callback_data under Telegram's 64-byte cap.
+// `v` (optional) carries the originating list view ('pending' | 'denied'
+// | 'approved'). When present, the handler refreshes that list after
+// the action; absent = original notification, edits the message inline.
+const acApprove = new CallbackData('acA').number('uid').string('v', { optional: true });
+const acDeny = new CallbackData('acD').number('uid').string('v', { optional: true });
+const acRevoke = new CallbackData('acR').number('uid');
+const acView = new CallbackData('acV').string('v'); // main | approved | pending | denied
+const acClose = new CallbackData('acC');
+// ─── small helpers ─────────────────────────────────────────────────
+const formatUser = (u, fallbackId) => {
+    if (!u)
+        return `id ${fallbackId}`;
+    const name = [u.firstName, u.lastName].filter(Boolean).join(' ') || `id ${u.id}`;
+    const handle = u.username ? `@${u.username}` : `id ${u.id}`;
+    return `${name} (${handle})`;
+};
+const fmtAge = (ms) => {
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}min`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h`;
+    return `${Math.floor(h / 24)}d`;
+};
+const requestNotificationText = (uid, r, repeat) => {
+    const parts = [
+        repeat ? '🔁 Acceso re-solicitado' : '🔔 Acceso solicitado',
+        '',
+        `👤 ${formatUser(r.user, uid)}`,
+        `🆔 ${uid}`,
+        `⏰ hace ${fmtAge(Date.now() - (r.requestedAt ?? Date.now()))}`,
+    ];
+    if (repeat)
+        parts.push(`🔁 intentos: ${(r.rejectedAttempts ?? 0) + 1}`);
+    if (r.firstMessage)
+        parts.push('', `💬 "${r.firstMessage}"`);
+    return parts.join('\n');
+};
+const requestKeyboard = (uid) => new InlineKeyboard()
+    .text('✅ Aprobar', acApprove.pack({ uid }))
+    .text('❌ Denegar', acDeny.pack({ uid }));
+let warnedMemory = false;
+const warnedMemoryStorage = () => {
+    if (!warnedMemory) {
+        warnedMemory = true;
+        console.warn('[access-control] using inMemoryStorage — approvals will not survive restarts. ' +
+            'Pass `storage: redisStorage()` (or sqliteStorage / cloudflareStorage) for persistence.');
+    }
+    return inMemoryStorage();
+};
+// ─── index helpers ─────────────────────────────────────────────────
+const emptyIndex = () => ({ pending: [], approved: [], denied: [] });
+const loadIndex = async (storage) => {
+    const raw = (await storage.get(INDEX_KEY));
+    return {
+        pending: raw?.pending ?? [],
+        approved: raw?.approved ?? [],
+        denied: raw?.denied ?? [],
+    };
+};
+const saveIndex = (storage, idx) => storage.set(INDEX_KEY, idx);
+const indexAdd = async (storage, bucket, uid) => {
+    const idx = await loadIndex(storage);
+    if (!idx[bucket].includes(uid))
+        idx[bucket].push(uid);
+    await saveIndex(storage, idx);
+};
+const indexMove = async (storage, uid, from, to) => {
+    const idx = await loadIndex(storage);
+    const remove = (list) => {
+        const i = list.indexOf(uid);
+        if (i >= 0)
+            list.splice(i, 1);
+    };
+    if (from === 'any') {
+        remove(idx.pending);
+        remove(idx.approved);
+        remove(idx.denied);
+    }
+    else {
+        remove(idx[from]);
+    }
+    if (!idx[to].includes(uid))
+        idx[to].push(uid);
+    await saveIndex(storage, idx);
+};
+// ─── per-user record helpers (cross-user storage access) ───────────
+const loadRecord = async (storage, userId) => (await storage.get(userSessionKey(userId)));
+const saveRecord = (storage, userId, rec) => storage.set(userSessionKey(userId), rec);
+// ─── plugin ────────────────────────────────────────────────────────
+export const accessControl = (opts = {}) => {
+    const storage = opts.storage ?? warnedMemoryStorage();
+    const defaults = new Set(opts.defaults ?? []);
+    const denyMessage = opts.denyMessage === false ? null : (opts.denyMessage ?? DEFAULT_DENY_MSG);
+    const throttleMs = opts.notifyThrottleMs ?? DEFAULT_THROTTLE_MS;
+    return (new Plugin('@adriangalilea/utils/bot/access-control', {
+        dependencies: ['@adriangalilea/utils/bot/admin'],
+    })
+        // Per-user record lives in this session (storage key `access:<senderId>`).
+        // The internal name `_accessSession` is plumbing — consumers read
+        // `ctx.access` (computed below) instead.
+        .extend(session({
+        storage,
+        key: '_accessSession',
+        getSessionKey: (ctx) => userSessionKey(ctx.senderId ?? 0),
+        initial: () => ({ status: 'unknown' }),
+    }))
+        // Compute the gate decision so handlers can read `ctx.access` ergonomically.
+        .derive((ctx) => {
+        // Only message + callback_query carry a senderId we can gate on.
+        if (!ctx.is('message') && !ctx.is('callback_query')) {
+            return { access: { allowed: false, reason: 'no-sender' } };
+        }
+        const senderId = ctx.from.id;
+        if (senderId === ctx.adminId) {
+            return { access: { allowed: true, source: 'admin' } };
+        }
+        if (defaults.has(senderId)) {
+            return { access: { allowed: true, source: 'default' } };
+        }
+        const rec = ctx._accessSession;
+        if (rec.status === 'approved') {
+            return { access: { allowed: true, source: 'store', record: rec } };
+        }
+        return {
+            access: { allowed: false, reason: rec.status },
+        };
+    })
+        // Gate. Authorized passes through; unauthorized triggers admin notify
+        // and silent stranger reply, then drops.
+        .use(async (ctx, next) => {
+        if (ctx.access.allowed) {
+            // Activity bump (only for store-approved users — admins/defaults
+            // don't have a session record we want to clutter).
+            if (ctx.access.source === 'store' && ctx.is('message')) {
+                ctx._accessSession.lastActivityAt = Date.now();
+                ctx._accessSession.messageCount = (ctx._accessSession.messageCount ?? 0) + 1;
+            }
+            return next();
+        }
+        // Acknowledge unauthorized callback queries so the spinner clears.
+        if (ctx.is('callback_query')) {
+            await ctx.answer({ text: 'Sin acceso.', show_alert: false });
+            return;
+        }
+        // Only message-shaped events have .text/.chat for our notification.
+        if (!ctx.is('message'))
+            return;
+        const userId = ctx.from.id;
+        const rec = ctx._accessSession;
+        const now = Date.now();
+        const isFirstRequest = rec.status === 'unknown';
+        if (isFirstRequest) {
+            rec.status = 'pending';
+            rec.user = {
+                id: userId,
+                firstName: ctx.from.firstName,
+                lastName: ctx.from.lastName,
+                username: ctx.from.username,
+            };
+            rec.chatId = ctx.chat.id;
+            rec.requestedAt = now;
+            rec.firstMessage = ctx.text?.slice(0, FIRST_MSG_LIMIT);
+            rec.messageCount = 0;
+            rec.rejectedAttempts = 0;
+            await indexAdd(storage, 'pending', userId);
+        }
+        else {
+            rec.rejectedAttempts = (rec.rejectedAttempts ?? 0) + 1;
+        }
+        const shouldNotify = isFirstRequest || now - (rec.lastNotifiedAt ?? 0) > throttleMs;
+        if (shouldNotify) {
+            rec.lastNotifiedAt = now;
+            try {
+                await ctx.bot.api.sendMessage({
+                    chat_id: ctx.adminId,
+                    text: requestNotificationText(userId, rec, !isFirstRequest),
+                    reply_markup: requestKeyboard(userId),
+                });
+            }
+            catch (e) {
+                console.error('[access-control] failed to notify admin (have you /started the bot from your account?)', e);
+            }
+            opts.onAccessRequest?.({ user: rec.user, firstMessage: rec.firstMessage });
+        }
+        if (denyMessage && isFirstRequest) {
+            try {
+                await ctx.send(denyMessage);
+            }
+            catch {
+                // user blocked the bot — irrelevant
+            }
+        }
+        // do NOT call next — drop
+    })
+        // ─── admin actions ────────────────────────────────────────
+        .callbackQuery(acApprove, async (ctx) => {
+        if (!ctx.isAdmin)
+            return ctx.answer({ text: 'Solo admin.', show_alert: true });
+        const uid = ctx.queryData.uid;
+        const rec = await loadRecord(storage, uid);
+        if (!rec)
+            return ctx.answer({ text: 'No encontrado.' });
+        const wasDenied = rec.status === 'denied';
+        const wasPending = rec.status === 'pending';
+        rec.status = 'approved';
+        rec.approvedAt = Date.now();
+        rec.approvedBy = ctx.adminId;
+        rec.deniedAt = undefined;
+        rec.deniedBy = undefined;
+        await saveRecord(storage, uid, rec);
+        await indexMove(storage, uid, wasPending ? 'pending' : wasDenied ? 'denied' : 'any', 'approved');
+        if (rec.chatId !== undefined) {
+            try {
+                await ctx.bot.api.sendMessage({
+                    chat_id: rec.chatId,
+                    text: wasDenied
+                        ? '✅ El admin reconsideró: ya tienes acceso.'
+                        : '✅ Acceso concedido. Ya puedes usar el bot.',
+                });
+            }
+            catch {
+                // user blocked / chat gone
+            }
+        }
+        await ctx.answer({ text: '✅ Aprobado' });
+        if (ctx.queryData.v) {
+            await renderView(ctx, storage, defaults, ctx.queryData.v);
+        }
+        else {
+            try {
+                await ctx.editText(`✅ Aprobado · ${formatUser(rec.user, uid)}`);
+            }
+            catch {
+                // not always editable
+            }
+        }
+        opts.onApprove?.({ userId: uid, approvedBy: ctx.adminId });
+    })
+        .callbackQuery(acDeny, async (ctx) => {
+        if (!ctx.isAdmin)
+            return ctx.answer({ text: 'Solo admin.', show_alert: true });
+        const uid = ctx.queryData.uid;
+        const rec = await loadRecord(storage, uid);
+        if (!rec)
+            return ctx.answer({ text: 'No encontrado.' });
+        const wasPending = rec.status === 'pending';
+        rec.status = 'denied';
+        rec.deniedAt = Date.now();
+        rec.deniedBy = ctx.adminId;
+        await saveRecord(storage, uid, rec);
+        await indexMove(storage, uid, wasPending ? 'pending' : 'any', 'denied');
+        if (rec.chatId !== undefined) {
+            try {
+                await ctx.bot.api.sendMessage({
+                    chat_id: rec.chatId,
+                    text: '❌ Acceso denegado.',
+                });
+            }
+            catch {
+                // ignore
+            }
+        }
+        await ctx.answer({ text: '❌ Denegado' });
+        if (ctx.queryData.v) {
+            await renderView(ctx, storage, defaults, ctx.queryData.v);
+        }
+        else {
+            try {
+                await ctx.editText(`❌ Denegado · ${formatUser(rec.user, uid)}`);
+            }
+            catch {
+                // ignore
+            }
+        }
+        opts.onDeny?.({ userId: uid, deniedBy: ctx.adminId });
+    })
+        .callbackQuery(acRevoke, async (ctx) => {
+        if (!ctx.isAdmin)
+            return ctx.answer({ text: 'Solo admin.', show_alert: true });
+        const uid = ctx.queryData.uid;
+        const rec = await loadRecord(storage, uid);
+        if (!rec)
+            return ctx.answer({ text: 'No encontrado.' });
+        rec.status = 'denied';
+        rec.deniedAt = Date.now();
+        rec.deniedBy = ctx.adminId;
+        await saveRecord(storage, uid, rec);
+        await indexMove(storage, uid, 'approved', 'denied');
+        if (rec.chatId !== undefined) {
+            try {
+                await ctx.bot.api.sendMessage({
+                    chat_id: rec.chatId,
+                    text: '↩️ Tu acceso al bot ha sido revocado.',
+                });
+            }
+            catch {
+                // ignore
+            }
+        }
+        await ctx.answer({ text: '↩️ Revocado' });
+        await renderView(ctx, storage, defaults, 'approved');
+    })
+        .callbackQuery(acView, async (ctx) => {
+        if (!ctx.isAdmin)
+            return ctx.answer({ text: 'Solo admin.', show_alert: true });
+        await ctx.answer({});
+        await renderView(ctx, storage, defaults, ctx.queryData.v);
+    })
+        .callbackQuery(acClose, async (ctx) => {
+        if (!ctx.isAdmin)
+            return ctx.answer({ text: 'Solo admin.', show_alert: true });
+        await ctx.answer({});
+        try {
+            await ctx.message?.delete();
+        }
+        catch {
+            // ignore
+        }
+    })
+        .command('access', async (ctx) => {
+        if (!ctx.isAdmin)
+            return;
+        const v = await mainView(storage, defaults);
+        await ctx.send(v.text, { reply_markup: v.keyboard });
+    }));
+};
+const renderView = async (ctx, storage, defaults, view) => {
+    const v = view === 'approved'
+        ? await listView(storage, 'approved', defaults)
+        : view === 'pending'
+            ? await listView(storage, 'pending', defaults)
+            : view === 'denied'
+                ? await listView(storage, 'denied', defaults)
+                : await mainView(storage, defaults);
+    try {
+        await ctx.editText(v.text, { reply_markup: v.keyboard });
+    }
+    catch {
+        // editText only works while message is recent enough; ignore
+    }
+};
+const mainView = async (storage, defaults) => {
+    const idx = await loadIndex(storage);
+    const text = [
+        '🔐 Access Control',
+        '',
+        `✅ Aprobados: ${idx.approved.length}`,
+        `⏳ Pendientes: ${idx.pending.length}`,
+        `❌ Denegados: ${idx.denied.length}`,
+        `👑 Defaults: ${defaults.size} (hardcoded)`,
+    ].join('\n');
+    const keyboard = new InlineKeyboard()
+        .text(`✅ Aprobados (${idx.approved.length})`, acView.pack({ v: 'approved' }))
+        .text(`⏳ Pendientes (${idx.pending.length})`, acView.pack({ v: 'pending' }))
+        .row()
+        .text(`❌ Denegados (${idx.denied.length})`, acView.pack({ v: 'denied' }))
+        .text('🔄 Refresh', acView.pack({ v: 'main' }))
+        .row()
+        .text('✖️ Cerrar', acClose.pack({}));
+    return { text, keyboard };
+};
+const listView = async (storage, filter, defaults) => {
+    const idx = await loadIndex(storage);
+    const ids = idx[filter];
+    // Cap at 20 to keep callback_data + rendering sane.
+    const shownIds = ids.slice(0, 20);
+    const records = await Promise.all(shownIds.map(async (id) => ({ id, rec: await loadRecord(storage, id) })));
+    const headerEmoji = filter === 'approved' ? '✅' : filter === 'pending' ? '⏳' : '❌';
+    const headerLabel = filter === 'approved' ? 'Aprobados' : filter === 'pending' ? 'Pendientes' : 'Denegados';
+    if (ids.length === 0) {
+        const text = `${headerEmoji} ${headerLabel} (0)\n\n(vacío)`;
+        const keyboard = new InlineKeyboard().text('⬅️ Volver', acView.pack({ v: 'main' }));
+        return { text, keyboard };
+    }
+    const lines = [`${headerEmoji} ${headerLabel} (${ids.length})`, ''];
+    const keyboard = new InlineKeyboard();
+    for (let i = 0; i < records.length; i++) {
+        const { id, rec } = records[i];
+        if (!rec) {
+            // index referenced a missing record — show as placeholder
+            lines.push(`${i + 1}. id ${id} (datos perdidos)`);
+            continue;
+        }
+        const ageRef = rec.approvedAt ?? rec.deniedAt ?? rec.requestedAt ?? Date.now();
+        lines.push(`${i + 1}. ${formatUser(rec.user, id)} · hace ${fmtAge(Date.now() - ageRef)}` +
+            (rec.messageCount ? ` · ${rec.messageCount} msgs` : ''));
+        if (filter === 'pending') {
+            keyboard
+                .text(`✅ ${i + 1}`, acApprove.pack({ uid: id, v: 'pending' }))
+                .text(`❌ ${i + 1}`, acDeny.pack({ uid: id, v: 'pending' }))
+                .row();
+        }
+        else if (filter === 'approved') {
+            keyboard.text(`↩️ Revocar #${i + 1}`, acRevoke.pack({ uid: id })).row();
+        }
+        else if (filter === 'denied') {
+            keyboard
+                .text(`✅ Reaprobar #${i + 1}`, acApprove.pack({ uid: id, v: 'denied' }))
+                .row();
+        }
+    }
+    if (ids.length > shownIds.length) {
+        lines.push('', `(+${ids.length - shownIds.length} más, no mostrados)`);
+    }
+    if (filter === 'approved' && defaults.size > 0) {
+        lines.push('', `+ ${defaults.size} hardcoded defaults`);
+    }
+    keyboard.text('⬅️ Volver', acView.pack({ v: 'main' }));
+    return { text: lines.join('\n'), keyboard };
+};
+// ─── test helper ───────────────────────────────────────────────────
+/**
+ * Inject a synthetic access request — for tests/demos when you can't
+ * easily spin up a second Telegram account. Writes a `pending` record
+ * to storage at the same key the plugin's session would, updates the
+ * index, then DMs the admin with the real
+ * `[✅ Aprobar][❌ Denegar]` keyboard. Tapping those buttons exercises
+ * the real callback handlers end-to-end.
+ *
+ * Pass the SAME `storage` instance you passed to `accessControl({ storage })`.
+ */
+export const simulateAccessRequest = async (bot, storage, adminId, fakeUser, message) => {
+    const now = Date.now();
+    const rec = {
+        status: 'pending',
+        user: fakeUser,
+        chatId: fakeUser.id,
+        requestedAt: now,
+        firstMessage: message?.slice(0, FIRST_MSG_LIMIT),
+        messageCount: 0,
+        rejectedAttempts: 0,
+        lastNotifiedAt: now,
+    };
+    await saveRecord(storage, fakeUser.id, rec);
+    await indexAdd(storage, 'pending', fakeUser.id);
+    await bot.api.sendMessage({
+        chat_id: adminId,
+        text: requestNotificationText(fakeUser.id, rec, false),
+        reply_markup: requestKeyboard(fakeUser.id),
+    });
+};
+//# sourceMappingURL=access-control.js.map

package/dist/bot/access-control.js.map

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

package/dist/bot/coalesce.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Coalesce client-split inbound messages.
+ *
+ * Telegram clients (Desktop / iOS / web) split a single message > 4096
+ * chars into multiple `sendMessage` calls before they ever reach the
+ * server. The bot receives them as **separate** `message` updates with
+ * no marker linking them. This middleware joins them back into one
+ * event so your handlers see the full text.
+ *
+ *     user pastes 8000 chars → client splits in 2 → bot gets 2 updates
+ *                                                            │
+ *                                                            ▼
+ *                                                 coalesce middleware
+ *                                                            │
+ *                                                     hold + join
+ *                                                            │
+ *                                                            ▼
+ *                                              handler sees ONE event
+ *                                              with full ctx.text
+ *
+ * ## Detection rule (strict)
+ *
+ * We coalesce only when ALL hold. Otherwise fragments pass through
+ * as separate events — false negatives are preferred over silently
+ * merging unrelated messages.
+ *
+ *   1. Same chat.
+ *   2. Same user (override with `acrossUsers: true`).
+ *   3. Leading fragment length ≥ `minLeadingLength` (a current
+ *      guess — see the type definition for the default and the
+ *      reasoning). Short messages never start a real client split.
+ *   4. Each subsequent fragment within `windowMs` of the previous.
+ *
+ * ## Known caveats
+ *
+ *   - `ctx.entities` is cleared on coalesced messages — per-fragment
+ *     entity offsets would point at the wrong characters once joined.
+ *     Plain-text consumers don't care; formatted-input consumers
+ *     should disable this plugin.
+ *   - In-memory buffer; doesn't survive bot restart mid-burst.
+ *
+ * Peer deps: `gramio`.
+ *
+ * @example
+ * import { Bot } from 'gramio'
+ * import { coalesceLongMessages } from '@adriangalilea/utils/bot/coalesce'
+ *
+ * const bot = new Bot(process.env.BOT_TOKEN!)
+ *   .extend(coalesceLongMessages())     // ← before .on / .command handlers
+ *   .on('message', (ctx) => {
+ *     // ctx.text is the full pasted text even if Telegram split it
+ *     return ctx.send(`got ${ctx.text?.length} chars`)
+ *   })
+ *
+ * @example  Power-user escape hatch
+ *
+ * import { isCoalescent } from '@adriangalilea/utils/bot/coalesce'
+ *
+ * if (isCoalescent(prev, curr)) {
+ *   // do your own thing
+ * }
+ */
+import { Plugin } from 'gramio';
+export type CoalesceCriteria = {
+    /**
+     * Minimum length of the leading fragment to consider a possible
+     * client split. Below this → never coalesce, zero latency. Once
+     * the buffer is open, follow-up fragments of any size join.
+     */
+    minLeadingLength?: number;
+    /**
+     * Max ms between consecutive fragments to consider them part of
+     * one client-split burst.
+     */
+    windowMs?: number;
+    /**
+     * If true, fragments from different users (same chat) can coalesce.
+     * Useful for "user forwarded a multi-author conversation as one
+     * logical block."
+     */
+    acrossUsers?: boolean;
+};
+export type CoalesceLongMessagesOptions = CoalesceCriteria & {
+    /**
+     * Log each fragment + buffer transition to stderr for debugging.
+     * Off by default.
+     */
+    log?: boolean;
+};
+/**
+ * Pure check: are these two fragments part of the same client-split
+ * burst? Use this if you want to make your own decision instead of
+ * letting the middleware do it.
+ *
+ * The two fragments are passed as plain objects so this function is
+ * decoupled from gramio's context type. Adapt your context as needed.
+ */
+export type CoalesceFragment = {
+    text: string;
+    chatId: number;
+    userId: number;
+    /** Timestamp in **milliseconds** (use `Date.now()` or `msg.date * 1000`). */
+    dateMs: number;
+};
+export declare const isCoalescent: (prev: CoalesceFragment, curr: CoalesceFragment, opts?: CoalesceCriteria) => boolean;
+export declare const coalesceLongMessages: (opts?: CoalesceLongMessagesOptions) => Plugin<{}, import("gramio").DeriveDefinitions, {}>;
+//# sourceMappingURL=coalesce.d.ts.map

package/dist/bot/coalesce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coalesce.d.ts","sourceRoot":"","sources":["../../src/bot/coalesce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAW/B,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,GAAG;IAC3D;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,YAAY,GACvB,MAAM,gBAAgB,EACtB,MAAM,gBAAgB,EACtB,OAAM,gBAAqB,KAC1B,OAUF,CAAA;AAWD,eAAO,MAAM,oBAAoB,GAAI,OAAM,2BAAgC,uDA8E1E,CAAA"}