@adriangalilea/utils 0.16.0 → 0.16.2

package/dist/bot/access-control.js

@@ -74,12 +74,12 @@
  *
  * await gracefulStart(bot)
  */
-import { CallbackData, InlineKeyboard, Plugin, } from 'gramio';
-import { say } from '../say/index.js';
-const INDEX_KEY = 'ac:index';
+import { CallbackData, InlineKeyboard, Plugin, } from "gramio";
+import { say } from "../say/index.js";
+const INDEX_KEY = "ac:index";
 const FIRST_MSG_LIMIT = 200;
 const DEFAULT_THROTTLE_MS = 6 * 60 * 60 * 1000;
-const FALLBACK_LANG = 'en';
+const FALLBACK_LANG = "en";
 /** gramio's `@gramio/session` default `getSessionKey` is `String(senderId)`. */
 const sessionKey = (userId) => String(userId);
 // ─── callback schemas ──────────────────────────────────────────────
@@ -88,16 +88,20 @@ const sessionKey = (userId) => String(userId);
 // `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');
+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 name = [u.firstName, u.lastName].filter(Boolean).join(" ") || `id ${u.id}`;
     const handle = u.username ? `@${u.username}` : `id ${u.id}`;
     return `${name} (${handle})`;
 };
@@ -116,23 +120,23 @@ const fmtAge = (ms) => {
 const requestNotificationText = (uid, r, repeat, lang) => {
     const parts = [
         say(repeat
-            ? { en: '🔁 Access re-requested', es: '🔁 Acceso re-solicitado' }
-            : { en: '🔔 Access requested', es: '🔔 Acceso solicitado' }, lang),
-        '',
+            ? { en: "🔁 Access re-requested", es: "🔁 Acceso re-solicitado" }
+            : { en: "🔔 Access requested", es: "🔔 Acceso solicitado" }, lang),
+        "",
         `👤 ${formatUser(r.user, uid)}`,
         `🆔 ${uid}`,
-        `⏰ ${say({ en: 'ago', es: 'hace' }, lang)} ${fmtAge(Date.now() - (r.requestedAt ?? Date.now()))}`,
+        `⏰ ${say({ en: "ago", es: "hace" }, lang)} ${fmtAge(Date.now() - (r.requestedAt ?? Date.now()))}`,
     ];
     if (repeat) {
-        parts.push(`🔁 ${say({ en: 'attempts', es: 'intentos' }, lang)}: ${(r.rejectedAttempts ?? 0) + 1}`);
+        parts.push(`🔁 ${say({ en: "attempts", es: "intentos" }, lang)}: ${(r.rejectedAttempts ?? 0) + 1}`);
     }
     if (r.firstMessage)
-        parts.push('', `💬 "${r.firstMessage}"`);
-    return parts.join('\n');
+        parts.push("", `💬 "${r.firstMessage}"`);
+    return parts.join("\n");
 };
 const requestKeyboard = (uid, lang) => new InlineKeyboard()
-    .text(say({ en: '✅ Approve', es: '✅ Aprobar' }, lang), acApprove.pack({ uid }), { style: 'success' })
-    .text(say({ en: '❌ Deny', es: '❌ Denegar' }, lang), acDeny.pack({ uid }), { style: 'danger' });
+    .text(say({ en: "✅ Approve", es: "✅ Aprobar" }, lang), acApprove.pack({ uid }), { style: "success" })
+    .text(say({ en: "❌ Deny", es: "❌ Denegar" }, lang), acDeny.pack({ uid }), { style: "danger" });
 // ─── index helpers ─────────────────────────────────────────────────
 const loadIndex = async (storage) => {
     const raw = (await storage.get(INDEX_KEY));
@@ -156,7 +160,7 @@ const indexMove = async (storage, uid, from, to) => {
         if (i >= 0)
             list.splice(i, 1);
     };
-    if (from === 'any') {
+    if (from === "any") {
         remove(idx.pending);
         remove(idx.approved);
         remove(idx.denied);
@@ -168,7 +172,8 @@ const indexMove = async (storage, uid, from, to) => {
         idx[to].push(uid);
     await saveIndex(storage, idx);
 };
-const loadFullRecord = async (storage, userId) => (await storage.get(sessionKey(userId))) ?? {};
+const loadFullRecord = async (storage, userId) => (await storage.get(sessionKey(userId))) ??
+    {};
 const saveAccess = async (storage, userId, rec) => {
     const full = await loadFullRecord(storage, userId);
     full.access = rec;
@@ -196,8 +201,8 @@ export const accessControl = (opts) => {
     // ctx.adminId / ctx.isAdmin are typed inside our handlers.
     // Session-side types flow through `.extend(opts.session)` below
     // and TypeScript merges them with our generic via the chain.
-    new Plugin('@adriangalilea/utils/bot/access-control', {
-        dependencies: ['@adriangalilea/utils/bot/admin'],
+    new Plugin("@adriangalilea/utils/bot/access-control", {
+        dependencies: ["@adriangalilea/utils/bot/admin"],
     })
         // Declare the shared session as a dependency. gramio's runtime
         // dedups against the bot's top-level extension; types flow.
@@ -205,21 +210,36 @@ export const accessControl = (opts) => {
         // 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' } };
+        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' } };
+            return {
+                access: { allowed: true, source: "admin" },
+            };
         }
         if (defaults.has(senderId)) {
-            return { access: { allowed: true, source: 'default' } };
+            return {
+                access: { allowed: true, source: "default" },
+            };
         }
         // ctx.session.access may be undefined for first-ever interaction
         // (session.initial() returns {} so .access isn't set yet).
-        const rec = ctx.session.access ?? { status: 'unknown' };
-        if (rec.status === 'approved') {
-            return { access: { allowed: true, source: 'store', record: rec } };
+        const rec = ctx.session.access ?? { status: "unknown" };
+        if (rec.status === "approved") {
+            return {
+                access: {
+                    allowed: true,
+                    source: "store",
+                    record: rec,
+                },
+            };
         }
         return {
             access: { allowed: false, reason: rec.status },
@@ -231,8 +251,8 @@ export const accessControl = (opts) => {
         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') &&
+            if (ctx.access.source === "store" &&
+                ctx.is("message") &&
                 ctx.session.access) {
                 ctx.session.access = {
                     ...ctx.session.access,
@@ -243,23 +263,23 @@ export const accessControl = (opts) => {
             return next();
         }
         // Acknowledge unauthorized callback queries so the spinner clears.
-        if (ctx.is('callback_query')) {
+        if (ctx.is("callback_query")) {
             await ctx.answer({
-                text: say({ en: 'No access.', es: 'Sin acceso.' }, ctxLang(ctx)),
+                text: say({ en: "No access.", es: "Sin acceso." }, ctxLang(ctx)),
                 show_alert: false,
             });
             return;
         }
         // Only message-shaped events have .text/.chat for our notification.
-        if (!ctx.is('message'))
+        if (!ctx.is("message"))
             return;
         const userId = ctx.from.id;
         const existing = ctx.session.access;
         const now = Date.now();
-        const isFirstRequest = !existing || existing.status === 'unknown';
+        const isFirstRequest = !existing || existing.status === "unknown";
         const rec = isFirstRequest
             ? {
-                status: 'pending',
+                status: "pending",
                 user: {
                     id: userId,
                     firstName: ctx.from.firstName,
@@ -274,7 +294,7 @@ export const accessControl = (opts) => {
             }
             : { ...existing };
         if (isFirstRequest) {
-            await indexAdd(storage, 'pending', userId);
+            await indexAdd(storage, "pending", userId);
         }
         else {
             rec.rejectedAttempts = (rec.rejectedAttempts ?? 0) + 1;
@@ -291,17 +311,20 @@ export const accessControl = (opts) => {
                 });
             }
             catch (e) {
-                console.error('[access-control] failed to notify admin (have you /started the bot from your account?)', 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 });
+            opts.onAccessRequest?.({
+                user: rec.user,
+                firstMessage: rec.firstMessage,
+            });
         }
         // Persist the updated record to the user's session.
         ctx.session.access = rec;
         if (!silentDeny && isFirstRequest) {
             try {
                 await ctx.send(say({
-                    en: 'This bot is private. Your request has been sent to the admin.',
-                    es: 'Este bot es privado. Tu solicitud se ha enviado al admin.',
+                    en: "This bot is private. Your request has been sent to the admin.",
+                    es: "Este bot es privado. Tu solicitud se ha enviado al admin.",
                 }, ctxLang(ctx)));
             }
             catch {
@@ -315,24 +338,24 @@ export const accessControl = (opts) => {
         const aLang = ctxLang(ctx);
         if (!ctx.isAdmin)
             return ctx.answer({
-                text: say({ en: 'Admin only.', es: 'Solo admin.' }, aLang),
+                text: say({ en: "Admin only.", es: "Solo admin." }, aLang),
                 show_alert: true,
             });
         const uid = ctx.queryData.uid;
         const rec = await loadAccess(storage, uid);
         if (!rec)
             return ctx.answer({
-                text: say({ en: 'Not found.', es: 'No encontrado.' }, aLang),
+                text: say({ en: "Not found.", es: "No encontrado." }, aLang),
             });
-        const wasDenied = rec.status === 'denied';
-        const wasPending = rec.status === 'pending';
-        rec.status = 'approved';
+        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 saveAccess(storage, uid, rec);
-        await indexMove(storage, uid, wasPending ? 'pending' : wasDenied ? 'denied' : 'any', 'approved');
+        await indexMove(storage, uid, wasPending ? "pending" : wasDenied ? "denied" : "any", "approved");
         if (rec.chatId !== undefined) {
             try {
                 const sLang = await langOfUser(storage, uid);
@@ -340,12 +363,12 @@ export const accessControl = (opts) => {
                     chat_id: rec.chatId,
                     text: say(wasDenied
                         ? {
-                            en: '✅ The admin reconsidered: you have access.',
-                            es: '✅ El admin reconsideró: ya tienes acceso.',
+                            en: "✅ The admin reconsidered: you have access.",
+                            es: "✅ El admin reconsideró: ya tienes acceso.",
                         }
                         : {
-                            en: '✅ Access granted. You can use the bot now.',
-                            es: '✅ Acceso concedido. Ya puedes usar el bot.',
+                            en: "✅ Access granted. You can use the bot now.",
+                            es: "✅ Acceso concedido. Ya puedes usar el bot.",
                         }, sLang),
                 });
             }
@@ -354,14 +377,14 @@ export const accessControl = (opts) => {
             }
         }
         await ctx.answer({
-            text: say({ en: '✅ Approved', es: '✅ Aprobado' }, aLang),
+            text: say({ en: "✅ Approved", es: "✅ Aprobado" }, aLang),
         });
         if (ctx.queryData.v) {
             await renderView(ctx, storage, defaults, ctx.queryData.v, aLang);
         }
         else {
             try {
-                await ctx.editText(`${say({ en: '✅ Approved', es: '✅ Aprobado' }, aLang)} · ${formatUser(rec.user, uid)}`);
+                await ctx.editText(`${say({ en: "✅ Approved", es: "✅ Aprobado" }, aLang)} · ${formatUser(rec.user, uid)}`);
             }
             catch {
                 // not always editable
@@ -373,27 +396,27 @@ export const accessControl = (opts) => {
         const aLang = ctxLang(ctx);
         if (!ctx.isAdmin)
             return ctx.answer({
-                text: say({ en: 'Admin only.', es: 'Solo admin.' }, aLang),
+                text: say({ en: "Admin only.", es: "Solo admin." }, aLang),
                 show_alert: true,
             });
         const uid = ctx.queryData.uid;
         const rec = await loadAccess(storage, uid);
         if (!rec)
             return ctx.answer({
-                text: say({ en: 'Not found.', es: 'No encontrado.' }, aLang),
+                text: say({ en: "Not found.", es: "No encontrado." }, aLang),
             });
-        const wasPending = rec.status === 'pending';
-        rec.status = 'denied';
+        const wasPending = rec.status === "pending";
+        rec.status = "denied";
         rec.deniedAt = Date.now();
         rec.deniedBy = ctx.adminId;
         await saveAccess(storage, uid, rec);
-        await indexMove(storage, uid, wasPending ? 'pending' : 'any', 'denied');
+        await indexMove(storage, uid, wasPending ? "pending" : "any", "denied");
         if (rec.chatId !== undefined) {
             try {
                 const sLang = await langOfUser(storage, uid);
                 await ctx.bot.api.sendMessage({
                     chat_id: rec.chatId,
-                    text: say({ en: '❌ Access denied.', es: '❌ Acceso denegado.' }, sLang),
+                    text: say({ en: "❌ Access denied.", es: "❌ Acceso denegado." }, sLang),
                 });
             }
             catch {
@@ -401,14 +424,14 @@ export const accessControl = (opts) => {
             }
         }
         await ctx.answer({
-            text: say({ en: '❌ Denied', es: '❌ Denegado' }, aLang),
+            text: say({ en: "❌ Denied", es: "❌ Denegado" }, aLang),
         });
         if (ctx.queryData.v) {
             await renderView(ctx, storage, defaults, ctx.queryData.v, aLang);
         }
         else {
             try {
-                await ctx.editText(`${say({ en: '❌ Denied', es: '❌ Denegado' }, aLang)} · ${formatUser(rec.user, uid)}`);
+                await ctx.editText(`${say({ en: "❌ Denied", es: "❌ Denegado" }, aLang)} · ${formatUser(rec.user, uid)}`);
             }
             catch {
                 // ignore
@@ -420,28 +443,28 @@ export const accessControl = (opts) => {
         const aLang = ctxLang(ctx);
         if (!ctx.isAdmin)
             return ctx.answer({
-                text: say({ en: 'Admin only.', es: 'Solo admin.' }, aLang),
+                text: say({ en: "Admin only.", es: "Solo admin." }, aLang),
                 show_alert: true,
             });
         const uid = ctx.queryData.uid;
         const rec = await loadAccess(storage, uid);
         if (!rec)
             return ctx.answer({
-                text: say({ en: 'Not found.', es: 'No encontrado.' }, aLang),
+                text: say({ en: "Not found.", es: "No encontrado." }, aLang),
             });
-        rec.status = 'denied';
+        rec.status = "denied";
         rec.deniedAt = Date.now();
         rec.deniedBy = ctx.adminId;
         await saveAccess(storage, uid, rec);
-        await indexMove(storage, uid, 'approved', 'denied');
+        await indexMove(storage, uid, "approved", "denied");
         if (rec.chatId !== undefined) {
             try {
                 const sLang = await langOfUser(storage, uid);
                 await ctx.bot.api.sendMessage({
                     chat_id: rec.chatId,
                     text: say({
-                        en: '↩️ Your bot access has been revoked.',
-                        es: '↩️ Tu acceso al bot ha sido revocado.',
+                        en: "↩️ Your bot access has been revoked.",
+                        es: "↩️ Tu acceso al bot ha sido revocado.",
                     }, sLang),
                 });
             }
@@ -450,15 +473,15 @@ export const accessControl = (opts) => {
             }
         }
         await ctx.answer({
-            text: say({ en: '↩️ Revoked', es: '↩️ Revocado' }, aLang),
+            text: say({ en: "↩️ Revoked", es: "↩️ Revocado" }, aLang),
         });
-        await renderView(ctx, storage, defaults, 'approved', aLang);
+        await renderView(ctx, storage, defaults, "approved", aLang);
     })
         .callbackQuery(acView, async (ctx) => {
         const aLang = ctxLang(ctx);
         if (!ctx.isAdmin)
             return ctx.answer({
-                text: say({ en: 'Admin only.', es: 'Solo admin.' }, aLang),
+                text: say({ en: "Admin only.", es: "Solo admin." }, aLang),
                 show_alert: true,
             });
         await ctx.answer({});
@@ -468,7 +491,7 @@ export const accessControl = (opts) => {
         const aLang = ctxLang(ctx);
         if (!ctx.isAdmin)
             return ctx.answer({
-                text: say({ en: 'Admin only.', es: 'Solo admin.' }, aLang),
+                text: say({ en: "Admin only.", es: "Solo admin." }, aLang),
                 show_alert: true,
             });
         await ctx.answer({});
@@ -479,14 +502,14 @@ export const accessControl = (opts) => {
             // ignore
         }
     })
-        .command('access', {
+        .command("access", {
         // Admin-only; hidden from Telegram's `/` menu so it doesn't
         // tempt other users to type it. Admin still invokes via /access.
         // See https://gramio.dev/triggers/command.html#commandmeta-fields
         //
         // Note: gramio's setMyCommands publishes ONE description per
         // bot, not per language. English form used as the canonical.
-        description: 'Admin: access control menu',
+        description: "Admin: access control menu",
         hide: true,
     }, async (ctx) => {
         if (!ctx.isAdmin)
@@ -498,12 +521,12 @@ export const accessControl = (opts) => {
 };
 const renderView = async (ctx, storage, defaults, view, lang) => {
     const idx = await loadIndex(storage);
-    const v = view === 'approved'
-        ? await listView(storage, idx, 'approved', defaults, lang)
-        : view === 'pending'
-            ? await listView(storage, idx, 'pending', defaults, lang)
-            : view === 'denied'
-                ? await listView(storage, idx, 'denied', defaults, lang)
+    const v = view === "approved"
+        ? await listView(storage, idx, "approved", defaults, lang)
+        : view === "pending"
+            ? await listView(storage, idx, "pending", defaults, lang)
+            : view === "denied"
+                ? await listView(storage, idx, "denied", defaults, lang)
                 : mainView(idx, defaults, lang);
     try {
         await ctx.editText(v.text, { reply_markup: v.keyboard });
@@ -513,25 +536,25 @@ const renderView = async (ctx, storage, defaults, view, lang) => {
     }
 };
 const mainView = (idx, defaults, lang) => {
-    const approved = say({ en: 'Approved', es: 'Aprobados' }, lang);
-    const pending = say({ en: 'Pending', es: 'Pendientes' }, lang);
-    const denied = say({ en: 'Denied', es: 'Denegados' }, lang);
+    const approved = say({ en: "Approved", es: "Aprobados" }, lang);
+    const pending = say({ en: "Pending", es: "Pendientes" }, lang);
+    const denied = say({ en: "Denied", es: "Denegados" }, lang);
     const text = [
-        say({ en: '🔐 Access Control', es: '🔐 Access Control' }, lang),
-        '',
+        say({ en: "🔐 Access Control", es: "🔐 Access Control" }, lang),
+        "",
         `✅ ${approved}: ${idx.approved.length}`,
         `⏳ ${pending}: ${idx.pending.length}`,
         `❌ ${denied}: ${idx.denied.length}`,
-        `👑 ${say({ en: 'Defaults', es: 'Defaults' }, lang)}: ${defaults.size} (hardcoded)`,
-    ].join('\n');
+        `👑 ${say({ en: "Defaults", es: "Defaults" }, lang)}: ${defaults.size} (hardcoded)`,
+    ].join("\n");
     const keyboard = new InlineKeyboard()
-        .text(`✅ ${approved} (${idx.approved.length})`, acView.pack({ v: 'approved' }))
-        .text(`⏳ ${pending} (${idx.pending.length})`, acView.pack({ v: 'pending' }))
+        .text(`✅ ${approved} (${idx.approved.length})`, acView.pack({ v: "approved" }))
+        .text(`⏳ ${pending} (${idx.pending.length})`, acView.pack({ v: "pending" }))
         .row()
-        .text(`❌ ${denied} (${idx.denied.length})`, acView.pack({ v: 'denied' }))
-        .text(say({ en: '🔄 Refresh', es: '🔄 Refresh' }, lang), acView.pack({ v: 'main' }))
+        .text(`❌ ${denied} (${idx.denied.length})`, acView.pack({ v: "denied" }))
+        .text(say({ en: "🔄 Refresh", es: "🔄 Refresh" }, lang), acView.pack({ v: "main" }))
         .row()
-        .text(say({ en: '✖️ Close', es: '✖️ Cerrar' }, lang), acClose.pack({}));
+        .text(say({ en: "✖️ Close", es: "✖️ Cerrar" }, lang), acClose.pack({}));
     return { text, keyboard };
 };
 const listView = async (storage, idx, filter, defaults, lang) => {
@@ -539,60 +562,60 @@ const listView = async (storage, idx, filter, defaults, lang) => {
     // 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 loadAccess(storage, id) })));
-    const headerEmoji = filter === 'approved' ? '✅' : filter === 'pending' ? '⏳' : '❌';
-    const headerLabel = filter === 'approved'
-        ? say({ en: 'Approved', es: 'Aprobados' }, lang)
-        : filter === 'pending'
-            ? say({ en: 'Pending', es: 'Pendientes' }, lang)
-            : say({ en: 'Denied', es: 'Denegados' }, lang);
-    const back = say({ en: '⬅️ Back', es: '⬅️ Volver' }, lang);
+    const headerEmoji = filter === "approved" ? "✅" : filter === "pending" ? "⏳" : "❌";
+    const headerLabel = filter === "approved"
+        ? say({ en: "Approved", es: "Aprobados" }, lang)
+        : filter === "pending"
+            ? say({ en: "Pending", es: "Pendientes" }, lang)
+            : say({ en: "Denied", es: "Denegados" }, lang);
+    const back = say({ en: "⬅️ Back", es: "⬅️ Volver" }, lang);
     if (ids.length === 0) {
         const text = `${headerEmoji} ${headerLabel} (0)\n\n` +
-            say({ en: '(empty)', es: '(vacío)' }, lang);
-        const keyboard = new InlineKeyboard().text(back, acView.pack({ v: 'main' }));
+            say({ en: "(empty)", es: "(vacío)" }, lang);
+        const keyboard = new InlineKeyboard().text(back, acView.pack({ v: "main" }));
         return { text, keyboard };
     }
-    const lines = [`${headerEmoji} ${headerLabel} (${ids.length})`, ''];
+    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} ${say({ en: '(data lost)', es: '(datos perdidos)' }, lang)}`);
+            lines.push(`${i + 1}. id ${id} ${say({ en: "(data lost)", es: "(datos perdidos)" }, lang)}`);
             continue;
         }
         const ageRef = rec.approvedAt ?? rec.deniedAt ?? rec.requestedAt ?? Date.now();
-        lines.push(`${i + 1}. ${formatUser(rec.user, id)} · ${say({ en: 'ago', es: 'hace' }, lang)} ${fmtAge(Date.now() - ageRef)}` +
-            (rec.messageCount ? ` · ${rec.messageCount} msgs` : ''));
-        if (filter === 'pending') {
+        lines.push(`${i + 1}. ${formatUser(rec.user, id)} · ${say({ en: "ago", es: "hace" }, lang)} ${fmtAge(Date.now() - ageRef)}` +
+            (rec.messageCount ? ` · ${rec.messageCount} msgs` : ""));
+        if (filter === "pending") {
             keyboard
-                .text(`✅ ${i + 1}`, acApprove.pack({ uid: id, v: 'pending' }), {
-                style: 'success',
+                .text(`✅ ${i + 1}`, acApprove.pack({ uid: id, v: "pending" }), {
+                style: "success",
             })
-                .text(`❌ ${i + 1}`, acDeny.pack({ uid: id, v: 'pending' }), {
-                style: 'danger',
+                .text(`❌ ${i + 1}`, acDeny.pack({ uid: id, v: "pending" }), {
+                style: "danger",
             })
                 .row();
         }
-        else if (filter === 'approved') {
+        else if (filter === "approved") {
             keyboard
-                .text(`${say({ en: '↩️ Revoke', es: '↩️ Revocar' }, lang)} #${i + 1}`, acRevoke.pack({ uid: id }), { style: 'danger' })
+                .text(`${say({ en: "↩️ Revoke", es: "↩️ Revocar" }, lang)} #${i + 1}`, acRevoke.pack({ uid: id }), { style: "danger" })
                 .row();
         }
-        else if (filter === 'denied') {
+        else if (filter === "denied") {
             keyboard
-                .text(`${say({ en: '✅ Reapprove', es: '✅ Reaprobar' }, lang)} #${i + 1}`, acApprove.pack({ uid: id, v: 'denied' }), { style: 'success' })
+                .text(`${say({ en: "✅ Reapprove", es: "✅ Reaprobar" }, lang)} #${i + 1}`, acApprove.pack({ uid: id, v: "denied" }), { style: "success" })
                 .row();
         }
     }
     if (ids.length > shownIds.length) {
-        lines.push('', `(+${ids.length - shownIds.length} ${say({ en: 'more, not shown', es: 'más, no mostrados' }, lang)})`);
+        lines.push("", `(+${ids.length - shownIds.length} ${say({ en: "more, not shown", es: "más, no mostrados" }, lang)})`);
     }
-    if (filter === 'approved' && defaults.size > 0) {
-        lines.push('', `+ ${defaults.size} hardcoded defaults`);
+    if (filter === "approved" && defaults.size > 0) {
+        lines.push("", `+ ${defaults.size} hardcoded defaults`);
     }
-    keyboard.text(back, acView.pack({ v: 'main' }));
-    return { text: lines.join('\n'), keyboard };
+    keyboard.text(back, acView.pack({ v: "main" }));
+    return { text: lines.join("\n"), keyboard };
 };
 // ─── test helper ───────────────────────────────────────────────────
 /**
@@ -608,7 +631,7 @@ const listView = async (storage, idx, filter, defaults, lang) => {
 export const simulateAccessRequest = async (bot, storage, adminId, fakeUser, message) => {
     const now = Date.now();
     const rec = {
-        status: 'pending',
+        status: "pending",
         user: fakeUser,
         chatId: fakeUser.id,
         requestedAt: now,
@@ -618,7 +641,7 @@ export const simulateAccessRequest = async (bot, storage, adminId, fakeUser, mes
         lastNotifiedAt: now,
     };
     await saveAccess(storage, fakeUser.id, rec);
-    await indexAdd(storage, 'pending', fakeUser.id);
+    await indexAdd(storage, "pending", fakeUser.id);
     const adminLang = await langOfUser(storage, adminId);
     await bot.api.sendMessage({
         chat_id: adminId,